godotengine/godot-docs
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs.git synced 2025-12-31 17:49:03 +03:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #11243 from Calinou/controllers-gamepads-joysticks-sdl3

Browse Source 
Update Controllers, gamepads and joysticks for SDL 3
This commit is contained in:
Matthew
2025-09-09 21:36:07 -04:00
committed by GitHub
parent ab1ec59eec 0b0625ca9d
commit bdeab147cd
1 changed files with 31 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

35
tutorials/inputs/controllers_gamepads_joysticks.rst
View File

@@ -4,7 +4,20 @@ Controllers, gamepads, and joysticks
====================================
Godot supports hundreds of controller models out of the box.
Controllers are supported on Windows, macOS, Linux, Android, iOS, and HTML5.
Controllers are supported on Windows, macOS, Linux, Android, iOS, and Web.
.. note::
Since Godot 4.5, the engine relies on `SDL 3 <https://www.libsdl.org/index.php>`__
for controller support on Windows, macOS, and Linux. This means the list of
supported controllers and their behavior should closely match what is available
in other games and engines using SDL 3. Note that SDL is only used for input,
not for windowing or sound.
Prior to Godot 4.5, the engine used its own controller support code.
This can cause certain controllers to behave incorrectly.
This custom code is still used to support controllers on Android, iOS,
and Web, so it may result in issues appearing only on those platforms.
Note that more specialized devices such as steering wheels, rudder pedals and
`HOTAS <https://en.wikipedia.org/wiki/HOTAS>`__ are less tested and may not
@@ -354,10 +367,24 @@ Controllers can still work without udev support, but it is less reliable as
regular polling must be used to check for controllers being connected or
disconnected during gameplay (hotplugging).
HTML5
^^^^^
Android/iOS
^^^^^^^^^^^
HTML5 controller support is often less reliable compared to "native" platforms.
As described at the top of the page, controller support on mobile platforms relies
on a custom implementation instead of using SDL for input. This means controller
support may be less reliable than on desktop platforms.
Support for SDL-based controller input on mobile platforms is
`planned <https://github.com/godotengine/godot/pull/109645>`__
in a future release.
Web
^^^
Web controller support is often less reliable compared to "native" platforms.
The quality of controller support tends to vary wildly across browsers. As a
result, you may have to instruct your players to use a different browser if they
can't get their controller to work.
Like for mobile platforms, support for SDL-based controller input on the web platform
is `planned <https://github.com/godotengine/godot/pull/109645>`__ in a future release.