godot-docs icon indicating copy to clipboard operation
godot-docs copied to clipboard

Add documentation for joypad features (LEDs, adaptive triggers, motion controls, etc)

Open Meorge opened this issue 1 month ago • 3 comments

Your Godot version: 4.6

Issue description: With Godot 4.6, thanks to the efforts of @Nintorch, special joypad features will be supported. These include:

  • https://github.com/godotengine/godot/pull/111681
  • https://github.com/godotengine/godot/pull/111682
  • https://github.com/godotengine/godot/pull/111714
  • https://github.com/godotengine/godot/pull/111679
  • https://github.com/godotengine/godot/pull/112680

These new methods will be documented in the class reference, but otherwise will remain somewhat hidden. I think we could add a page titled something like "Joypad-specific features" that describes these capabilities in greater detail, with code examples and diagrams as necessary.

This applies especially to the adaptive triggers feature; while I tried to describe them as well as I could in my PR suggestions for the class reference, I think diagrams like I included here would go a long way for helping people understand how each mode works.

[!note] I'm not sure how far out we are from 4.6 feature freeze at this point, and thus how likely all of these features are to be merged in time for it. If some of them don't make it, we will certainly need to break this new page into parts so that we aren't advertising non-existent methods in 4.6.

URL to the documentation page (if already existing): https://docs.godotengine.org/en/stable/tutorials/inputs/controllers_gamepads_joysticks.html (possibly?)

Meorge avatar Nov 14 '25 17:11 Meorge

That would be awesome! :D Also, now there's one more PR :) https://github.com/godotengine/godot/pull/112680

Nintorch avatar Nov 14 '25 17:11 Nintorch

Added it to the list!

I'd be happy to work on a draft for this, if you're OK with it and think it makes sense; if you would prefer to write it though, I wouldn't want to take it from you 😄

Meorge avatar Nov 14 '25 17:11 Meorge

Added it to the list!

I'd be happy to work on a draft for this, if you're OK with it and think it makes sense; if you would prefer to write it though, I wouldn't want to take it from you 😄

That would be nice, thank you! I wish I could try to make a draft too, but I'm currently quite busy with university stuff, so I don't have too much free time 😅

Nintorch avatar Nov 14 '25 17:11 Nintorch