Game Commands - nonkit

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_battle 1001>>

Parameter	Type	Description
`id`	int	Battle configuration ID

start_predefined_battle

Starts a predefined battle configuration.

<<start_predefined_battle 1001>>

Parameter	Type	Description
`id`	int	Predefined battle ID

start_level

Starts a game level.

<<start_level 1>>
<<start_level 1 true>>

Parameter	Type	Default	Description
`id`	int	required	Level ID
`isPlot`	bool	`true`	Whether this is a plot level

pause_battle / resume_battle

Pauses or resumes the current battle.

<<pause_battle>>
<<resume_battle>>

Event Commands

add_event_trigger

Adds a trigger for an event.

<<add_event_trigger "NodeName" "EventName">>
<<add_event_trigger "NodeName" "EventName" "arg1" "arg2">>

Parameter	Type	Default	Description
`node`	string	required	Node to trigger
`eventName`	string	required	Event identifier
`arg1`	string	`""`	Optional argument
`arg2`	string	`""`	Optional argument

event_end

Ends the current event and returns control to gameplay.

<<event_end>>

Always call event_end at the end of your dialogue to properly close the event.

event_cancel

Cancels the current event without completing it.

<<event_cancel>>

clear_all_event

Clears all active events.

<<clear_all_event>>

Character Management

add_character

Adds a character to the player’s party.

<<add_character 1003>>

Parameter	Type	Description
`id`	int	Character ID

Known Character IDs:

ID	Character
1000	Protagonist
1001	Lilith (莉莉丝)
1002	Karen (卡莲)
1003	Sartre (夏特露)
1004	Fouco (弗子)
1005	Green (格林)

remove_character

Removes a character from the party.

<<remove_character 1003>>

Parameter	Type	Description
`id`	int	Character ID

heal_charactor

Heals a character by a percentage.

<<heal_charactor 1002 0.5>>

Parameter	Type	Description
`id`	int	Character ID
`p`	float	Heal percentage (0.5 = 50%)

Note the spelling: heal_charactor (not “character”).

injure_charactor

Damages a character by a percentage.

<<injure_charactor 1002 0.25>>

Parameter	Type	Description
`id`	int	Character ID
`p`	float	Damage percentage

Items and Currency

change_item

Adds or removes items from inventory.

<<change_item 2007 9 true>>
<<change_item 2008 -1 true>>
<<change_item 1001 2 false>>

Parameter	Type	Default	Description
`id`	int	required	Item ID
`num`	int	required	Quantity (negative to remove)
`show`	bool	`true`	Show notification

set_item

Sets item quantity directly.

<<set_item 2007 5>>

Parameter	Type	Description
`id`	int	Item ID
`num`	int	New quantity

change_gold

Modifies the player’s gold.

<<change_gold 100>>
<<change_gold -50>>

Parameter	Type	Description
`value`	int	Gold change (positive or negative)

change_affection

Changes affection level with a character.

<<change_affection 1001 10 true>>
<<change_affection 1002 -10 true>>

Parameter	Type	Default	Description
`id`	int	required	Character ID
`value`	int	required	Affection change
`show`	bool	`true`	Show notification

change_reputation

Changes player reputation.

<<change_reputation 15 true>>
<<change_reputation -7 true>>

Parameter	Type	Default	Description
`value`	int	required	Reputation change
`show`	bool	`true`	Show notification

Attributes

change_attribute

Changes a player attribute.

<<change_attribute Strength 5 true>>
<<change_attribute Willpower -3 true>>

Parameter	Type	Default	Description
`name`	string	required	Attribute name
`value`	int	required	Change amount
`show`	bool	`true`	Show notification

increase_attribute

Increases an attribute (alias for positive change).

<<increase_attribute DEX 2 true>>

Parameter	Type	Default	Description
`name`	string	required	Attribute name
`value`	int	required	Increase amount
`show`	bool	`true`	Show notification

add_exp

Adds experience to a character.

<<add_exp 1002 100>>

Parameter	Type	Description
`characterID`	int	Character ID
`value`	int	Experience points

Time Management

next_day

Advances to the next day.

<<next_day>>

next_period

Advances to the next time period.

<<next_period>>
<<next_period true>>

Parameter	Type	Default	Description
`skipEventTriggerCheck`	bool	`false`	Skip event triggers

jump_to_period

Jumps to a specific day and period.

<<jump_to_period 5 "Morning">>

Parameter	Type	Description
`day`	int	Target day
`period`	string	Period name

UI Commands

open_view

Opens a game UI view.

<<open_view GuildView>>
<<open_view MapView arg>>

Parameter	Type	Default	Description
`name`	string	required	View identifier
`arg`	string	`null`	Optional argument

open_view_overlay

Opens a view as an overlay.

<<open_view_overlay MapView>>

Parameter	Type	Default	Description
`name`	string	required	View identifier
`arg`	string	`null`	Optional argument

close_view

Closes a UI view.

<<close_view GuildView>>

Parameter	Type	Description
`name`	string	View to close

close_all_view

Closes all open views.

<<close_all_view>>

set_style

Changes the dialogue box style.

<<set_style "bubble">>
<<set_style "normal">>
<<set_style center>>

Parameter	Type	Description
`style`	string	Style identifier (bubble, normal, center)

toast

Shows a toast notification.

<<toast "Message">>

Parameter	Type	Default	Description
`value`	string	required	Message to display
`argsStr`	string	`""`	Optional arguments

Audio Commands

set_bgm

Changes the background music.

<<set_bgm "music_name">>
<<set_bgm "music_name" 0.5 0.5>>
<<set_bgm "">>

Parameter	Type	Default	Description
`name`	string	required	Music track name (empty to stop)
`fadeOutTime`	float	`0`	Fade out duration
`fadeInTime`	float	`0`	Fade in duration

play_sound_effect

Plays a sound effect.

<<play_sound_effect "sound_name">>

Parameter	Type	Description
`name`	string	Sound effect name

Location Commands

set_current_place

Sets the current map location.

<<set_current_place 9>>

Parameter	Type	Description
`placeID`	int	Location ID

set_available_place

Sets available map locations.

<<set_available_place "1,2,3,9">>

Parameter	Type	Description
`places`	string	Comma-separated place IDs

set_available_mapEvent

Sets available map events.

<<set_available_mapEvent "10001,10002">>

Parameter	Type	Description
`mapEvents`	string	Comma-separated event IDs

Miscellaneous

set_player_name

Sets the player’s name.

<<set_player_name "Hero">>

Parameter	Type	Description
`name`	string	Player name

save_game

Saves the game at a specific node.

<<save_game "NodeName">>

Parameter	Type	Description
`nodeName`	string	Save point identifier

return_to_main_view

Returns to the main game view.

<<return_to_main_view>>

line_show / line_hide

Shows or hides the dialogue line.

<<line_show>>
<<line_hide>>

set_auto_advance

Enables or disables auto-advance.

<<set_auto_advance true>>
<<set_auto_advance false>>

Parameter	Type	Description
`valid`	bool	Enable auto-advance

wait_input

Waits for player input.

<<wait_input>>

wait_time_anim

Waits for time animation to complete.

<<wait_time_anim>>

Common Patterns

Quest Completion

<<change_gold 500>>
<<change_item 10050 1 true>>
<<change_affection 1002 20>>
<<event_end>>

Shop Transaction

<<if get_gold() >= 100>>
    <<change_gold -100>>
    <<change_item 10001 1>>
    Shopkeeper: Here you go!
<<else>>
    Shopkeeper: You don't have enough gold.
<<endif>>

Time Progression

<<next_period>>
<<set_bgm "music_evening">>

Scene End

<<char_remove "Lilith">>
<<event_end>>

Overview

Commands & Functions

​Battle Commands

​start_battle

​start_predefined_battle

​start_level

​pause_battle / resume_battle

​Event Commands

​add_event_trigger

​event_end

​event_cancel

​clear_all_event

​Character Management

​add_character

​remove_character

​heal_charactor

​injure_charactor

​Items and Currency

​change_item

​set_item

​change_gold

​change_affection

​change_reputation

​Attributes

​change_attribute

​increase_attribute

​add_exp

​Time Management

​next_day

​next_period

​jump_to_period

​UI Commands

​open_view

​open_view_overlay

​close_view

​close_all_view

​set_style

​toast

​Audio Commands

​set_bgm

​play_sound_effect

​Location Commands

​set_current_place

​set_available_place

​set_available_mapEvent

​Miscellaneous

​set_player_name

​save_game

​return_to_main_view

​line_show / line_hide

​set_auto_advance

​wait_input

​wait_time_anim

​Common Patterns

​Quest Completion

​Shop Transaction

​Time Progression

​Scene End

Battle Commands

start_battle

start_predefined_battle

start_level

pause_battle / resume_battle

Event Commands

add_event_trigger

event_end

event_cancel

clear_all_event

Character Management

add_character

remove_character

heal_charactor

injure_charactor

Items and Currency

change_item

set_item

change_gold

change_affection

change_reputation

Attributes

change_attribute

increase_attribute

add_exp

Time Management

next_day

next_period

jump_to_period

UI Commands

open_view

open_view_overlay

close_view

close_all_view

set_style

toast

Audio Commands

set_bgm

play_sound_effect

Location Commands

set_current_place

set_available_place

set_available_mapEvent

Miscellaneous

set_player_name

save_game

return_to_main_view

line_show / line_hide

set_auto_advance

wait_input

wait_time_anim

Common Patterns

Quest Completion

Shop Transaction

Time Progression

Scene End