Godot CharacterBody3D: movimiento sobre el suelo con velocidad correcta y temporización de la física

Separar la intención del desplazamiento

Un controlador de personaje convierte la entrada en una velocidad deseada y después resuelve el movimiento frente al mundo. También decide cuándo se permite saltar, caer o detenerse. Mantén estas decisiones separadas de la animación visual, para que una pose de carrera no se convierta sin querer en la autoridad del movimiento con colisiones. Empieza con un controlador pequeño cuyas unidades y transiciones de estado puedas explicar sobre el papel.

Usar el reloj de la física

Llama a move_and_slide() desde _physics_process(); este método ya aplica el paso de tiempo de la física. La propiedad velocity expresa una rapidez, normalmente en metros por segundo, y el deslizamiento puede modificarla. [1] Si multiplicas esa velocidad por delta antes de la llamada, aplicas el tiempo dos veces. La guía de física de Godot distingue la velocidad de un desplazamiento que se pasa a otras API de movimiento. [2]

Integrar la aceleración y después resolver el movimiento

En un controlador convencional con el eje Y hacia arriba, actualiza la velocidad horizontal a partir de la intención de movimiento y la velocidad de caída con la aceleración multiplicada por delta. El tutorial oficial de movimiento muestra esta separación. [3] Decide cómo limitar la entrada para que el movimiento en diagonal no aumente sin querer la rapidez permitida. Mantén la velocidad vertical independiente al asignar los componentes horizontales. Define cuándo se puede saltar y consume la solicitud de salto una sola vez antes de resolver el movimiento de ese tick.

Ejemplo: un astronauta en una pasarela

Imagina a un astronauta que camina a una rapidez prevista de 6 metros por segundo con 60 ticks de física por segundo. En un trayecto horizontal sin obstáculos, la distancia correspondiente es de 0,1 metros por tick. Guarda la rapidez como 6, no como 0,1; deja que el método de movimiento aplique el paso de tiempo. Añade a la escena de prueba una rampa, un techo bajo y un hueco. Comprueba que al soltar el movimiento el personaje se detiene según la política de aceleración que hayas elegido, que saltar bajo el techo no conserva el movimiento ascendente y que al salir de la pasarela comienza la caída. Estos números ilustran la conversión de unidades y no son resultados de movimiento medidos.

Estado de suelo y limitaciones

is_on_floor() informa del resultado de la última llamada a move_and_slide(), y en la clasificación del suelo influyen up_direction y floor_max_angle. [1] Antes de la siguiente llamada de movimiento, esa información describe el movimiento resuelto anterior. Trata en consecuencia la aparición, el teletransporte y los cambios de contacto. Prueba los límites de pendiente, las rampas descendentes, las esquinas y las plataformas móviles, y después inspecciona por separado la velocidad solicitada y el desplazamiento real. Un cuerpo de personaje es una primitiva de controlador, no un diseño completo de locomoción. Subir escalones, ajustar las animaciones, el búfer de entrada y la predicción de red requieren políticas adicionales. Mantén el comportamiento de la API descrito en este artículo alineado con la versión de Godot del proyecto.

Fuentes

1. CharacterBody3D class reference — Godot Engine contributors.
2. Physics introduction — Godot Engine contributors.
3. Moving the player with code — Godot Engine contributors.