Functions

Returns	Syntax	Description	Example
A random number	RAND() no parameters	Generates a random number	RAND() will output a random value between 0 and 1, e.g. 0.625 RAND()*10 will output a random value between 0 and 10, e.g. 6.25
Rounded number	ROUND(value, digits) value (Number): the number to be rounded. digits (Integer): the number of decimal places to round to.	Rounds a number to the specified number of decimal places	Example: ROUND(3.14159, 2) → 3.14
Number of characters in the string, including spaces	LEN("value") value (String): the input string whose length is to be determined	Returns the length of a string	LEN("hello") will output a value of 5
Either trueValue or falseValuedepending on the condition	IF(condition,trueValue,falseValue) condition (Expression): A logical expression that evaluates to true or false trueValue (Any): The value returned if the condition is true falseValue (Any): The value returned if the condition is false	Returns one value if a condition is true and another value if it is false	IF (temperature < 10, “cold”, “hot") if temperature = 5 , the result is "cold", but if temperature = 15 , the result is "hot".
Result of the evaluated expression	EVAL (expression)	Re-evaluates a string as an expression and returns the result. expression (String): a valid expression in string format to be evaluated.	EVAL(”5 + 5”) = 10
Numeric value represented by the string, or an error if the conversion is not possible	TO_NUMBER(value)	Converts a string to its numerical representation, if possible.	TO_NUMBER(”5”) returns the number representation of the string, in this case 5, if possible. If the input is not a valid number (e.g., "abc"), it returns an error.
Time passed between frames as a floating-point number, typically measured in seconds	DELTA_TIME	Retrieves the time elapsed between the current frame and the previous frame. Commonly used in “on update” interactions to ensure smooth and consistent motion or timing.	If DELTA_TIME returns 0.016 (16 milliseconds), it can be used for animations or movement calculations: position += speed * DELTA_TIME
Value from the target range that corresponds to the key in the lookup range	XLOOKUP(dataset, key, lookupRange, targetRange) dataset (Array) the dataset containing the lookup and target ranges. key (Any) the value to search for in the lookup range. lookupRange (Array) the range where the key will be searched. targetRange (Array) the range from which the corresponding value will be returned.	Searches for a key in a lookup range and returns the corresponding value from a target range.	XLOOKUP(salesData, "Product A", salesData["Products"], salesData["Revenue"]) → Returns the revenue associated with "Product A"
Value of the specified property from the target entity, which could include objects, settings, or other accessible data types	GET(target, propertyName)	Retrieves the value of a specified property from a target entity. This can be used to access various attributes, settings, or metadata across different types of objects or entities.	GET(OBJ("Box"), "position") → Retrieves the position of the object named "Box”
Reference to the specified object, which can then be used in other functions or operations	OBJ(name) name (String) the name of the object to retrieve	Retrieves a reference to an object by its name. This is used to interact with specific objects.	OBJ("Box") → Retrieves the object named "Box" for further interaction
	UI	Same as above
	VAR	Same as above
	PARENT_OF	Same as above
	CHILDREN_OF	Same as above
Contextual reference to the current object, component, or environment	SELF
In an interaction, returns the trigger	TRIGGER	In an interaction, returns the trigger or event that initiated the action.	Interaction: trigger ”on click”, action “set variable” → TRIGGER() will return the object name clicked
Scalar value representing the dot product of the two vectors. A positive result indicates alignment, zero indicates perpendicularity, and a negative result indicates opposing directions	DOT(v1, v2) v1 (Vector) the first input vector v2 (Vector) the second input vector	Calculates the dot product of two vectors. The dot product is a scalar value that represents the magnitude of one vector projected onto another.	DOT([1, 0, 0], [0, 1, 0]) → 0 (vectors are perpendicular)
Vector that is perpendicular to both input vectors	CROSS(v1, v2)	Calculates the cross product of two vectors. The cross product results in a new vector that is perpendicular to both input vectors and represents the area of the parallelogram formed by the vectors.	CROSS([1, 0, 0], [0, 1, 0]) → [0, 0, 1] a vector perpendicular to both input vectors
Scalar value representing the length of the vector	MAGNITUDE(vector)	Calculates the magnitude (length) of a vector. The magnitude represents the distance of the vector from the origin in space.	MAGNITUDE([3, 4, 0]) → 5 (calculated as √(3² + 4² + 0²))
Unit vector with the same direction as the input vector but a magnitude of 1	NORMALIZE(vector)	Converts a vector into a unit vector (a vector with a magnitude of 1) while maintaining its direction.	NORMALIZE([3, 4, 0]) → [0.6, 0.8, 0] (calculated by dividing each component by the magnitude, √(3² + 4² + 0²) = 5).
A value or vector between v1 and v2 based on the interpolation factor factor	LERP(v1, v2, factor) v1 (Number or Vector) the starting value or vector of the interpolation v2 (Number or Vector) the ending value or vector of the interpolation factor (Number) the interpolation factor, a value between 0 and 1, where 0 represents v1 and 1 represents v2	Performs linear interpolation between two values or vectors based on a given ratio.	LERP([0, 0], [10, 10], 0.5) → [5, 5] (halfway between the two vectors)