#Controller & input
The controller, makcu, mouse, and keyboard objects expose the current input device state. Use them to read what the user is pressing — for example, to gate aim-assist on a button hold.
#controller
Gamepad button and stick state.
#Triggers & bumpers
| Property |
Description |
controller.lt |
L2 / left trigger (0 or 1, or analog if setTrigger is used). |
controller.rt |
R2 / right trigger. |
controller.lb |
L1 / left bumper. |
controller.rb |
R1 / right bumper. |
#Sticks
| Property |
Description |
controller.l3 |
Left stick click. |
controller.r3 |
Right stick click. |
controller.leftStickX / .leftStickY |
Left stick axis values, -100 to +100. |
controller.rightStickX / .rightStickY |
Right stick axis values. |
#Face buttons
| Property |
Description |
controller.cross |
Cross / A |
controller.circle |
Circle / B |
controller.square |
Square / X |
controller.triangle |
Triangle / Y |
D-Pad & menu
| Property |
Description |
controller.up / .down / .left / .right |
D-pad directions. |
controller.start |
Start / Options. |
controller.back |
Back / Share. |
#makcu
When device == "makcu", the makcu object exposes mouse button state.
| Property |
Description |
makcu.left |
Left mouse button. |
makcu.right |
Right mouse button (commonly used for ADS). |
makcu.middle |
Middle mouse button. |
makcu.button4 |
Mouse button 4. |
makcu.button5 |
Mouse button 5. |
#Reading input
function getAds() {
if (device == "makcu") {
return makcu.right;
}
return controller.lt;
}
if (getAds()) {
// ADS button held — run aim assist
}
#Output functions
Scripts can also push values back to the input device. Output functions all return 0.
| Function |
Description |
setButton(name, value) |
Set gamepad button (0 / 1). Names: lt, rt, lb, rb, cross, circle, square, triangle, etc. |
setTrigger(name, value) |
Set analog trigger (0–100). Name: lt or rt. |
setStick(name, x, y) or setStick(name, value) |
Set stick position (±100). Name: left / right, or axis-specific (leftX, rightY, etc.). |
setMouseButton(name, value) |
Set mouse button. Names: left, right, middle, button4, button5. |
setKey(name, value) |
Set keyboard key. |
makcuPress(button) / makcuRelease(button) |
Press / release makcu mouse buttons 1–5. |
// Hold ADS while target is in view
if (confidence > 0.7) {
setMouseButton("right", 1);
} else {
setMouseButton("right", 0);
}
