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

Spawns

Decide where in the world a creature shows up, in which difficulty ring, how often, and how many at a time.

What this lets you make#

A species only defines a creature. To make it walk around in the wild you also add it to a spawn table. One spawn entry is a single sentence: "this creature, in these biomes and this difficulty range, at this frequency, this many at a time".

You can place your own creatures or built-in ones, for example more bandits in the desert. Bosses, story props, sea creatures, mounts and stronghold contraptions cannot be placed (it is the same set that cannot be a base, listed on the Species page).

In the editor#

Open the Spawns tab under Creatures in the left column and press Add. Each entry is named after the creature.

FieldWhat it does
CreaturePick one from this mod or from the game.
WhenAny time or Night only.
BehaviorHunts the player or Roams peacefully. Not shown for night-only spawns.
WhereEverywhere, or pick from Grassland, Forest, Desert, Mesa and Tundra. Pick at least one.
How far from the startMonsters get stronger the farther you go. Choose By distance (from Near the start to Frontier) or By level.
How commonFrom Very rare to Very common. Like the game is the middle.
Group sizeHow many appear together, from one number to another.
MoreStarts collapsed. Role in a group (Leader, Follower or Either, for hunters only) and Near water only.

The right column shows the creature with a short summary of where, how far and how many.

To test, press the top-bar Test.

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 is data/spawns.json, and mod.json points to it with "spawns": "data/spawns.json" under content.

A minimal working example#

Make Ember Wolves appear in deserts and red-rock country, in areas of level 6 to 14, in groups of 1 to 3:

data/spawns.json
[
  {
    "species": "ember_wolf",
    "time": "any",
    "kind": "hostile",
    "biomes": ["DESERT", "MESA"],
    "levels": [6, 14],
    "weight": 0.8,
    "group": [1, 3]
  }
]

Fields#

FieldRange and meaning
species (required)The creature to place: one from your mod, a built-in one, or @othermod/id
timeany (default, day and night) or night (night only)
kindhostile (default, attacks the player) or wildlife (animals that only fight back). Ignored when time is night
biomes (required)"ALL" or a list. Allowed: GRASSLAND, FOREST, DESERT, MESA (red rock), TUNDRA (snowfield). For wildlife, "ALL" means all five
rings or levels (required, pick one)rings is a difficulty ring range [from, to], whole numbers 1 to 5. levels is a level range [from, to], 1 to 100, which the game turns into the rings whose levels overlap it. A single number means [n, n]. You cannot write both
weight (required)How often, 0.05 to 4. Built-in spawns use roughly 0.4 to 1.2. A bigger number is more common
group[fewest, most] creatures per group, 1 to 8, default [1, 1]
roleHostile only. lead (forms its own group), companion (joins another group), both (default)
nearWatertrue means only near water. Default false

Difficulty rings and levels#

The world is split into five rings around the starting point. The farther from the start, the more dangerous. rings takes ring numbers; levels takes the levels you have in mind and the game finds the matching rings for you.

RingDistance from the startLevels
10 to 400 blocks1 to 2
2400 to 900 blocks3 to 7
3900 to 1700 blocks7 to 13
41700 to 3000 blocks12 to 20
53000 to 5700 blocks18 to 25

If the levels range overlaps none of the rings (for example [40, 60]), the load check says no region has that level range. To go further out, write "rings": [5, 5] instead.

Two more examples#

You can use only built-in creatures, with no species at all. This list sends bandits out in packs at night on grassland and in forests, and lets deer appear in forests near water (wildlife, so they never start a fight):

data/spawns.json
[
  {
    "species": "BANDIT",
    "time": "night",
    "biomes": ["GRASSLAND", "FOREST"],
    "rings": [2, 4],
    "weight": 0.6,
    "group": [2, 4],
    "role": "lead"
  },
  {
    "species": "DEER",
    "kind": "wildlife",
    "biomes": ["FOREST"],
    "rings": [1, 2],
    "weight": 0.8,
    "group": [2, 4],
    "nearWater": true
  }
]

Common mistakes#

  • Making a species but no spawn. The creature never appears by itself.
  • Writing both rings and levels, or neither. Pick exactly one.
  • Putting OCEAN in biomes. Spawn tables only have the five land biomes. For buildings at sea use Blueprints.
  • Setting weight very high (like 4) with no biome limit, and ending up with creatures everywhere. Built-ins sit around 0.4 to 1.2, so start near 0.5.
  • Placing a boss, a mount or a sea creature. These are refused.
  • A group like [3, 1]. The first number cannot be bigger than the second.
  • Species: define a creature first.
  • Blueprints: put creatures in a fixed spot inside a building.
  • Quests: send players to hunt them.
  • Rules: raise or lower enemy health and damage across the board.
  • The mod editor: build this kind of content with forms and test it in the game.