Física 3D
La física 3D de Gobu usa Box3D. Es el motor de física 3D por defecto (registrado como
Box3D), y los actores de física de siempre funcionan sobre él.
Cuerpos
Sección titulada «Cuerpos»| Actor | Para qué |
|---|---|
| StaticBody3D | Escenario: no se mueve |
| RigidBody3D | Lo mueve la simulación |
| CharacterBody3D | Lo mueve tu código: el jugador, los enemigos |
| Area3D | Detecta lo que entra y sale, sin chocar |
El diálogo para añadir actores y el árbol Objects los muestran con sus nombres cortos: StaticBody, RigidBody, CharacterBody y Area (ver Un nombre según el tipo de proyecto). Los títulos de las secciones del Inspector conservan el nombre 3D (CharacterBody3D).

Cada cuerpo necesita una forma hija, CollisionShape (CollisionShape3D). Como en Unreal, la forma solo
se dibuja en el visor cuando la seleccionas (para verlas siempre, desactiva Editor Settings > Editors > 3D Gizmos >
Gizmo Settings > Show Collision Shapes Only When Selected).

Un personaje
Sección titulada «Un personaje»module Player
use actor::Player as body : CharacterBody3D
fn _physics_process(delta: float) void { if not body.is_on_floor() { body.velocity.y -= 9.8 * delta } _ = body.move_and_slide()}module Coin
use actor::Coin as coin : Area3D
on coin.body_entered(body: Spatial3D) { GetWorld.despawn(coin)}Áreas y mallas
Sección titulada «Áreas y mallas»En Box3D los sensores solo detectan formas convexas: un sensor no ve cuerpos con forma de
malla (ConcavePolygonShape3D), height field ni compuestas. Es una decisión de Box3D, no un
fallo.
Para que un Area3D funcione sobre escenario con malla cóncava (una plataforma que cae al
pisarla, por ejemplo), el backend de Gobu busca esas mallas con una consulta exacta en cada
paso de física y emite las señales de entrada y salida. Solo lo hace para las áreas que
están monitorizando (monitoring), así que su coste se limita a ellas.

Mallas de colisión por ambos lados
Sección titulada «Mallas de colisión por ambos lados»ConcavePolygonShape3D.backface_collision se respeta: con ella activada, cada triángulo
colisiona también por detrás.

Rayos y barridos de forma
Sección titulada «Rayos y barridos de forma»RayCast3D, ShapeCast3D (RayCast y ShapeCast en el
diálogo para añadir actores) y las consultas del espacio de
física (intersect_ray, de punto y de forma) devuelven el collider, y el clic del ratón
sobre un Area3D (input_pickable) funciona con Box3D. Igual que en 2D, cuando un barrido
empieza ya solapado y Box3D no da normal, el backend la rellena.