Skip to content

Commit cbdec4e

Browse files
committed
Point mapping contributions to Godot in Controllers, gamepads and joysticks
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`.
1 parent 3a42447 commit cbdec4e

File tree

1 file changed

+8
-6
lines changed

1 file changed

+8
-6
lines changed

tutorials/inputs/controllers_gamepads_joysticks.rst

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,7 @@
33
Controllers, gamepads, and joysticks
44
====================================
55

6-
Godot supports hundreds of controller models thanks to the community-sourced
7-
`SDL game controller database <https://github.com/gabomdq/SDL_GameControllerDB>`__.
8-
6+
Godot supports hundreds of controller models out of the box.
97
Controllers are supported on Windows, macOS, Linux, Android, iOS, and HTML5.
108

119
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
306304
with your PC if you are using the controller in wireless mode.
307305

308306
If buttons are incorrectly mapped, this may be due to an erroneous mapping from
309-
the `SDL game controller database <https://github.com/gabomdq/SDL_GameControllerDB>`__.
310-
You can contribute an updated mapping to be included in the next Godot version
311-
by opening a pull request on the linked repository.
307+
the SDL game controller database used by Godot or the
308+
`Godot game controller database <https://github.com/godotengine/godot/blob/master/core/input/godotcontrollerdb.txt>`__.
309+
In this case, you will need to create a custom mapping for your controller.
312310

313311
There are many ways to create mappings. One option is to use the mapping wizard
314312
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
336334
:ref:`Input.add_joy_mapping() <class_Input_method_add_joy_mapping>`
337335
as early as possible in a script's ``_ready()`` function.
338336

337+
Once you are satisfied with the custom mapping, you can contribute it for
338+
the next Godot version by opening a pull request on the
339+
`Godot game controller database <https://github.com/godotengine/godot/blob/master/core/input/godotcontrollerdb.txt>`__.
340+
339341
My controller works on a given platform, but not on another platform.
340342
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
341343

0 commit comments

Comments
 (0)