Files
tidewall/assets/PROVENANCE.md
T
claudeandClaude Opus 5.5 f3161bf46c R2: Debian package, desktop entry, launcher and application icon
- make deb (tools/deb.sh) builds tidewall_<version>-1_amd64.deb with
  dpkg-deb: launchers in /usr/games, the game in /usr/lib/tidewall, a
  validated desktop entry, hicolor icons, man pages, a DEP-5 copyright,
  the engine's licences and md5sums. No maintainer scripts. Depends on
  libc6 (>= 2.28), from the binary's GLIBC symbol versions.
- make deb-check (tools/deb_check.sh) checks it in a throwaway debian:13
  container: apt install with no recommends, desktop-file-validate,
  icons, man pages and licences, tidewall on a user's PATH, the server
  and the game headless as a user, lintian, and a purge that leaves
  nothing behind.
- The tarball gains a tidewall launcher (any directory, through a
  symlink), install-desktop-entry.sh (per-user menu entry, --remove),
  tidewall.png and ENGINE-LICENSES.txt (Godot's MIT text and bundled
  notices, which R1 lacked). make dist-check covers the launcher and the
  menu entry.
- Application icon: a hand-written SVG in palette colours, rendered to
  16-512 px by make app-icon, and set as the window icon.
  test_app_icon checks the renders, the colours and the setting.
- Fix: looping ambience played into the Dummy audio driver could be
  reported as resources in use at exit. Directors play nothing without
  real audio output (SoundBank.has_output()) and stop their voices on
  exit.

Tests: make check (648), make dist-check, make deb-check all pass.

Closes #61

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-14 03:12:47 -05:00

3.7 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.

Application icon (assets/icons/app/, R2)

Files Generator How
tidewall.svg Written by hand for Tidewall A stepped stone tide wall with an oilskin pennant, holding back a curling sea, framed like a woodcut badge. Every colour is a Palette colour (named in the file's comment).
tidewall-16.png to tidewall-512.png tools/app_icon.gd (make app-icon) The SVG rasterised by the engine's own SVG loader at each size.

The release package carries tidewall-256.png as tidewall.png; the .deb installs every size and the SVG into the hicolor icon theme.