From cbdec4e72efdedc7cccf7e2b069fda31b2b92ef6 Mon Sep 17 00:00:00 2001 From: Hugo Locurcio Date: Wed, 29 Jan 2025 11:09:11 +0100 Subject: [PATCH] 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`. --- .../inputs/controllers_gamepads_joysticks.rst | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/tutorials/inputs/controllers_gamepads_joysticks.rst b/tutorials/inputs/controllers_gamepads_joysticks.rst index 05ed81bd3..b541aa60d 100644 --- a/tutorials/inputs/controllers_gamepads_joysticks.rst +++ b/tutorials/inputs/controllers_gamepads_joysticks.rst @@ -3,9 +3,7 @@ Controllers, gamepads, and joysticks ==================================== -Godot supports hundreds of controller models thanks to the community-sourced -`SDL game controller database `__. - +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 `__. -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 `__. +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 `__. @@ -336,6 +334,10 @@ additional controller mappings, you can add them by calling :ref:`Input.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 `__. + My controller works on a given platform, but not on another platform. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~