Skip to main content

Variables

Variable Set To Value

Set the specified variable to a defined value.

Variable Set To Value
Variable
$Variable0
Value
0
  • Variable: The variable to use.
  • Value: The value to set the selected variable to.

Actor

Store Actor Direction In Variable

Store the current direction of an actor within a variable.

Store Actor Direction In Variable
Actor
Actor 1
Variable
$Variable0
  • Actor: The actor you want to check.
  • Variable: The variable to use for the direction.

Store Actor Position In Variables

Store the current position of an actor within two variables, one to store the horizontal position and another to store the vertical position.

Store Actor Position In Variables
Actor
Actor 1
X
$Variable0
Y
$Variable0
  • Actor: The actor you want to check.
  • X: The variable to use for the horizontal position.
  • Y: The variable to use for the vertical position.

Boolean

Variable Set To 'False'

Set the value of the specified variable to false.

Variable Set To 'False'
Variable
$Variable0
Value
False
  • Variable: The variable to use.
  • Value: The value to set the selected variable to.

Variable Set To 'True'

Set the value of the specified variable to true.

Variable Set To 'True'
Variable
$Variable0
Value
True
  • Variable: The variable to use.
  • Value: The value to set the selected variable to.

Control Flow

If Variable Compare With Value

Conditionally run part of the script based on the value of a variable compared with a value.

If Variable Compare With Value
Condition
$Variable0
==
0
True
Add Event
Else
  • Condition: The condition to evaluate.
  • True: The script to run if the condition is true.
  • False: The script to run if the condition is false.

If Variable Compare With Variable

Conditionally run part of the script based on the value of a variable compared with another variable.

If Variable Compare With Variable
Condition
$Variable0
==
$Variable0
True
Add Event
Else
  • Condition: The condition to evaluate.
  • True: The script to run if the condition is true.
  • False: The script to run if the condition is false.

Counter

Variable Decrement By 1

Decrease the value of the specified variable by one.

Variable Decrement By 1
Variable
$Variable0
  • Variable: The variable to use.

Variable Increment By 1

Increase the value of the specified variable by one.

Variable Increment By 1
Variable
$Variable0
  • Variable: The variable to use.

Engine Fields

Store Engine Field In Variable

Store the value of an Engine Field in a variable.

References
/docs/settings/#engine-settings

Store Engine Field In Variable
Engine Field
Jump Velocity
Variable
$Variable0
  • Engine Field: The engine field to read the value of.
  • Variable: The variable to use.

Flags

Variable Flags Add

Set selected flags to true on a variable. All unselected flags will keep their previous value.

Variable Flags Add
Variable
$Variable0
Flag 1
Flag 2
Flag 3
Flag 4
Flag 5
Flag 6
Flag 7
Flag 8
Flag 9
Flag 10
Flag 11
Flag 12
Flag 13
Flag 14
Flag 15
Flag 16
  • Variable: The variable to use.
  • Flag 1: Set flag 1 to true.
  • Flag 2: Set flag 2 to true.
  • Flag 3: Set flag 3 to true.
  • Flag 4: Set flag 4 to true.

Variable Flags Clear

Set selected flags to false on a variable. All unselected flags will keep their previous value.

Variable Flags Clear
Variable
$Variable0
Flag 1
Flag 2
Flag 3
Flag 4
Flag 5
Flag 6
Flag 7
Flag 8
Flag 9
Flag 10
Flag 11
Flag 12
Flag 13
Flag 14
Flag 15
Flag 16
  • Variable: The variable to use.
  • Flag 1: Set flag 1 to false.
  • Flag 2: Set flag 2 to false.
  • Flag 3: Set flag 3 to false.
  • Flag 4: Set flag 4 to false.

Variable Flags Set

Set the value of a variable by enabling individual bits of the 16-bit number. Allows 16 true/false values to be stored within a single variable. Setting the flags will replace the previous value of the variable.

Variable Flags Set
Variable
$Variable0
Flag 1
Flag 2
Flag 3
Flag 4
Flag 5
Flag 6
Flag 7
Flag 8
Flag 9
Flag 10
Flag 11
Flag 12
Flag 13
Flag 14
Flag 15
Flag 16
  • Variable: The variable to use.
  • Flag 1: Set flag 1 to true.
  • Flag 2: Set flag 2 to true.
  • Flag 3: Set flag 3 to true.
  • Flag 4: Set flag 4 to true.

Math

Evaluate Math Expression

Set a variable to the result of evaluating a math expression.

References
/docs/scripting/math-expressions

Evaluate Math Expression
Variable
$Variable0
Expression
e.g. 5 + (6 * $health)...
  • Variable: The variable to use.
  • Expression: The expression to evaluate.

Math Functions

Allows you to perform various maths functions on a variable to add/subtract/multiply/divide/modulus a value/variable/random number.

Math Functions
Variable
$Variable0
Operation
Set To
Value
True
  • Variable: The variable to use.
  • Operation: The operation to use for modifying the variable value.
  • Value: The value to combine with the variable using the selected operation.

Random

Seed Random Number Generator

Place this to run in response to user input to ensure random numbers change between playthroughs.

Seed Random Number Generator
Place this to run in response to user input to ensure random numbers change between playthroughs

Reset

Reset All Variables To 'False'

Reset all variables used by your project back to false.

Reset All Variables To 'False'
Reset ALL variables back to 'False'.

Save Data

Store Variable from Game Data In Variable

Read a variable's value from a specified save slot and store it in a variable.

Store Variable from Game Data In Variable
Set Variable
$Variable0
To Variable
$Variable0
From Save Slot
Slot 1
Slot 2
Slot 3
  • Set Variable: The variable to update.
  • To Variable: The variable to read the value of.
  • From Save Slot: The save slot to use.