Skip to main content

Action Nodes

Action nodes are leaf nodes that run concrete logic and return a state. Below are the built-in actions; business logic is usually implemented via custom actions (see Getting Started).

Succeeder

Always returns SUCCESS.

Failer

Always returns FAILURE.

Error

Always returns ERROR.

Runner

Always returns RUNNING. Useful as a placeholder or for testing.

Log

Prints a log line and returns SUCCESS.

  • Property info: the string to print.

Wait

Returns SUCCESS after a fixed duration; returns RUNNING in the meantime.

  • Property milliseconds: the wait time in milliseconds.

It records the start time in OnOpen and compares the current time in OnTick, so the deadline stays the same across frames.

RandWait

Returns SUCCESS after a random duration, without blocking the goroutine. The random duration is chosen in OnOpen and stored in the blackboard, so the deadline stays the same while RUNNING.

Supported properties:

PropertyDescription
min_ms / max_msrandom range in milliseconds, preferred
timemini / timemaxlegacy behavior3editor aliases
millisecondsfixed-duration fallback, compatible with Wait

At registration, RandomSleep is a compatibility alias of RandWait.

NameBehavior
SucceederAlways SUCCESS
FailerAlways FAILURE
ErrorAlways ERROR
RunnerAlways RUNNING
LogPrint a log line
WaitFixed wait
RandWait / RandomSleepRandom wait