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

StateDefaultDescription
game_state"exploration" but can be set to a custom state in General->ManifestMain game view state (used by game_state component slot)
overlay_state"overlay-navigation"Overlay layer state
popup_statenullActive popup state
progression_statenullSide panel tab (quests, character, gallery)
progression_sub_statenullCharacter sheet sub-tab
suppress_character_progressionfalseWhen 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_listtrueWhether to show party character list
disable_uifalseDisable all UI interactions
block_scene_advancefalseBlock scene advancement clicks/keys without disabling UI
block_party_inventoryfalseBlock access to party inventory

Selection States

StateDefaultDescription
selected_characternullCurrently viewed character in character sheet
active_characternullCharacter being interacted with
active_inventorynullCurrently open inventory ID
active_itemnullCurrently selected item UID

Map States

StateDefaultDescription
map_zoom_factor1Current map zoom level

Quest States

StateDefaultDescription
is_show_completed_questsfalseWhether to show completed quests in quest log


System States

StateDefaultDescription
supress_game_eventsfalseSuppress game event triggers
disable_savesfalseDisable save functionality
replay_modefalseWhether game is in replay mode
replay_mode_unlock_choicesfalseUnlock all choices in replay mode
max_log40Maximum number of log entries