🎮 Gamepad Commands

Gamepad Controls

Supported Buttons

Button Name	Aliases	Description
`A`	`SOUTH`	Primary action button
`B`	`EAST`	Secondary action button
`C`	-	Tertiary action button
`X`	`NORTH`	Auxiliary button 1
`Y`	`WEST`	Auxiliary button 2
`Z`	-	Auxiliary button 3
`TL`	-	Top left shoulder button
`TR`	-	Top right shoulder button
`TL2`	-	Left trigger (analog)
`TR2`	-	Right trigger (analog)
`SELECT`	-	Select/back button
`START`	-	Start/menu button
`MODE`	-	Home/guide button
`THUMBL`	-	Left thumbstick click
`THUMBR`	-	Right thumbstick click

D-Pad (Hat) Positions

Position	Description
`CENTER`	Neutral position
`UP`	Up direction
`UP_RIGHT`	Up-right diagonal
`RIGHT`	Right direction
`DOWN_RIGHT`	Down-right diagonal
`DOWN`	Down direction
`DOWN_LEFT`	Down-left diagonal
`LEFT`	Left direction
`UP_LEFT`	Up-left diagonal

Basic Controls

Description: Presses and holds a gamepad button.

Syntax:

pressButton '<button>'

Example:

pressButton 'A'
pressButton 'TL'

Description: Releases a pressed gamepad button.

Syntax:

releaseButton '<button>'

Example:

releaseButton 'B'

Description: Presses and releases a button with specified delay.

Syntax:

tapButton '<button>' <delayMs>

Example:

tapButton 'X' 200  // Press X for 200ms

Description: Sets D-Pad (hat) position.

Syntax:

hat '<position>'

Example:

hat 'UP_LEFT'
hat 'CENTER'  // Returns to neutral

Advanced Controls

Description: Sets left analog stick position (-127 to 127).

Syntax:

leftStick <x> <y>

Example:

leftStick 100 0    // Full right
leftStick 0 -100   // Full up
leftStick 0 0      // Center

Description: Sets right analog stick position (-127 to 127).

Syntax:

rightStick <x> <y>

Example:

rightStick -50 50  // Diagonal left-down

Description: Sets left trigger value (0-255).

Syntax:

leftTrigger <value>

Example:

leftTrigger 255  // Full press

Description: Sets right trigger value (0-255).

Syntax:

rightTrigger <value>

Example:

rightTrigger 128  // Half press

Description: Presses multiple buttons simultaneously.

Syntax:

comboPress '<button1,button2,...>'

Example:

comboPress 'A,B'      // A+B combo
comboPress 'TL,TR'    // Both shoulder buttons

Description: Releases all pressed buttons.

Syntax:

comboRelease

Example:

comboPress 'X,Y'
delay 1000
comboRelease

Special Functions

Description: Rapidly taps a button multiple times.

Syntax:

rapidFire '<button>' <times> <intervalMs>

Example:

rapidFire 'A' 10 100  // Press A 10 times with 100ms intervals

Description: Moves sticks in circular pattern.

Syntax:

sweepSticks <amplitude> <steps> <delayMs>

Example:

sweepSticks 100 36 50  // Full circle with 36 steps

Description: Briefly presses D-Pad direction.

Syntax:

tapDpad '<direction>' <delayMs>

Example:

tapDpad 'UP' 300  // Hold up for 300ms

Description: Resets all controls to neutral state.

Syntax:

reset

Example:

reset  // Centers sticks and releases all buttons

🎮 Gamepad Commands

Gamepad Controls

Supported Buttons

D-Pad (Hat) Positions

Basic Controls

Advanced Controls

Special Functions

On this page