Game States Reference
All built-in game states you can read and write using game.getState() and game.setState(), or via the state action ({state: "disable_ui=true"}).
UI States
| State | Default | Description |
|---|---|---|
game_state | "exploration" but can be set to a custom state in General->Manifest | Main game view state (used by game_state component slot) |
overlay_state | "overlay-navigation" | Overlay layer state |
popup_state | null | Active popup state |
progression_state | null | Side panel tab (quests, character, gallery) |
progression_sub_state | null | Character sheet sub-tab |
suppress_character_progression | false | When true, clicking a character in the character list only updates selected_character and skips opening the progression overlay. Use when the game renders the character sheet elsewhere (e.g., a side panel) and doesn't want the full-page overlay on every click. |
gallery_tab | "characters" | Active gallery tab |
show_character_list | true | Whether to show party character list |
disable_ui | false | Disable all UI interactions |
block_scene_advance | false | Block scene advancement clicks/keys without disabling UI |
block_party_inventory | false | Block access to party inventory |
Selection States
| State | Default | Description |
|---|---|---|
selected_character | null | Currently viewed character in character sheet |
active_character | null | Character being interacted with |
active_inventory | null | Currently open inventory ID |
active_item | null | Currently selected item UID |
Map States
| State | Default | Description |
|---|---|---|
map_zoom_factor | 1 | Current map zoom level |
Quest States
| State | Default | Description |
|---|---|---|
is_show_completed_quests | false | Whether to show completed quests in quest log |
System States
| State | Default | Description |
|---|---|---|
supress_game_events | false | Suppress game event triggers |
disable_saves | false | Disable save functionality |
replay_mode | false | Whether game is in replay mode |
replay_mode_unlock_choices | false | Unlock all choices in replay mode |
max_log | 40 | Maximum number of log entries |