Files
claudeandClaude Opus 5.5 8142e39ab3 A13: Gamepad and accessibility
Gamepad: PadInput reads pad events in one fixed layout (sticks move and
look, triggers aim and fire, bumpers step slots and build pieces, Start
pauses), fed through ClientInput alongside the keys and mouse. Menus take
South to choose and East or Start to go back. The tutorial names pad
buttons once the pad is used.

Aim assist (option, on by default, pad only): friction across an
opponent in plain sight near the look, and a pull of at most 9 deg/s
while aiming. Client look only; never through cover.

Accessibility (new Access tab): colour-vision sets for the signal colours
(red-green, blue-yellow), checked by simulated colour vision in
test_palette; interface size 90-130%, with the HUD hotbar refitting at the
larger sizes; captions for key sounds with direction; reduce motion
(calmer aim zoom and hurt flash).

Tests for the pad, aim assist, captions, palettes, settings, the menus
driven from a pad, and a pad playing through a real offline session.
make access-captures renders the new screens and options.

Closes #53

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-15 08:53:30 -05:00

48 lines
4.8 KiB
Markdown

# Tidewall (working name)
A free and open-source third-person battle royale for Linux, made with [Godot](https://godotengine.org).
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](docs/PLAY.md): install, controls, how a match goes, graphics and troubleshooting.
- **Host:** [docs/SERVER.md](docs/SERVER.md): dedicated servers, options, ports, Docker and systemd.
- **Contribute:** [CONTRIBUTING.md](CONTRIBUTING.md). Credits: [CREDITS.md](CREDITS.md).
## Status
**v1.0.0.** The release gates (all tests, a whole offline match and a 24-client network soak) pass automatically, but the game has not yet been played by a person on real hardware. That playtest ([#65](https://gitea.eom.dev/claude/tidewall/issues/65)) is next, and fixes from it will come as point releases.
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, and thrown powder kegs that blast through walls and breakwaters, 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](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](docs/PLAY.md#tested-configurations)).
- **The 1.0.0 packages are solo only.** Duos with downs and revives ([#30](https://gitea.eom.dev/claude/tidewall/issues/30)) are on `main` since 1.0.0 was tagged: `--team-size=2` on a server, `--duos` or the Practice menu's Crew offline. Bots play as teammates and revive, but don't otherwise stick together.
- Bots carry powder kegs but don't throw them ([#83](https://gitea.eom.dev/claude/tidewall/issues/83)).
- Most bots fall early in a match ([#74](https://gitea.eom.dev/claude/tidewall/issues/74)). Bots build on `main` since 1.0.0 was tagged ([#29](https://gitea.eom.dev/claude/tidewall/issues/29)), but only cover walls, ramps and a last-stand ring of breakwaters, not forts. The 1.0.0 packages have bots that don't build.
- **The 1.0.0 packages have no gamepad support, accessibility options or tutorial.** All three are on `main` since 1.0.0 was tagged ([#53](https://gitea.eom.dev/claude/tidewall/issues/53), [#52](https://gitea.eom.dev/claude/tidewall/issues/52)); the gamepad has only been tested with simulated input. No character customization ([#43](https://gitea.eom.dev/claude/tidewall/issues/43)) or editing of placed pieces ([#18](https://gitea.eom.dev/claude/tidewall/issues/18)).
- **The Join menu only searches the LAN** ([#82](https://gitea.eom.dev/claude/tidewall/issues/82)). List servers work from the command line (`--browse --list=...`); in the menu, join other servers by address.
- Under OpenGL (the fallback when Vulkan can't start) the sun casts no shadows, because that renderer drew them with washed-out colours ([#81](https://gitea.eom.dev/claude/tidewall/issues/81)).
- One network soak saw a single transient world-hash mismatch that hasn't been reproduced since ([#80](https://gitea.eom.dev/claude/tidewall/issues/80)).
- The name is a working name until it has been cleared.
The [milestones](https://gitea.eom.dev/claude/tidewall/milestones) and [issues](https://gitea.eom.dev/claude/tidewall/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](LICENSE)). Original art and audio: CC BY-SA 4.0 ([LICENSE-ASSETS](LICENSE-ASSETS)). The Godot engine is MIT-licensed; see [CREDITS.md](CREDITS.md).