WILDLANDS — the survival explorer's kit.
The rigged body the engine ships has no material of its own, so the character
is dressed the way a game character should be: real 3D geometry seated on the
actual skeleton bones with `Humanoid:attach`, so every piece follows the body
through every animation instead of floating beside it.
Bones used (all real, from the standard humanoid layout):
Head hair, face shade
Neck scarf
Spine_02 jacket chest, crossed straps
Spine_01 jacket skirt
Spine_03 backpack, holstered axe
Hips belt, pouches
Shoulder_* sleeve (upper arm)
Elbow_* sleeve (forearm)
Hand_* glove
UpperLeg_* trouser thigh
LowerLeg_* trouser shin
Ankle_* boot
foot boot toe
mk(name: ?, props: ?, textures: ?) → void
Colours are LINEAR: the renderer multiplies them straight into the light.
`textures` maps a slot to an already-resolved texture reference. The identities
are written as literals at each call site rather than looked up from a
variable here, so every reference stays statically pinned.
| arg | type | description |
|---|
| name | ? | |
| props | ? | |
| textures | ? | |
rt(name: ?, props: ?) → void
Runtime GPU materials, built once per session.
These are deliberately NOT authored `.material` assets. An authored material
only reaches the GPU once the asset index holds a version record for it, and in
this world the index has none — every `Model` given one is disabled on awake
with "material 'wildlands.materials.wl_jacket' has no version yet (no guid and
checksum in the asset index), so it has nothing to file on the GPU", which is
why the character's clothing stopped drawing. `renderer.material.create` files
the material straight onto the GPU and has no index to wait for. Verified: a
Model given one of these stays `running`.
| arg | type | description |
|---|
| name | ? | |
| props | ? | |
meshOf(g: ?, keep: ?) → void
| arg | type | description |
|---|
| g | ? | |
| keep | ? | |
boneAxis(boneEnt: ?, childEnt: ?) → void
A bone's local frame is not knowable in advance: a rig may point a shoulder
bone down the arm, across the chest, or anywhere else. So a garment for a limb
is built by MEASURING the limb: take the two bones at its ends, express the
world direction between them in the first bone's own basis, and sweep the
sleeve along that. The result follows the limb whatever the rig's convention.
| arg | type | description |
|---|
| boneEnt | ? | |
| childEnt | ? | |
limbTube(lx: ?, ly: ?, lz: ?, len: ?, rTop: ?, rBot: ?, col: ?, bulge: ?) → void
A taper swept from a bone toward its child, in the bone's own space.
| arg | type | description |
|---|
| lx | ? | |
| ly | ? | |
| lz | ? | |
| len | ? | |
| rTop | ? | |
| rBot | ? | |
| col | ? | |
| bulge | ? | |
sleeve(rTop: ?, rBot: ?, len: ?, col: ?) → void
A limb sleeve: a tapered tube a little wider than the limb it covers.
| arg | type | description |
|---|
| rTop | ? | |
| rBot | ? | |
| len | ? | |
| col | ? | |
torsoShell(rWaist: ?, rChest: ?, h: ?, col: ?) → void
A torso shell: a swept body from waist to shoulders, wider than deep.
| arg | type | description |
|---|
| rWaist | ? | |
| rChest | ? | |
| h | ? | |
| col | ? | |
ring(radius: ?, tube: ?, col: ?) → void
| arg | type | description |
|---|
| radius | ? | |
| tube | ? | |
| col | ? | |
flatBox(g: ?, cx: ?, cy: ?, cz: ?, sx: ?, sy: ?, sz: ?, col: ?) → void
| arg | type | description |
|---|
| g | ? | |
| cx | ? | |
| cy | ? | |
| cz | ? | |
| sx | ? | |
| sy | ? | |
| sz | ? | |
| col | ? | |
strap(g: ?, x1: ?, y1: ?, z1: ?, x2: ?, y2: ?, z2: ?, w: ?, th: ?, col: ?) → void
A plane strap between two points on the chest, as a thin slab.
| arg | type | description |
|---|
| g | ? | |
| x1 | ? | |
| y1 | ? | |
| z1 | ? | |
| x2 | ? | |
| y2 | ? | |
| z2 | ? | |
| w | ? | |
| th | ? | |
| col | ? | |
build(list: ?, M: ?) → void
Each entry: { socket, geometry, material, position (metres, bone-local),
rotation (euler degrees, bone-local), scale }
| arg | type | description |
|---|
| list | ? | |
| M | ? | |
add(socket: ?, geo: ?, mat: ?, pos: ?, rot: ?, scl: ?, limb: ?) → void
| arg | type | description |
|---|
| socket | ? | |
| geo | ? | |
| mat | ? | |
| pos | ? | |
| rot | ? | |
| scl | ? | |
| limb | ? | |
dress(bodyId: ?) → void
Dress `bodyId`'s humanoid. Returns the list of pieces it made.
| arg | type | description |
|---|
| bodyId | ? | |
skinBody(bodyId: ?) → void
Give the body itself a skin material so the head and any exposed skin read as
skin rather than the engine's grey default. The skinned mesh carries one
material for the whole body, so the fabric garments above cover everything
except the head, neck and hands.
| arg | type | description |
|---|
| bodyId | ? | |
walk(e: ?, depth: ?) → void
| arg | type | description |
|---|
| e | ? | |
| depth | ? | |
hold(bodyId: ?, kind: ?) → void
| arg | type | description |
|---|
| bodyId | ? | |
| kind | ? | |
stow(bodyId: ?, kind: ?) → void
| arg | type | description |
|---|
| bodyId | ? | |
| kind | ? | |