From 84d74ca4351a97148ad8339676f9df7946bc21fb Mon Sep 17 00:00:00 2001
From: historia <[not public]>
Date: Thu, 25 Jun 2026 20:33:47 -0400
Subject: feat: trigger system for scripted events added.

---
 building_guide/state.md | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

(limited to 'building_guide/state.md')

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."
 
-- 
cgit v1.2.3