Files
tidewall/assets/PROVENANCE.md
T
claudeandClaude Opus 5.5 0991f27700 A4: Item models and icons
tools/models/items.py builds every item in headless Blender from
primitives: the boathook, the eight weapons and powder keg, four
consumables and five kinds of ammo, each with its own outline. It
writes an OBJ per item (the Debian Blender's glTF exporter needs numpy),
a JSON with the grip and the left hand's support point, and a 128 px
Cycles icon rendered on the CPU. Materials are named after Palette
colours, and TRIM2_/TRIM3_ surfaces are the tier treatment: rope
whipping from tier 2, brass bands from tier 3; tier 0 is faded.

ItemModels paints the models from Palette by tier. EntityView puts the
held item's grip in each figure's right hand, turned with the player's
pitch and put away aboard, falling, gliding or swimming, and draws
items lying in the world with their models, one MultiMesh per model
and tier. The hotbar shows each slot's icon.

make models rebuilds them; make item-captures renders the items held,
over the shoulder, on the ground and by tier.

Closes #44

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-13 14:46:41 -05:00

2.4 KiB

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.

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.