Files
tidewall/docs/GDD.md
T
claudeandClaude Opus 5.5 5021d13686 W4: Points of interest
PoiSet.generate(island) places 10 to 16 points of interest per island from
the seed's "poi" stream: hilltop shrines, lighthouses, docks, salt works,
quarries and fishing hamlets, at least 85 m apart. Each kind has a siting
rule (height band, flatness, coast or summit) that loosens step by step
until its minimum is placed. Piers are sited so their deck clears the
ground all the way out to water 1.5 m deep.

Poi assembles each from modular parts in a local frame turned in quarter
turns, so every solid stays an axis-aligned box: walls with a door and
lintel, plinths, steps down to the ground, roofs, a stair to a loft. Each
POI carries loot spawn markers, exposed through PoiSet.loot_markers(),
and walking routes from open ground into its interiors.

- Simulation adds every POI solid to its ground and never spawns players
  inside one.
- SimGround indexes solids in 8 m cells, so collision queries only test
  nearby boxes. Smoke p95 tick is 0.47 ms with about 300 solids.
- Movement tests the body where it will stand after stepping up, so
  stairs with treads narrower than the body can be climbed. The
  traversal test found the lighthouse stair impassable without it.
- PoiView draws parts as one MultiMesh per look, in the seafaring
  palette. Capture scenarios poi_<kind> frame each kind.
- Summit stone is darker so it no longer reads as snow.

Tests: 30 seeds get every kind within its limits, 10 to 16 in total,
spaced and sited; placement is deterministic; loot markers stand on
floors and are not inside solids; a player walks every route of every
POI on 4 seeds through doors, up steps and the lighthouse stair; stairs
with 0.45 m treads are climbed and a step doesn't carry the body into a
wall; the solid index matches a full scan on 500 queries.

Closes #11

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-10 14:47:10 -05:00

7.8 KiB

Tidewall game design

Tidewall is a third-person build-and-survive battle royale for Linux. Up to 24 players or bots land on a procedurally generated island. They scavenge, fight and build while the sea rises in phases and takes the low ground. The last player or team alive wins.

Every gameplay number is a named constant in the single tuning table, src/sim/tuning.gd. This document refers to those constants by name, so it can't drift from the game. To change a number, edit that file.

What makes Tidewall distinct

  • The rising sea. There is no circle closing in from the outside. The danger is a water level that everybody can see and that rises on a published schedule.
  • Elevation is safe ground. The map's shape decides where the fight goes. Valleys flood first, ridges become islands, and the last land is the highest land. Reading the terrain is a core skill.
  • Breakwaters hold back water. A sealed ring of breakwater keeps ground below sea level dry for a while. Water pressure wears them down, and enemies can breach them. A breach floods everything behind it. A defended low-ground fort is a real and risky strategy.
  • Seafaring folk art. The look is weathered and hand-made, built on tarred wood, rope, net floats and salt-faded paint. See ORIGINALITY.md.

Core loop

  1. Launch. A packet ship sails a straight line past the island. Each player picks a moment to leave by lifeline mortar and steers a gull-kite to the ground.
  2. Scavenge. Search wrecks, fishing huts and lighthouses for weapons and supplies. Harvest driftwood, stone and salvage iron with the boathook.
  3. Read the tide. Check the next flood line and decide where to be.
  4. Build and fight. Raise cover, climb, wall off a position, or seal a breakwater.
  5. Climb or hold. Move uphill with the water, or defend what you built.
  6. Last one standing wins. Teams win when no other team has a living member.

Match sizes

Mode Players Constants
Solo 24 players SOLO_PLAYERS
Duos 12 teams of 2 DUO_TEAMS, DUO_TEAM_SIZE

Bots fill empty slots. Offline play is a local server filled with bots, the same game code as online play. A downed duo partner can be revived, within REVIVE_SECONDS.

The island

Every match is a new island, generated from the match seed by src/sim/island.gd. The server and every client build it from the seed alone, and compare Island.heightmap_hash(), so terrain is never sent.

  • About a kilometre across (ISLAND_RADIUS_METRES), in the WORLD_SIZE_METRES square, with open sea all round for the packet ship's approach.
  • Elevation bands suit the tide: beach up to ISLAND_BEACH_TOP, wet flat marsh up to ISLAND_MARSH_TOP, forest up to ISLAND_FOREST_TOP, then highland, and summit ground from ISLAND_SUMMIT_BAND.
  • Land rises from the coast over a broad dome, so each tide phase takes a ring of the island rather than all the low ground at once.
  • Two to four summits (ISLAND_MIN_SUMMITS, ISLAND_MAX_SUMMITS), at least ISLAND_SUMMIT_SPACING_METRES apart and joined by lower ridges. The tallest stands between ISLAND_PEAK_MIN and ISLAND_PEAK_MAX, always below ISLAND_MAX_HEIGHT, so the last tide covers it. Late fights happen on several hills, not one.
  • The worldgen test sweeps 100 seeds: land covers 30 to 70% of the world, at least two distinct high points, 85% of land walkable, and no more than 3% of dry land cut off from the main landmass at the first two sea levels.

tools/island_map.gd draws a top-down map of any seed, with a contour at each tide level.

Points of interest

Every island gets 10 to 16 places worth landing at (POI_KINDS, POI_MIN_TOTAL, POI_MAX_TOTAL), at least POI_SPACING_METRES apart, placed from the seed by src/sim/poi_set.gd:

Kind Sited Built from
Hilltop shrine On a summit Open-fronted stone shrine with a painted roof, cairns
Lighthouse Near the coast, raised ground Stone tower, keeper's room, stair to a loft, light chamber
Dock On the shore, facing open water Plank pier on posts reaching deep water, net shed
Salt works Flat beach or marsh Evaporation pans behind low walls, boiling house
Quarry Highland Cut stone blocks, lifting frame, tool shed
Fishing hamlet Forest band Three or four huts round a yard, net-drying rack

Each is assembled from modular parts (walls with doors, plinths, steps, roofs, stairs). Loot spawn markers sit on their floors, for the loot system, and a test walks a player from open ground into every interior.

Tide phases

TIDE_PHASES is an ordered list of phases. Each one sets:

  • hold: seconds the water stays still, with the next flood line shown on the map;
  • rise: seconds the water takes to reach the new level;
  • level: the sea height in metres at the end of the rise;
  • drown_dps: damage per second to anyone in water above their head.

The last phase raises the sea above the highest ground, so every match ends. Players standing in shallow water wade and slow down. Underwater, they lose breath over BREATH_SECONDS, and then take the phase's drown_dps. Swimming is slow and leaves a player unable to build or fire. Water flows along the terrain, so low ground that is cut off from the sea stays dry until something opens a path.

Building

Harvested materials are driftwood, stone and salvage iron, each capped at MATERIAL_CAP. Pieces snap to a grid of GRID_CELL_METRES cells.

Piece Purpose
Wall Cover and enclosure
Floor Bridges and platforms
Ramp Fast elevation
Roof Overhead cover
Breakwater Keeps water out; the only piece water can't pass

BUILD_PIECES holds what each piece costs. MATERIALS holds each material's health and build_seconds, and materials trade speed for strength. A piece goes up quickly but reaches full health only after its build_seconds have passed. Pieces with no connection to the ground collapse. Each boathook hit harvests HARVEST_PER_HIT material.

Breakwaters. Each holds up to BREAKWATER_MAX_HEAD metres of water above its base. Every second under pressure it loses BREAKWATER_WEAR_PER_METRE health per metre of head. Weapons damage it normally. When one fails, the water level equalises through the gap at BREACH_FLOW_METRES_PER_SECOND.

Weapons and items

WEAPONS holds damage, fire rate, magazine size, reload time, range falloff and rarity.

Name Role
Boathook Melee and harvesting; always carried
Fowling Piece Close-range spread
Dock Carbine Mid-range automatic
Signal Revolver Accurate sidearm
Whaler's Longgun Long-range, single shot
Line Thrower Fires a line to pull yourself to a surface
Powder Keg Thrown explosive; damages structures heavily

Items are in ITEMS: Sailcloth Bandage restores health, Brine Tonic restores more health slowly, and Cork Vest adds armor, up to PLAYER_MAX_ARMOR. A player has PLAYER_MAX_HEALTH health and INVENTORY_SLOTS carried item slots.

Controls

Rebindable. Defaults for keyboard and mouse:

Action Default
Move W A S D
Jump Space
Crouch Left Ctrl
Sprint Left Shift
Fire / harvest / place Left mouse
Aim Right mouse
Reload R
Interact E
Build mode Q
Next / previous piece Mouse wheel
Cycle material T
Inventory slots 1 to 5
Map M

Gamepad support is planned with the accessibility work in v0.6.

Out of scope for v1.0

  • Monetization of any kind: no store, currency, battle pass or loot boxes.
  • Accounts, ranked play, global matchmaking or anti-cheat beyond server authority.
  • Modes other than solo and duos, or teams larger than 2.
  • Vehicles, or swimming combat.
  • Platforms other than Linux, and mobile or VR.
  • Voice chat.
  • User-made maps or mods.