feat: trigger system for scripted events added.

1 files changed, 6 insertions, 1 deletions

diff --git a/building_guide/state.md b/building_guide/state.md
index 013e62a..2e0b5cc 100644
--- a/building_guide/state.md
+++ b/building_guide/state.md
@@ -4,5 +4,10 @@
 
 **Player flags** (`set_player_flags`, checked with `player_flag`) are per-character. Quest progress, "has read the sign," "paid the toll" — these are different for each player. Saved to the character YAML and persist across logins.
 
----
+### Triggers — flag-change events
+
+Any flag change (world or player) can activate a **trigger** — a timed sequence of
+messages, broadcasts, spawns, and further flag mutations. See `triggers.md` for
+the full system. This is how you turn "player looked at the sign" into "spaceship
+landed and stairs opened."