Files
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

51 lines
3.7 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:
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.