---
title: "Astra.Components.DynamicBodyMotor"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-dynamicbodymotor/
---

# Astra.Components.DynamicBodyMotor

Motor dinâmico: Locomoção por força e salto com apoio sobre Corpo físico dinâmico. Família Física 3D · Corpos.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.DynamicBodyMotor
```

Motor dinâmico: Locomoção por força e salto com apoio sobre Corpo físico dinâmico. Família Física 3D · Corpos.

Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_rigidbody3d.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.DynamicBodyMotor>`.

Consulte também [Motor dinâmico](/pt-br/snapshot-2026-10-06/componentes/astra-physics-dynamic-motor/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-e7a02c47b5be980f) | Method |
| [Remove](#member-21f4dbc8c842b060) | Method |
| [Wrap](#member-8085fc8bfc3f8f02) | Method |
| [Acceleration](#member-3bb4447857462658) | Property |
| [AirControl](#member-dea85d7c0a92204f) | Property |
| [AutomaticSupport](#member-a06cdcdc623d7830) | Property |
| [Braking](#member-83da6d5345ffa8f6) | Property |
| [Component](#member-7b236d73a334579a) | Property |
| [Enabled](#member-2990b77d9e7cede9) | Property |
| [InheritPlatformVelocity](#member-9136b1bd9135aa52) | Property |
| [InstanceId](#member-a065251ccc14a61e) | Property |
| [IsAlive](#member-c9fe9db480a29164) | Property |
| [JumpSpeed](#member-0c8dcdd8af197f57) | Property |
| [MaxSlope](#member-ff64a29ef5fad1bf) | Property |
| [Object](#member-ebad482915ad55c8) | Property |
| [ProbeDistance](#member-0f55a19bec09ddce) | Property |
| [ProbeHeight](#member-70c066d2b93c5e0f) | Property |
| [Speed](#member-ba8c2dfcaf1ba89d) | Property |
| [SupportRadius](#member-629925a74107b497) | Property |
| [TypeId](#member-a26bba12a78da02c) | Property |

<h3 id="member-e7a02c47b5be980f" class="astra-member">.ctor</h3>

```csharp
public DynamicBodyMotor(Astra.Component component)
```

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-21f4dbc8c842b060" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

<h3 id="member-8085fc8bfc3f8f02" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.DynamicBodyMotor Wrap(Astra.Component component)
```

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-3bb4447857462658" class="astra-member">Acceleration</h3>

```csharp
public float Acceleration { get; set; }
```

Aceleração (m/s²)

Faixa válida: 0 a 1000.

<h3 id="member-dea85d7c0a92204f" class="astra-member">AirControl</h3>

```csharp
public float AirControl { get; set; }
```

Controle no ar

Faixa válida: 0 a 1.

<h3 id="member-a06cdcdc623d7830" class="astra-member">AutomaticSupport</h3>

```csharp
public bool AutomaticSupport { get; set; }
```

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

<h3 id="member-83da6d5345ffa8f6" class="astra-member">Braking</h3>

```csharp
public float Braking { get; set; }
```

Frenagem (m/s²)

Faixa válida: 0 a 1000.

<h3 id="member-7b236d73a334579a" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

<h3 id="member-2990b77d9e7cede9" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Habilitado

<h3 id="member-9136b1bd9135aa52" class="astra-member">InheritPlatformVelocity</h3>

```csharp
public bool InheritPlatformVelocity { get; set; }
```

Acompanhar plataforma

<h3 id="member-a065251ccc14a61e" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

<h3 id="member-c9fe9db480a29164" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

<h3 id="member-0c8dcdd8af197f57" class="astra-member">JumpSpeed</h3>

```csharp
public float JumpSpeed { get; set; }
```

Velocidade do salto (m/s)

Faixa válida: 0 a 100.

<h3 id="member-ff64a29ef5fad1bf" class="astra-member">MaxSlope</h3>

```csharp
public float MaxSlope { get; set; }
```

Rampa máxima (°)

Faixa válida: 0 a 89.

<h3 id="member-ebad482915ad55c8" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

<h3 id="member-0f55a19bec09ddce" class="astra-member">ProbeDistance</h3>

```csharp
public float ProbeDistance { get; set; }
```

Alcance abaixo dos pés (m)

Faixa válida: 0.001 a 2.

<h3 id="member-70c066d2b93c5e0f" class="astra-member">ProbeHeight</h3>

```csharp
public float ProbeHeight { get; set; }
```

Centro até os pés (m). Usado somente quando Apoio pela colisão está desligado.

Faixa válida: 0.01 a 100.

<h3 id="member-ba8c2dfcaf1ba89d" class="astra-member">Speed</h3>

```csharp
public float Speed { get; set; }
```

Velocidade (m/s)

Faixa válida: 0 a 100.

<h3 id="member-629925a74107b497" class="astra-member">SupportRadius</h3>

```csharp
public float SupportRadius { get; set; }
```

Raio de sondagem (m). Usado somente quando Apoio pela colisão está desligado.

Faixa válida: 0 a 10.

<h3 id="member-a26bba12a78da02c" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```