Entities Config

From DragonMineZ Wiki

config/dragonminez/entities.json sets the base stats of DMZ creatures and enemies, and the default stat jump when a saga enemy transforms into its next form. Like the other server configs, the server sends it to every client.

For the creatures themselves, see the Bestiary.

Keys

Key Default What it does
configVersion A version string, for example "2.2.0" Version stamp used for config upgrades. Do not change it (see How to JSON).
defaultEntityStats See below Base stats per entity id (an object).
transformDefaults See below Default multipliers and trigger used when a saga enemy transforms (an object).

Entity base stats

defaultEntityStats maps an entity registry id (for example "dragonminez:bandit") to a stat object:

Key Default What it does
health 20 Max health. The default applies when the field is missing.
meleeDamage 1 Melee attack damage. The default applies when the field is missing.
kiDamage 1 Ki blast damage (only for entities that have a ki blast damage attribute). The default applies when the field is missing.

Values below 1 are raised to 1.

The stats are applied once, when the entity first spawns. Entities that were already in the world keep the stats they spawned with. Entities spawned for a quest use the stats written in the quest instead (see Custom Quests), scaled by the difficulty multipliers in General Server Config (easyMode* / hardMode*); naturally spawned entities are not scaled by difficulty.

Default entries

Entity id Name health meleeDamage kiDamage
dragonminez:dinokid Baby Dinosaur 30.0 4.0 0.0
dragonminez:dino1 Dinosaur 100.0 8.0 0.0
dragonminez:dino2 Large Dinosaur 150.0 12.0 0.0
dragonminez:dino3 Flying Dinosaur 75.0 10.0 0.0
dragonminez:sabertooth Sabertooth Tiger 30.0 5.0 0.0
dragonminez:giant_fish Giant Fish 80.0 8.0 0.0
dragonminez:giant_turtle Giant Turtle 40.0 0.0 0.0
dragonminez:bandit Bandit 75.0 10.0 0.0
dragonminez:red_ribbon_soldier Red Ribbon's Soldier 40.0 5.0 0.0
dragonminez:robot1 Red Ribbon Robot 120.0 15.0 0.0
dragonminez:robot2 Red Ribbon Robot 120.0 15.0 0.0
dragonminez:robot3 Red Ribbon Robot 120.0 15.0 0.0
dragonminez:mini_buu Mini Buu 60.0 8.0 6.0
dragonminez:saga_ogre_red Red Ogre 200.0 20.0 0.0
dragonminez:saga_ogre_blue Blue Ogre 200.0 20.0 0.0
dragonminez:mini_janemba_stampede Mini Janemba 20.0 2.0 0.0

You can add entries for other entity ids too: any living entity whose id is listed gets these stats when it spawns.

Spawn rates

See also: Bestiary

entities.json only sets stats. Where and how often creatures spawn naturally is defined by the Forge biome modifiers in data/dragonminez/forge/biome_modifier/ (spawn weights and group sizes per biome), which a datapack can override.

Bandits, the Red Ribbon Army, Sabertooth Tigers, Frieza's Soldiers and Mini Buus use their own spawn category, dragonminez:wild_enemy, with its own cap. Structures can define spawns for it in their spawn_overrides, as the Red Ribbon Tower does. The spawn rules, weights and biomes of each creature are listed in the Bestiary.

Saga enemy transformations

See also: Sagas

Saga enemies that have a next form (for example Frieza) transform when their health drops low enough. The transformDefaults values are used unless the quest's kill objective sets its own.

Key Default What it does
healthMultiplier 1.5 The new form's max health is the previous form's max health × this value (minimum 0.1).
meleeMultiplier 1.5 Multiplier on the previous form's melee damage (minimum 0.1).
kiMultiplier 1.5 Multiplier on the previous form's ki blast damage (minimum 0.1).
triggerHealthPercent 0.5 Fraction of max health (0–1) at which the enemy transforms.

Example

{
  "configVersion": "2.2.0",
  "defaultEntityStats": {
    "dragonminez:bandit": {
      "health": 75.0,
      "meleeDamage": 10.0,
      "kiDamage": 0.0
    }
  },
  "transformDefaults": {
    "healthMultiplier": 1.5,
    "meleeMultiplier": 1.5,
    "kiMultiplier": 1.5,
    "triggerHealthPercent": 0.5
  }
}

Removed keys

hardModeSettings (hpMultiplier, damageMultiplier) no longer exists. Difficulty scaling is configured in General Server Config with easyModeHPMultiplier, easyModeDamageMultiplier, hardModeHPMultiplier and hardModeDamageMultiplier.

Reload and validate

  1. Edit config/dragonminez/entities.json.
  2. Validate the JSON syntax.
  3. Run /dmzreload config. New values apply to entities spawned afterwards.