Skip to main content
Game commands affect gameplay state, trigger systems, and control the game world.
These function signatures are based on analysis of the game’s files. Some behaviors and parameter descriptions are inferred and may not be fully accurate. Furthermore, the game is in Early Access and may change over time.

Battle Commands

start_battle

Initiates a battle encounter.

start_predefined_battle

Starts a predefined battle configuration.

start_level

Starts a game level.

pause_battle / resume_battle

Pauses or resumes the current battle.

Event Commands

add_event_trigger

Adds a trigger for an event.

event_end

Ends the current event and returns control to gameplay.
Always call event_end at the end of your dialogue to properly close the event.

event_cancel

Cancels the current event without completing it.

clear_all_event

Clears all active events.

Character Management

add_character

Adds a character to the player’s party.
Known Character IDs:

remove_character

Removes a character from the party.

heal_charactor

Heals a character by a percentage.
Note the spelling: heal_charactor (not “character”).

injure_charactor

Damages a character by a percentage.

Items and Currency

change_item

Adds or removes items from inventory.

set_item

Sets item quantity directly.

change_gold

Modifies the player’s gold.

change_affection

Changes affection level with a character.

change_reputation

Changes player reputation.

Attributes

change_attribute

Changes a player attribute.

increase_attribute

Increases an attribute (alias for positive change).

add_exp

Adds experience to a character.

Time Management

next_day

Advances to the next day.

next_period

Advances to the next time period.

jump_to_period

Jumps to a specific day and period.

UI Commands

open_view

Opens a game UI view.

open_view_overlay

Opens a view as an overlay.

close_view

Closes a UI view.

close_all_view

Closes all open views.

set_style

Changes the dialogue box style.

toast

Shows a toast notification.

Audio Commands

set_bgm

Changes the background music.

play_sound_effect

Plays a sound effect.

Location Commands

set_current_place

Sets the current map location.

set_available_place

Sets available map locations.

set_available_mapEvent

Sets available map events.

Miscellaneous

set_player_name

Sets the player’s name.

save_game

Saves the game at a specific node.

return_to_main_view

Returns to the main game view.

line_show / line_hide

Shows or hides the dialogue line.

set_auto_advance

Enables or disables auto-advance.

wait_input

Waits for player input.

wait_time_anim

Waits for time animation to complete.

Common Patterns

Quest Completion

Shop Transaction

Time Progression

Scene End