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).

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.