--- title: "Astra.Components.PhysicsBody" version: snapshot-2026-10-07 engineGeneration: astra-current language: C# status: semantic-reference reviewedAt: 2026-10-07 appRelease: "0.2.3-preview.20261007" runtimeVerified: false platformEvidence: [] url: https://astraengine.com.br/pt-br/snapshot-2026-10-07/api/astra-components-physicsbody/ --- # Astra.Components.PhysicsBody Corpo físico: Massa e resposta física. 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.PhysicsBody ``` Corpo físico: Massa e resposta física. Família Física 3D · Corpos. Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-Rigidbody.html **Interfaces:** `Astra.Components.IComponentFacade`. ## Onde acessar este tipo Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Corpos** → **Corpo físico**. No Behavior em Play, obtenha a fachada com `Object.GetComponent()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new PhysicsBody(component)` envolve um componente existente; não adiciona um componente à cena. ## Roadmap e uso [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente. Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/). Consulte também [Corpo físico](/pt-br/snapshot-2026-10-07/componentes/astra-physics-body/) para propriedades, valores iniciais, requisitos e edição em Play. ## Membros | Membro | Categoria | |---|---| | [.ctor](#member-61bf54466a3194cc) | Method | | [GetMaterial](#member-f30d0d4363940d89) | Method | | [Remove](#member-742ba0d9954b980f) | Method | | [SetMaterial](#member-93a54818183550d5) | Method | | [Wrap](#member-9692518abaa2cae7) | Method | | [AllowSleep](#member-43c33dbbd04d4c23) | Property | | [AngularDamping](#member-2b5c14abb3199dc4) | Property | | [AngularVelocity](#member-8db6b50a9e2e7ef0) | Property | | [AutomaticCenterOfMass](#member-f90ac9819273e5e2) | Property | | [AutomaticInertia](#member-1a0866fe9c051acc) | Property | | [CenterOfMass](#member-39f44bea777d9efa) | Property | | [Component](#member-ebb9c5fcabd9898d) | Property | | [ContinuousCollision](#member-a6eaa86d5f0a254a) | Property | | [FreezePositionX](#member-f3d265ea2d9ec103) | Property | | [FreezePositionY](#member-50570724d85b7fbc) | Property | | [FreezePositionZ](#member-8e078ea73ef2f642) | Property | | [FreezeRotationX](#member-5b4d37285be87666) | Property | | [FreezeRotationY](#member-24f936b343836b43) | Property | | [FreezeRotationZ](#member-e261d0281cad429b) | Property | | [Friction](#member-c1fed90a74a2a3e1) | Property | | [FrictionCombine](#member-0fd9f54fb9b25a8a) | Property | | [GravityFactor](#member-af0fafe655fd7222) | Property | | [InertiaTensor](#member-5aa5fcb582bb0dc4) | Property | | [InstanceId](#member-adcb9b5fbb4df747) | Property | | [Interpolation](#member-748ac64c1d2c4e79) | Property | | [IsAlive](#member-bd788774308a8386) | Property | | [LinearDamping](#member-420f46f2aedd605e) | Property | | [Mass](#member-0cd4f8b5a230fa43) | Property | | [MaxAngularVelocity](#member-65a01ed658e05f86) | Property | | [MaxLinearVelocity](#member-b50b93a062687d6e) | Property | | [Monitorable](#member-e7cf8916e74a4137) | Property | | [Monitoring](#member-f653415132efd68d) | Property | | [Motion](#member-acba4c2440e1c140) | Property | | [Object](#member-175bb73f52752e86) | Property | | [Restitution](#member-e107851c40928fb1) | Property | | [RestitutionCombine](#member-f723f471bc6e442c) | Property | | [Sensor](#member-c6d8b4823d0d829e) | Property | | [SolverVelocitySteps](#member-4b2402b214661899) | Property | | [Surface](#member-a3a590513f021afd) | Property | | [TypeId](#member-f7d87b29df1c9853) | Property | | [Velocity](#member-404366a6f8f62d5c) | Property |

.ctor

```csharp public PhysicsBody(Astra.Component component) ``` **Caminho:** Inspector → Corpo físico; ou fachada C# em um Behavior. **Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência. | Parâmetro | Tipo | Contrato | |---|---|---| | `component` | `Astra.Component` | |

GetMaterial

```csharp public Astra.AssetGuid GetMaterial(uint slot = 0) ``` Material físico. Recurso do projeto por slot **Caminho:** Inspector → Corpo físico; ou fachada C# em um Behavior. **Uso:** Material físico. Recurso do projeto por slot **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência. | Parâmetro | Tipo | Contrato | |---|---|---| | `slot` | `uint` | · Opcional: `0` |

Remove

```csharp public void Remove() ``` Remove a instância pelo ciclo nativo; dependências e ownership podem recusar. **Caminho:** Inspector → Corpo físico; ou fachada C# em um Behavior. **Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

SetMaterial

```csharp public void SetMaterial(Astra.AssetGuid value, uint slot = 0) ``` **Caminho:** Inspector → Corpo físico; ou fachada C# em um Behavior. **Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência. | Parâmetro | Tipo | Contrato | |---|---|---| | `value` | `Astra.AssetGuid` | | | `slot` | `uint` | · Opcional: `0` |

Wrap

```csharp public static Astra.Components.PhysicsBody Wrap(Astra.Component component) ``` **Caminho:** Inspector → Corpo físico; ou fachada C# em um Behavior. **Uso:** Envolve um Component existente após conferir TypeId; não cria componente. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência. | Parâmetro | Tipo | Contrato | |---|---|---| | `component` | `Astra.Component` | |

AllowSleep

```csharp public bool AllowSleep { get; set; } ``` Permitir repouso **Caminho:** Inspector → Corpo físico → Corpo; ou fachada C# em um Behavior. **Uso:** **Permitir repouso:** Permite dormir quando o corpo pode ficar em repouso. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

AngularDamping

```csharp public float AngularDamping { get; set; } ``` Amortecimento angular Faixa válida: 0 a 10. **Caminho:** Inspector → Corpo físico → Amortecimento; ou fachada C# em um Behavior. **Uso:** **Amortecimento angular:** Amortecimento de velocidade angular. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

AngularVelocity

```csharp public System.Numerics.Vector3 AngularVelocity { get; set; } ``` Giro inicial **Caminho:** Inspector → Corpo físico → Início; ou fachada C# em um Behavior. **Uso:** **Giro inicial X · rad/s:** Velocidade angular do corpo, eixo X. **Giro inicial Y · rad/s:** Velocidade angular do corpo, eixo Y. **Giro inicial Z · rad/s:** Velocidade angular do corpo, eixo Z. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

AutomaticCenterOfMass

```csharp public bool AutomaticCenterOfMass { get; set; } ``` Centro de massa automático. Ligado, o Jolt calcula o centro pela forma (Rigidbody.automaticCenterOfMass) **Caminho:** Inspector → Corpo físico → Massa; ou fachada C# em um Behavior. **Uso:** **Centro de massa automático:** Ligado calcula centro de massa da composição física; desligue para usar as coordenadas manuais. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

AutomaticInertia

```csharp public bool AutomaticInertia { get; set; } ``` Inércia automática. Ligado, a inércia vem da forma e da massa (Rigidbody.automaticInertiaTensor) **Caminho:** Inspector → Corpo físico → Massa; ou fachada C# em um Behavior. **Uso:** **Inércia automática:** Ligado calcula inércia; desligue para usar os valores manuais e conferir resposta de rotação. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

CenterOfMass

```csharp public System.Numerics.Vector3 CenterOfMass { get; set; } ``` Centro de massa **Caminho:** Inspector → Corpo físico → Massa; ou fachada C# em um Behavior. **Uso:** **Centro de massa X:** Coordenada local em metros do centro de massa manual. Desligue cálculo automático; muda a resposta de rotação física, não desloca a malha visual. **Centro de massa Y:** Coordenada local em metros do centro de massa manual. Desligue cálculo automático; muda a resposta de rotação física, não desloca a malha visual. **Centro de massa Z:** Coordenada local em metros do centro de massa manual. Desligue cálculo automático; muda a resposta de rotação física, não desloca a malha visual. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Component

```csharp public Astra.Component Component { get; } ``` **Caminho:** Inspector → Corpo físico; ou fachada C# em um Behavior. **Uso:** Handle genérico da instância, usado para operações de reflexão e recursos. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

ContinuousCollision

```csharp public bool ContinuousCollision { get; set; } ``` Colisão contínua. Varredura linear Jolt; não detecta varredura apenas angular **Caminho:** Inspector → Corpo físico → Simulação; ou fachada C# em um Behavior. **Uso:** **Colisão contínua:** Varredura linear Jolt; não detecta varredura apenas angular **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

FreezePositionX

```csharp public bool FreezePositionX { get; set; } ``` Travar posição X. Eixos do mundo; bloquear todos exige corpo estático **Caminho:** Inspector → Corpo físico → Restrições; ou fachada C# em um Behavior. **Uso:** **Travar posição X:** Eixos do mundo; bloquear todos exige corpo estático **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

FreezePositionY

```csharp public bool FreezePositionY { get; set; } ``` Travar posição Y. Eixos do mundo; bloquear todos exige corpo estático **Caminho:** Inspector → Corpo físico → Restrições; ou fachada C# em um Behavior. **Uso:** **Travar posição Y:** Eixos do mundo; bloquear todos exige corpo estático **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

FreezePositionZ

```csharp public bool FreezePositionZ { get; set; } ``` Travar posição Z. Eixos do mundo; bloquear todos exige corpo estático **Caminho:** Inspector → Corpo físico → Restrições; ou fachada C# em um Behavior. **Uso:** **Travar posição Z:** Eixos do mundo; bloquear todos exige corpo estático **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

FreezeRotationX

```csharp public bool FreezeRotationX { get; set; } ``` Travar rotação X. Eixos do mundo; bloquear todos exige corpo estático **Caminho:** Inspector → Corpo físico → Restrições; ou fachada C# em um Behavior. **Uso:** **Travar rotação X:** Eixos do mundo; bloquear todos exige corpo estático **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

FreezeRotationY

```csharp public bool FreezeRotationY { get; set; } ``` Travar rotação Y. Eixos do mundo; bloquear todos exige corpo estático **Caminho:** Inspector → Corpo físico → Restrições; ou fachada C# em um Behavior. **Uso:** **Travar rotação Y:** Eixos do mundo; bloquear todos exige corpo estático **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

FreezeRotationZ

```csharp public bool FreezeRotationZ { get; set; } ``` Travar rotação Z. Eixos do mundo; bloquear todos exige corpo estático **Caminho:** Inspector → Corpo físico → Restrições; ou fachada C# em um Behavior. **Uso:** **Travar rotação Z:** Eixos do mundo; bloquear todos exige corpo estático **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Friction

```csharp public float Friction { get; set; } ``` Atrito Faixa válida: 0 a 1. **Caminho:** Inspector → Corpo físico → Material; ou fachada C# em um Behavior. **Uso:** **Atrito:** Atrito nos contatos; compare deslizamento com o mesmo par de superfícies. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

FrictionCombine

```csharp public Astra.Components.PhysicsBody.FrictionCombineOption FrictionCombine { get; set; } ``` Combinar atrito. Num par, vale o modo de maior precedência: máximo > multiplicar > mínimo > média. Padrão: média geométrica **Caminho:** Inspector → Corpo físico → Material; ou fachada C# em um Behavior. **Uso:** **Combinar atrito:** Política de combinar atrito do par. Padrão conserva a regra do motor; a precedência dos modos participa da escolha. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

GravityFactor

```csharp public float GravityFactor { get; set; } ``` Multiplicador da gravidade Faixa válida: -100 a 100. **Caminho:** Inspector → Corpo físico → Amortecimento; ou fachada C# em um Behavior. **Uso:** **Multiplicador da gravidade:** Multiplica gravidade mundial deste corpo 3D. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

InertiaTensor

```csharp public System.Numerics.Vector3 InertiaTensor { get; set; } ``` Inércia **Caminho:** Inspector → Corpo físico → Massa; ou fachada C# em um Behavior. **Uso:** **Inércia X:** Componente diagonal da inércia manual, usada com cálculo automático desligado. Valores válidos afetam resistência à rotação; compare com a massa e forma reais. **Inércia Y:** Componente diagonal da inércia manual, usada com cálculo automático desligado. Valores válidos afetam resistência à rotação; compare com a massa e forma reais. **Inércia Z:** Componente diagonal da inércia manual, usada com cálculo automático desligado. Valores válidos afetam resistência à rotação; compare com a massa e forma reais. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

InstanceId

```csharp public ulong InstanceId { get; } ``` **Caminho:** Inspector → Corpo físico; ou fachada C# em um Behavior. **Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Interpolation

```csharp public Astra.Components.PhysicsBody.InterpolationOption Interpolation { get; set; } ``` Interpolação. Suaviza a pose desenhada entre passos de 60 Hz (Rigidbody.interpolation); a física não muda **Caminho:** Inspector → Corpo físico → Simulação; ou fachada C# em um Behavior. **Uso:** **Interpolação:** Política de suavização visual entre passos físicos; não aumenta a frequência do solver nem muda a trajetória física. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

IsAlive

```csharp public bool IsAlive { get; } ``` **Caminho:** Inspector → Corpo físico; ou fachada C# em um Behavior. **Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

LinearDamping

```csharp public float LinearDamping { get; set; } ``` Amortecimento linear Faixa válida: 0 a 10. **Caminho:** Inspector → Corpo físico → Amortecimento; ou fachada C# em um Behavior. **Uso:** **Amortecimento linear:** Amortecimento de velocidade linear. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Mass

```csharp public float Mass { get; set; } ``` Massa kg (kg) Faixa válida: 0.01 a 1000000. **Caminho:** Inspector → Corpo físico → Corpo; ou fachada C# em um Behavior. **Uso:** **Massa kg:** Massa do corpo dinâmico em kg; influencia resposta a força/impulso. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

MaxAngularVelocity

```csharp public float MaxAngularVelocity { get; set; } ``` Limite angular (rad/s) Faixa válida: 0.001 a 100000. **Caminho:** Inspector → Corpo físico → Simulação; ou fachada C# em um Behavior. **Uso:** **Limite angular:** Limite de velocidade angular do corpo. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

MaxLinearVelocity

```csharp public float MaxLinearVelocity { get; set; } ``` Limite linear (m/s) Faixa válida: 0.001 a 100000. **Caminho:** Inspector → Corpo físico → Simulação; ou fachada C# em um Behavior. **Uso:** **Limite linear:** Limite de velocidade linear do corpo. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Monitorable

```csharp public bool Monitorable { get; set; } ``` Detectável por sensores. Desligado, sensores ignoram este corpo (Area3D.monitorable) **Caminho:** Inspector → Corpo físico → Corpo; ou fachada C# em um Behavior. **Uso:** **Detectável por sensores:** Permite que outros sensores detectem este corpo pelo filtro. É independente de Monitorar os próprios eventos. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Monitoring

```csharp public bool Monitoring { get; set; } ``` Monitorar. Desligado, o sensor não publica entrada, permanência nem saída (Area3D.monitoring) **Caminho:** Inspector → Corpo físico → Corpo; ou fachada C# em um Behavior. **Uso:** **Monitorar:** Permite publicar eventos deste sensor. Desligado não significa desativar o collider visual ou outro sensor. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Motion

```csharp public Astra.Components.PhysicsBody.MotionOption Motion { get; set; } ``` Movimento **Caminho:** Inspector → Corpo físico → Corpo; ou fachada C# em um Behavior. **Uso:** **Movimento:** Escolhe autoridade estática/cinemática/dinâmica no domínio do corpo. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Object

```csharp public Astra.GameObject Object { get; } ``` **Caminho:** Inspector → Corpo físico; ou fachada C# em um Behavior. **Uso:** Objeto dono deste componente; use para resolver composição. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Restitution

```csharp public float Restitution { get; set; } ``` Restituição Faixa válida: 0 a 1. **Caminho:** Inspector → Corpo físico → Material; ou fachada C# em um Behavior. **Uso:** **Restituição:** Restituição nos contatos; controla ressalto conforme a combinação física. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

RestitutionCombine

```csharp public Astra.Components.PhysicsBody.RestitutionCombineOption RestitutionCombine { get; set; } ``` Combinar restituição. Num par, vale o modo de maior precedência. Padrão: o maior valor **Caminho:** Inspector → Corpo físico → Material; ou fachada C# em um Behavior. **Uso:** **Combinar restituição:** Política de combinar restituição do par. Compare em uma queda controlada; não muda o material visual. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Sensor

```csharp public bool Sensor { get; set; } ``` Sensor sem resposta **Caminho:** Inspector → Corpo físico → Corpo; ou fachada C# em um Behavior. **Uso:** **Sensor sem resposta:** Participa como sensor/sobreposição; não é uma superfície sólida de contato. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

SolverVelocitySteps

```csharp public float SolverVelocitySteps { get; set; } ``` Iterações de velocidade. 0 usa as iterações do mundo; aumenta custo por ilha de contato Faixa válida: 0 a 255. **Caminho:** Inspector → Corpo físico → Simulação; ou fachada C# em um Behavior. **Uso:** **Iterações de velocidade:** 0 usa as iterações do mundo; aumenta custo por ilha de contato **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Surface

```csharp public Astra.Components.PhysicsBody.SurfaceOption Surface { get; set; } ``` Superfície. Tipo de superfície lido por scripts no acerto e no contato (passos, faíscas, sons) **Caminho:** Inspector → Corpo físico → Material; ou fachada C# em um Behavior. **Uso:** **Superfície:** Classificação da superfície para consumidores como regras de passos. Selecionar o valor não cria som ou Behavior automaticamente. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

TypeId

```csharp public static string TypeId { get; } ``` **Caminho:** Inspector → Corpo físico; ou fachada C# em um Behavior. **Uso:** Identificador nativo usado em AddComponent/GetComponent. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Velocity

```csharp public System.Numerics.Vector3 Velocity { get; set; } ``` Velocidade inicial **Caminho:** Inspector → Corpo físico → Início; ou fachada C# em um Behavior. **Uso:** **Velocidade inicial X:** Velocidade linear inicial/autorada do corpo, eixo X. **Velocidade inicial Y:** Velocidade linear inicial/autorada do corpo, eixo Y. **Velocidade inicial Z:** Velocidade linear inicial/autorada do corpo, eixo Z. **Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.