Add joypad motion sensors tutorial by Nintorch · Pull Request #11692 · godotengine/godot-docs

Nintorch · 2026-01-28T08:02:21Z

Partially addresses #11466
Follow-up to godotengine/godot#111679

The gyroscope calibration explanation was borrowed from https://github.com/JibbSmart/GamepadMotionHelpers?tab=readme-ov-file#gyro-calibration

TODO:

Accelerometer Z axis
Update according to Fix joypad motion sensors example for C# godot#116241

tutorials/inputs/controller_features.rst

Nintorch · 2026-01-28T10:17:26Z

Thank you for your review, AThousandShips! I will be able to fix the text in the PR soon!

skyace65 · 2026-01-29T00:03:14Z

Might be a bit before this gets merged since it's for 4.7

tutorials/inputs/controller_features.rst

Nintorch · 2026-01-29T18:48:33Z

Thank you for your review, Calinou! I applied your suggestions! :)

tutorials/inputs/controller_features.rst

Meorge

I've included some comments/suggestions I have for improving the flow and wording.

This might be something to take a closer look at later after suggestions have been evaluated, but I felt like the accelerometer section spent longer on background information than the gyroscope section did. It'd probably make sense to restructure them a bit so that they are more consistent with their balance of "theory" (discussing what the sensor is, how it works, etc) and "practice" (examples, code snippets, etc).

tutorials/inputs/controller_features.rst

Nintorch · 2026-02-16T12:28:31Z

Thank you for your review, Meorge! I included your suggestions into the code! :)

By the way, here's the website that I used for gyroscope usage examples: https://www.pcgamingwiki.com/wiki/List_of_games_that_support_tracked_motion_controllers_in_non-VR_gameplay#DualShock_4

Meorge

Added a few more little tweaks/suggestions 🙂

In a few spots I removed instances of things like "we" for succinctness; I don't recall off-hand what the official Godot manual style says about those. If it is indeed supposed to avoid that sort of phrasing, there are a few other spots in here that can be changed.

tutorials/inputs/controller_features.rst

Meorge · 2026-02-24T19:35:46Z

tutorials/inputs/controller_features.rst

+- Movement left and right are reported as **+X** and **-X**.
+- Movement down and up are reported as **+Y** and **-Y**.
+- Movement away from and towards the user are reported as **+Z** and **-Z**.


This looks to be the opposite of the diagram (for example, here it says that left is +X, but the diagram says right is +X). Which one is correct?

The text one is correct.

In that case we should probably reach out to @Cykyrios so they can update the diagram.

I did :D
#11692 (comment)

tutorials/inputs/controller_features.rst

Calinou

Looks good to me in terms of content. I requested some stylistic changes. Also, all tabs should be replaced by 4 spaces in code samples (we currently follow different guidelines in the docs compared to the engine). Trailing whitespace should also be removed.

tutorials/inputs/controller_features.rst

Calinou · 2026-02-24T18:46:04Z

tutorials/inputs/controller_features.rst

+See `the article on GyroWiki here <http://gyrowiki.jibbsmart.com/blog:good-gyro-controls-part-1:the-gyro-is-a-mouse>`
+for information on how to use gyroscope input as a mouse.


Suggested change

See `the article on GyroWiki here <http://gyrowiki.jibbsmart.com/blog:good-gyro-controls-part-1:the-gyro-is-a-mouse>`

for information on how to use gyroscope input as a mouse.

See `the article on GyroWiki <http://gyrowiki.jibbsmart.com/blog:good-gyro-controls-part-1:the-gyro-is-a-mouse>`__

for information on how to use gyroscope input as a mouse.

PS: That website triggers an HTTP-only warning on Firefox in strict mode. @JibbSmart Could you look into setting up HTTPS with e.g. Let's Encrypt? This would avoid the warning.

tutorials/inputs/controller_features.rst

AL2009man · 2026-02-25T02:31:14Z

might wanna include Fortnite as part of the example, given it's one of the biggest multiplayer game to include Gyro Aiming and is set as baseline example on how to do Gyro Aim.

that, and it's created by the person behind GamepadMotionHelper.

tutorials/inputs/controller_features.rst

AThousandShips

LGTM

tutorials/inputs/controller_features.rst

Nintorch · 2026-02-26T09:53:30Z

Thank you for your review, AThousandShips! :)

Co-Authored-By: Malcolm Anderson <malcolminyo@gmail.com> Co-Authored-By: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com> Co-Authored-By: Cyril Bissey <53737317+Cykyrios@users.noreply.github.com> Co-Authored-By: Hugo Locurcio <hugo.locurcio@hugo.pro>

Calinou

Looks good to me.

Nintorch · 2026-02-27T04:15:27Z

Thank you for your review, Calinou! :)

skyace65 · 2026-02-28T21:14:14Z

Thanks!

Nintorch mentioned this pull request Jan 28, 2026

Add support for joypad motion sensors godotengine/godot#111679

Merged

9 tasks

AThousandShips reviewed Jan 28, 2026

View reviewed changes

Nintorch force-pushed the joypad-motion-sensors branch 2 times, most recently from 0d68400 to 8f5a6f0 Compare January 28, 2026 11:06

skyace65 added this to the 4.7 milestone Jan 29, 2026

Calinou requested changes Jan 29, 2026

View reviewed changes

Nintorch force-pushed the joypad-motion-sensors branch from 0039ac9 to 89eb679 Compare January 29, 2026 18:48

skyace65 added enhancement area:manual Issues and PRs related to the Manual/Tutorials section of the documentation labels Feb 1, 2026

Nintorch commented Feb 3, 2026

View reviewed changes

tutorials/inputs/controller_features.rst Outdated Show resolved Hide resolved

Meorge suggested changes Feb 14, 2026

View reviewed changes

Nintorch force-pushed the joypad-motion-sensors branch from f3a3525 to 2169a66 Compare February 16, 2026 12:27

Nintorch force-pushed the joypad-motion-sensors branch from 2169a66 to cad3aaf Compare February 16, 2026 12:43

Meorge reviewed Feb 16, 2026

View reviewed changes

Cykyrios mentioned this pull request Feb 17, 2026

Document mobile motion and orientation sensor axes godotengine/godot#113635

Open

3 tasks

AThousandShips reviewed Feb 17, 2026

View reviewed changes

Nintorch force-pushed the joypad-motion-sensors branch from cad3aaf to 0220b24 Compare February 17, 2026 18:13

Nintorch requested a review from Calinou February 24, 2026 13:30

Meorge suggested changes Feb 24, 2026

View reviewed changes

Calinou requested changes Feb 24, 2026

View reviewed changes

AThousandShips reviewed Feb 25, 2026

View reviewed changes

tutorials/inputs/controller_features.rst Outdated Show resolved Hide resolved

Nintorch force-pushed the joypad-motion-sensors branch from 0220b24 to e4d9d98 Compare February 26, 2026 07:03

Nintorch requested a review from Calinou February 26, 2026 07:05

Nintorch force-pushed the joypad-motion-sensors branch 2 times, most recently from 89bec82 to f9cc280 Compare February 26, 2026 07:09

AThousandShips approved these changes Feb 26, 2026

View reviewed changes

tutorials/inputs/controller_features.rst Outdated Show resolved Hide resolved

Nintorch force-pushed the joypad-motion-sensors branch from f9cc280 to 4848b70 Compare February 26, 2026 10:04

Calinou approved these changes Feb 26, 2026

View reviewed changes

skyace65 approved these changes Feb 28, 2026

View reviewed changes

skyace65 merged commit 10eee18 into godotengine:master Feb 28, 2026
1 check passed

Nintorch deleted the joypad-motion-sensors branch March 1, 2026 04:42

		See `the article on GyroWiki here <http://gyrowiki.jibbsmart.com/blog:good-gyro-controls-part-1:the-gyro-is-a-mouse>`
		for information on how to use gyroscope input as a mouse.

Uh oh!

Conversation

Nintorch commented Jan 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Nintorch commented Jan 28, 2026

Uh oh!

skyace65 commented Jan 29, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Nintorch commented Jan 29, 2026

Uh oh!

Uh oh!

Meorge left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Nintorch commented Feb 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Meorge left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Meorge Feb 24, 2026

Choose a reason for hiding this comment

Uh oh!

Nintorch Feb 25, 2026

Choose a reason for hiding this comment

Uh oh!

Meorge Feb 25, 2026

Choose a reason for hiding this comment

Uh oh!

Nintorch Feb 25, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Calinou left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Nintorch commented Jan 28, 2026 •

edited

Loading

Nintorch commented Feb 16, 2026 •

edited

Loading

AL2009man commented Feb 25, 2026 •

edited

Loading