People
A mod may ship characters (characters/*.ron): the models the walker wears and the
passengers are made of. The shipped people mod carries twenty-four of them, generated
out of MakeHuman 2 by tools/characters/ (its README explains the pipeline and how to
add faces of your own); a mod of yours adds people the same way:
( name: "Lena", // display name — content, not translated model: "people/assets/f01_lena.glb", // glTF below mods/, like every other model gender: Female, // Female | Male | Unspecified roles: [Player, Passenger], // what the app may pick it for; default both height: 1.68, // m, informational tags: ["young", "casual"],)The file is all the app needs; everything else is convention in the model, so a character needs no per-file tables:
- Origin and axes: metres, Y up, the origin on the ground between the feet, the face towards −Z — the frame the walker and the vehicles use.
- Levels of detail: the skinned mesh as nodes
char_LOD0…char_LOD3(the_LOD<n>convention every model shares), finest first, all on one skeleton so a level switches without a pose change. The generated people carry about 30 000 / 6 000 / 1 600 / 500 triangles; the app hands over at 30, 80 and 200 m and culls a person at 500 m (300 m for somebody aboard a train). - Clips, in families told apart by name, as many of each as the model likes:
idle,idle2,idle3, … (looping stands with a little life in them — a standing person plays one of them, drawn by its seed),sit,sit2, … (feet on the floor, the seat about 0.45 m up; a passenger plays one),walk_<cm/s>(one gait cycle in place, named after the pace it was recorded at —walk_120covers 1.2 m/s at its own speed; a plainwalkcounts as 1.5 m/s — a walking person plays the one nearest its pace, sped up or down to cover the ground, so a stroll and a hurry are different clips rather than one clip at two speeds) andstand,stand2, … (held frames, what a model without idles falls back to). Whatever is missing is not used — the app falls back to the nearest family it finds, and a character with no clips stands in its rest pose. The shipped people carry four walks, four idles and three seated clips each, retargeted from motion capture recordings (tools/characters/README.md) that are licensed CC BY — a mod that copies one of these files takes the attribution inTHIRD_PARTY_LICENSES.mdwith it. - Textures: one opaque atlas for skin and clothes, one cut-out atlas (alpha mask) for hair, brows, lashes and eyes; the app builds the mip chain the first time a character is shown.
Where people appear. Passengers are placed by the app, not by the line file — they are cosmetic and derived, so nothing about them is stored or sent:
- On platforms: every
Platformdevice gets a waiting crowd along its length, one person per six metres or so (at least one, at most sixty), 2.3–2.9 m beside the track on the platform’s side, standing on the platform’s height (or on the ground where none is given), facing the track give or take — a few look along the platform — in a mix of the model’s idle clips with staggered starts so no two move in step. About a third of them walk instead, up and down a 1.2 m wide lane 3.8 m from the track, a shoulder’s width behind the crowd. Which person stands where is decided by a hash of the line’s name and the device’s index, so every client of a multiplayer run — and every restart — shows the same crowd. - In seats: a vehicle whose model block lists
seats(see Model (glTF)) has about two thirds of them taken, decided by a hash of the train, the vehicle and the seat, with thesitclip. A vehicle that lists none carries nobody. - On walkways: a line may draw footpaths and walk areas (see Walkways under Lines and scenarios), and a model may carry them (see Track objects): people walk a footpath round and round without stopping, and wander a walk area between spots inside it while the rest of its people stand about. Nobody walks through anybody: on a footpath everyone keeps to the right (0.35 m and more from the middle, so two meeting pass a shoulder’s width apart), walks at the one pace the way has (so nobody overtakes) and turns round at each end in a half circle from one lane onto the other — an oval nobody on it ever has to cross; a wanderer’s spots and ways keep clear of the people standing in the area and of the spots the other wanderers stop at — two wanderers may still cross while both walk.
- The walker: see The character above. What another player’s walker looks like is not sent over the wire yet; remote walkers are not drawn at all.
Where a person is at any moment is a pure function of the line, a seed and the scenario clock — nothing about the crowd is stored or sent, every client computes the same people in the same places, and the crowd stands still while the run is paused. People stream with the terrain tiles like trees and scenery objects, so a long line with many stations costs nothing where nobody is looking.
The glTF files of the people mod are Git LFS objects, like every binary asset below
mods/ (.gitattributes lists the extensions): a checkout needs git lfs install once,
otherwise the files are pointers — the mod manager then warns … is a Git LFS pointer
for each model instead of loading nothing.