Generate an original rigged low-poly character with scripted headless Blender (tools/art/), with locomotion, swim, glide, build and combat animations driven by an animation tree.
Acceptance
make art regenerates the assets from source scripts.
All listed animations are implemented, and captures are reviewed for each state.
Clients animate from replicated state only.
**Depends on:** A1, W1
Generate an original rigged low-poly character with scripted headless Blender (`tools/art/`), with locomotion, swim, glide, build and combat animations driven by an animation tree.
**Acceptance**
- `make art` regenerates the assets from source scripts.
- All listed animations are implemented, and captures are reviewed for each state.
- Clients animate from replicated state only.
claude
added this to the v0.6 Art, Audio and UI milestone 2026-11-09 05:28:28 +00:00
tools/models/figure.py builds the islander in headless Blender: oilskin coat, sou'wester, sea boots, bedding roll and the canvas wing-sail, as 12 rigid parts with their origins at their joints, plus figure.json. It lives beside tools/models/items.py rather than in tools/art/, so the two share the same builders. make figure rebuilds the figure, and make art rebuilds the figure and every item.
Not skinned: Debian's Blender can't export glTF (numpy is missing), so the figure is jointed. That fits the carved folk-art style.
FigureRig hangs the parts on pivots and paints them from Palette in each player's own oilskin. One AnimationTree plays the animations, which FigurePoses holds as key poses:
movement: idle, walk and run blended by speed; crouch and creep; air, skydive, glide, swim and aboard
holds: long, short and carried
layers: reload and use
one-shots: fire (long and short), boathook swing, keg throw and building
a flinch when health drops
Clients animate from replicated state only. That means snapshot fields and FLAG_ bits (reloading and using now reach mirrored players), plus FX:
Every boathook swing is now a swing sim event, sent as a SHOT with no item. Missed swings are now also heard.
New FX kind PLACE covers pieces placed.
Protocol version is now 4.
Testing
test_figure_rig: 15 tests.
New swing and PLACE cases in test_harvest and test_net_fx.
make check passes (604 tests). make client-check passes over UDP.
Captures, all opened and reviewed: figure_states, figure_actions and figure_close (make figure-captures), plus client_glide and client_landed from a real network client.
Follow-ups and limits
No foot planting or IK, so feet can slide slightly at odd speeds, and the left hand only roughly meets a long gun's fore-end.
Motion has not been seen in real time on real hardware; that's left for R6.
The sail and barge models depend on the launch-fiction decision in #72.
Done in 0773833.
**What changed**
- `tools/models/figure.py` builds the islander in headless Blender: oilskin coat, sou'wester, sea boots, bedding roll and the canvas wing-sail, as 12 rigid parts with their origins at their joints, plus `figure.json`. It lives beside `tools/models/items.py` rather than in `tools/art/`, so the two share the same builders. `make figure` rebuilds the figure, and `make art` rebuilds the figure and every item.
- **Not skinned:** Debian's Blender can't export glTF (numpy is missing), so the figure is jointed. That fits the carved folk-art style.
- `FigureRig` hangs the parts on pivots and paints them from Palette in each player's own oilskin. One AnimationTree plays the animations, which `FigurePoses` holds as key poses:
- movement: idle, walk and run blended by speed; crouch and creep; air, skydive, glide, swim and aboard
- holds: long, short and carried
- layers: reload and use
- one-shots: fire (long and short), boathook swing, keg throw and building
- a flinch when health drops
- **Clients animate from replicated state only.** That means snapshot fields and FLAG_ bits (reloading and using now reach mirrored players), plus FX:
- Every boathook swing is now a `swing` sim event, sent as a SHOT with no item. Missed swings are now also heard.
- New FX kind `PLACE` covers pieces placed.
- Protocol version is now 4.
**Testing**
- `test_figure_rig`: 15 tests.
- New swing and PLACE cases in `test_harvest` and `test_net_fx`.
- `make check` passes (604 tests). `make client-check` passes over UDP.
- Captures, all opened and reviewed: `figure_states`, `figure_actions` and `figure_close` (`make figure-captures`), plus `client_glide` and `client_landed` from a real network client.
**Follow-ups and limits**
- No foot planting or IK, so feet can slide slightly at odd speeds, and the left hand only roughly meets a long gun's fore-end.
- Motion has not been seen in real time on real hardware; that's left for R6.
- The sail and barge models depend on the launch-fiction decision in #72.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Depends on: A1, W1
Generate an original rigged low-poly character with scripted headless Blender (
tools/art/), with locomotion, swim, glide, build and combat animations driven by an animation tree.Acceptance
make artregenerates the assets from source scripts.Done in
0773833.What changed
tools/models/figure.pybuilds the islander in headless Blender: oilskin coat, sou'wester, sea boots, bedding roll and the canvas wing-sail, as 12 rigid parts with their origins at their joints, plusfigure.json. It lives besidetools/models/items.pyrather than intools/art/, so the two share the same builders.make figurerebuilds the figure, andmake artrebuilds the figure and every item.FigureRighangs the parts on pivots and paints them from Palette in each player's own oilskin. One AnimationTree plays the animations, whichFigurePosesholds as key poses:swingsim event, sent as a SHOT with no item. Missed swings are now also heard.PLACEcovers pieces placed.Testing
test_figure_rig: 15 tests.test_harvestandtest_net_fx.make checkpasses (604 tests).make client-checkpasses over UDP.figure_states,figure_actionsandfigure_close(make figure-captures), plusclient_glideandclient_landedfrom a real network client.Follow-ups and limits