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) --- AGENTS.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) (limited to 'AGENTS.md') diff --git a/AGENTS.md b/AGENTS.md index bbf1469..893ba59 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -33,14 +33,14 @@ File prefixes in `internal/game/`: `game.go/cmd_registry.go/tick.go` (core), `co ## Two State Systems -- **World flags** (`set_flags` / `flag`): Shared by all players. +- **Global flags** (`set_global_flags` / `global_flag`): Shared by all players. - **Player flags** (`set_player_flags` / `player_flag`): Per-character, saved to YAML. ## Room Scripting -- **`on_enter` steps**: message + optional condition. A step may have `delay` and/or `set_flags`/`set_player_flags`. Timed steps run as scheduled enter sequences; otherwise messages print synchronously. Conditions snapshotted once at entry. Resumes on reconnect if interrupted. +- **`on_enter` steps**: message + optional condition. A step may have `delay` and/or `set_global_flags`/`set_player_flags`. Timed steps run as scheduled enter sequences; otherwise messages print synchronously. Conditions snapshotted once at entry. Resumes on reconnect if interrupted. - **Conditional descriptions** (`description: [{text, condition}]`): first passing variant wins. For objects, if no variant matches the object is absent for that player. Accepts plain string or list. -- **Exits** can `set_flags`/`set_player_flags` on successful traverse. +- **Exits** can `set_global_flags`/`set_player_flags` on successful traverse. ## Data Files @@ -79,7 +79,7 @@ Actions route through `startAction()` in `act.go`: normalize verb → resolve ta ### Condition System -Used by exits, talk options, on-enter, use_interactions: `flag` (world), `player_flag` (per-char), `value` (exact match), `has_item`, `min_credits`, `all_of`, `any_of`, `not`. Bare flag/player_flag passes on truthy. +Used by exits, talk options, on-enter, use_interactions: `global_flag` (global), `player_flag` (per-char), `value` (exact match), `has_item`, `min_credits`, `all_of`, `any_of`, `not`. Bare global_flag/player_flag passes on truthy. ## Two Depletion Mechanics -- cgit v1.2.3