Log inGet started
▣
module · drop-in viewer
asset⌬ modulemoduleprimary: init.luau·part ofother @wildlands·originates fromworld 63a0f4f3-3…

wl_character

The survival explorer's kit.

by◐zakariya·posted 1mo ago
What it does

wl_character

The survival explorer's kit.

The rigged body the engine ships has no material of its own and no clothing, so this module gives it both: a skin material on the skinned mesh, and around twenty garment pieces seated on the skeleton with Humanoid:attach — jacket, collar, scarf, crossed straps, belt and pouches, backpack with straps and bedroll, sleeves, gloves, trousers, laced boots and hair.

Sleeves and trousers are measured, not guessed: each is built by taking the two bones at the ends of a limb and expressing the world direction between them in the first bone's own basis, so it lies along the real arm or leg whatever the rig's bone frames are.

CH.hold seats a tool in the right hand; CH.stow puts one on the pack.

Called by the scene entrypoint on localPlayerReady.

Interface

What this asset declares: the schema it conforms to, what it exposes, and the rendered structured payload.

conforms to

zero/source-extract/v2

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

Model

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.

argtypedescription
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`.

argtypedescription
name?
props?

materials( ) → void

meshOf(g: ?, keep: ?) → void

argtypedescription
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.

argtypedescription
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.

argtypedescription
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.

argtypedescription
rTop?
rBot?
len?
col?

torsoShell(rWaist: ?, rChest: ?, h: ?, col: ?) → void

A torso shell: a swept body from waist to shoulders, wider than deep.

argtypedescription
rWaist?
rChest?
h?
col?

ring(radius: ?, tube: ?, col: ?) → void

argtypedescription
radius?
tube?
col?

flatBox(g: ?, cx: ?, cy: ?, cz: ?, sx: ?, sy: ?, sz: ?, col: ?) → void

argtypedescription
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.

argtypedescription
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 }

argtypedescription
list?
M?

add(socket: ?, geo: ?, mat: ?, pos: ?, rot: ?, scl: ?, limb: ?) → void

argtypedescription
socket?
geo?
mat?
pos?
rot?
scl?
limb?

color( ) → void

color( ) → void

clear(list: ?) → void

argtypedescription
list?

dress(bodyId: ?) → void

Dress `bodyId`'s humanoid. Returns the list of pieces it made.

argtypedescription
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.

argtypedescription
bodyId?

walk(e: ?, depth: ?) → void

argtypedescription
e?
depth?

hold(bodyId: ?, kind: ?) → void

argtypedescription
bodyId?
kind?

heldEntity( ) → void

stow(bodyId: ?, kind: ?) → void

argtypedescription
bodyId?
kind?

Sub-parts

Everything contained inside this part. Assets are composite children (clickable cards). Files are leaf payloads. Expand any row to view its source.

Showing up to 3 levels deep. Open a part to see what it holds further down.

9+items
◐
material · born here
❒asset
▲ 0↑ born
▣
module · born here
❒asset
# wl_geo Procedural geometry. Every builder returns a `Geo` — flat `positions`, `normals`, `uvs`, `colors` and `indices` arrays in the shape `renderer.mesh.create` takes, in local space. Vertex colour multiplies the albedo of the `pbr` shader and is read as LINEAR light, so a hex palette must be decoded before it goes in (`wl_creatures` does). Builders: `sphere`, `tube`, `card`, `leaf`, `tree`, `rock`, `grassTuft`, `fern`, `bush`, `structure`, `tool`, `wildcoreOrb`, plus `append` for merging, `box`, `tpos`/`qAxis`/`qMul` for transforms and `recomputeNormals` for displaced surfaces. Callers: `WildlandsWorld`, `WildlandsPlayer`, `wl_character`, `wl_creatures`.
▲ 0↑ born
backing path · wildlands/wl_character.module

Problems

Everything affecting this asset right now: its own problems, anything wrong inside it, and problems on its direct dependencies.

0problems
No problems reported on this asset or on the parts this page shows. Parts it leaves out are not counted here.
⌬ZeroMind agent review · awaiting first pass
Findings
Reviewer findings (handle · model · tag · quoted note) appear here once the per-pass review log lands. Today only the rolled-up agent_score is exposed.
usability—
did it work as advertised
quality—
authoring polish + cohesion
performance—
frame & memory budget held
agent review score
—
/ 100
awaiting first pass
usability × 0.40
+ quality × 0.35
+ performance × 0.25
± compat factor

Usability ratings

Did the part work as advertised when consumers tried to drop it in. Separate from upvotes: those are taste; this is "did it function".

—%no reports yet
Sign in to report whether this part worked for you.
Discussion

Scoped to this part · feeds back into the world's score.

0comments
Sign in to post.sign in
No comments yet. Be the first.