#72: The packet ship, the lifeline mortar and the gull-kite

Eric chose option B on #72. The drop is now the GDD's launch:

- A packet ship sails a seeded straight line past the island, offshore,
  as close in as it can while keeping 45 m of open water from any land
  (eight-way probes; up to 32 headings, then the four world sides).
- Jump fires the lifeline mortar along the look heading. How high the
  player aims sets the charge (-10 to 45 degrees: 16 to 110 m/s over
  the ground; every shot climbs at 75 m/s). The climb can't be steered
  and the kite can't open until the arc tops out. Riders still aboard at
  the end are fired towards the middle of the island.
- Drop.reach() mirrors the fall for both ways down (kite at the top, or
  a fall with the kite opening by itself); bots, the soak and autoplay
  clients and the tutorial pilot aim with Drop.aim_charge().
- Bots fire at their landing spot once abeam of it, when in easy reach
  at their own staggered moment, or just before the route ends, and open
  the kite early only when the spot is beyond the rest of a fall.
- Art: VesselModels.ship() (two-masted packet, tanned square sails, a
  salt-white boot-top, a bowsprit and the mortar on its bed, mirrored to
  face the island), the figure's gull-kite (figure.py), and a lifeline
  cord from the muzzle to each player still climbing.
- Renamed barge to ship and wing-sail to gull-kite throughout code,
  tests, captures, docs and the tutorial text. make match now defaults to
  seed 2, where the scripted player still harvests and builds.

Closes #72

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-15 12:49:21 -05:00
co-authored by Claude Opus 5.5
parent 4357861bd4
commit aa797580a7
69 changed files with 1753 additions and 847 deletions
+7 -7
View File
@@ -172,7 +172,7 @@ sources tracked per second). A source is an IPv4 address, or an IPv6 address's w
**Lobby, backfill and late arrivals.** People who connect during the lobby or the
countdown take places (`Match.join()`); bots are only added when the match starts,
into whatever places are still empty, so people joining and leaving in the lobby
never displace or strand a bot. Someone who connects after the barge leaves, or
never displace or strand a bot. Someone who connects after the ship sails, or
during results, becomes a watcher (`Match.watch()`): they spectate a living player
(the winner during results) through the same snapshots an eliminated player gets,
and take a place ahead of any bots when the next lobby opens. The server still turns
@@ -360,7 +360,7 @@ trips, 41 of 41 shots hit; with the lag ignored, 0 of 41. At 500 ms, past the ca
`ClientGame` (`src/net/`) is a client's side of a match. It works on packets, so it
runs the same over a `NetClient` or a test's simulated link. From the seed in the
MATCH notice it generates the island itself (a `Simulation` it never steps) and plans
the same barge route, so it can run the server's movement code on the server's ground.
the same ship route, so it can run the server's movement code on the server's ground.
**The command clock.** A command must reach the server before the tick it names, so
the client's tick runs ahead of the server's by the trip there plus a margin. Nobody
@@ -482,7 +482,7 @@ weights from the island's elevation bands, with rock on steep ground.
`MatchView` (`src/client/`) is the client's picture of one match: sky, sun, terrain,
sea, points of interest, props, built pieces and `EntityView`, which draws players, the
barge, items and chests. All of it reads one `Simulation` and never writes to it, and a
ship, items and chests. All of it reads one `Simulation` and never writes to it, and a
new match gets a new view. The camera sits on a player's shoulder through `CameraRig`.
`EffectsView` (`src/client/effects/`, A7) draws the match's visual effects from the
server's FX records and from changes it sees in the world (pieces gone, players in the
@@ -490,7 +490,7 @@ water, surges). Its particles are simulated on the CPU in packed arrays and draw
two MultiMeshes (blended and added) of camera-facing quads, sized per instance by a
small shader, with tracers as a third; everything is allocated once at the preset's
budget, so a big fight costs a fixed three draw calls and never adds nodes or grows buffers.
The figure (`FigureRig`), items (`ItemModels`) and barge and chests (`VesselModels`) are
The figure (`FigureRig`), items (`ItemModels`) and ship and chests (`VesselModels`) are
the generated art described in assets/PROVENANCE.md; `test_world_art` fails on any
primitive stand-in mesh.
@@ -499,7 +499,7 @@ In play, the simulation it reads is the client's own copy of the world: the
`ClientWorld` keeps its pieces, props, chests and tide in line with the server, and
`ClientMirror` (`src/net/`) writes the rest of the picture into it every frame: each
entity the server has told this client about, where it is being drawn now (everyone
else from the recent past, the client's own player where it was predicted), the barge,
else from the recent past, the client's own player where it was predicted), the ship,
the clock and the sea level. So the same views draw a networked match, a local
server's simulation in a test, or a replay in a capture, and there is one set of
drawing code. Captures and tests still point a `MatchView` straight at a server's
@@ -559,7 +559,7 @@ budget:
The max includes one long tick per match: unthrottled, the 15 s results screen passes
in a fraction of a second, so the main thread waits for the worker still building the
next island. At the real 30 Hz the worker finishes long before the lobby opens.
- **Client:** the match `make match` saved, rendered at the whole island, the barge (24
- **Client:** the match `make match` saved, rendered at the whole island, the ship (24
figures together, the worst case for draw calls), landed, a build and the final
players, and a crowded pine forest. Each capture reports its frame's draw calls,
primitives, objects, nodes and memory (`tools/capture.gd`'s `render` field).
@@ -631,7 +631,7 @@ model and tier. The hotbar shows the icons.
## Player figure (A2)
`tools/models/figure.py` builds the islander in headless Blender as twelve rigid
parts (pelvis, torso, head, upper arms, forearms, thighs, shins and the wing-sail),
parts (pelvis, torso, head, upper arms, forearms, thighs, shins and the gull-kite),
each an OBJ whose origin is the joint it turns about, plus `figure.json` with the
joints and hand points (`make art` rebuilds these and the items). OBJ has no
skeleton, so the figure is jointed rather than skinned.
+3 -3
View File
@@ -6,7 +6,7 @@ is sampled, recorded, downloaded or taken from a third party. How each kind of a
made is described in [assets/PROVENANCE.md](../assets/PROVENANCE.md); the licence is
CC BY-SA 4.0 ([LICENSE-ASSETS](../LICENSE-ASSETS)).
Code-built art (terrain, sea, points of interest, props, build pieces, the barge, sea
Code-built art (terrain, sea, points of interest, props, build pieces, the ship, sea
chests and effects) isn't a file here: it's drawn by the scripts under `src/client/`.
This file is written by `tools/godot.sh --script res://tools/provenance.gd`, and
@@ -104,10 +104,10 @@ This file is written by `tools/godot.sh --script res://tools/provenance.gd`, and
| `assets/models/figure/forearm_r.obj` | `tools/models/figure.py` | A part of the player figure (OBJ and MTL) or its joint data (JSON), built from primitives in headless Blender. |
| `assets/models/figure/head.mtl` | `tools/models/figure.py` | A part of the player figure (OBJ and MTL) or its joint data (JSON), built from primitives in headless Blender. |
| `assets/models/figure/head.obj` | `tools/models/figure.py` | A part of the player figure (OBJ and MTL) or its joint data (JSON), built from primitives in headless Blender. |
| `assets/models/figure/kite.mtl` | `tools/models/figure.py` | A part of the player figure (OBJ and MTL) or its joint data (JSON), built from primitives in headless Blender. |
| `assets/models/figure/kite.obj` | `tools/models/figure.py` | A part of the player figure (OBJ and MTL) or its joint data (JSON), built from primitives in headless Blender. |
| `assets/models/figure/pelvis.mtl` | `tools/models/figure.py` | A part of the player figure (OBJ and MTL) or its joint data (JSON), built from primitives in headless Blender. |
| `assets/models/figure/pelvis.obj` | `tools/models/figure.py` | A part of the player figure (OBJ and MTL) or its joint data (JSON), built from primitives in headless Blender. |
| `assets/models/figure/sail.mtl` | `tools/models/figure.py` | A part of the player figure (OBJ and MTL) or its joint data (JSON), built from primitives in headless Blender. |
| `assets/models/figure/sail.obj` | `tools/models/figure.py` | A part of the player figure (OBJ and MTL) or its joint data (JSON), built from primitives in headless Blender. |
| `assets/models/figure/shin_l.mtl` | `tools/models/figure.py` | A part of the player figure (OBJ and MTL) or its joint data (JSON), built from primitives in headless Blender. |
| `assets/models/figure/shin_l.obj` | `tools/models/figure.py` | A part of the player figure (OBJ and MTL) or its joint data (JSON), built from primitives in headless Blender. |
| `assets/models/figure/shin_r.mtl` | `tools/models/figure.py` | A part of the player figure (OBJ and MTL) or its joint data (JSON), built from primitives in headless Blender. |
+18 -11
View File
@@ -47,7 +47,7 @@ The server runs matches back to back, in [`src/sim/match.gd`](../src/sim/match.g
1. **Lobby.** Players join. Once `MATCH_MIN_PLAYERS` are in, it waits
`MATCH_LOBBY_SECONDS` for more, or counts down at once when full.
2. **Countdown.** `MATCH_COUNTDOWN_SECONDS`. If too many leave, it goes back to the lobby.
3. **Drop.** Bots fill the empty places, everyone boards the barge and loot is placed.
3. **Drop.** Bots fill the empty places, everyone boards the packet ship and loot is placed.
4. **Play.** Ends when at most one team has anyone standing.
5. **Results.** Finishing places and the winners stay up for `MATCH_RESULTS_SECONDS`,
then bots leave and the server goes back to the lobby with a new island.
@@ -144,14 +144,21 @@ seed, so only damage is match state.
### The drop
Every match starts with the drop, simulated in [`src/sim/drop.gd`](../src/sim/drop.gd).
A carrier crosses the island at `BARGE_ALTITUDE` on a straight route drawn from the seed.
The route passes within `BARGE_CENTRE_JITTER` of the middle and always crosses at least
`BARGE_MIN_LAND_METRES` of dry land. Players ride it until they press jump, then fall,
steering at `FREEFALL_STEER_SPEED`, up to `FREEFALL_MAX_SPEED`. Jump opens the sail, and
it opens by itself `WING_AUTO_DEPLOY_HEIGHT` above the ground or water. Under the sail
they sink at `GLIDE_FALL_SPEED` and steer at `GLIDE_SPEED`, and touch down without damage.
Anyone still aboard at the end of the route is thrown off. The carrier's name and look,
sky barge or the packet ship and mortar of the core loop above, are open in #72.
A packet ship sails past the island on a straight route drawn from the seed, its deck
`SHIP_DECK_HEIGHT` above the sea. The route runs as close in as it can while keeping
`SHIP_COAST_CLEARANCE` of open water between itself and any land, so it never crosses
the island. Players ride it until they press jump, which fires them inland by lifeline
mortar along the way they face. How high they aim sets the charge: from
`MORTAR_PITCH_LOW_DEGREES` (or lower) to `MORTAR_PITCH_HIGH_DEGREES` (or higher) the shot's
speed over the ground runs from `MORTAR_MIN_SPEED` to `MORTAR_MAX_SPEED`, and every shot
climbs at `MORTAR_RISE_SPEED`. Nothing steers the climb. Over the top of the arc they
fall, steering at `FREEFALL_STEER_SPEED`, up to `FREEFALL_MAX_SPEED`. Jump opens the
gull-kite, and it opens by itself `KITE_AUTO_DEPLOY_HEIGHT` above the ground or water.
Under the kite they sink at `GLIDE_FALL_SPEED` and steer at `GLIDE_SPEED`, and touch down
without damage. A full charge with the kite opened at the top carries about a kilometre,
further than any land lies from any route (`test_drop` checks 60 seeds). Anyone still
aboard at the end of the route is fired towards the middle of the island. Eric chose
this launch in #72 over the sky barge first built for W7.
## Tide phases
@@ -331,7 +338,7 @@ each weapon's headshot multiplier.
The balance targets are checked by `make balance` over at least `BALANCE_MIN_MATCHES`
bot-only matches of `SOLO_PLAYERS` players (H3):
- the median match, from the barge leaving to the last player standing, lasts between
- the median match, from the ship sailing to the last player standing, lasts between
`BALANCE_MEDIAN_MINUTES_MIN` and `BALANCE_MEDIAN_MINUTES_MAX` minutes;
- no one weapon takes more than `BALANCE_MAX_WEAPON_SHARE` of the eliminations made with
weapons, the boathook included.
@@ -348,7 +355,7 @@ Keys are matched by position. Defaults for keyboard and mouse:
| Action | Default |
|---|---|
| Move | W A S D |
| Jump; leap from the barge; open the wing-sail | Space |
| Jump; fire the mortar from the ship; open the gull-kite | Space |
| Crouch; dive when swimming | Left Ctrl |
| Sprint | Left Shift |
| Use, fire, harvest or place | Left mouse |
+10 -8
View File
@@ -1,7 +1,7 @@
# Playing Tidewall on Linux
Tidewall is a free and open-source build-and-survive battle royale. Up to 24 players
and bots leap from a sky barge onto a generated island, scavenge, fight and build,
and bots fire themselves from a packet ship onto a generated island, scavenge, fight and build,
while the sea rises in phases and swallows the low ground. The last one standing wins.
To run a server, see [SERVER.md](SERVER.md).
@@ -37,7 +37,7 @@ Replace `1.0.0` with the version you downloaded.
The first time, the game offers the tutorial; after that it opens on its main menu.
- **Tutorial** is a few minutes on an island of your own: leave the barge and glide
- **Tutorial** is a few minutes on an island of your own: fire yourself off the ship and glide
down, walk and jump, cut materials with the boathook, build a wall, fire the dock
carbine you start with, and get above the line the tide will reach. A card under the
minimap says what to do with your own keys and moves on when you've done it. Nobody
@@ -86,7 +86,7 @@ position, so they sit in the same place on any keyboard layout.
| Action | Default |
|---|---|
| Move | W A S D |
| Jump; on the barge, leap; in the air, open the wing-sail | Space |
| Jump; on the ship, fire the mortar; in the air, open the gull-kite | Space |
| Crouch; in water, dive | Left Ctrl |
| Sprint | Left Shift |
| Use, fire, harvest or place | Left mouse |
@@ -112,7 +112,7 @@ South is A on most pads.
| Move | Left stick |
| Look | Right stick |
| Sprint (until you stop) | Click the left stick |
| Jump, leap, open the wing-sail | South (A) |
| Jump, fire the mortar, open the gull-kite | South (A) |
| Crouch, dive | East (B) |
| Reload | West (X) |
| Pick up or open a chest | North (Y) |
@@ -158,10 +158,12 @@ Settings → Access:
## How a match goes
1. **The drop.** Everyone rides a sky barge across the island. Press jump to leap,
steer with the move keys while you fall, and press jump again to open the wing-sail.
It opens by itself near the ground. Anyone still aboard at the end of the route is
thrown off.
1. **The drop.** Everyone rides a packet ship that sails past the island, offshore.
Face where you want to land and press jump to fire yourself inland by lifeline
mortar: aim level for the shore, and look higher to carry further, up to the far
side of the island. The climb can't be steered. Over the top of the arc, steer with
the move keys and press jump again to open the gull-kite; it opens by itself near the
ground. Anyone still aboard at the end of the route is fired towards the middle.
2. **Scavenge.** Fishing hamlets, docks, salt works, quarries, lighthouses and hilltop
shrines hold weapons, ammunition and supplies, on the floor and in sea chests (E opens one).
Washed-up crates on the beaches spill loot when broken.
+4 -3
View File
@@ -179,9 +179,10 @@ collision box, give or take a few centimetres of lap or trim.
gone), a third of the strips are split short and darkened. Battered (two thirds
gone), a third are knocked out so the dark backing shows, and the rest are split
and charred. `make build-captures` renders the test card (`captures/build_states.png`).
- **The barge and sea chests** (`VesselModels`): a lofted tarred hull with an ochre
rubbing strake under a gored canvas envelope, striped tanned and banded ochre; sea
chests painted sea-green with tarred bands, a salt-white border and a gilt hasp.
- **The packet ship and sea chests** (`VesselModels`): a two-masted packet with a lofted
tarred hull, an ochre rubbing strake, a salt-white boot-top at the waterline, tanned
square sails with an ochre band, a bowsprit, and a squat tarred lifeline mortar with
gilt bands on a timber bed; sea chests painted sea-green with tarred bands, a salt-white border and a gilt hasp.
- **Terrain** (`terrain.gdshader`): sand with shingle, marsh, grass in tussocks and
wind-dried patches, rock with lichen blotches, pale summits. Fine detail fades out
past about 150 m so it doesn't shimmer.
+2 -2
View File
@@ -31,7 +31,7 @@ found and fixed:
|---|---|---|---|
| Menus | `menu_main`, `menu_practice`, `menu_join`, `menu_settings`, `menu_settings_mouse`, `menu_pause`, `menu_results` | Paper panels over the sea and tide post; every label readable; the version line; focus outline on the first button; nothing clipped. | Pass |
| Lobby | `match_lobby` | The whole island from the air, sea round it with no square edge. | Pass after H16 |
| The drop | `match_barge`, `client_barge`, `match_glide`, `client_glide`, `vessels` | The sky barge and its 24 passengers; the wing-sail held overhead; the island below. | Pass |
| The drop | `match_ship`, `client_ship`, `match_glide`, `client_glide`, `vessels` | The packet ship and its 24 passengers offshore; the gull-kite held overhead; the island below. | Pass |
| Landing | `match_landed`, `client_landed`, `quality_low`, `quality_medium`, `quality_high` | The player on the shoulder camera, a sea chest, a building's inside. The three presets differ in shadow and detail, not in what's there. | Pass |
| Biomes | `props_beach`, `props_forest`, `props_highland`, `props_overview`, `props_crate`, `props_felled`, `terrain`, `terrain_lod`, `sea_shore_calm` | Sand with wet patches and beached boats, pine forest, highland stone and boulders, the marsh flats at low tide. | Pass |
| Points of interest | `poi_hamlet`, `poi_dock`, `poi_lighthouse`, `poi_quarry`, `poi_salt_works`, `poi_shrine`, `style_*` | Each reads as its place; the woodcut print pass (outlines, hatching) on, and off in the `_plain` captures. | Pass |
@@ -39,7 +39,7 @@ found and fixed:
| Players and items | `figure_states`, `figure_actions`, `figure_close`, `items_held`, `items_shoulder`, `items_ground`, `items_tiers`, `items_kegs` | Coats in every colour, every pose, items in hand and on the ground, tier marks. | Pass |
| Combat | `effects_fight`, `effects_blast`, `effects_work`, `effects_stress` | Muzzle flash at the muzzle, the hit marker round the reticle, the keg blast and collapse dust, tracers in the stress scene. | Pass |
| HUD | `client_hud`, `hud_2160` (`CAPTURE_SIZE=3840x2160`) | Tide plaque, health and armour, the six slots, materials, the feed and count, crisp at 4K. | Pass |
| Chart | `chart_first`, `chart_later` | Place names, the barge's line, the next tide's land hatched, the minimap. | Pass |
| Chart | `chart_first`, `chart_later` | Place names, the ship's line, the next tide's land hatched, the minimap. | Pass |
| Each tide phase | `sea_tide_0` … `sea_tide_7`, `water_flood`, `water_shore` | The sea rising phase by phase to nothing left; the storm building to a gale with rain; flooding following the terrain. | Pass |
| The gale and under water | `sea_shore_gale`, `sea_underwater`, `match_final` | Rain, dark sea and whitecaps; the murk and the bright ceiling only when the camera is under the sea. | Pass after H15 |
| Results | `match_tide`, `match_results` | The drowned island from the lobby's viewpoint; the last players on the highest ground. | Pass after H15 |