Axel Meyer fa511204c2 feat(vagrant): v0.3.0 — substrate-port rig + animations + locomotion
- humanoid.rig.json rewrite: legs->root, rest.rot+rest.scl on all bones,
  Y-mirror via scl=-1 on leg_l/r/foot_l/r, locomotion-block with
  procedural footplant config
- walk.anim.json: substrate walk_fwd_lower port; track=lower; pos+scl
  channels on legs+feet
- walk_upper.anim.json (NEW): substrate walk_upper port; arm-swing
- idle.anim.json: substrate idle_upper port; pos+rot on shoulders+arms
- init.lua: walk_upper parallel-play wiring
- manifest bump v0.2->v0.3; puppet dep ^0.3.0
2026-05-18 18:55:34 +02:00

sporel-module-vagrant-skeleton

F.vagrant Tier-1 test-chamber: single player as puppet, WASD direct movement, camera-chase, headtrack to mouse-cursor. Phase 1 stage.

Version: 0.2.0 Module-ID: vagrant-skeleton Requires: lib-core.input >=0.4.0, lib-core.camera >=0.3.0, lib-core.render >=0.1.0, lib-core.maps >=0.1.2, lib-core.puppet >=0.2.0, lib-asset.prototype-subterrain >=0.1.0 Tags: test-chamber, puppet, walking-sim

Topology

Controls

  • W A S D — direct movement (4-way, normalized for diagonals)
  • Mouse — head/torso look-at target
  • ESC — return to launcher

Demonstrates

  • lib-core.puppet integration (skeleton, keyframe animation, procedural-ready, look-at constraint)
  • idle <-> walk animation-state transition driven by movement input
  • Camera-chase via lib-core.camera target-provider
  • Throwaway-content test-chamber stance: existing maps v0.1 format, hand-painted humanoid rig + 2 keyframe animations.

Interactions

  • WASD active -> walk animation on lower track
  • WASD released -> idle animation on upper track (subtle torso sway)
  • Mouse moved -> head-bone angle updates each frame to face cursor's world-position (look-at constraint on bones marked look_at: true)

CI Hooks

  • SPOREL_CI=1 -> 60-frame perf canary. Emits vagrant: frame_avg_ms=N and vagrant: render_frame_ok (per-frame, from render hook), then exits. Used by smoke stages P0-S25a + P0-S25b.

References

  • ADR-0028 (Launcher-Flow)
  • ADR-0036 (Lib-Override for multi-module reuse)
  • ADR-0037 (Tests-as-Libs)
  • ADR-0038 (API-Doc-Convention)

CHANGELOG

v0.2.0

  • Sprite-mode rendering throughout: 13-bone humanoid puppet via lib-core.puppet v0.2 with PROTOTYPE asset-pack textures; sprite-tilemap via lib-core.maps v0.1.2 with 4 floor variants (floor_001-003 walkable, floor_004 as wall); hardcoded furniture (bed, bench, backpack) via engine.render.draw_sprite_transform.
  • Asset-pack indirection: manifest.module asset_aliases maps the alias- keys (player, tiles, world) to lib-asset.prototype-subterrain. Rig and tilemap atlas-ids resolved at init via puppet.load_textures and maps.load_textures.
  • Tile rotations: vagrant_test.map.json includes a tile_rotations parallel array exercising 90 and 180-degree rotations for visual verification of the rotation pipeline.
  • Animation refinements: walk on lower track now includes foot bones (legs + feet alternate); idle on upper track with subtle body+head sway.
  • New smoke traces emitted under SPOREL_CI=1: vagrant: render_frame_ok (per frame from render hook), vagrant: sprite_mode=on (once after first sprite draw), vagrant: assets_loaded=14 (once after init).
Description
F.vagrant Tier-1 test-chamber: single player + puppet + tilemap
Readme 666 KiB
Languages
Lua 100%