Ir al contenido
Descargar
Guía de Gobu

Física 2D

La física 2D de Gobu usa Box2D. Es el motor de física 2D por defecto (registrado como Box2D), así que no tienes que configurar nada: los actores de física de siempre funcionan sobre él.

ActorPara qué
StaticBody2DSuelo, paredes: no se mueve
RigidBody2DLo mueve la simulación: cajas, pelotas, restos
CharacterBody2DLo mueve tu código: el jugador, los enemigos
Area2DDetecta 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 2D (CharacterBody2D).

La categoría Physics del diálogo para añadir actores: primero Area, CharacterBody, RigidBody y StaticBody, luego las formas, las uniones y los barridos

Cada cuerpo necesita una forma hija, CollisionShape o CollisionPolygon (CollisionShape2D, CollisionPolygon2D).

El prefab del jugador con su hijo CollisionShape seleccionado: el rectángulo dibujado sobre el sprite y su RectangleShape2D en el Inspector

El jugador es un prefab cuya raíz es un CharacterBody2D. Su código lo importa con use actor:: y lo mueve con move_and_slide():

module Player
use actor::Player as body : CharacterBody2D
fn _physics_process(delta: float) void {
if not body.is_on_floor() {
body.velocity.y += 980.0 * delta
}
_ = body.move_and_slide()
}

El prefab del jugador con su raíz, Player, seleccionada: la sección CharacterBody2D del Inspector muestra Speed y Jump Speed de su código, Motion Mode, Up Direction...

Un Area2D avisa con señales cuando un cuerpo entra o sale. Una moneda, por ejemplo:

module Coin
use actor::Coin as coin : Area2D
on coin.body_entered(body: Spatial2D) {
GetWorld.despawn(coin)
}

El prefab de la moneda: su raíz es un Area2D con una forma circular, y el Inspector muestra Monitoring, Monitorable y su máscara de colisión

RayCast2D y ShapeCast2D (RayCast y ShapeCast en el diálogo para añadir actores) funcionan como en Godot, igual que las consultas del espacio de física (intersect_ray, consultas de punto y de forma). El resultado incluye el collider, y el clic del ratón sobre un Area2D (input_pickable) también funciona con Box2D.

El prefab del enemigo con su RayCast2D Ledge seleccionado: la flecha baja desde su pie delantero, y el Inspector muestra su Target Position y su Collision Mask

  • Las colisiones de un solo sentido (one_way_collision) se respetan en el movimiento de los personajes.
  • Liberar un cuerpo desde una señal de física es más seguro al final del frame: usa later (capítulo 10) o GetWorld.despawn.