Mods are a feature of the full game, not the demo. They open when the full game launches, and details may change before then.

Species (creatures)

Start from a creature that already exists in the game, change its health, damage, size, colours, drops, moves and behaviour, and you have a new creature.

What this lets you make#

You do not build a monster from scratch. You pick an existing creature as the base (base), and the new creature copies its model, moves and behaviour. Then you change what you want: numbers (health, damage, speed, size, level), colours, drops, moves and a few behaviour switches. Tint a Frost Wolf orange-red and give it 40% more health, and you have an "Ember Wolf".

The result is a real species in the game. The bestiary, nameplates, combat and drops all treat it like a built-in creature. But it does not appear on its own. Add it to the spawn tables with Spawns, put it in a Blueprint as a guard, or use it as a kill target in a Quest.

A mod that uses this table needs to be installed by everyone playing together, and worlds made with it count as modded worlds.

In the editor#

Open the Creatures tab under Creatures in the left column. Press Add to start a new creature, or Copy from game to start from a base game creature (all multipliers start at 1).

FieldWhat it does
Base creaturePick a creature from the game; its look, moves and habits carry over. Change picks another one.
NameWhat players see (Other languages underneath).
TypeFighter attacks on sight; Wildlife only fights back when hit.
StrengthHealth, Damage, Speed, Attack speed and Size are multipliers (1 is the same as the base) and the form shows the real result, for example "Health 120 → 168". Level is set directly. Weight is Light, Normal or Heavy (heavier is harder to knock back).
LookTint with Tint strength, Brightness, and Color swaps (Old color to New color, picked from the colours it already has). For humanoid bases there is also Hood color, and Body part colors (skin, hair, eyes, clothes), which starts collapsed.
DropsIf empty, it keeps the base drops. Once you add rows (Item, Chance, Fewest, Most, Minimum level), only those drop, unless you switch on Also keep the base drops.
BehaviorPeaceful, Night only and Runs away are each Keep base, Yes or No (running away has distance, speed and time settings). Faction keeps creatures of one group from fighting each other.
MovesStarts collapsed. By default it keeps all the base moves. For Basic attack, Gap closer, Area attack and Special move you can keep it, tune the numbers (Damage, Cooldown (s), Wind-up (s)), copy another creature's move, or remove it. Add a move adds a new one.

The right column shows a picture of the creature, its real numbers, its colours and its drops.

To test, press Try this one above the form. The editor saves, reloads, and puts you in a flat daytime test arena with the creature standing in front of you. The top-bar Test loads the whole mod instead.

Advanced: writing the JSON by hand#

Below is the same content as it looks in the file. The editor saves exactly this format. You can also press Open folder at the top of the editor and edit the file in an outside text editor; when you save, the editor picks up the change. Fields the form does not show are kept as they are. Where the file goes and how it is listed: Mod folder and mod.json.

The file lives at data/species.json in your mod folder, and mod.json points to it with "species": "data/species.json" under content (see Folder and mod.json). The file is a list, and each entry is one creature.

A minimal working example#

An Ember Wolf: tougher than a Frost Wolf and tinted orange-red. Anything you leave out stays as the Frost Wolf has it, moves included.

data/species.json
[
  {
    "id": "ember_wolf",
    "base": "FROST_WOLF",
    "name": "Ember Wolf",
    "names": { "zh-TW": "餘燼狼", "zh-CN": "余烬狼" },
    "stats": { "hp": 1.4, "damage": 1.2, "speed": 1.1, "scale": 1.1 },
    "look": {
      "tint": { "color": "#d4582a", "strength": 0.6 },
      "brightness": 1.05
    },
    "drops": [
      { "item": "wolf_pelt", "chance": 0.6, "min": 1, "max": 2 },
      { "item": "raw_meat", "chance": 0.8, "min": 1, "max": 2 }
    ]
  }
]

name is the plain name and names adds other languages (en, zh-TW, zh-CN). You need at least one name, up to 40 characters. A language you leave out borrows a name from another one.

Fields#

A field is one setting in the file. If you misspell a field name, the game points it out instead of silently ignoring it.

FieldRange and meaning
id (required)Your own name for it: lowercase letters, digits and underscores, starting with a letter or digit, up to 48 characters. The game adds your mod id in front, so it never clashes with another mod
base (required)The creature to copy, from the list below. You can also use a creature defined earlier in the same file, or @othermod/id (the other mod must be in your dependsOn)
name, names (required)Display name, up to 40 characters
categoryCOMBAT (attacks on sight) or AMBIENT (wildlife that only fights back when hit). Left out, it follows the base
stats.hp, stats.damageMultipliers from 0.25 to 4 (1 means unchanged)
stats.speed, stats.attackSpeedMultipliers from 0.5 to 2. A higher attackSpeed means shorter gaps between attacks
stats.scaleSize multiplier from 0.4 to 3. The nameplate height follows
stats.levelLevel, a whole number from 1 to 100. This one is an absolute number, not a multiplier
stats.weightWeight class: light, standard or heavy
look.tintWhole-body tint: { "color": "#rrggbb", "strength": 0 to 1 }. Strength defaults to 0.6. Light and shade are kept
look.brightnessBrightness multiplier from 0.5 to 1.6
look.swapUp to 16 exact colour swaps: { "from": colour, "to": colour }. Swaps run first, then the tint
look.colors, look.hoodColorHuman-shaped creatures only. Set clothing colours directly. colors accepts skin, hair, eye, tunic, tunicTrim, shirt, pants, boots, belt
dropsUp to 16 entries. Each has item (vanilla or modded), chance (0 to 1, required), min/max (1 to 50) and minLevel (the creature must be at least this level to drop it)
keepBaseDropsWhen true, your drops are added on top of the base creature's own. Default false
movesMoves, four slots: BASIC, GAP_CLOSE, AREA, MECHANIC. See "Moves" below
behaviourBehaviour switches, see "Behaviour" below

Creatures you can use as a base#

These are the game's creature codes, in capitals with underscores. Story bosses, their helpers and props, sea creatures, mounts and stronghold contraptions cannot be a base, and cannot be placed in the wild.

KindAllowed `base` values
Human-shaped (can use look.colors)ZOMBIE, SKELETON, GOBLIN, ORC_WARRIOR, CULTIST, BANDIT
Beasts and wildlifeWOLF, WOLF_ARMORED (armoured wolf), FROST_WOLF, BEAR, POLAR_BEAR, PENGUIN, CRAB, DEER, ELK, GOAT, FOX, ARCTIC_FOX, SEAL, RABBIT, SNOW_HARE, SAND_HARE, SHEEP, BOAR, CHICKEN, PIG, BAT, VULTURE, STORM_HAWK, BLADEHORN_BISON, GRASS_STALKER, YETI
Bugs and desert creaturesSAND_SCORPION, SAND_LIZARD, SAND_BURROWER, FOREST_SPIDER, CAVE_SPIDER, GIANT_ANT, ANT_QUEEN, SPIDER_BROODMOTHER, SCORPION_KING, CRYSTAL_MITE, ICE_BEETLE, ROCK_ARMADILLO, SLAG_LIZARD, BOG_TOAD, TIDE_CRAB_BRUTE
Slimes and spiritsSLIME, BOMB_SLIME, SAND_SLIME, ICE_SLIME, ECHO_SLIME, FROST_WISP, NIGHT_WISP, MOSS_GOLEM, THORN_SPRITE, CLIFF_HARPY
GoblinsGOBLIN_SLINGER, GOBLIN_SHAMAN, GOBLIN_CHIEFTAIN, GOBLIN_BOMBER, GOBLIN_WITCHDOCTOR
OrcsORC_SHIELDBEARER, ORC_WARCHIEF, ORC_DRUMMER, ORC_JAVELINEER
BanditsBANDIT_CROSSBOW, BANDIT_CAPTAIN, BANDIT_CUTTHROAT
UndeadSKELETON_ARCHER, SKELETON_SHIELD, BONE_KNIGHT, BONE_PRIEST, DUNE_MUMMY
CultCULTIST_SUMMONER, CULT_HIGH_PRIEST, CULT_ZEALOT, CULT_HEXER

If you write a code that is not on this list, the load check shows you the creatures you can use.

Moves#

Every creature has four move slots: BASIC (its basic attack), GAP_CLOSE (closing the distance), AREA (hits an area) and MECHANIC (a special trick). A slot you do not mention keeps the base creature's move, scaled by your damage and attackSpeed multipliers. You can write each slot like this:

  • As an object: tune that move. "BASIC": { "damage": 24 } changes only the damage and keeps the rest.
  • With "copy": take a move from somewhere. "copy": "AREA" takes the base creature's own move in that slot, and "copy": "POLAR_BEAR.GAP_CLOSE" takes another creature's move, written as "creature code.slot".
  • As false: remove that move.
  • If the base has no move in that slot (a Frost Wolf only has its plain bite, for example), you must give a kind yourself or copy one.
Move fieldRange
kindmelee, lunge, charge, ranged, leap, hazard, summon, aura, guard, mend, revive, rally, lob, stealth, curse, eldritch
damage0 to 400
minRange / maxRange0 to 20 / 0.5 to 30 blocks. minRange cannot be bigger than maxRange
windupSecSeconds of telegraph before the hit lands, 0.15 to 4. It cannot be shorter than 0.15, or players could not see it or dodge it
strikeSec, recoverSecStrike animation 0.05 to 3 seconds, recovery 0 to 4 seconds
cooldownSecGap before the same move can be used again, 0.3 to 60 seconds
chainA combo, up to 2 hits. Each has windupSec (0.15 to 2), damageMult (0.1 to 1.5) and an optional delaySec (0 to 1). false removes the combo
elementfire, frost, poison, storm; false removes the element
payloadExtra details for specific kinds of move, see the next table

The fields inside payload depend on the kind of move:

Kind of move`payload` fields and ranges
rangedspell (how the shot looks: mob_rock, mob_bolt, mob_spit, mob_arrow, mob_eldritch), projectileSpeed (5 to 60). You can also add hazard so the impact point leaves a ground effect
hazard (needs hazard)hazard (ice, poison, fire), hazardRadius (0.5 to 6), hazardSec (0.5 to 15), at (at the player's feet target, or at its own feet self)
summon (needs summon)summon: { "type": creature, "count": 1 to 3 }. Bosses cannot be summoned
auraauraRadius (1 to 15) and auraKind: damage boosts attack (auraDamageMult 1 to 2), speed boosts movement (auraSpeedMult 1 to 2), guard reduces damage taken (auraDamageTakenMult 0.4 to 1, so 0.7 means 70% damage taken)
guardOnly in the MECHANIC slot. guardArc (width of the protected front, in radians, 0.3 to 6.28) and guardMult (damage from hits inside that arc is multiplied by this, 0.2 to 1)
mend, reviveBoth are chanted and a heavy hit can interrupt them. healRadius (1 to 15), healFrac (share of max health restored, 0.02 to 0.5); reviveRadius (1 to 15), reviveWindowSec (how recently an ally must have fallen to be raised, 1 to 30)
rallyrallyRadius (1 to 20), rallyDamageMult (1 to 2), rallySec (1 to 20)
stealthstealthSec (1 to 10), ambushMult (damage multiplier on the next melee hit, 1 to 3), stealthSpeedMult (1 to 2)
cursecurseSec (0.5 to 10), curseTakenMult (how much more damage the player takes, 0 to 1), curseHealCut (how much of the player's healing is lost, 0 to 0.9)
eldritcheldritchBurstMult (extra damage multiplier when three stacks pop, 0 to 2)
lobflightSec (flight time, 0.4 to 3), hazard, hazardRadius, hazardSec: players in the radius where it lands are hurt, and it leaves a ground effect
charge, lungechargeSpeedMult (charge speed multiplier, 1 to 4), lungeDistance (how far the lunge goes, 0.5 to 8), dive (true turns it into a dive through the target), wallStun (seconds the creature is stunned if its charge hits a wall, taking double damage meanwhile, 0 to 3)
ranged with pulltrue pulls the player closer when the shot hits
melee, lungebackstep (0 to 2, hops away after hitting), ring (true draws a red ring on the ground during the telegraph), selfDestruct ({ "radius": 1 to 6 }, blows up after the hit)
status (added effect)An effect applied together with a melee, charge or ranged hit: slow (0 to 0.8, so 0.4 means 40% slower), slowSec (0 to 5), poisonSec (0 to 8), rootSec (0 to 2)

If you are not sure what you want, the safest route is to start by tuning plain numbers such as damage and cooldownSec, or to copy a move from a built-in creature.

Behaviour#

FieldMeaning
passivetrue only fights back when hit (like chickens and pigs); false removes this from the base
nightOnlytrue only appears and acts at night
scavengertrue eats nearby corpses and drops instead of only hunting
braceOnHittrue does not flinch when hit (knockback still happens)
territorialRadiusGuards a home area instead of roaming, radius 4 to 40; false removes it
fleeRuns away when the player gets close: triggerRadius (1 to 15), sprintMult (1 to 2.5) and durationSec (0.5 to 6), all three required; false removes it
factionA faction tag that affects how creatures relate to each other: wild, undead, goblin, orc, cult, bandit, construct, echo; false removes it

One more example, this time human-shaped: a Cultist turned into an Ash Priest that only comes out at night, wears grey robes and has a tuned basic attack.

data/species.json
[
  {
    "id": "ash_priest",
    "base": "CULTIST",
    "name": "Ash Priest",
    "names": { "zh-TW": "灰燼祭司" },
    "category": "COMBAT",
    "stats": { "hp": 2, "scale": 1.15, "level": 12, "weight": "standard" },
    "look": {
      "hoodColor": "#4a4a4a",
      "colors": { "tunic": "#6b3a2a", "tunicTrim": "#d9b44a" }
    },
    "moves": { "BASIC": { "damage": 24, "cooldownSec": 1.4 } },
    "behaviour": { "nightOnly": true, "territorialRadius": 16 }
  }
]

Common mistakes#

  • Writing health as an absolute number, like "maxHp": 140. This table wants a multiplier, "hp": 1.4. To change a built-in creature's absolute numbers, use Patches.
  • Using look.colors on a creature that is not human-shaped. Wolves and slimes have no clothing, so this is an error. Use tint or swap for them.
  • A windupSec smaller than 0.15.
  • Giving only damage for a slot where the base has no move. Add a kind, or use copy.
  • Writing only one or two of the flee numbers. All three are required.
  • Expecting the creature to show up in the world just because the species exists. You still need Spawns.
  • Using a boss or a sea creature as base.