[feat] 33 P2: animated, functional pack items (doors that open, no autoplay)

[AlexZ005]

Roadmap 33, lane 33-anim-core: contract P2, animated, functional pack items. This is the core half of K4 ("if its a door it should be functional ... not randomly plays animation or in loop").

What it does

• Nothing autoplays. Placing an animated GLB used to start its first clip and loop it forever. Now the clip is selected, not playing, until someone presses play. Animated imports also land at the drop point, which this path used to ignore.
• behavior on a pack item (door | toggle | oneshot | loop, triggers click | proximity | knock). A peer in Edit always sees the rest pose. A trigger works in Interact/Play: the desktop click, the Play tap, and the VR laser/poke, which all go through moduleSDK's one click dispatch. Proximity is 1.5 m. A knock is a VR hand at >= 0.6 m/s.
• State replicates as one new behavior message {uuid, on, at, from, n}, latest-wins on sessionNow(). It has a wireValidate shape and is ROOM_SCOPED. Every peer derives the pose from the stamp. A late joiner gets behaviorState on its objectfile. The state is runtime only: never saved, never undone.
• The leaf collider follows. The frame becomes custom slab colliders with the doorway cut out, through the wall's depth. Each moving node gets a kinematic box that follows it. An open door lets the walker through and a shut one stops it, while a sim runs.
• A sound per trigger: new game sounds door gate slide lever lid.
• The Explorer shows a ▶ "animated" badge on cards and list rows.
• The Animation panel previews a clip in Edit locally: nothing is sent, nothing is saved, and the item goes back to rest.
• api.behavior {list, state, trigger} for modules.
• Animated imports also carry userData.lod on objectfile, the save and undo, for 33-lod-editor.
• A sim start's "simulate the selection" fallback never picks a functional item.

Contract notes for the pack lanes are at the top of the handover. anim-kit's 19 interactive-kit items were checked against the runtime offline.

Proof

• pack-behavior (new, 51 checks, two peers + a late joiner), driving the real Explorer path with a routed pack and a gltf-transform test door (tests/e2e/fixtures/test-door.glb):
  • placed and still;
  • Edit stands down;
  • a REAL click in Interact opens it, with sound;
  • B sees it open in Interact and shut in Edit;
  • the capsule passes an open door and is stopped by a shut one;
  • counterfactual: with the doorway not cut, an open door is a wall;
  • the save holds the spec and no state;
  • the late joiner gets the same stamp;
  • the preview sends nothing;
  • wire validation, api.behavior, and a slow vs fast knock.
• vitest behaviorCore (18).
• Touched suites green: animated-models 15/0 and animation-persist 23/0 (both now press play first, because there is no autoplay), game-audio 26/0 (25 sounds), packs-explorer 10/0.
• svelte-check 333/47 (= base, measured on c7018be), vitest 396/396, check-storage clean, npm run build green.

Owed on device

A door in a Quest (laser click, poke, knock speed), the sounds' character, the badge in non-dark themes, and walking up to a proximity sliding door for real.

Forks taken (QUESTIONS-33-anim-core.md)

• Door state lasts the session: Edit shows the rest pose and Interact shows the shared state again.
• Old saves with playing: true keep playing.
• Proximity opens on entering and closes on leaving.
• A desktop click counts as the knock.

🤖 Generated with Claude Code