Mantis Command Reference

Mantis Language · Complete Syntax & Command Cheat Sheet

Every command currently supported in Mantis, grouped by functional category with links to dedicated reference pages.

Core commands

Command	Syntax	What It Does	Dedicated Guide
`STRING`	`STRING text`	Types text exactly as written.	STRING Guide
`STRINGLN`	`STRINGLN text`	Types text, then presses Enter.	STRINGLN Guide
`FAST_STRING` (Pro)	`FAST_STRING text`	Types text via batched HID codes at maximum speed.	FAST_STRING Guide
`STRING_BLOCK`	`STRING_BLOCK ... END_STRING`	Types multiple lines collapsed into one.	Strings Guide
`DELAY`	`DELAY ms`	Pauses the script.	DELAY Guide
`SET_DELAY`	`SET_DELAY ms`	Sets fixed per-keystroke pacing.	SET_DELAY Guide
`SET_SPEED`	`SET_SPEED speed`	Sets per-keystroke pacing via preset (e.g. `$Random`, `$Human`).	SET_SPEED Guide
`DEFINE`	`DEFINE name type value`	Declares a compile-time constant.	DEFINE Guide
`REM`	`REM comment`	Comment — stripped during compilation.	REM Guide
`LOOP`	`LOOP [count] ... END_LOOP`	Repeats a block infinitely or a finite number of times.	LOOP Guide
`BREAK`	`BREAK`	Exits the current loop early.	LOOP Guide
`CONTINUE`	`CONTINUE`	Skips to the next iteration of the loop.	LOOP Guide
`IF / ELSE`	`IF cond THEN ... END_IF`	Branching based on a condition (`BUTTON_PRESSED`, `TRUE`).	IF & ELSE Guide
`LED_ON` / `LED_OFF`	`LED_ON` / `LED_OFF`	Scriptable onboard status LED control.	LED Guide
`WAIT_FOR_BUTTON_PRESS`	`WAIT_FOR_BUTTON_PRESS`	Pauses until the onboard button is pressed.	Button Guide
`BUTTON_DEF`	`BUTTON_DEF ... END_BUTTON`	Defines an on-press handler block.	BUTTON_DEF Guide
`FUNCTION`	`FUNCTION name() ... END_FUNCTION`	Defines a reusable named block.	FUNCTION Guide
Function call	`name()`	Runs a previously defined function.	FUNCTION Guide
`ATTACKMODE`	`ATTACKMODE mode`	Configures USB CDC/HID/OFF modes.	ATTACKMODE Guide
`INJECT_MOD`	`INJECT_MOD modifier`	Directly injects raw modifier bitmasks.	INJECT_MOD Guide

Examples

Related commands are grouped into one runnable example where it makes sense; standalone commands get their own.

STRING / STRINGLN / FAST_STRING / STRING_BLOCK

STRING Hello
STRINGLN Hello
FAST_STRING Hello
STRING_BLOCK
This block spans three source lines
but types as one.
END_STRING

hello.mantis

1STRING Hello
2STRINGLN Hello
3FAST_STRING Hello
4STRING_BLOCK
5This block spans three source lines
6but types as one.
7END_STRING

DELAY / SET_DELAY / SET_SPEED

DELAY 500
SET_DELAY 30
SET_SPEED $Human
SET_SPEED $Random

hello.mantis

1DELAY 500
2SET_DELAY 30
3SET_SPEED $Human
4SET_SPEED $Random

DEFINE

DEFINE #NAME STR Karvi
STRINGLN Hello #NAME

hello.mantis

1DEFINE #NAME STR Karvi
2STRINGLN Hello #NAME

LOOP / BREAK / CONTINUE

LOOP 10
IF BUTTON_PRESSED THEN
  BREAK
END_IF
STRING .
DELAY 300
END_LOOP

hello.mantis

1LOOP 10
2IF BUTTON_PRESSED THEN
3  BREAK
4END_IF
5STRING .
6DELAY 300
7END_LOOP

IF / ELSE

IF BUTTON_PRESSED THEN
  STRINGLN Button is pressed!
ELSE
  STRINGLN Button is released.
END_IF

hello.mantis

1IF BUTTON_PRESSED THEN
2  STRINGLN Button is pressed!
3ELSE
4  STRINGLN Button is released.
5END_IF

LED_ON / LED_OFF

LED_ON
DELAY 300
LED_OFF

hello.mantis

1LED_ON
2DELAY 300
3LED_OFF

WAIT_FOR_BUTTON_PRESS

STRING Waiting...
WAIT_FOR_BUTTON_PRESS
STRINGLN Button pressed, continuing.

hello.mantis

1STRING Waiting...
2WAIT_FOR_BUTTON_PRESS
3STRINGLN Button pressed, continuing.

FUNCTION … END_FUNCTION / name()

FUNCTION greet()
STRINGLN Hello from a function!
END_FUNCTION

greet()
greet()

hello.mantis

1FUNCTION greet()
2STRINGLN Hello from a function!
3END_FUNCTION
4
5greet()
6greet()

BUTTON_DEF … END_BUTTON

BUTTON_DEF
STRINGLN You pressed the button!
END_BUTTON

hello.mantis

1BUTTON_DEF
2STRINGLN You pressed the button!
3END_BUTTON

ATTACKMODE / INJECT_MOD

ATTACKMODE HID
INJECT_MOD CTRL ALT

hello.mantis

1ATTACKMODE HID
2INJECT_MOD CTRL ALT

Keys & modifiers

See Keyboard commands for the full key and modifier tables and examples.

Pro / roadmap

Reserved for a future release — not available in the base Mantis firmware today:

Name	Note
Serial / CDC scripting	Planned commands for scripting the device’s serial (USB CDC) channel directly.