From ab2597b22ccdb71116992aec78080d9858358d04 Mon Sep 17 00:00:00 2001
From: historia <[not public]>
Date: Tue, 7 Jul 2026 16:24:27 -0400
Subject: rename flags to global_flags (differentiate from player_flags)

---
 building_guide/objects.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

(limited to 'building_guide/objects.md')

diff --git a/building_guide/objects.md b/building_guide/objects.md
index af693c4..d377f23 100644
--- a/building_guide/objects.md
+++ b/building_guide/objects.md
@@ -149,7 +149,7 @@ use_interactions:
       not: true
     message: "You push the heavy iron gate open."
     action:
-      set_flags:
+      set_global_flags:
         gate_open: true
 ```
 
@@ -183,7 +183,7 @@ on_look:
         read_sign: true
 ```
 `on_look` fires the action AFTER showing the object's description. It uses the same
-`NodeAction` type as talk nodes — supports `set_player_flags`, `set_flags`,
+`NodeAction` type as talk nodes — supports `set_player_flags`, `set_global_flags`,
 `give_item`, `take_item`, `teleport`, `heal`, `cost`, and everything else in the
 [node action reference](behaviors.md#node-action-reference).
 
@@ -220,7 +220,7 @@ use_interactions:
     message: "You insert the crystal key into the slot. It clicks into place."
     action:
       take_item: crystal_key
-      set_flags:
+      set_global_flags:
         crystal_inserted: true
 ```
 
@@ -235,7 +235,7 @@ use_interactions:
       take_item: ancient_scroll
       set_player_flags:
         quest_complete: true
-      set_flags:
+      set_global_flags:
         temple_door_open: true
 ```
 
@@ -252,7 +252,7 @@ use_interactions:
 
 | Field              | Type           | Description                        |
 | ------------------ | -------------- | ---------------------------------- |
-| `set_flags`        | map[string]any | Set world flags (shared)           |
+| `set_global_flags`        | map[string]any | Set global flags (shared)           |
 | `set_player_flags` | map[string]any | Set player flags (per-character)   |
 | `give_item`        | string         | Give an item to inventory          |
 | `take_item`        | string         | Remove an item from inventory      |
@@ -263,7 +263,7 @@ use_interactions:
 
 | Field         | Description                      |
 | ------------- | -------------------------------- |
-| `flag`        | World flag check                 |
+| `global_flag`        | Global flag check                 |
 | `player_flag` | Per-character flag check         |
 | `has_item`    | Inventory item check             |
 | `value`       | Expected value for flag checks   |
-- 
cgit v1.2.3