godotengine/godot-docs
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs.git synced 2026-01-03 05:48:42 +03:00
Code Issues Packages Projects Releases Wiki Activity

Point mapping contributions to Godot in Controllers, gamepads and joysticks

Browse Source 
GameControllerDB's upstream does not accept contributions from Godot
since it does not use SDL. Users can still create custom mappings,
but they should be submitted to Godot's controller database instead
of the SDL one.

This also adds a reference to `godotcontrollerdb.txt` which was missing
in the first place. This file is used as a complement to `gamecontrollerdb.txt`.
This commit is contained in:
Hugo Locurcio
2025-01-29 11:09:11 +01:00
parent 3a424470fe
commit cbdec4e72e
1 changed files with 8 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
tutorials/inputs/controllers_gamepads_joysticks.rst
View File

@@ -3,9 +3,7 @@
Controllers, gamepads, and joysticks
====================================
Godot supports hundreds of controller models thanks to the community-sourced
`SDL game controller database <https://github.com/gabomdq/SDL_GameControllerDB>`__.
Godot supports hundreds of controller models out of the box.
Controllers are supported on Windows, macOS, Linux, Android, iOS, and HTML5.
Note that more specialized devices such as steering wheels, rudder pedals and
@@ -306,9 +304,9 @@ After updating the controller's firmware, unpair the controller and pair it agai
with your PC if you are using the controller in wireless mode.
If buttons are incorrectly mapped, this may be due to an erroneous mapping from
the `SDL game controller database <https://github.com/gabomdq/SDL_GameControllerDB>`__.
You can contribute an updated mapping to be included in the next Godot version
by opening a pull request on the linked repository.
the SDL game controller database used by Godot or the
`Godot game controller database <https://github.com/godotengine/godot/blob/master/core/input/godotcontrollerdb.txt>`__.
In this case, you will need to create a custom mapping for your controller.
There are many ways to create mappings. One option is to use the mapping wizard
in the `official Joypads demo <https://godotengine.org/asset-library/asset/2785>`__.
@@ -336,6 +334,10 @@ additional controller mappings, you can add them by calling
:ref:`Input.add_joy_mapping() <class_Input_method_add_joy_mapping>`
as early as possible in a script's ``_ready()`` function.
Once you are satisfied with the custom mapping, you can contribute it for
the next Godot version by opening a pull request on the
`Godot game controller database <https://github.com/godotengine/godot/blob/master/core/input/godotcontrollerdb.txt>`__.
My controller works on a given platform, but not on another platform.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~