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