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>
This commit is contained in:
2026-11-14 03:12:47 -05:00
co-authored by Claude Opus 5.5
parent 9b5064d7a8
commit f3161bf46c
47 changed files with 1078 additions and 4 deletions
+18
View File
@@ -0,0 +1,18 @@
Package: tidewall
Version: @VERSION@
Architecture: amd64
Maintainer: Tidewall developers <claude@eom.dev>
Installed-Size: @SIZE@
Depends: libc6 (>= 2.28)
Recommends: libvulkan1 | libgl1, libx11-6, libxcursor1, libxinerama1, libxrandr2, libxi6, libxext6, libasound2t64 | libpulse0, libfontconfig1, libdbus-1-3
Section: games
Priority: optional
Homepage: https://gitea.eom.dev/claude/tidewall
Description: build-and-survive battle royale on a drowning island
Tidewall is a free and open-source third-person battle royale. The sea
rises in phases and swallows the low ground, so the last dry land keeps
getting higher and smaller. Gather salvage, build breakwaters and ramps,
and be the last one standing.
.
This package has the game, offline practice against bots, LAN and
internet play, and a headless dedicated server (tidewall-server).
+57
View File
@@ -0,0 +1,57 @@
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: Tidewall
Upstream-Contact: https://gitea.eom.dev/claude/tidewall/issues
Source: https://gitea.eom.dev/claude/tidewall
Files: *
Copyright: 2026 Tidewall contributors
License: GPL-3+ and CC-BY-SA-4.0
Comment: The code is GPL-3.0-or-later. The game's models, textures, icons and
sounds, all generated by scripts in the source repository (see
/usr/share/doc/tidewall/PROVENANCE.md.gz), are CC BY-SA 4.0. They are packed
together in /usr/lib/tidewall/tidewall.pck.
Files: usr/lib/tidewall/tidewall.x86_64
Copyright: 2014-present Godot Engine contributors
2007-2014 Juan Linietsky, Ariel Manzur
License: Expat
Comment: The official Godot Engine 4.7.2 release export template, unmodified.
The notices and licences of the third-party code built into it are in
/usr/share/doc/tidewall/ENGINE-LICENSES.gz.
License: GPL-3+
This program is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your option)
any later version.
.
This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
details.
.
On Debian systems, the complete text of the GNU General Public License
version 3 can be found in /usr/share/common-licenses/GPL-3.
License: Expat
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to
deal in the Software without restriction, including without limitation the
rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
sell copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
.
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
IN THE SOFTWARE.
License: CC-BY-SA-4.0
Creative Commons Attribution-ShareAlike 4.0 International. The licence's
full text is at https://creativecommons.org/licenses/by-sa/4.0/legalcode
+43
View File
@@ -0,0 +1,43 @@
.TH TIDEWALL\-SERVER 6 "2026-11-14" "Tidewall" "Games"
.SH NAME
tidewall\-server \- headless dedicated server for Tidewall
.SH SYNOPSIS
.B tidewall\-server
.RB [ \-\-config=\fIfile\fP ]
.RI [ options ]
.SH DESCRIPTION
.B tidewall\-server
runs the game without a window, as a server people join over UDP. SIGTERM or
Ctrl+C stops it cleanly: everyone connected is told it is shutting down. Logs
are JSON lines on standard output. Exit status: 0 clean, 1 script error,
2 bad command line.
.SH OPTIONS
.TP
.BI \-\-config= file
Read options from a file, one per line without the leading dashes; see
/usr/share/doc/tidewall/examples/server.cfg.
.TP
.B \-\-listen
Take players over the network.
.TP
.BI \-\-port= n
UDP port (default 24650). LAN discovery answers on the port plus one.
.TP
.BI \-\-bots= n
Fill each match's empty places with bots.
.TP
.BI \-\-name= name
The name shown in server lists.
.TP
.BI \-\-list= host[:port]
Register with a list server.
.TP
.BI \-\-health\-port= n
Answer GET /health over HTTP on this TCP port, on loopback.
.SH ENVIRONMENT
.TP
.B TIDEWALL_STATE
A writable directory for the engine's files and the stop file (default
~/.local/state/tidewall\-server).
.SH SEE ALSO
.BR tidewall (6)
+40
View File
@@ -0,0 +1,40 @@
.TH TIDEWALL 6 "2026-11-14" "Tidewall" "Games"
.SH NAME
tidewall \- build-and-survive battle royale on a drowning island
.SH SYNOPSIS
.B tidewall
.RB [ \-\-rendering\-driver
.IR driver ]
.RB [ \-\-
.IR "game options" ]
.SH DESCRIPTION
.B tidewall
starts the game on its main menu: practice offline against bots, find a
server on the local network, or join one by address. The sea rises in phases
and swallows the low ground; gather salvage, build, and be the last one
standing.
.PP
Options before
.B \-\-
go to the Godot engine; options after it go to the game.
.SH OPTIONS
.TP
.BI \-\-rendering\-driver " opengl3"
Use OpenGL instead of Vulkan, for hardware without a Vulkan driver.
.TP
.BI \-\-connect= host[:port]
Join a server directly (the port defaults to 24650).
.TP
.BI \-\-name= name
The name to play under.
.TP
.B \-\-offline
Start a practice match against bots at once.
.SH FILES
.TP
.I ~/.local/share/godot/app_userdata/Tidewall/
Settings and key bindings.
.SH SEE ALSO
.BR tidewall\-server (6)
.PP
/usr/share/doc/tidewall/README.md
+3
View File
@@ -0,0 +1,3 @@
#!/bin/sh
# Tidewall, installed from the Debian package. Options go to the game.
exec /usr/lib/tidewall/tidewall.x86_64 "$@"
+5
View File
@@ -0,0 +1,5 @@
#!/bin/sh
# A Tidewall dedicated server, installed from the Debian package. See
# /usr/share/doc/tidewall/examples/server.cfg and `man`-free help in
# /usr/share/doc/tidewall/README.md. Options go to the server.
exec /usr/lib/tidewall/tidewall-server "$@"
+11
View File
@@ -0,0 +1,11 @@
[Desktop Entry]
Type=Application
Name=Tidewall
GenericName=Battle royale
Comment=Build and survive on an island the sea is swallowing
Exec=tidewall
Icon=tidewall
Terminal=false
Categories=Game;ActionGame;
Keywords=battle royale;build;survive;sea;island;
PrefersNonDefaultGPU=true
+17 -2
View File
@@ -5,7 +5,16 @@ swallows the low ground, so the last dry land keeps getting higher and smaller.
## Play
./tidewall.x86_64
./tidewall
`tidewall` starts the game from this folder whatever directory you are in, and works
through a symlink too (for example `ln -s "$PWD/tidewall" ~/.local/bin/tidewall`).
To add Tidewall to your desktop's application menu, for you alone:
./install-desktop-entry.sh
Run it again if you move the folder, and `./install-desktop-entry.sh --remove` to take
the entry away. On Debian or Ubuntu, the `.deb` package does all of this system-wide.
The game opens on its main menu: practice against bots offline, or join a server on
your network or by address. It needs a Vulkan-capable GPU and driver (Forward+). On
@@ -26,16 +35,22 @@ the server cleanly. Logs are JSON lines on standard output.
| File | |
|---|---|
| `tidewall` | Starts the game |
| `install-desktop-entry.sh` | Adds the game to your application menu |
| `tidewall.x86_64` | The Godot 4.7.2 engine (official release template) |
| `tidewall.pck` | The game |
| `tidewall-server` | Runs the same game headless as a dedicated server |
| `server.cfg` | Example server configuration |
| `VERSION` | Version, commit and engine |
| `tidewall.png` | The application icon |
| `PROVENANCE.md` | How every model, texture and sound was made |
| `ENGINE-LICENSES.txt` | The Godot engine's licence and the notices of the code built into it |
## Licence
Code: GPL-3.0-or-later (`LICENSE`). Art and audio, all generated by scripts in the
source repository: CC BY-SA 4.0 (`LICENSE-ASSETS`). The Godot engine is MIT-licensed.
source repository: CC BY-SA 4.0 (`LICENSE-ASSETS`). The Godot engine is MIT-licensed;
its licence and the notices of the third-party code built into it are in
`ENGINE-LICENSES.txt`.
Source: https://gitea.eom.dev/claude/tidewall
+48
View File
@@ -0,0 +1,48 @@
#!/usr/bin/env sh
# Adds Tidewall from this folder to your desktop's application menu, for you alone:
# a desktop entry in ~/.local/share/applications and the icon in
# ~/.local/share/icons. Nothing outside your home is touched.
#
# ./install-desktop-entry.sh add it (again, if the folder moved)
# ./install-desktop-entry.sh --remove take it away
set -eu
here="$(dirname "$(readlink -f "$0")")"
data="${XDG_DATA_HOME:-$HOME/.local/share}"
entry="$data/applications/tidewall.desktop"
icon="$data/icons/hicolor/256x256/apps/tidewall.png"
if [ "${1:-}" = "--remove" ]; then
rm -f "$entry" "$icon"
echo "Removed the Tidewall menu entry."
exit 0
fi
if [ "$#" -gt 0 ]; then
echo "usage: $0 [--remove]" >&2
exit 2
fi
case "$here" in
*'"'* | *'\'* | *'`'* | *'$'* | *'%'*)
echo "This folder's path has a character a desktop entry can't hold; move it and try again." >&2
exit 1
;;
esac
mkdir -p "$(dirname "$entry")" "$(dirname "$icon")"
cp "$here/tidewall.png" "$icon"
cat >"$entry" <<ENTRY
[Desktop Entry]
Type=Application
Name=Tidewall
GenericName=Battle royale
Comment=Build and survive on an island the sea is swallowing
Exec="$here/tidewall"
Path=$here
Icon=tidewall
Terminal=false
Categories=Game;ActionGame;
Keywords=battle royale;build;survive;sea;island;
PrefersNonDefaultGPU=true
ENTRY
chmod 0644 "$entry"
echo "Added Tidewall to your application menu ($entry)."
Vendored Executable
+5
View File
@@ -0,0 +1,5 @@
#!/usr/bin/env sh
# Starts Tidewall from wherever this folder is, whatever the current directory, and
# through a symlink too. Options are passed to the game (e.g. --rendering-driver opengl3).
here="$(dirname "$(readlink -f "$0")")"
exec "$here/tidewall.x86_64" "$@"