Gamepad Commands

Presses and holds a button. See the button reference below.

pressButton 'A'
pressButton 'TL'

Releases a single held button.

releaseButton 'B'

Presses a button, waits delayMs, then releases it.

tapButton 'X' 200

Presses several buttons at once. Names are joined with commas (unlike the keyboard's comboKey, which uses +).

comboPress 'A,B'
comboPress 'TL,TR'

Releases all currently pressed buttons. It takes no arguments — there is no selective release. This is equivalent to reset for buttons.

comboPress 'X,Y'
delay 1000
comboRelease

Taps a button times times, waiting intervalMs between taps.

rapidFire 'A' 10 100

Sets the left stick position. Both axes are 8‑bit signed (-128–127).

leftStick 100 0
leftStick 0 -100
leftStick 0 0

Sets the right stick position (z/rz axes), 8‑bit signed each.

rightStick -50 50

Sets the left analog trigger (rx) value, 8‑bit signed.

leftTrigger 127
leftTrigger -128

Sets the right analog trigger (ry) value, 8‑bit signed.

rightTrigger 64
rightTrigger -64

Moves both sticks in a circular sweep of amplitude, over steps steps, pausing delayMs between steps.

sweepSticks 100 36 50

Sets the D‑pad (hat) position. See the hat reference below.

hat 'UP_LEFT'
hat 'CENTER'

Presses a hat direction, waits delayMs, then returns to CENTER.

tapDpad 'UP' 300