A short, skippable tutorial on an island of your own: leave the barge, glide
down, walk and jump, cut materials with the boathook, place a wall, aim and
fire, and get above the line the tide will reach after its next rise.
- MatchRules.tutorial(): one player, no bots, last_team_wins off (alone is
not a win, only the tide or a fall ends it) and starting_kit (a dock
carbine with a full magazine and 60 cartridges, Tuning.TUTORIAL_KIT).
Both rules go in command logs; older logs read with the defaults.
- Tutorial watches the client's own view (predicted player, world copy,
FX) and moves on when each step is done. Instructions name the player's
own key bindings. TutorialCard shows it under the minimap.
- TutorialPilot plays it through ClientInput for --tutorial --autoplay,
the tests and make tutorial-check (12 seeds, all finish).
- First launch offers it (welcome screen, remembered in settings); it is
always on the main menu; Leave in the pause menu skips it. Finishing is
saved. --tutorial on the command line.
- make tutorial-captures; PLAY.md, the man page, ARCHITECTURE.md and
CLAUDE.md updated.
Closes#52
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Two-player teams, enforced by the simulation:
- Match puts every player on a team (SimEntity.team); Weapons.damage_player
refuses damage between teammates from every weapon, the boathook and blasts.
- A player whose health runs out with a teammate standing goes down instead of
out: 60 health to bleed (one point every half second), crawling at 1 m/s, no
firing, building, looting or items. Hits still take it; drowning too.
- A standing teammate within 2 m holding interact for 6 s revives them with 30
health. Letting go or moving away starts it over.
- Downed players are out when their health runs out again or when no teammate
is left standing, credited to whoever downed them. A team falls together and
shares its place; the tie-break puts standing ahead of downed.
- Downs and revives go through Match events and the kill feed ("X knocked Y
down"); the HUD says what to do while down.
Wire: FLAG_DOWNED in the player record and the own block (flags now u16),
so prediction crawls too. Protocol version 5.
Bots: never target a teammate, land with their teammate, regroup when they
stray past 30 m, crawl toward a standing teammate when down, go to revive a
downed teammate within 60 m when not in a fight, and turn from a downed target
to its standing teammate when it's in view.
Options: --team-size=2 on the server, --duos offline, and Solo/Duos under
Crew in the Practice menu. The figure has a downed crawl pose.
Tests: test_duos (downing, crawl, revive, interrupted revive, bleed-out,
finishing, team out, falling together, no friendly damage including kegs,
drowning while down, hash, match placement and tie-break), bots as teammates,
the downed flag on the wire, the feed, server and menu options. make
duo-matches plays 10 bot duos matches.
Closes#30
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 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>
- 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>