Game Controller triggers¶
Controller Button¶
Runs when you press or release a button on a game controller. Great for using a gamepad as a set of extra hotkeys.
| Setting | What to put in |
|---|---|
| Controller | Which controller. Leave empty for any controller. Or type its number like #1, part of its name like "DualSense", or its kind like PS5 or Xbox One. Separate several with commas. |
| Button | Which button: Any, or names separated by commas. South, East, West and North mean the bottom, right, left and top buttons on every gamepad (South is Xbox A or PlayStation Cross). Starts as: Any. |
| When | Pressed reacts when you push the button down. Released reacts when you let go. Both reacts to either. Options: Pressed, Released, Both. Starts as: Pressed. |
Variables you get
| Variable | What it holds |
|---|---|
%button% |
The button's position name, like "South" |
%buttonLabel% |
The name printed on that button for this kind of controller, like "Cross" |
%pressed% |
True when pushed down, false when released |
%holdDurationMs% |
How long it was held, in milliseconds; only when released |
%heldButtons% |
All buttons held down right now, separated by commas |
%controllerName% |
The controller's name |
%controllerIndex% |
The controller's number (#1 is the first one) |
%controllerType% |
The kind of controller, like "PS5" or "Xbox One" |
%batteryPercent% |
The battery level, in percent |
%batteryState% |
Whether it is on battery or charging |
Type id: controller.button
Controller Button Combo¶
Runs when you hold several controller buttons at the same time, like both bumpers. Good for secret shortcuts that cannot be pressed by accident.
| Setting | What to put in |
|---|---|
| Controller | Which controller. Leave empty for any controller. Or type its number like #1, part of its name like "DualSense", or its kind like PS5 or Xbox One. Separate several with commas. |
| Buttons | The buttons to hold together, joined with a plus sign, like "LeftShoulder+RightShoulder". It runs once, when the last of them goes down. Starts as: LeftShoulder+RightShoulder. |
| No other buttons held | Tick to run only when exactly these buttons are held and no others. Untick to also allow other buttons held at the same time. Starts as: false. |
Variables you get
| Variable | What it holds |
|---|---|
%button% |
The button that completed the combo |
%heldButtons% |
All buttons held down right now, separated by commas |
%controllerName% |
The controller's name |
%controllerIndex% |
The controller's number (#1 is the first one) |
%controllerType% |
The kind of controller, like "PS5" or "Xbox One" |
%batteryPercent% |
The battery level, in percent |
%batteryState% |
Whether it is on battery or charging |
Type id: controller.buttonCombo
Controller Connected¶
Runs when a game controller is plugged in or switches on. Handy for a welcome sound or for setting its light colour.
| Setting | What to put in |
|---|---|
| Controller | Which controller. Leave empty for any controller. Or type its number like #1, part of its name like "DualSense", or its kind like PS5 or Xbox One. Separate several with commas. |
Variables you get
| Variable | What it holds |
|---|---|
%controllerName% |
The controller's name |
%controllerIndex% |
The controller's number (#1 is the first one) |
%controllerType% |
The kind of controller, like "PS5" or "Xbox One" |
%batteryPercent% |
The battery level, in percent |
%batteryState% |
Whether it is on battery or charging |
%controllerCount% |
How many controllers are connected now |
Type id: controller.connected
Controller D-pad¶
Runs when you press the D-pad (the cross of four arrows) on a game controller. On a gamepad the D-pad is called Hat1.
| Setting | What to put in |
|---|---|
| Controller | Which controller. Leave empty for any controller. Or type its number like #1, part of its name like "DualSense", or its kind like PS5 or Xbox One. Separate several with commas. |
| Hat | Which D-pad: Hat1 is the normal D-pad on a gamepad. Type Any for all of them. Flight sticks may have Hat2 and more. Starts as: Any. |
| Direction | Which direction to react to: Up, Down, Left, Right, a diagonal like UpLeft, or Centered for when you let go. Any reacts whenever it leaves the middle. Options: Any, Up, Down, Left, Right, UpLeft, UpRight, DownLeft, DownRight, Centered. Starts as: Any. |
Variables you get
| Variable | What it holds |
|---|---|
%hat% |
The D-pad name, like "Hat1" |
%hatDirection% |
The direction now, like "Up" or "Centered" |
%hatPreviousDirection% |
The direction before |
%controllerName% |
The controller's name |
%controllerIndex% |
The controller's number (#1 is the first one) |
%controllerType% |
The kind of controller, like "PS5" or "Xbox One" |
%batteryPercent% |
The battery level, in percent |
%batteryState% |
Whether it is on battery or charging |
Type id: controller.hat
Controller Disconnected¶
Runs when a game controller is unplugged or switches off.
| Setting | What to put in |
|---|---|
| Controller | Which controller. Leave empty for any controller. Or type its number like #1, part of its name like "DualSense", or its kind like PS5 or Xbox One. Separate several with commas. |
Variables you get
| Variable | What it holds |
|---|---|
%controllerName% |
The controller's name |
%controllerIndex% |
The controller's number (#1 is the first one) |
%controllerType% |
The kind of controller, like "PS5" or "Xbox One" |
%batteryPercent% |
The battery level, in percent |
%batteryState% |
Whether it is on battery or charging |
%controllerCount% |
How many controllers are connected now |
Type id: controller.disconnected
Controller stick or trigger¶
Runs when a stick or trigger on a game controller is pushed far enough, or moves at all. An axis is one direction of a stick, or one trigger.
| Setting | What to put in |
|---|---|
| Controller | Which controller. Leave empty for any controller. Or type its number like #1, part of its name like "DualSense", or its kind like PS5 or Xbox One. Separate several with commas. |
| Axis | Which stick direction or trigger. Type Any for all, or names separated by commas: LeftX, LeftY, RightX, RightY, LeftTrigger, RightTrigger. X is left-right, Y is up-down, and down counts as positive. Starts as: Any. |
| Direction | Positive is right, down, or a pulled trigger. Negative is left or up. Either accepts both. Options: Either, Positive, Negative. Starts as: Either. |
| Threshold (%) | How far it must be pushed, in percent of the full way, from 0 to 100. A little wobble near the middle is ignored. Starts as: 50. |
| Fire | Enter runs once when the threshold is passed. Exit runs once when it comes back. While beyond keeps running as long as it stays past the threshold. Any movement runs on every move and ignores threshold and direction. Options: Enter, Exit, While beyond, Any movement. Starts as: Enter. |
Variables you get
| Variable | What it holds |
|---|---|
%axis% |
The axis name, like "LeftX" |
%axisValue% |
How far it is pushed, from -1 to 1 (triggers: 0 to 1) |
%axisPercent% |
The same as a percent, from -100 to 100 |
%axisPrevious% |
The value before this move |
%axisDirection% |
Which side it is on: Positive, Negative or Centered |
%controllerName% |
The controller's name |
%controllerIndex% |
The controller's number (#1 is the first one) |
%controllerType% |
The kind of controller, like "PS5" or "Xbox One" |
%batteryPercent% |
The battery level, in percent |
%batteryState% |
Whether it is on battery or charging |
Type id: controller.axis