Commands

Overview

Commands are a way to communicate with the script to change settings such as speed, and enacting actions such as walking.

To run a command, go to the programmable block in the terminal, change the Argument, and press Run.

Syntax

Commands follow the format command argument, when [brackets] specify an optional argument and <lesser/greater> signs are required arguments.

For any command that involves changing settings with numbers e.g. [value], you can set, add, or subtract a number from it.

• To set a value, use =<number>, such as: stepspeed =3
• To add a value, use +<number>, such as: stepspeed +3
• To subtract a value, use -<number>, such as: stepspeed -3

For any command that involves [toggle], being a boolean (true/false):

• To toggle, use toggle or leave it blank
• To toggle on, use on or true
• To toggle off, use off or false

Any argument not stated here will be explained in the command's description.

Command List

Setup & Utilities

• apply
  • Applies any settings changed with commands to the configurations, good for adjusting settings and locking them in
• setup [toggle]
  • Toggle setup mode; basically like running "reload" constantly with the side effect of being more performance heavy
• reload
  • Reload all the blocks and their associated configurations

  • NOTE: This is REQUIRED for leg/arm custom data configurations to take effect; alternatively use setup mode

  • NOTE: For the programmable block's custom data, a reload or recompile is required; alternatively use setup mode

• autorename [placeholder]
  • Rename all leg blocks based on a template, read more here.
• autotag
  • Finds all blocks based on cockpit's position (relative to the cockpit's forward/backwards)

  • NOTE: Doesn't support strafe joints

• autotype <type>
  • Automatically retype all legs, want to switch to Chicken walker? Use autotype 2

Movement

• walk [forwards/backwards]
  • Toggle walk override, if no argument is provided, it will toggle between walking forwards and halting; if an argument is provided, it will toggle between that direction and halting
• halt
  • Stops walking
• crouch [toggle]
  • Toggle crouch
• turn [value]
  • Change turn override, -1 is left, 1 is right, 0 is halt (default)
• thrusters [toggle]
  • Toggle thrusters
• vtol [toggle]
  • Toggle thruster vtol mode
• hover [toggle]
  • Toggle thruster mode, default toggles between Override and Hover, otherwise, on is hover, off is override

Joints & Arms

• twist [degrees]
  • Set the torso twist rotors to go to the degrees specified 0 to 360, by default 0 if no value is provided
  • This also follows the [value] standard, so ex: twist =0 to zero, twist +5 to add 5 to the current rotation
  • Additive/subtractive rotations are based on the current twist(s) average rotation, not the current target rotation
• arm
  • Reset arms to their default zeros
• armcontrol [toggle]
  • Toggle arm control
• legcontrol [toggle]
  • Toggle leg control
• stabilizationcontrol [toggle]
  • Toggle stabilization control

Settings

• stepspeed [value]
  • Change walk speed
• crouchspeed [value]
  • Change crouch speed
• standingdistance [value]
  • Change standing distance -- leg specific
• standingheight [value]
  • Change standing height -- multiplier for how far the legs reach down
• steplength [value]
  • Change step length -- how far the feet will travel
• stepheight [value]
  • Change step height -- how far the feet lift off the ground
• croucheight [value]
  • Change crouch height -- how far the mech crouches
• strafedistance [value]
  • Change strafe distance -- how far the mech strafes, like step length
• standinglean [value]
  • Change standing lean -- how far the foot "leans" forward/back
• standingwidth [value]
  • Change standing lean -- how far the foot "leans" left/right
• autohalt [toggle]
  • Toggle autohalt -- when true, mech will slow down when no movement is being held; when false, no such throttle "decay" is had

Miscellaneous

• limp [toggle]
  • Turn off rotors and other leg blocks for a limp effect