Skip to content

Gamepads (controllers)

Add support for gamepads (or other controllers) to your game, giving access to information such as button presses, axis positions, trigger pressure, etc...

Authors and contributors to this community extension: Bouh, lhphr, ZachjuKamashi.


Add support for gamepads (or other controllers).

It gives access to:

  • button presses
  • axis positions and force
  • trigger pressure
  • configurable deadzone
  • vibration
  • automatic mappers for platformer characters and top-down movement

The Bomberman-like example handles 4 players with gamepads (open the project online).

Read more...

Tip

Learn how to install new extensions by following a step-by-step guide.

Actions

Advanced gamepad vibration
Generate an advanced vibration on the specified controller. Incompatible with Firefox.

Change gamepad active vibration
Change a vibration on the specified controller. Incompatible with Firefox.

Set gamepad deadzone for sticks
Set the deadzone for sticks of the gamepad. The deadzone is an area for which movement on sticks won't be taken into account (instead, the stick will be considered as not moved). Deadzone is between 0 and 1, and is by default 0.2.

Gamepad vibration
Generate a vibration on the specified controller. Might only work if the game is running in a recent web browser.

Conditions

Any gamepad button pressed
Check if any button is pressed on a gamepad.

Gamepad stick pushed (axis)
Check if a stick of a gamepad is pushed in a given direction.

Gamepad button pressed
Check if a button is pressed on a gamepad.
Buttons can be: * Xbox: "A", "B", "X", "Y", "LB", "RB", "LT", "RT", "BACK", "START", * PS4: "CROSS", "SQUARE", "CIRCLE", "TRIANGLE", "L1", "L2", "R1", "R2", "SHARE", "OPTIONS", "PS_BUTTON", "CLICK_TOUCHPAD", * Other: "UP", "DOWN", "LEFT", "RIGHT", "CLICK_STICK_LEFT", "CLICK_STICK_RIGHT".

Gamepad button released
Test if a button is released on a gamepad. Buttons can be:
* Xbox: "A", "B", "X", "Y", "LB", "RB", "LT", "RT", "BACK", "START", * PS4: "CROSS", "SQUARE", "CIRCLE", "TRIANGLE", "L1", "L2", "R1", "R2", "SHARE", "OPTIONS", "PS_BUTTON", "CLICK_TOUCHPAD", * Other: "UP", "DOWN", "LEFT", "RIGHT", "CLICK_STICK_LEFT", "CLICK_STICK_RIGHT".

Gamepad connected
Check if a gamepad is connected.

Gamepad type
Check if the specified gamepad has the specified information in its description. Useful to know if the gamepad is a Xbox or PS4 controller.

Any gamepad button released
Check if any button is released on a gamepad.

Stick force
Compare the force of gamepad stick (from 0 to 1).

Expressions

Expression Description
Gamepads::ConnectedGamepadsCount() Return the number of connected gamepads.
Gamepads::Deadzone(number) Return the value of the deadzone applied to a gamepad sticks, between 0 and 1.
number The gamepad identifier: 1, 2, 3 or 4
Gamepads::GamepadCount() Return the number of gamepads.
Gamepads::GamepadType(number) Return a string containing informations about the specified gamepad.
number The gamepad identifier: 1, 2, 3 or 4
Gamepads::LastButtonID(number) Return the index of the last pressed button of a gamepad.
number The gamepad identifier: 1, 2, 3 or 4
Gamepads::LastButtonString(number, string) Return the last button pressed. Buttons for Xbox and PS4 can be: Xbox: "A", "B", "X", "Y", "LB", "RB", "LT", "RT", "BACK", "START", PS4: "CROSS", "SQUARE", "CIRCLE", "TRIANGLE", "L1", "L2", "R1", "R2", "SHARE", "OPTIONS", "PS_BUTTON", "CLICK_TOUCHPAD",* Both: "UP", "DOWN", "LEFT", "RIGHT", "CLICK_STICK_LEFT", "CLICK_STICK_RIGHT".
number The gamepad identifier: 1, 2, 3 or 4
string Controller type
Gamepads::StickAngle(number, string) Return the angle of a gamepad stick.If the deadzone value is high, the angle value is rounded to main axes, left, left, up, down.An zero deadzone value give a total freedom on the angle value.
number The gamepad identifier: 1, 2, 3 or 4
string Stick: "Left" or "Right"
Gamepads::StickForce(number, string) Return the force of gamepad stick (from 0 to 1).
number The gamepad identifier: 1, 2, 3 or 4
string Stick: "Left" or "Right"
Gamepads::StickForceX(number, string) Return the gamepad stick force on X axis (from -1 at the left to 1 at the right).
number The gamepad identifier: 1, 2, 3 or 4
string Stick: "Left" or "Right"
Gamepads::StickForceY(number, string) Return the gamepad stick force on Y axis (from -1 at the top to 1 at the bottom).
number The gamepad identifier: 1, 2, 3 or 4
string Stick: "Left" or "Right"
Gamepads::StrongVibrationMagnitude(number) Return the strength of the strong vibration motor on the gamepad of a player.
number The gamepad identifier: 1, 2, 3 or 4
Gamepads::TriggerPressure(number, string) Get the value of the pressure on a gamepad trigger.
number The gamepad identifier: 1, 2, 3 or 4
string Trigger button
Gamepads::WeakVibrationMagnitude(number) Return the strength of the weak vibration motor on the gamepad of a player.
number The gamepad identifier: 1, 2, 3 or 4

Platformer gamepad mapper

Control a platformer character with a gamepad.

No expressions for this behavior.

Top-down gamepad mapper

Control a top-down character with a gamepad.

No expressions for this behavior.


This page is an auto-generated reference page about the Gamepads (controllers) extension, made by the community of GDevelop, the open-source, cross-platform game engine designed for everyone. Learn more about all GDevelop community-made extensions here.