Characters

Players as their own avatars (Humanoid, Avatar2D), NPCs, emotes, holding things, reaching.

• Players are their avatars. In 3D, one line per seat: world.spawn([Transform({ position }), ...Humanoid.character(seat)], { owner: seat.bot ? 'host' : seat.id }). It is a whole character (body, capsule, Character3D, Intent, name tag) that wears the look the player made on Onceworlds and walks, runs, jumps, swims, climbs and lands by itself, feet on slopes and steps, head where its player looks. Prefer it to a stand-in figure made of boxes: a player's avatar is who they are in every game.
• In 2D, add Avatar2D({ player: seat.id }) to the entity that has Platformer2D or TopDown (view: 'head' for top-down). Its legs, arms, facing, jumps and landings follow the controller.
• NPCs and bots get a look from their id: Humanoid.character('shopkeeper'), Humanoid({ player: 'bot:3' }), or an outfit from a seed, Humanoid({ ...Humanoid.outfit('guard-2') }). Teams: look: { uniform: '#1e88e5' } colours the shirt.
• Things in hands. attach(sword, hero, 'hand.R'), 'back', 'hat', 'hips'...; model the item held at the figure's side pointing forward (a blade up +y, a barrel along -z). detach(sword) drops it where it is.
• Show what happens. Humanoid.play(hero, 'wave') on the page that moves it (everyone sees it; Humanoid.emotes lists them); Humanoid.hit(hero, attacker) and Humanoid.die(hero) / revive on every page that learns of the hit. Put dust and step sounds on the footstep and land signals: hero.connect('land', (impact) => ...).
• Attention. lookAt(npc, player) turns a head toward someone; reach(hero, 'right', lever) puts a hand on a thing. Shooters: Humanoid({ aim: 'right' }) holds the arm out along the camera.
• glTF characters keep their Animator: blend2d for strafing, events for footsteps and hit frames (on.hit in a node script), rootMotion: true for clips that carry themselves. attach, lookAt and reach find Mixamo-style bones by name.
• In Build, the Humanoid node is a whole character; put a Socket node under it (its bone, then the held thing under the Socket). The Inspector's outfit picker dresses NPCs; a player's Humanoid only needs player set from code when they join.
• Phones. Thirty walking figures add under a millisecond to a step on a laptop. footIK: false saves two short ray casts per figure per step, for crowds of NPCs.