feat: new type of non-violent 'combat': work

1 files changed, 8 insertions, 0 deletions

diff --git a/building_guide/state.md b/building_guide/state.md
new file mode 100644
index 0000000..2eefcc4
--- /dev/null
+++ b/building_guide/state.md
@@ -0,0 +1,8 @@
+## State: World vs Player
+
+**World flags** (`set_flags`, checked with `flag`) are shared by every player on the server. A door opened by one player is open for everyone. A lever pulled once changes the world for all.
+
+**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.
+
+---
+