WIKI

Mods

Wildlife

Birds, snakes and microfauna are scenery: a mod that only changes them keeps your normal profile. Each has a JSON file merged over the game's (_vanilla_reference in your Mods folder has the game's three, with every field) and model keys for new species. A field that fails its check is named in the log, and the value before it stays.

Birds

{
  "version": 1,
  "settings": {"density": 1.3},
  "species": {
    "flamingo": {"model": "Birds/Flamingo", "active": {"twilight": 3, "night": 1},
                 "group": [6, 16], "flock_chance": 1.0, "formation": "v"},
    "raven": {"active": {"day": 0}}
  }
}
  • settings merges field by field and species by id, so {"raven": {"active": {"day": 0}}} only silences the ravens by day.
  • A new species needs a model, a Birds/<Name> key from your models.json; its other fields come from the raven.
  • active: the hours it flies, day, twilight and night, as a list or as weights. group and flock_chance: the flock's size and how often it comes as a flock. formation: solo, loose, cluster, v or thermal. Also altitude, speed, size, the wingbeat and the glides.
  • call_family gives a species a voice: corvid, small, owl or none (the default for a new one).
  • settings.density scales how often birds come, and "enabled": false removes them. Nobody flies in rain or a sandstorm.

Bird models

One GLB at the bird's size in the game: in Blender X forward, Y left and Z up, the origin between the shoulders and the wings spread flat, with no bones; the game beats the wings itself. For the best flight, add Empties ShoulderL, ShoulderR, WristL and WristR under the root, and a second UV map named BirdRig: U the span, 0 at the shoulder and ±1 at the wingtip (positive on the bird's right), V the part, 0 body, 1 wing, 2 tail, 3 head and 4 legs (in Blender write 1 − part, since the export flips V). Without them it still flies, more stiffly. "material": "game" paints vertex-coloured plumage like the game's birds; keep a bird under about 6,000 triangles. Flamingos at dusk adds one.

Snakes

{
  "version": 1,
  "settings": {"capture_chance": 0.3, "hunters": ["buzzard", "owl", "raven"]},
  "species": {
    "sand_racer": {"active": {}},
    "desert_cobra": {"model": "Snakes/Cobra", "active": {"twilight": 2},
                     "gait": "serpentine", "speed": [20, 28], "size": [1, 1.2]}
  }
}
  • An empty active silences a species. A new one needs a model, a Snakes/<Name> key, and takes its other fields from the sand racer.
  • gait: serpentine (the body follows the head's trail) or sidewinding. Also speed, size, wave_amplitude, wavelength and tracks (how visible its trail in the sand is).
  • settings: density, interval_seconds, max_snakes, plateau_share (how many cross the plain instead of the pit), and capture_chance and hunters, the chance a bird of prey takes one and the birds that may.

Snake models

One straight mesh at the snake's size, in Godot's frame: the snout at x = 0, the body along −X and the belly on y = 0. The game bends it along its spine, so it needs no bones. A second UV map gives U from 0 at the tail's tip to 1 at the snout, and V the part (0 body, 1 head, 2 eye, 3 horn); without one it is all body. The colours are its vertex colours.

Microfauna

{
  "version": 1,
  "settings": {"colonies": [16, 24, 32, 40]},
  "species": {
    "scorpion": {"model": "Microfauna/Scorpion", "behavior": "wander",
                 "speed": [1.3, 2.1], "size": [0.85, 1.1], "length": 5.0}
  },
  "groups": {
    "scorpion_den": {"pit": 1.2, "plain": 1.0, "members": {"scorpion": [1, 2]}},
    "butterflies": {"pit": 0}
  }
}
  • Each colony lives under a stone, and its creatures come out round it. behavior: trail (an ant carrying seeds to and from a pile), wander, hop or flutter.
  • A species appears only through a group: members says how many of each a colony holds (at most 12 creatures), and pit and plain how likely a new colony there is to be this group. A weight of 0 keeps a group out.
  • A new species needs a model, a Microfauna/<Name> key, and takes its other fields from the beetle.
  • settings.colonies is the number of colonies at each graphics preset, Low to Ultra.

Microfauna models

A small mesh at its size in the game (the ant is about 3 units long, a tile 64), facing +X with Y up and its feet on y = 0. With "material": "imported" it keeps its own materials and moves as one piece. With "material": "game" it wears the game's shell from its vertex colours, and a second UV map moves its parts: U is 0 for the body, ±1 to ±3 for the legs by side, ±4 for feelers, claws or a tail, ±5 for wings and 6 for a carried seed, and V the weight, 0 where the part joins the body and 1 at its tip (in Blender, 1 − weight). Desert scorpions adds one.

The plain's shrubs

Environment/PlainShrubs is one model with a mesh per species, named Saltbush, Creosote, Burrobush and Brittlebush, each standing on its root at the origin, Y up, 28 to 42 units across. An optional <Species>_Far mesh is drawn from afar. Where they stand is the game's own; on the game's built-in plains, "scenery": {"shrub_density": 0.5} in balance.json keeps that share of them.