Ir al contenido
Descargar
Guía de Gobu

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.

ActorPara qué
StaticBody3DEscenario: no se mueve
RigidBody3DLo mueve la simulación
CharacterBody3DLo mueve tu código: el jugador, los enemigos
Area3DDetecta 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).

El diálogo Add Actor, categoría Physics: Area, CharacterBody, RigidBody y StaticBody

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 suelo, una caja, una pelota, un jugador, una moneda y una rampa, cada uno con su CollisionShape3D dentro

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)
}

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.

El área Coin seleccionada, con Monitoring activado en el Inspector

ConcavePolygonShape3D.backface_collision se respeta: con ella activada, cada triángulo colisiona también por detrás.

Una rampa cuya forma de colisión es un ConcavePolygonShape3D con Backface Collision activado

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.