RETURN OF THE SAIYANS / RoTS Helper

Script Reference

RoTS scripts use a bounded, ElfBot-style command language in Hotkeys, Shortkeys and Cavebot Actions. This reference lists reviewed RoTS commands for release 1.0.36; it does not execute arbitrary Lua.

Published version 1.0.36

QUICK START

How scripts look

Select a taskselecttask "Bear"

Function-style syntaxselectTask("Dark Wolf")

Wait for task confirmationselecttask "Bear" | say "Task selected"

Cancel one named taskcanceltask "Rat"

Cancel, then choose another taskcancelTask("Rat") | wait 1000 | selectTask("Bear")

COMMANDS & VALUES

Find a script command

Commands do something. Values starting with $ can be used in conditions and expressions.

Search this helper

Tablet tasks

selecttask "TASK NAME"

Select a CC BioTech Lab task by its exact name, ignoring letter case. Requests the current list and uses the server-provided task ID, without opening the tablet yourself or requiring you to stand in the lab. Native server responses may update the tablet. Room unlocks, minimum level and available slots still apply. Waits for server confirmation before continuing; a failed or timed-out selection ends the remaining script. Does not cancel tasks or claim rewards.

selectTask("TASK NAME")

Function-style alias of selecttask, for example selectTask("Bear"). Quote names containing spaces. This is a supported script command, not a g_game.selectTask Lua API. An already selected task is reused without sending another pick-up request.

canceltask "TASK NAME"

Cancel exactly one named in-progress task, ignoring letter case. WARNING: cancellation discards its progress. Reads a fresh native active-task snapshot even if the tablet is closed, uses that active task ID, and refreshes again to confirm removal before continuing. Missing, ambiguous or completed tasks are not cancelled. Other tasks and rewards are unchanged. A failed or timed-out cancellation ends the remaining script.

cancelTask("TASK NAME")

Function-style alias of canceltask, for example cancelTask("Rat"). Use wait 1000 before a following selecttask to respect the native request cooldown. Completed tasks must be claimed through the normal tablet; this command never claims rewards.

Script flow

COMMAND | COMMAND

Run commands in sequence. Task selection and cancellation wait for confirmation before the next command.

wait MS

Wait the specified number of milliseconds before continuing the script.

if [EXPRESSION] COMMAND

Run COMMAND only when the expression is true; comparisons, arithmetic, && and || are supported.

ifnot [EXPRESSION] COMMAND

Run COMMAND only when the expression is false.

auto DELAY COMMAND

Repeat a Hotkey or Shortkey script at the given interval. Use task selection as a one-shot Cavebot Action or hotkey rather than polling it repeatedly.

Game and helper

say TEXT

Send TEXT through game chat.

log TEXT

Show a helper script status message.

fasttarget

Use the RoTS battle module to select its first target.

nexttarget

Use the RoTS battle module to select its next target.

settargeting VALUE

Enable, disable or toggle helper Targeting with on, off or toggle.

setcavebot VALUE

Enable, disable or toggle Cavebot with on, off or toggle.

gotolabel "LABEL"

Jump to a Cavebot waypoint with this custom label.

Read-only values

$connected

1 while connected to the game, otherwise 0.

$hppc

Your local character health percentage.

$level

Your local character level.

$posx · $posy · $posz

Your local character map coordinates and floor.

Use selecttask "Bear" or canceltask "Rat" in a Hotkey, Shortkey or Cavebot Action. Cancellation loses task progress; completed tasks are protected. Each response phase has a 5-second timeout, and cancellation requests are spaced by at least 1 second. The helper never fabricates task IDs, bypasses unlocks or claims success without a server response. The server supplies kills and maxKills for task progress; checking progress and claiming rewards are not script commands in this release.