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}}
}
}
settingsmerges field by field andspeciesby id, so{"raven": {"active": {"day": 0}}}only silences the ravens by day.- A new species needs a
model, aBirds/<Name>key from yourmodels.json; its other fields come from the raven. active: the hours it flies,day,twilightandnight, as a list or as weights.groupandflock_chance: the flock's size and how often it comes as a flock.formation:solo,loose,cluster,vorthermal. Alsoaltitude,speed,size, the wingbeat and the glides.call_familygives a species a voice:corvid,small,owlornone(the default for a new one).settings.densityscales how often birds come, and"enabled": falseremoves 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
activesilences a species. A new one needs amodel, aSnakes/<Name>key, and takes its other fields from the sand racer. gait:serpentine(the body follows the head's trail) orsidewinding. Alsospeed,size,wave_amplitude,wavelengthandtracks(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), andcapture_chanceandhunters, 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,hoporflutter. - A species appears only through a group:
memberssays how many of each a colony holds (at most 12 creatures), andpitandplainhow likely a new colony there is to be this group. A weight of 0 keeps a group out. - A new species needs a
model, aMicrofauna/<Name>key, and takes its other fields from the beetle. settings.coloniesis 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.
