Fluids
fluidsReveal water and magma facts: aquifer layers, standing/flowing water, ice, magma sea depth, flood exposure, and well water sources. Read-only, fog-of-war-safe data for engineering decisions.
Instructions
Water and magma engineering facts the Earthworks tier (tile_region, geology) does not cover: aquifer layers, standing/flowing water, the magma sea's top, flood exposure at the fort interior, and well water-source depth. Revealed-only, fog-of-war safe — undiscovered tiles never contribute to any field here, the same as tile_region/defenses. aquifer_layers[] groups contiguous revealed z-levels sharing the same light/heavy classification (a mix of both within a run of z-levels reads "mixed") with light_tiles/heavy_tiles tile counts (capped at 50 layers). water_layers[] is a per-z-level aggregate of revealed standing/flowing water tiles (tiles, salt_tiles/fresh_tiles, stagnant_tiles/flowing_tiles, max_depth 1..7) — NOT flood-filled into discrete named bodies (no connectivity analysis is attempted; a single lake spanning two z-levels appears as two rows) — capped at 200 z-levels. ice_layers[] is the frozen peer of water_layers[]: a per-z-level count of revealed ICE tiles (walkable_tiles = ice you can stand on, e.g. a frozen river surface; solid_tiles = ice wall you would have to mine; the two always sum to tiles), capped at 200 z-levels. Frozen water is NOT water as far as the engine is concerned — it has no flow and becomes a solid tile — so a river or brook that freezes over DISAPPEARS from water_layers[] entirely and shows up here instead. A fort reading water_layers: [] alongside a populated ice_layers[] has surface water that exists but is frozen, which is also when wells report source "frozen" and jobs cancel for "No water source". magma_sea is the highest revealed z-level with at least 20 revealed magma tiles (a size floor meant to separate a real magma sea from a small pool/volcano pipe), omitted (not a null field) if no such level is revealed. flood_risk_tiles[] lists revealed FULL-depth (max_depth 7/7) water tiles chebyshev-adjacent to a tile in the same walkable group as any citizen — a flood-EXPOSURE fact (this water sits next to fort-reachable space right now), not a prediction of whether or when it floods anything; capped at 50 (flood_risk_total/flood_risk_truncated track the real count). wells[] extends rooms_and_zones' well read with each well's x/y and the water source found scanning down from it (source: water/magma/frozen/unknown, depth_to_source in z-levels; depth_to_source is absent if the source is unknown or the scan hit a hidden tile first) — capped at 20. scan.complete is false if the fort-wide tile budget was hit before reaching z=0 (scan.last_z_scanned marks where it stopped); every field above is still fog-of-war-safe when that happens, just possibly missing deep layers. Facts only — no dig/pump/floodgate recommendations. Returns {"error":"no fort loaded"} if no fort is active.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||