From 617d80a8f0bc70feedc3a9b9848d69455bf53447 Mon Sep 17 00:00:00 2001
From: 4ian <1280130+4ian@users.noreply.github.com>
Date: Wed, 6 May 2026 09:03:29 +0000
Subject: [PATCH] [Auto] [Update] Mention new forward/up/right direction vector
 expressions for 3D models and cameras

---
 automated_updates_data.json              | 2 +-
 docs/gdevelop5/objects/3d-model/index.md | 6 ++++++
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/automated_updates_data.json b/automated_updates_data.json
index 6c71cb99bf..652a4e5d94 100644
--- a/automated_updates_data.json
+++ b/automated_updates_data.json
@@ -1,5 +1,5 @@
 {
-  "last_automated_updates_commit": "e9b9596d6dddf8fc483ed5d4c2a4725215b073fe",
+  "last_automated_updates_commit": "b3f7bc5ebfb63e43b74816f49d89ada7350011e9",
   "last_improved_things": [
     {
       "date": "2026-02-16",
diff --git a/docs/gdevelop5/objects/3d-model/index.md b/docs/gdevelop5/objects/3d-model/index.md
index 4a1fff8a05..e79ef2cf82 100644
--- a/docs/gdevelop5/objects/3d-model/index.md
+++ b/docs/gdevelop5/objects/3d-model/index.md
@@ -97,6 +97,12 @@ The **center location** determines the point around which the object rotates and
 
     For characters, setting the origin to "Bottom center (Z)" makes it easy to place them on the ground, as the object's Z position will represent the ground level where the character stands.
 
+## Object orientation
+
+A 3D model's current orientation can be read as three direction vectors expressed in the world: a **forward**, an **up** and a **right** vector. These are useful when the object's rotation is not aligned with the world axes — for example to make a turret fire a projectile in the direction it is currently aiming, to move a vehicle along the way it is facing, or to spawn a thruster effect under a tilted spaceship.
+
+The same kind of vectors are also available for the 3D camera, which can help align gameplay with the player's point of view (such as moving relative to where the camera is looking).
+
 ## File format
 
 GDevelop supports 3D models saved in the **GLB (.glb) format**. It is a standardized file format used to share 3D data. Notably, it includes the 3D mesh of the object, as well as its textures, material specifications, and animations. This format is also sometimes called **GLTF**, for "GL Transmission Format". You can sometimes find .gltf files, but only the **.glb** files are supported by GDevelop, as they can embed the textures and animations whereas .gltf files require separate files.