Variables

Variables store and reuse values. A variable can hold a static value, an operator expression, or a device state.

Declaring and referencing#

1. Declare with _$VAR.
2. Assign with =, and the value must be quoted (double quotes).
3. Reference the value inside any argument with ${name}$.

# Static value
_$VAR isAdmin = "true"
writeLn "${isAdmin}$"

# Operator inside a variable
_$VAR delayTime = "_$random(500, 1500)"
delay "${delayTime}$"

# State inside a variable
_$VAR capsStatus = "_@capslockState"
writeLn "${capsStatus}$"

Runtime assignment and math#

_$VAR declares a variable when the line is read. To change a value while the script runs — for example to drive a repeat/while counter — use the commands below. They operate on the same global variables you reference with ${name}$.

The math commands treat the variable as a signed integer in base 10; a non-numeric current value is read as 0.

set counter "0"
whileStart "${counter}$" < "3"
writeLn "Line ${counter}$"
add counter 1
whileEnd

How a reference is resolved#

When you use "${name}$", the interpreter looks up the global variable and then, if its stored value contains a marker:

1. Evaluates operators if the value contains _$.
2. Resolves a state if the value contains _@ — and lowercases the result.

Device states#

State-backed values can be used standalone or embedded in text.

_$VAR usbStatus = "_@usbState"
writeLn "USB is: ${usbStatus}$"

Practical examples#

Dynamic delay#

_$VAR delayTime = "_$random(500, 1500)"
delay "${delayTime}$"

OS-aware branch#

_$VAR os = "_@detectedOS"
IF "${os}$" is "windows"
terminal 'windows' powershell
IF_END

Combining an operator and text#

_$VAR username = "_$random(1, 100)"
writeLn "Generated user: ${username}$"