Files
tidewall/assets/PROVENANCE.md
T
claudeandClaude Opus 5.5 923876ed1f A5: World art for points of interest, build pieces, vessels and terrain
- PoiMesher dresses every point of interest from its parts: lapped tarred
  weatherboards, plank boards, stone in a running bond with lichen, tiled
  roofs with a ridge cap, salt-white trim on paint, crusted salt pans, and a
  tarred frame round the lighthouse's glowing glass. One mesh per POI.
- Huts get a shuttered window in each side wall (non-solid parts, no rng).
- Build pieces show their state: building in quarter steps, worn (a third of
  health gone) and battered (two thirds gone, strips knocked out).
  StructureView rebuilds a piece's mesh only when its state changes.
- VesselModels builds the barge (lofted hull, curved rails, mooring lines,
  gored envelope) and the sea chests in code; the primitive stand-ins are gone.
- Terrain: tussocks, wind-dried patches, shingle on sand, lichen on rock.
- test_world_art (9) fails on any primitive stand-in mesh or placeholder
  resource under src/ or assets/, and covers POI bounds and determinism,
  windows, the lamp surface, wear and build stages, view rebuilds and the
  vessel models.
- make poi-captures and make build-captures (state card, vessels).

Closes #45

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-13 20:39:24 -05:00

3.1 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: that covers the points of interest (src/client/poi/poi_mesher.gd), build pieces (src/client/building/piece_mesher.gd), the barge and sea chests (src/client/entities/vessel_models.gd), props (src/client/props/prop_view.gd) and the terrain and sea shaders. test/client/test_world_art.gd fails on any primitive stand-in mesh or placeholder resource under src/ or assets/.

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.