Godot CharacterBody3D: movimento no chão com velocidade correta e temporização da física

Separe a intenção do deslocamento

Um controlador de personagem converte a entrada do jogador em uma velocidade desejada e depois resolve o movimento em relação ao mundo. Ele também decide quando pular, cair ou parar é permitido. Mantenha essas decisões separadas da animação visual, para que a pose de corrida não se torne, sem ninguém perceber, a autoridade sobre o movimento de colisão. Comece com um controlador pequeno, cujas unidades e transições de estado você consiga explicar no papel.

Use o relógio da física

Chame move_and_slide() a partir de _physics_process(); o método já aplica o passo de tempo da física. A propriedade velocity expressa uma velocidade, normalmente em metros por segundo, e pode ser modificada pelo deslizamento. [1] Multiplicar essa velocidade por delta antes da chamada aplica o tempo duas vezes. A documentação de física do Godot distingue a velocidade de um deslocamento, que é o que outras APIs de movimento recebem. [2]

Integre a aceleração e depois resolva o movimento

Em um controlador convencional com eixo Y para cima, atualize a velocidade horizontal a partir da intenção de movimento e atualize a velocidade de queda com a aceleração multiplicada por delta. O tutorial oficial de movimento demonstra essa separação. [3] Decida como a entrada é limitada, para que o movimento na diagonal não aumente sem querer a velocidade permitida. Mantenha a velocidade vertical independente ao definir os componentes horizontais. Defina quando o pulo é permitido e consuma o pedido de pulo uma única vez, antes de resolver o movimento daquele tick.

Exemplo: um astronauta em uma passarela

Imagine um astronauta andando a uma velocidade pretendida de 6 metros por segundo, com 60 ticks de física por segundo. Em um trajeto horizontal sem obstáculos, a distância correspondente é de 0,1 metro por tick. Armazene a velocidade como 6, não como 0,1; deixe o método de movimento aplicar o passo de tempo. Adicione uma rampa, um teto baixo e um vão à cena de teste. Verifique se, ao soltar o comando de movimento, o personagem para de acordo com a política de aceleração escolhida, se pular sob o teto não mantém o movimento para cima e se sair da passarela inicia a queda. Esses números ilustram a conversão de unidades e não são resultados medidos de movimento.

Estado de contato com o chão e limitações

is_on_floor() informa o resultado da última chamada de move_and_slide(), e a classificação do chão é influenciada por up_direction e floor_max_angle. [1] Antes da próxima chamada de movimento, essa informação descreve o movimento resolvido anteriormente. Trate de acordo com isso o spawn, o teletransporte e as mudanças de contato. Teste os limites de inclinação, rampas em descida, cantos e plataformas móveis, e depois inspecione separadamente a velocidade solicitada e o deslocamento real. Um corpo de personagem é uma primitiva de controle, não um projeto completo de locomoção. Subida de degraus, correspondência com animações, buffer de entrada e predição de rede exigem políticas adicionais. Mantenha o comportamento da API descrito neste artigo alinhado com a versão do Godot usada no projeto.

Fontes

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