B3: Structure health and structural integrity

Pieces build up health, take damage from the boathook and the tide, and
collapse when nothing connects them to the ground.

- Build-up: a piece starts at 10% of its material's health and gains
  the rest evenly over build_seconds. Damage taken while building stays.
- Damage: Simulation.damage_piece, and boathook swings now hit pieces
  nearer than any prop for HARVEST_DAMAGE, with no material back.
- Tide: once a second, pieces with their base under the sea lose
  TIDE_STRUCTURE_DPS; breakwaters wear per metre of head and fail past
  BREAKWATER_MAX_HEAD.
- Integrity: grounded means touching terrain or a fixed solid (not a
  prop). On removal, a breadth-first search from the former neighbours
  stops at the first grounded piece, so only structures that really
  lost support are walked in full; loose components collapse together.
  Simulation.ground_changed rechecks grounding after terrain changes.
- Wall skirts now reach at most one level (2 m), so upper walls aren't
  grounded through a skirt; terrain checks merge boxes sharing a bottom.
- 12 tests: build-up per material, damage during building, material
  strength, fresh pieces breaking, cascades, a second support, boathook
  bringing down a wall and its floor, tide wear and breakwater failure,
  tide-triggered collapse, terrain-triggered collapse, fixed solids as
  ground, and a 564-piece fort (one removal 57 us, worst search 416 us,
  full cascade of 479 pieces 4.7 ms).

Closes #17

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-11 14:30:54 -05:00
co-authored by Claude Opus 5.5
parent f35ebf7171
commit f38bb9c69a
9 changed files with 548 additions and 20 deletions
+11
View File
@@ -154,6 +154,17 @@ and `build_seconds`, and materials trade speed for strength. A piece goes up qui
reaches full health only after its `build_seconds` have passed. Pieces with no connection
to the ground collapse.
**Health and collapse.** A new piece starts at `BUILD_START_HEALTH_FRACTION` of its
material's health and gains the rest evenly over `build_seconds`, so a fresh iron wall
is briefly weaker than a finished driftwood one. Damage taken while building stays
taken. The boathook does `HARVEST_DAMAGE` to pieces and gives nothing back. A piece is
grounded when it touches the terrain or a fixed solid such as a pier deck (props don't
count; they can be felled). Every piece needs a path through touching pieces to a
grounded one, or it collapses, and collapses cascade. Pieces with their base under the
sea wear each second: `TIDE_STRUCTURE_DPS` for most, and for breakwaters
`BREAKWATER_WEAR_PER_METRE` per metre of water over the base, failing at once past
`BREAKWATER_MAX_HEAD`.
**Placing.** Build mode (Q) shows a ghost of the selected piece where it would go:
sea green if it can be placed, rust red if not. The look direction snaps to a quarter
turn. Walls and breakwaters go on the edge of your own cell in that direction; floors,