Skip to content

[Auto] [Improve] Fixed device sensor units, rotation typo, and swapped 3D gamepad mapper names #503

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
github-actions wants to merge 1 commit into
base: main
Choose a base branch
from
Open

[Auto] [Improve] Fixed device sensor units, rotation typo, and swapped 3D gamepad mapper names #503

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions automated_updates_data.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -68,6 +68,10 @@
{
"date": "2026-03-05",
"summary": "Improved network docs: updated to async single-URL API, added HTTP methods, error variable, CORS warning, content type info, and Open URL action"
},
{
"date": "2026-03-08",
"summary": "Fixed device-sensors docs: corrected rotation unit from m/s² to °/s, fixed 'beta' typo to 'gamma', added gravity note; fixed swapped gamepad mapper names in physics3d docs"
}
]
}
20 changes: 12 additions & 8 deletions docs/gdevelop5/all-features/device-sensors/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,11 @@ The "gamma" rotation.

## Motion sensor

In contrast to the orientation sensor which returns absolute values, the motion sensor delivers relative ones. This sensor only returns values while the device is moving. If you hold it still, no matter its orientation, the sensor will return 0. You can access the motion data along an axis via the "x", "y", "z" values and the rotation data around an axis via "alpha", "beta" and "gamma" which are explained in the next section.
In contrast to the orientation sensor which returns absolute values, the motion sensor delivers relative ones. You can access the motion data along an axis via the "x", "y", "z" values and the rotation data around an axis via "alpha", "beta" and "gamma" which are explained in the next section.

!!! note

The acceleration values include the effect of gravity. For example, a phone lying flat on a table will report approximately 9.8 m/s² on the Z-axis even when completely still.

!!! note

Expand Down Expand Up @@ -125,7 +129,7 @@ This value shows the acceleration around the x-axis. If you hold your device in

![](/gdevelop5/all-features/motion_gamma.png)

This value shows the acceleration around the y-axis. If you hold your device in portrait mode with a hand on each side, you can turn your device around the y-axis and the beta value will increase.
This value shows the acceleration around the y-axis. If you hold your device in portrait mode with a hand on each side, you can turn your device around the y-axis and the gamma value will increase.

### Conditions

Expand All @@ -147,15 +151,15 @@ This condition lets you compare the value of z-acceleration to a number or varia

**Motion Alpha**

This condition lets you compare the value of alpha to a number or variable. (m/s²)
This condition lets you compare the rotation rate alpha to a number or variable. (°/s)

**Motion Beta**

This condition lets you compare the value of beta to a number or variable. (m/s²)
This condition lets you compare the rotation rate beta to a number or variable. (°/s)

**Motion Gamma**

This condition lets you compare the value of gamma to a number or variable. (m/s²)
This condition lets you compare the rotation rate gamma to a number or variable. (°/s)

### Actions

Expand Down Expand Up @@ -183,14 +187,14 @@ The "z" acceleration. (m/s²)

**Alpha Value**

The "alpha" rotation. (m/s²)
The "alpha" rotation rate. (°/s)

**Beta Value**

The "beta" rotation. (m/s²)
The "beta" rotation rate. (°/s)

**Gamma Value**

The "gamma" rotation. (m/s²)
The "gamma" rotation rate. (°/s)

![](/gdevelop5/all-features/devicesensorsevents.png)
4 changes: 2 additions & 2 deletions docs/gdevelop5/behaviors/physics3d/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ These behaviors make the character move according to player inputs automatically

* [3D platformer keyboard mapper](/gdevelop5/extensions/physics-character3dkey-mapper)
* [3D platformer multitouch controller mapper](/gdevelop5/objects/multitouch-joystick)
* [3D shooter gamepad mapper](/gdevelop5/all-features/gamepad/)
* [3D platformer gamepad mapper](/gdevelop5/all-features/gamepad/)

[Open example in GDevelop](https://editor.gdevelop.io/?project=example://3d-platformer){ .md-button .md-button--primary }

Expand All @@ -64,7 +64,7 @@ These behaviors make the character move according to player inputs automatically

* [3D shooter keyboard mapper](/gdevelop5/extensions/physics-character3dkey-mapper) and [First person camera mouse mapper](/gdevelop5/extensions/mouse-pointer-lock/#first-person-camera-mouse-mapper)
* [3D shooter multitouch controller mapper](/gdevelop5/objects/multitouch-joystick)
* [3D platformer gamepad mapper](/gdevelop5/all-features/gamepad/)
* [3D shooter gamepad mapper](/gdevelop5/all-features/gamepad/)

[Open example in GDevelop](https://editor.gdevelop.io/?project=example://3d-first-person){ .md-button .md-button--primary }

Expand Down