ScriptNode

Script Node Options

Here is a list of all the configurable options you can tweak for individual script nodes.

Triggers

Name	@trigger
Purpose	Sets the node to respond to a trigger event. Available triggers are listed further in this document.
Notes	If multiple nodes are specified for the same trigger, a random one that meets all the trigger criterea from the highest scoring set will be selected.

Name	@function
Purpose	Sets the node to respond to a trigger event. Unlike @trigger, all valid nodes with this trigger set are invoked

Name	@who
Purpose	Sets the character target for the node. Triggers that target specific characters can only trigger nodes with the corresponding character target.
Arguments	identifier: id of the target character.
Notes	Only one thread can be executing per character.

Name	@when
Purpose	Sets the conditions required for this node to be invoked and increases the node's evaluation score by the number of expressions.
Arguments	expressions: comma-separated list of expressions.
Notes	Nodes with higher evaluation scores will be considered before nodes with lower evaluation scores.

Name	@boostScore
Purpose	Adjusts the score
Arguments	integer: adjustment to the evaluation score
Notes	Nodes with higher evalaluation scores will be considered before nodes with lower evaluation scores.

Name	@triggerPriority
Purpose	Sets the node's priority. This affects how this node interacts with threads that are already executing.
Arguments	TriggerPriority: the node's priority level. "Low", "Medium", "High", and "Cutscene".
Notes	Nodes marked with @cutscene are automatically considered to be at the highest priority, "Cutscene"

Execution Mode

Name	@cutscene
Purpose	Sets the node as a cutscene node. This will block input and engage letterboxing until the node is exited.
Notes	Only one cutscene can be active at a time.

Name	@interrupt
Purpose	Allows the node to interrupt threads running with the same priority level.

Name	@ignoreDuringCutscene
Purpose	This node will be skipped if a cutscene is currently engaged.

Name	@chatter
Purpose	Text from this node will appear in the corner of the screen from your guide character.

Name	@entrypoint
Purpose	Exposes the node to other scripts. Scripts cannot directly invoke nodes from other scripts unless they are exposed.

Name	@autosave
Purpose	Causes the game to automatically save once this node begins

Repetition

Name	@once
Purpose	Prevents this node from being seen more than once.
Argument	(Optional) session to prevent it from being seen across the current session. Omit to prevent it for the save file.

Name	@repeat
Purpose	Prevents this node from being seen consecutive times.
Argument	integer: number of nodes that must be seen before this node is eligible to be seen again.