- docs/PLAY.md is now the player guide: install from the tarball or .deb, starting a match, controls, how a match goes, settings files and troubleshooting, ahead of the graphics and tested-configuration sections. - docs/SERVER.md: quick start, every option, ports, being found, logs, Docker and systemd, memory, and what was checked. - CONTRIBUTING.md (engine setup, rules, commits, licence of contributions) and CREDITS.md. - README: status and known limitations as they are. - GDD controls table matched to the real defaults (B, Tab, G, 1 to 6). Running the documented commands from an unpacked release found two bugs, fixed here: - `tidewall --connect=HOST` ignored the option unless it came after `--`. ClientConfig.game_args() now takes the game's own options from the engine's arguments when there is no `--`; tested. - A headless run with no mode printed a line and never exited; it quits now. The renderer option is given as the pair the capture tests use (`--rendering-method gl_compatibility --rendering-driver opengl3`) in the docs, the tarball README and the man page. The Join menu only searching the LAN is documented and filed as #82. Closes #62 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Tidewall (working name)
A free and open-source third-person battle royale for Linux, made with Godot.
Up to 24 players or bots drop onto a procedurally generated island. Scavenge, fight and build. The sea rises in phases and swallows the low ground, so the last safe land keeps getting higher and smaller, and what you build can keep you above water.
- Play: docs/PLAY.md: install, controls, how a match goes, graphics and troubleshooting.
- Host: docs/SERVER.md: dedicated servers, options, ports, Docker and systemd.
- Contribute: CONTRIBUTING.md. Credits: CREDITS.md.
Status
Pre-release (0.9.0), heading for v1.0.0. Not yet played by a person on real hardware; that playtest comes before the release.
What works and is tested automatically:
- Whole matches, lobby to results, offline against bots or on a dedicated server, with up to 24 players and bots.
- The rising tide on every generated island, with flooding that follows the terrain, breakwaters that hold water back, storm surges and sudden death.
- Building walls, floors, ramps, roofs and breakwaters in driftwood, stone and salvage iron, with collapse; harvesting with the boathook; seven weapons, including a harpoon gun and a line thrower, in four tiers; healing and armor; sea chests and crates.
- Bots at three difficulties. Balance was tuned over 200 bot matches (median match 13 minutes; see docs/BALANCE.md).
- Multiplayer with client prediction, tested with 24 network clients over two matches under simulated latency, jitter and loss; LAN discovery; list servers; joining by address.
- Menus, HUD, chart, settings with rebindable keys, generated art and synthesized sound and music.
- A release tarball and a Debian package, both checked outside the source tree, and a container image for servers. A 50-match run of one server showed no crash and flat memory.
All of this is checked headless or with software rendering in a container. No frame rate on a real GPU, and nothing about how the game feels, has been measured yet.
Known limitations
- Untested on real hardware. No real GPU, Wayland session or hybrid-graphics machine has run it yet (docs/PLAY.md).
- Solo only. Duos and reviving (#30) aren't in this release.
- The powder keg can be carried but not thrown yet (#22), and there are no particle effects such as muzzle flashes, tracers or splashes (#47).
- Bots don't build (#29), and most of them fall early in a match (#74).
- No gamepad support or tutorial (#53, #52). No character customization (#43) or editing of placed pieces (#18).
- The Join menu only searches the LAN. List servers work from the command line (
--browse --list=...); in the menu, join other servers by address. - Under OpenGL with shadows on, ground and rocks look paler than under Vulkan (#81).
- One network soak saw a single transient world-hash mismatch that hasn't been reproduced since (#80).
- The name is a working name until it has been cleared.
The milestones and issues track the rest.
Originality
Tidewall works in the build-and-survive battle royale genre, but it is its own game. Its name, characters, art, audio, world and UI are all original. It contains no assets, names or designs from any commercial game.
Licence
Code: GPL-3.0-or-later (LICENSE). Original art and audio: CC BY-SA 4.0 (LICENSE-ASSETS). The Godot engine is MIT-licensed; see CREDITS.md.