Builder's Manual · Chapter 4

Adding a Discovery

A discovery is what a tile has on it besides ground and creatures. Springs, outcrops, forage, graves, vantages.

It is the old dungeon room-event with two changes, and both are about the shift from a corridor to a place you live in.

oneShot is usually false

In a dungeon almost every event was spent on first use, because the player was never coming back. In an overworld the opposite is true.

oneShot: false means the tile is never marked cleared and the discovery fires again on every visit. @Missing file, @Missing file and @Missing file are all standing features, and they are what make the Kettle worth inhabiting rather than stripping.

Reserve oneShot: true for things that are genuinely used up. @Missing file is a grave: it gives once.

This is the single easiest thing to get wrong, and the GM instructions call it out as the most damaging mistake available — a spring that stops working is a region that quietly stops being an overworld.

terrainAffinity replaced depth

There are no depth bands, so placement is constrained by ground instead. terrainAffinity lists the terrains a discovery may sit on; empty means anywhere.

It is authoring guidance, not a runtime check — the GM never consults it. It stops you putting a forage patch on bare rock.

Writing the resolution

onSuccess and onFailure are instructions to the GM, not flavour text. State every number and name every field that gets written. "Award 2–4 stone to their stores" is usable; "the traveller gathers some stone" is not.

Be explicit about the cleared flag in the text itself, even though oneShot already says it. The GM reads the prose more carefully than the boolean, and the two agreeing costs you one sentence.

check names a stat and a DC; the player rolls 1d20 + _<stat>. No check means no roll and you go straight to onSuccess. Failure should cost something other than nothing — less yield, or a closed door — but a failed forage that deals damage is reaching.

Resources

resourceYield names a resource reference and a range, and it is now the rich tier of a real gathering system — see Resources and Structures.

Two things to write into onSuccess when you author a gathering node. Say that the award is capped by what the traveller can carry, because the GM will otherwise hand over five units to someone with two units of space. And say explicitly that the node is not used up, because a gathering node with oneShot: true is a build ladder with a hole in it.

Manual updated Aug 20, 2026.