The islander is built in headless Blender (tools/models/figure.py, `make figure`, `make art`) as twelve rigid parts with their origins at their joints: an oilskin coat, a sou'wester, sea boots, a bedding roll and the canvas wing-sail. Debian's Blender can't write glTF, so the figure is jointed rather than skinned. FigureRig hangs the parts on pivots, paints them from Palette with the coat in the player's own oilskin, and plays FigurePoses' hand-written key poses through one AnimationTree: idle, walk and run by speed, crouch and creep, air, skydive, glide, swim and aboard; long, short and carried holds; reload and use layers; fire, boathook swing, keg throw and building as one-shots; and a flinch when health drops. The chest takes a third of the pitch and the held item all of it. Figures animate from replicated state only: positions, look, health, the held item and the FLAG_ bits (reloading and using now reach mirrored players), with actions from FX. Every boathook swing is now a sim "swing" event, sent as a SHOT with no item, so misses are seen and heard; the new FX kind PLACE shows pieces placed. Protocol version 4. Tests: test_figure_rig (15), plus swing and PLACE cases in test_harvest and test_net_fx. make check passes (604 tests); make client-check passes. Captures: figure_states, figure_actions, figure_close (make figure-captures), client_glide and client_landed. Closes #42 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
36 lines
2.8 KiB
Markdown
36 lines
2.8 KiB
Markdown
# Asset provenance
|
|
|
|
Every file under `assets/` is made by a script in this repository. Nothing here is
|
|
sampled, recorded, downloaded or taken from a third party. Colours, shaders and
|
|
meshes built in code are recorded by being in the repository and aren't listed here.
|
|
|
|
## Audio (`assets/audio/`, A8)
|
|
|
|
| Files | Generator | How |
|
|
|---|---|---|
|
|
| `step_*`, `land`, `swing_*`, `shot_*`, `keg_blast`, `reload`, `hit_*`, `chop`, `build_*`, `break_*`, `splash`, `swim`, `surge`, `bell`, `foghorn`, `lighthouse`, `hurt`, `pickup`, `chest_open`, `eliminated`, `amb_*`, `ui_*` | `tools/audio/recipes.gd` | Synthesized from seeded noise, wavetable oscillators, filters and decaying modes (`tools/audio/dsp.gd`). |
|
|
| `music_drone`, `music_drum`, `music_concertina`, `music_fiddle` | `tools/audio/score.gd` | An original eight-bar tune and chord sequence in D Dorian, written for Tidewall as the note lists in the script, rendered with the same synthesis. It follows no existing song. |
|
|
| `manifest.json` | `tools/audio/generate.gd` | Each file's category, length, SHA-256, peak and loudness. |
|
|
|
|
Regenerate everything with:
|
|
|
|
tools/godot.sh --script res://tools/audio/generate.gd
|
|
|
|
and check it with `tools/godot.sh --script res://tools/audio/check.gd` (part of
|
|
`make check` through `test/audio/test_audio_assets.gd`, which also regenerates every
|
|
file and compares hashes). Files are mono 16-bit PCM at 22,050 Hz. Licence: see
|
|
`LICENSE-ASSETS`.
|
|
|
|
## Item models and icons (`assets/models/items/`, `assets/icons/items/`, A4)
|
|
|
|
| Files | Generator | How |
|
|
|---|---|---|
|
|
| `models/items/<id>.obj`, `.mtl`, `.json` | `tools/models/items.py` | Built from primitives (boxes, cylinders, cones, spheres, tori) in headless Blender (`blender --background --factory-startup --python tools/models/items.py`). Materials are named after `Palette` colours, and the client paints them from `src/client/style/palette.gd`. The JSON holds the grip, the left hand's support point and the bounds. |
|
|
| `icons/items/<id>.png` | `tools/models/items.py` | The same model rendered at 128 px with Cycles on the CPU, colours read from `palette.gd`. |
|
|
| `models/figure/<part>.obj`, `.mtl`, `figure.json` | `tools/models/figure.py` | The player figure, built from primitives in headless Blender (`make art`), one rigid part per limb with its origin at its joint. Materials are `Palette` names, plus `COAT` and `COAT_DARK` for the player's own oilskin. The animations aren't files: `src/client/entities/figure_poses.gd` holds them as key poses written by hand. |
|
|
|
|
OBJ, not glTF: the Debian Blender's glTF exporter needs numpy, which the build
|
|
machine doesn't have. Blender isn't part of `make check`, so these files are checked
|
|
by `test/client/test_item_models.gd` (every item has a model, icon and grip, painted
|
|
from the Palette) rather than regenerated byte for byte.
|