---
title: "Motor dinâmico"
version: snapshot-2026-10-07
engineGeneration: astra-current
language: C#
status: source-reviewed
reviewedAt: 2026-10-07
appRelease: "0.2.3-preview.20261007"
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-07/componentes/astra-physics-dynamic-motor/
---

# Motor dinâmico

Locomoção por força e salto com apoio sobre Corpo físico dinâmico

**Família:** Física 3D · **Grupo:** Corpos · **Identificador:** `astra.physics.dynamic_motor` · **Payload:** 3

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Locomoção por força e salto com apoio sobre Corpo físico dinâmico

Resolva Corpo físico, Colisor e autoridade de pose antes de aplicar forças, motores ou juntas. Corpo dinâmico recebe forças; sensor emite sobreposição. Character e Motor dinâmico têm contratos próprios.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Corpos** → **Motor dinâmico**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.DynamicBodyMotor](/pt-br/snapshot-2026-10-07/api/astra-components-dynamicbodymotor/).

A seção Posse de controle escolhe UI, teclado, gamepad, Script ou IA. Prioridades ficam visíveis em Automático. Selecionar uma origem não cria vínculos de entrada. [Arbitragem, cancelamento, campos e receita](/pt-br/snapshot-2026-10-07/sistemas/posse-de-controle/).

**Guia relacionado:** [Posse e movimento medido](/pt-br/snapshot-2026-10-07/sistemas/posse-de-controle/)

## Exemplo de uso

Crie chão estático e um corpo dinâmico com colisor. Compare queda, massa, atrito e restituição. Para sensor, conecte TriggerEnter a um Behavior como no HUD de corações.



## Dependências

- [Corpo físico](/pt-br/snapshot-2026-10-07/componentes/astra-physics-body/): Adicione Corpo físico dinâmico ao receptor

## Conflitos

- [Personagem](/pt-br/snapshot-2026-10-07/componentes/astra-physics-character/): Incompatível com personagem cápsula

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 3 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Locomoção

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Velocidade**](#field-speed)<br/>`speed` | número · m/s | 6 | 0 … 100 |
| [**Aceleração**](#field-acceleration)<br/>`acceleration` | número · m/s² | 24 | 0 … 1000 |
| [**Frenagem**](#field-braking)<br/>`braking` | número · m/s² | 36 | 0 … 1000 |
| [**Controle no ar**](#field-air-control)<br/>`air_control` | número | 0.25 | 0 … 1 |
| [**Velocidade do salto**](#field-jump-speed)<br/>`jump_speed` | número · m/s | 6 | 0 … 100 |
| [**Habilitado**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-speed">Velocidade · <code>speed</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Locomoção** → **Velocidade**.

**Uso e efeito:** Velocidade de reprodução/percurso/motor na unidade do componente.

**Valor:** 6 · **Tipo:** número · **Unidade:** m/s · **Domínio:** 0 … 100.



<h4 id="field-acceleration">Aceleração · <code>acceleration</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Locomoção** → **Aceleração**.

**Uso e efeito:** Limita a força de correção para atingir a velocidade alvo; usa a massa real, sem escrever Transform diretamente.

**Valor:** 24 · **Tipo:** número · **Unidade:** m/s² · **Domínio:** 0 … 1000.



<h4 id="field-braking">Frenagem · <code>braking</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Locomoção** → **Frenagem**.

**Uso e efeito:** Limita a correção da velocidade quando não há comando de movimento.

**Valor:** 36 · **Tipo:** número · **Unidade:** m/s² · **Domínio:** 0 … 1000.



<h4 id="field-air-control">Controle no ar · <code>air_control</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Locomoção** → **Controle no ar**.

**Uso e efeito:** Multiplicador de controle enquanto sem apoio.

**Valor:** 0.25 · **Tipo:** número · **Domínio:** 0 … 1.



<h4 id="field-jump-speed">Velocidade do salto · <code>jump_speed</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Locomoção** → **Velocidade do salto**.

**Uso e efeito:** Velocidade alvo inicial de salto.

**Valor:** 6 · **Tipo:** número · **Unidade:** m/s · **Domínio:** 0 … 100.



<h4 id="field-enabled">Habilitado · <code>enabled</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Locomoção** → **Habilitado**.

**Uso e efeito:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



### Chão

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Centro até os pés**](#field-probe-height)<br/>`probe_height` | número · m | 1 | 0.01 … 100 |
| [**Alcance abaixo dos pés**](#field-probe-distance)<br/>`probe_distance` | número · m | 0.15 | 0.001 … 2 |
| [**Raio de sondagem**](#field-support-radius)<br/>`support_radius` | número · m | 0.3 | 0 … 10 |
| [**Rampa máxima**](#field-max-slope)<br/>`max_slope` | número · ° | 50 | 0 … 89 |
| [**Acompanhar plataforma**](#field-inherit-platform-velocity)<br/>`inherit_platform_velocity` | booleano | verdadeiro | verdadeiro \| falso |
| [**Apoio pela colisão**](#field-automatic-support)<br/>`automatic_support` | booleano | verdadeiro | verdadeiro \| falso |

<h4 id="field-probe-height">Centro até os pés · <code>probe_height</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Chão** → **Centro até os pés**.

**Uso e efeito:** Usado somente quando Apoio pela colisão está desligado.

**Valor:** 1 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.01 … 100.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-probe-distance">Alcance abaixo dos pés · <code>probe_distance</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Chão** → **Alcance abaixo dos pés**.

**Uso e efeito:** Alcance da consulta de apoio.

**Valor:** 0.15 · **Tipo:** número · **Unidade:** m · **Domínio:** 0.001 … 2.



<h4 id="field-support-radius">Raio de sondagem · <code>support_radius</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Chão** → **Raio de sondagem**.

**Uso e efeito:** Usado somente quando Apoio pela colisão está desligado.

**Valor:** 0.3 · **Tipo:** número · **Unidade:** m · **Domínio:** 0 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-max-slope">Rampa máxima · <code>max_slope</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Chão** → **Rampa máxima**.

**Uso e efeito:** Inclinação máxima de apoio do motor.

**Valor:** 50 · **Tipo:** número · **Unidade:** ° · **Domínio:** 0 … 89.



<h4 id="field-inherit-platform-velocity">Acompanhar plataforma · <code>inherit_platform_velocity</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Chão** → **Acompanhar plataforma**.

**Uso e efeito:** Herda velocidade da plataforma de apoio quando permitido.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-automatic-support">Apoio pela colisão · <code>automatic_support</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Chão** → **Apoio pela colisão**.

**Uso e efeito:** Sonda a superfície real do colisor do solver, com escala, rotação e partes compostas. Cinco amostras; alcance abaixo da forma em metros.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



### Posse de controle

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Prioridade UI**](#field-control-priority-ui)<br/>`control_priority_ui` | número | 10 | 0 … 1000 |
| [**Prioridade Teclado / mouse**](#field-control-priority-keyboard)<br/>`control_priority_keyboard` | número | 10 | 0 … 1000 |
| [**Prioridade Gamepad**](#field-control-priority-gamepad)<br/>`control_priority_gamepad` | número | 10 | 0 … 1000 |
| [**Prioridade Script**](#field-control-priority-script)<br/>`control_priority_script` | número | 20 | 0 … 1000 |
| [**Prioridade IA**](#field-control-priority-ai)<br/>`control_priority_ai` | número | 5 | 0 … 1000 |
| [**Fonte de controle**](#field-control-source)<br/>`control_source` | enumeração | Automático | Automático \| UI \| Teclado / mouse \| Gamepad \| Script \| IA |

<h4 id="field-control-priority-ui">Prioridade UI · <code>control_priority_ui</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Posse de controle** → **Prioridade UI**.

**Uso e efeito:** Prioridade de arbitragem desta origem em Automático, de 0 a 1000. Maior vence entre candidatos; na fonte exclusiva fica oculta e é preservada. Não é prioridade de execução do script.

**Valor:** 10 · **Tipo:** número · **Domínio:** 0 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-control-priority-keyboard">Prioridade Teclado / mouse · <code>control_priority_keyboard</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Posse de controle** → **Prioridade Teclado / mouse**.

**Uso e efeito:** Prioridade de arbitragem desta origem em Automático, de 0 a 1000. Maior vence entre candidatos; na fonte exclusiva fica oculta e é preservada. Não é prioridade de execução do script.

**Valor:** 10 · **Tipo:** número · **Domínio:** 0 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-control-priority-gamepad">Prioridade Gamepad · <code>control_priority_gamepad</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Posse de controle** → **Prioridade Gamepad**.

**Uso e efeito:** Prioridade de arbitragem desta origem em Automático, de 0 a 1000. Maior vence entre candidatos; na fonte exclusiva fica oculta e é preservada. Não é prioridade de execução do script.

**Valor:** 10 · **Tipo:** número · **Domínio:** 0 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-control-priority-script">Prioridade Script · <code>control_priority_script</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Posse de controle** → **Prioridade Script**.

**Uso e efeito:** Prioridade de arbitragem desta origem em Automático, de 0 a 1000. Maior vence entre candidatos; na fonte exclusiva fica oculta e é preservada. Não é prioridade de execução do script.

**Valor:** 20 · **Tipo:** número · **Domínio:** 0 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-control-priority-ai">Prioridade IA · <code>control_priority_ai</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Posse de controle** → **Prioridade IA**.

**Uso e efeito:** Prioridade de arbitragem desta origem em Automático, de 0 a 1000. Maior vence entre candidatos; na fonte exclusiva fica oculta e é preservada. Não é prioridade de execução do script.

**Valor:** 5 · **Tipo:** número · **Domínio:** 0 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

<h4 id="field-control-source">Fonte de controle · <code>control_source</code></h4>

**Onde:** Inspector → **Motor dinâmico** → **Posse de controle** → **Fonte de controle**.

**Uso e efeito:** Automático arbitra os canais; UI/Teclado/Gamepad/Script/IA escolhe uma origem exclusiva. Origem exclusiva neutra mantém a posse; não passa para a IA.

**Valor:** Automático · **Tipo:** enumeração · **Domínio:** Automático \| UI \| Teclado / mouse \| Gamepad \| Script \| IA.



## Roadmap deste componente

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Ampliar autoria/rebuild, geometria e apoio dos motores, juntas e diagnóstico por cenário. Fechamento deve incluir salvar/reabrir, remoção e gameplay no aparelho. Importação universal de todas as formas e controles não está declarada pronta.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Motor dinâmico** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_rigidbody3d.html). Essa referência não representa paridade funcional.