Pular para o conteúdo
AstraDOCS

Junta

Astra 0.2.3-preview.20261007Conferido em fonteReferência revisada · 07 out. 2026

Nove mecanismos Jolt com limites, referenciais e motores

Família: Física 3D · Grupo: Juntas · Identificador: astra.physics.joint · Payload: 3

Nove mecanismos Jolt com limites, referenciais e motores

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.

Hierarquia → selecione o objeto → Inspector → Adicionar componente → Física 3D / Juntas → Junta.

O schema permite múltiplas instâncias no mesmo objeto; identifique a instância antes de editar ou remover. A fachada C# correspondente é Astra.Components.Joint.

Quebra por força/torque remove a restrição do solver e publica o evento em runtime. O componente autoral permanece. Zero conserva a junta sem quebra por esse limite; a quebra no Play não vira exclusão salva.

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.

Nenhuma regra adicional declarada no schema deste componente.

Operação Contrato
Adicionar/remover em Play ponto seguro
Alterar propriedades em Play ponto seguro
Múltiplas instâncias Sim
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.

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.

Propriedade Tipo / unidade Padrão Domínio
Âncora A · X
anchor_a_x
número 0 -100000 … 100000
Âncora A · Y
anchor_a_y
número 0 -100000 … 100000
Âncora A · Z
anchor_a_z
número 0 -100000 … 100000
Âncora B · X
anchor_b_x
número 0 -100000 … 100000
Âncora B · Y
anchor_b_y
número 0 -100000 … 100000
Âncora B · Z
anchor_b_z
número 0 -100000 … 100000
Conectar corpo
connected_body
referência Escolher corpo astra.physics.body · outro objeto

Âncora A · X · anchor_a_x

Onde: Inspector → Junta → Âncoras → Âncora A · X.

Uso e efeito: Posição da âncora no frame do corpo A, componente X. Configure os dois frames compatíveis.

Valor: 0 · Tipo: número · Domínio: -100000 … 100000.

Âncora A · Y · anchor_a_y

Onde: Inspector → Junta → Âncoras → Âncora A · Y.

Uso e efeito: Posição da âncora no frame do corpo A, componente Y. Configure os dois frames compatíveis.

Valor: 0 · Tipo: número · Domínio: -100000 … 100000.

Âncora A · Z · anchor_a_z

Onde: Inspector → Junta → Âncoras → Âncora A · Z.

Uso e efeito: Posição da âncora no frame do corpo A, componente Z. Configure os dois frames compatíveis.

Valor: 0 · Tipo: número · Domínio: -100000 … 100000.

Âncora B · X · anchor_b_x

Onde: Inspector → Junta → Âncoras → Âncora B · X.

Uso e efeito: Posição da âncora no frame do corpo B, componente X. Configure os dois frames compatíveis.

Valor: 0 · Tipo: número · Domínio: -100000 … 100000.

Âncora B · Y · anchor_b_y

Onde: Inspector → Junta → Âncoras → Âncora B · Y.

Uso e efeito: Posição da âncora no frame do corpo B, componente Y. Configure os dois frames compatíveis.

Valor: 0 · Tipo: número · Domínio: -100000 … 100000.

Âncora B · Z · anchor_b_z

Onde: Inspector → Junta → Âncoras → Âncora B · Z.

Uso e efeito: Posição da âncora no frame do corpo B, componente Z. Configure os dois frames compatíveis.

Valor: 0 · Tipo: número · Domínio: -100000 … 100000.

Conectar corpo · connected_body

Onde: Inspector → Junta → Âncoras → Conectar corpo.

Uso e efeito: Objeto com o corpo conectado; confira a cadeia de dependências.

Valor: Escolher corpo · Tipo: referência · Domínio: astra.physics.body · outro objeto.

Propriedade Tipo / unidade Padrão Domínio
Eixo A · X
axis_a_x
número 0 -1 … 1
Eixo A · Y
axis_a_y
número 1 -1 … 1
Eixo A · Z
axis_a_z
número 0 -1 … 1
Eixo B · X
axis_b_x
número 0 -1 … 1
Eixo B · Y
axis_b_y
número 1 -1 … 1
Eixo B · Z
axis_b_z
número 0 -1 … 1
Plano A · X
normal_a_x
número 1 -1 … 1
Plano A · Y
normal_a_y
número 0 -1 … 1
Plano A · Z
normal_a_z
número 0 -1 … 1
Plano B · X
normal_b_x
número 1 -1 … 1
Plano B · Y
normal_b_y
número 0 -1 … 1
Plano B · Z
normal_b_z
número 0 -1 … 1

Eixo A · X · axis_a_x

Onde: Inspector → Junta → Eixos → Eixo A · X.

Uso e efeito: Direção do eixo no frame do corpo A, componente X. Configure os dois frames compatíveis.

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

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

Eixo A · Y · axis_a_y

Onde: Inspector → Junta → Eixos → Eixo A · Y.

Uso e efeito: Direção do eixo no frame do corpo A, componente Y. Configure os dois frames compatíveis.

Valor: 1 · Tipo: número · Domínio: -1 … 1.

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

Eixo A · Z · axis_a_z

Onde: Inspector → Junta → Eixos → Eixo A · Z.

Uso e efeito: Direção do eixo no frame do corpo A, componente Z. Configure os dois frames compatíveis.

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

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

Eixo B · X · axis_b_x

Onde: Inspector → Junta → Eixos → Eixo B · X.

Uso e efeito: Direção do eixo no frame do corpo B, componente X. Configure os dois frames compatíveis.

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

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

Eixo B · Y · axis_b_y

Onde: Inspector → Junta → Eixos → Eixo B · Y.

Uso e efeito: Direção do eixo no frame do corpo B, componente Y. Configure os dois frames compatíveis.

Valor: 1 · Tipo: número · Domínio: -1 … 1.

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

Eixo B · Z · axis_b_z

Onde: Inspector → Junta → Eixos → Eixo B · Z.

Uso e efeito: Direção do eixo no frame do corpo B, componente Z. Configure os dois frames compatíveis.

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

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

Plano A · X · normal_a_x

Onde: Inspector → Junta → Eixos → Plano A · X.

Uso e efeito: Normal de referência no frame do corpo A, componente X. Configure os dois frames compatíveis.

Valor: 1 · Tipo: número · Domínio: -1 … 1.

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

Plano A · Y · normal_a_y

Onde: Inspector → Junta → Eixos → Plano A · Y.

Uso e efeito: Normal de referência no frame do corpo A, componente Y. Configure os dois frames compatíveis.

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

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

Plano A · Z · normal_a_z

Onde: Inspector → Junta → Eixos → Plano A · Z.

Uso e efeito: Normal de referência no frame do corpo A, componente Z. Configure os dois frames compatíveis.

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

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

Plano B · X · normal_b_x

Onde: Inspector → Junta → Eixos → Plano B · X.

Uso e efeito: Normal de referência no frame do corpo B, componente X. Configure os dois frames compatíveis.

Valor: 1 · Tipo: número · Domínio: -1 … 1.

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

Plano B · Y · normal_b_y

Onde: Inspector → Junta → Eixos → Plano B · Y.

Uso e efeito: Normal de referência no frame do corpo B, componente Y. Configure os dois frames compatíveis.

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

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

Plano B · Z · normal_b_z

Onde: Inspector → Junta → Eixos → Plano B · Z.

Uso e efeito: Normal de referência no frame do corpo B, componente Z. Configure os dois frames compatíveis.

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

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

Propriedade Tipo / unidade Padrão Domínio
Limite mínimo
limit_min
número 0 -100000 … 100000
Limite máximo
limit_max
número 1 -100000 … 100000

Limite mínimo · limit_min

Onde: Inspector → Junta → Movimento → Limite mínimo.

Uso e efeito: Limite inferior da junta na unidade do tipo.

Valor: 0 · Tipo: número · Domínio: -100000 … 100000.

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

Limite máximo · limit_max

Onde: Inspector → Junta → Movimento → Limite máximo.

Uso e efeito: Limite superior da junta na unidade do tipo.

Valor: 1 · Tipo: número · Domínio: -100000 … 100000.

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

Propriedade Tipo / unidade Padrão Domínio
Velocidade do motor
motor_velocity
número 0 -1000 … 1000
Alvo do motor
motor_position
número 0 -100000 … 100000
Força / torque máximo
motor_force
número 100 0 … 1000000
Frequência · Hz
spring_frequency
número · Hz 2 0.001 … 1000
Amortecimento da mola
spring_damping
número 1 0 … 10
Motor
motor
enumeração Desligado Desligado | Velocidade | Posição | Posição e velocidade

Velocidade do motor · motor_velocity

Onde: Inspector → Junta → Motor → Velocidade do motor.

Uso e efeito: Velocidade alvo do motor da junta.

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

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

Alvo do motor · motor_position

Onde: Inspector → Junta → Motor → Alvo do motor.

Uso e efeito: Posição alvo do motor da junta.

Valor: 0 · Tipo: número · Domínio: -100000 … 100000.

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

Força / torque máximo · motor_force

Onde: Inspector → Junta → Motor → Força / torque máximo.

Uso e efeito: Força/torque máximo do motor, conforme o tipo de junta.

Valor: 100 · Tipo: número · Domínio: 0 … 1000000.

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

Frequência · Hz · spring_frequency

Onde: Inspector → Junta → Motor → Frequência · Hz.

Uso e efeito: Frequência da mola da junta.

Valor: 2 · Tipo: número · Unidade: Hz · Domínio: 0.001 … 1000.

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

Amortecimento da mola · spring_damping

Onde: Inspector → Junta → Motor → Amortecimento da mola.

Uso e efeito: Amortecimento da mola da junta.

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

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

Motor · motor

Onde: Inspector → Junta → Motor → Motor.

Uso e efeito: Modo de motor da junta; exige tipo e limites compatíveis.

Valor: Desligado · Tipo: enumeração · Domínio: Desligado | Velocidade | Posição | Posição e velocidade.

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

Propriedade Tipo / unidade Padrão Domínio
Cone · semiângulo Y
swing_y
número · ° 45 0 … 180
Cone · semiângulo Z
swing_z
número · ° 45 0 … 180
Torção mínima
twist_min
número · ° -45 -180 … 180
Torção máxima
twist_max
número · ° 45 -180 … 180

Cone · semiângulo Y · swing_y

Onde: Inspector → Junta → Rotação → Cone · semiângulo Y.

Uso e efeito: Limite de swing no eixo Y da junta.

Valor: 45 · Tipo: número · Unidade: ° · Domínio: 0 … 180.

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

Cone · semiângulo Z · swing_z

Onde: Inspector → Junta → Rotação → Cone · semiângulo Z.

Uso e efeito: Limite de swing no eixo Z da junta.

Valor: 45 · Tipo: número · Unidade: ° · Domínio: 0 … 180.

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

Torção mínima · twist_min

Onde: Inspector → Junta → Rotação → Torção mínima.

Uso e efeito: Limite inferior de twist.

Valor: -45 · Tipo: número · Unidade: ° · Domínio: -180 … 180.

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

Torção máxima · twist_max

Onde: Inspector → Junta → Rotação → Torção máxima.

Uso e efeito: Limite superior de twist.

Valor: 45 · Tipo: número · Unidade: ° · Domínio: -180 … 180.

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

Propriedade Tipo / unidade Padrão Domínio
Limite mínimo
linear_x_minimum
número · u -1 -100000 … 100000
Limite máximo
linear_x_maximum
número · u 1 -100000 … 100000
Atrito máximo
linear_x_friction
número · N 0 0 … 1000000
Velocidade alvo
linear_x_velocity
número · u/s 0 -1000 … 1000
Posição alvo
linear_x_position
número · u 0 -100000 … 100000
Força máxima
linear_x_force
número · N 100 0 … 1000000
Frequência
linear_x_frequency
número · Hz 2 0.001 … 1000
Amortecimento
linear_x_damping
número 1 0 … 10
Movimento
linear_x_motion
enumeração Travado Travado | Limitado | Livre
Motor
linear_x_motor
enumeração Desligado Desligado | Velocidade | Posição | Posição e velocidade

Limite mínimo · linear_x_minimum

Onde: Inspector → Junta → Translação X → Limite mínimo.

Uso e efeito: Junta: limite inferior do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: -1 · Tipo: número · Unidade: u · Domínio: -100000 … 100000.

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

Limite máximo · linear_x_maximum

Onde: Inspector → Junta → Translação X → Limite máximo.

Uso e efeito: Junta: limite superior do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 1 · Tipo: número · Unidade: u · Domínio: -100000 … 100000.

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

Atrito máximo · linear_x_friction

Onde: Inspector → Junta → Translação X → Atrito máximo.

Uso e efeito: Junta: fricção no grau de liberdade do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 0 · Tipo: número · Unidade: N · Domínio: 0 … 1000000.

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

Velocidade alvo · linear_x_velocity

Onde: Inspector → Junta → Translação X → Velocidade alvo.

Uso e efeito: Junta: velocidade alvo do motor do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 0 · Tipo: número · Unidade: u/s · Domínio: -1000 … 1000.

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

Posição alvo · linear_x_position

Onde: Inspector → Junta → Translação X → Posição alvo.

Uso e efeito: Junta: posição/ângulo alvo do motor do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 0 · Tipo: número · Unidade: u · Domínio: -100000 … 100000.

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

Força máxima · linear_x_force

Onde: Inspector → Junta → Translação X → Força máxima.

Uso e efeito: Junta: força/torque máximo do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 100 · Tipo: número · Unidade: N · Domínio: 0 … 1000000.

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

Frequência · linear_x_frequency

Onde: Inspector → Junta → Translação X → Frequência.

Uso e efeito: Junta: frequência da mola do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 2 · Tipo: número · Unidade: Hz · Domínio: 0.001 … 1000.

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

Amortecimento · linear_x_damping

Onde: Inspector → Junta → Translação X → Amortecimento.

Uso e efeito: Junta: amortecimento da mola do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

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

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

Movimento · linear_x_motion

Onde: Inspector → Junta → Translação X → Movimento.

Uso e efeito: Junta: política livre/limitado/travado do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: Travado · Tipo: enumeração · Domínio: Travado | Limitado | Livre.

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

Motor · linear_x_motor

Onde: Inspector → Junta → Translação X → Motor.

Uso e efeito: Junta: modo do motor do canal linear X. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: Desligado · Tipo: enumeração · Domínio: Desligado | Velocidade | Posição | Posição e velocidade.

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

Propriedade Tipo / unidade Padrão Domínio
Limite mínimo
linear_y_minimum
número · u -1 -100000 … 100000
Limite máximo
linear_y_maximum
número · u 1 -100000 … 100000
Atrito máximo
linear_y_friction
número · N 0 0 … 1000000
Velocidade alvo
linear_y_velocity
número · u/s 0 -1000 … 1000
Posição alvo
linear_y_position
número · u 0 -100000 … 100000
Força máxima
linear_y_force
número · N 100 0 … 1000000
Frequência
linear_y_frequency
número · Hz 2 0.001 … 1000
Amortecimento
linear_y_damping
número 1 0 … 10
Movimento
linear_y_motion
enumeração Travado Travado | Limitado | Livre
Motor
linear_y_motor
enumeração Desligado Desligado | Velocidade | Posição | Posição e velocidade

Limite mínimo · linear_y_minimum

Onde: Inspector → Junta → Translação Y → Limite mínimo.

Uso e efeito: Junta: limite inferior do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: -1 · Tipo: número · Unidade: u · Domínio: -100000 … 100000.

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

Limite máximo · linear_y_maximum

Onde: Inspector → Junta → Translação Y → Limite máximo.

Uso e efeito: Junta: limite superior do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 1 · Tipo: número · Unidade: u · Domínio: -100000 … 100000.

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

Atrito máximo · linear_y_friction

Onde: Inspector → Junta → Translação Y → Atrito máximo.

Uso e efeito: Junta: fricção no grau de liberdade do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 0 · Tipo: número · Unidade: N · Domínio: 0 … 1000000.

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

Velocidade alvo · linear_y_velocity

Onde: Inspector → Junta → Translação Y → Velocidade alvo.

Uso e efeito: Junta: velocidade alvo do motor do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 0 · Tipo: número · Unidade: u/s · Domínio: -1000 … 1000.

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

Posição alvo · linear_y_position

Onde: Inspector → Junta → Translação Y → Posição alvo.

Uso e efeito: Junta: posição/ângulo alvo do motor do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 0 · Tipo: número · Unidade: u · Domínio: -100000 … 100000.

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

Força máxima · linear_y_force

Onde: Inspector → Junta → Translação Y → Força máxima.

Uso e efeito: Junta: força/torque máximo do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 100 · Tipo: número · Unidade: N · Domínio: 0 … 1000000.

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

Frequência · linear_y_frequency

Onde: Inspector → Junta → Translação Y → Frequência.

Uso e efeito: Junta: frequência da mola do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 2 · Tipo: número · Unidade: Hz · Domínio: 0.001 … 1000.

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

Amortecimento · linear_y_damping

Onde: Inspector → Junta → Translação Y → Amortecimento.

Uso e efeito: Junta: amortecimento da mola do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

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

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

Movimento · linear_y_motion

Onde: Inspector → Junta → Translação Y → Movimento.

Uso e efeito: Junta: política livre/limitado/travado do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: Travado · Tipo: enumeração · Domínio: Travado | Limitado | Livre.

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

Motor · linear_y_motor

Onde: Inspector → Junta → Translação Y → Motor.

Uso e efeito: Junta: modo do motor do canal linear Y. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: Desligado · Tipo: enumeração · Domínio: Desligado | Velocidade | Posição | Posição e velocidade.

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

Propriedade Tipo / unidade Padrão Domínio
Limite mínimo
linear_z_minimum
número · u -1 -100000 … 100000
Limite máximo
linear_z_maximum
número · u 1 -100000 … 100000
Atrito máximo
linear_z_friction
número · N 0 0 … 1000000
Velocidade alvo
linear_z_velocity
número · u/s 0 -1000 … 1000
Posição alvo
linear_z_position
número · u 0 -100000 … 100000
Força máxima
linear_z_force
número · N 100 0 … 1000000
Frequência
linear_z_frequency
número · Hz 2 0.001 … 1000
Amortecimento
linear_z_damping
número 1 0 … 10
Movimento
linear_z_motion
enumeração Travado Travado | Limitado | Livre
Motor
linear_z_motor
enumeração Desligado Desligado | Velocidade | Posição | Posição e velocidade

Limite mínimo · linear_z_minimum

Onde: Inspector → Junta → Translação Z → Limite mínimo.

Uso e efeito: Junta: limite inferior do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: -1 · Tipo: número · Unidade: u · Domínio: -100000 … 100000.

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

Limite máximo · linear_z_maximum

Onde: Inspector → Junta → Translação Z → Limite máximo.

Uso e efeito: Junta: limite superior do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 1 · Tipo: número · Unidade: u · Domínio: -100000 … 100000.

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

Atrito máximo · linear_z_friction

Onde: Inspector → Junta → Translação Z → Atrito máximo.

Uso e efeito: Junta: fricção no grau de liberdade do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 0 · Tipo: número · Unidade: N · Domínio: 0 … 1000000.

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

Velocidade alvo · linear_z_velocity

Onde: Inspector → Junta → Translação Z → Velocidade alvo.

Uso e efeito: Junta: velocidade alvo do motor do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 0 · Tipo: número · Unidade: u/s · Domínio: -1000 … 1000.

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

Posição alvo · linear_z_position

Onde: Inspector → Junta → Translação Z → Posição alvo.

Uso e efeito: Junta: posição/ângulo alvo do motor do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 0 · Tipo: número · Unidade: u · Domínio: -100000 … 100000.

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

Força máxima · linear_z_force

Onde: Inspector → Junta → Translação Z → Força máxima.

Uso e efeito: Junta: força/torque máximo do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 100 · Tipo: número · Unidade: N · Domínio: 0 … 1000000.

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

Frequência · linear_z_frequency

Onde: Inspector → Junta → Translação Z → Frequência.

Uso e efeito: Junta: frequência da mola do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 2 · Tipo: número · Unidade: Hz · Domínio: 0.001 … 1000.

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

Amortecimento · linear_z_damping

Onde: Inspector → Junta → Translação Z → Amortecimento.

Uso e efeito: Junta: amortecimento da mola do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

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

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

Movimento · linear_z_motion

Onde: Inspector → Junta → Translação Z → Movimento.

Uso e efeito: Junta: política livre/limitado/travado do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: Travado · Tipo: enumeração · Domínio: Travado | Limitado | Livre.

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

Motor · linear_z_motor

Onde: Inspector → Junta → Translação Z → Motor.

Uso e efeito: Junta: modo do motor do canal linear Z. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: Desligado · Tipo: enumeração · Domínio: Desligado | Velocidade | Posição | Posição e velocidade.

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

Propriedade Tipo / unidade Padrão Domínio
Limite mínimo
angular_x_minimum
número · ° -1 -180 … 180
Limite máximo
angular_x_maximum
número · ° 1 -180 … 180
Atrito máximo
angular_x_friction
número · Nm 0 0 … 1000000
Velocidade alvo
angular_x_velocity
número · °/s 0 -1000 … 1000
Posição alvo
angular_x_position
número · ° 0 -180 … 180
Força máxima
angular_x_force
número · Nm 100 0 … 1000000
Frequência
angular_x_frequency
número · Hz 2 0.001 … 1000
Amortecimento
angular_x_damping
número 1 0 … 10
Movimento
angular_x_motion
enumeração Travado Travado | Limitado | Livre
Motor
angular_x_motor
enumeração Desligado Desligado | Velocidade | Posição | Posição e velocidade

Limite mínimo · angular_x_minimum

Onde: Inspector → Junta → Rotação X → Limite mínimo.

Uso e efeito: Junta: limite inferior do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: -1 · Tipo: número · Unidade: ° · Domínio: -180 … 180.

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

Limite máximo · angular_x_maximum

Onde: Inspector → Junta → Rotação X → Limite máximo.

Uso e efeito: Junta: limite superior do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 1 · Tipo: número · Unidade: ° · Domínio: -180 … 180.

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

Atrito máximo · angular_x_friction

Onde: Inspector → Junta → Rotação X → Atrito máximo.

Uso e efeito: Junta: fricção no grau de liberdade do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 0 · Tipo: número · Unidade: Nm · Domínio: 0 … 1000000.

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

Velocidade alvo · angular_x_velocity

Onde: Inspector → Junta → Rotação X → Velocidade alvo.

Uso e efeito: Junta: velocidade alvo do motor do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 0 · Tipo: número · Unidade: °/s · Domínio: -1000 … 1000.

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

Posição alvo · angular_x_position

Onde: Inspector → Junta → Rotação X → Posição alvo.

Uso e efeito: Junta: posição/ângulo alvo do motor do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 0 · Tipo: número · Unidade: ° · Domínio: -180 … 180.

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

Força máxima · angular_x_force

Onde: Inspector → Junta → Rotação X → Força máxima.

Uso e efeito: Junta: força/torque máximo do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 100 · Tipo: número · Unidade: Nm · Domínio: 0 … 1000000.

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

Frequência · angular_x_frequency

Onde: Inspector → Junta → Rotação X → Frequência.

Uso e efeito: Junta: frequência da mola do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 2 · Tipo: número · Unidade: Hz · Domínio: 0.001 … 1000.

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

Amortecimento · angular_x_damping

Onde: Inspector → Junta → Rotação X → Amortecimento.

Uso e efeito: Junta: amortecimento da mola do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

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

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

Movimento · angular_x_motion

Onde: Inspector → Junta → Rotação X → Movimento.

Uso e efeito: Junta: política livre/limitado/travado do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: Travado · Tipo: enumeração · Domínio: Travado | Limitado | Livre.

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

Motor · angular_x_motor

Onde: Inspector → Junta → Rotação X → Motor.

Uso e efeito: Junta: modo do motor do canal angular X. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: Desligado · Tipo: enumeração · Domínio: Desligado | Velocidade | Posição | Posição e velocidade.

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

Propriedade Tipo / unidade Padrão Domínio
Limite mínimo
angular_y_minimum
número · ° -1 -180 … 180
Limite máximo
angular_y_maximum
número · ° 1 -180 … 180
Atrito máximo
angular_y_friction
número · Nm 0 0 … 1000000
Velocidade alvo
angular_y_velocity
número · °/s 0 -1000 … 1000
Posição alvo
angular_y_position
número · ° 0 -180 … 180
Força máxima
angular_y_force
número · Nm 100 0 … 1000000
Frequência
angular_y_frequency
número · Hz 2 0.001 … 1000
Amortecimento
angular_y_damping
número 1 0 … 10
Movimento
angular_y_motion
enumeração Travado Travado | Limitado | Livre
Motor
angular_y_motor
enumeração Desligado Desligado | Velocidade | Posição | Posição e velocidade

Limite mínimo · angular_y_minimum

Onde: Inspector → Junta → Rotação Y → Limite mínimo.

Uso e efeito: Junta: limite inferior do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: -1 · Tipo: número · Unidade: ° · Domínio: -180 … 180.

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

Limite máximo · angular_y_maximum

Onde: Inspector → Junta → Rotação Y → Limite máximo.

Uso e efeito: Junta: limite superior do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 1 · Tipo: número · Unidade: ° · Domínio: -180 … 180.

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

Atrito máximo · angular_y_friction

Onde: Inspector → Junta → Rotação Y → Atrito máximo.

Uso e efeito: Junta: fricção no grau de liberdade do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 0 · Tipo: número · Unidade: Nm · Domínio: 0 … 1000000.

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

Velocidade alvo · angular_y_velocity

Onde: Inspector → Junta → Rotação Y → Velocidade alvo.

Uso e efeito: Junta: velocidade alvo do motor do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 0 · Tipo: número · Unidade: °/s · Domínio: -1000 … 1000.

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

Posição alvo · angular_y_position

Onde: Inspector → Junta → Rotação Y → Posição alvo.

Uso e efeito: Junta: posição/ângulo alvo do motor do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 0 · Tipo: número · Unidade: ° · Domínio: -180 … 180.

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

Força máxima · angular_y_force

Onde: Inspector → Junta → Rotação Y → Força máxima.

Uso e efeito: Junta: força/torque máximo do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 100 · Tipo: número · Unidade: Nm · Domínio: 0 … 1000000.

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

Frequência · angular_y_frequency

Onde: Inspector → Junta → Rotação Y → Frequência.

Uso e efeito: Junta: frequência da mola do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 2 · Tipo: número · Unidade: Hz · Domínio: 0.001 … 1000.

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

Amortecimento · angular_y_damping

Onde: Inspector → Junta → Rotação Y → Amortecimento.

Uso e efeito: Junta: amortecimento da mola do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

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

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

Movimento · angular_y_motion

Onde: Inspector → Junta → Rotação Y → Movimento.

Uso e efeito: Junta: política livre/limitado/travado do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: Travado · Tipo: enumeração · Domínio: Travado | Limitado | Livre.

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

Motor · angular_y_motor

Onde: Inspector → Junta → Rotação Y → Motor.

Uso e efeito: Junta: modo do motor do canal angular Y. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: Desligado · Tipo: enumeração · Domínio: Desligado | Velocidade | Posição | Posição e velocidade.

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

Propriedade Tipo / unidade Padrão Domínio
Limite mínimo
angular_z_minimum
número · ° -1 -180 … 180
Limite máximo
angular_z_maximum
número · ° 1 -180 … 180
Atrito máximo
angular_z_friction
número · Nm 0 0 … 1000000
Velocidade alvo
angular_z_velocity
número · °/s 0 -1000 … 1000
Posição alvo
angular_z_position
número · ° 0 -180 … 180
Força máxima
angular_z_force
número · Nm 100 0 … 1000000
Frequência
angular_z_frequency
número · Hz 2 0.001 … 1000
Amortecimento
angular_z_damping
número 1 0 … 10
Movimento
angular_z_motion
enumeração Travado Travado | Limitado | Livre
Motor
angular_z_motor
enumeração Desligado Desligado | Velocidade | Posição | Posição e velocidade

Limite mínimo · angular_z_minimum

Onde: Inspector → Junta → Rotação Z → Limite mínimo.

Uso e efeito: Junta: limite inferior do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: -1 · Tipo: número · Unidade: ° · Domínio: -180 … 180.

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

Limite máximo · angular_z_maximum

Onde: Inspector → Junta → Rotação Z → Limite máximo.

Uso e efeito: Junta: limite superior do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 1 · Tipo: número · Unidade: ° · Domínio: -180 … 180.

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

Atrito máximo · angular_z_friction

Onde: Inspector → Junta → Rotação Z → Atrito máximo.

Uso e efeito: Junta: fricção no grau de liberdade do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 0 · Tipo: número · Unidade: Nm · Domínio: 0 … 1000000.

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

Velocidade alvo · angular_z_velocity

Onde: Inspector → Junta → Rotação Z → Velocidade alvo.

Uso e efeito: Junta: velocidade alvo do motor do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 0 · Tipo: número · Unidade: °/s · Domínio: -1000 … 1000.

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

Posição alvo · angular_z_position

Onde: Inspector → Junta → Rotação Z → Posição alvo.

Uso e efeito: Junta: posição/ângulo alvo do motor do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 0 · Tipo: número · Unidade: ° · Domínio: -180 … 180.

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

Força máxima · angular_z_force

Onde: Inspector → Junta → Rotação Z → Força máxima.

Uso e efeito: Junta: força/torque máximo do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 100 · Tipo: número · Unidade: Nm · Domínio: 0 … 1000000.

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

Frequência · angular_z_frequency

Onde: Inspector → Junta → Rotação Z → Frequência.

Uso e efeito: Junta: frequência da mola do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: 2 · Tipo: número · Unidade: Hz · Domínio: 0.001 … 1000.

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

Amortecimento · angular_z_damping

Onde: Inspector → Junta → Rotação Z → Amortecimento.

Uso e efeito: Junta: amortecimento da mola do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

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

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

Movimento · angular_z_motion

Onde: Inspector → Junta → Rotação Z → Movimento.

Uso e efeito: Junta: política livre/limitado/travado do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: Travado · Tipo: enumeração · Domínio: Travado | Limitado | Livre.

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

Motor · angular_z_motor

Onde: Inspector → Junta → Rotação Z → Motor.

Uso e efeito: Junta: modo do motor do canal angular Z. O tipo de junta, modo e unidade definem quando tem efeito.

Valor: Desligado · Tipo: enumeração · Domínio: Desligado | Velocidade | Posição | Posição e velocidade.

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

Propriedade Tipo / unidade Padrão Domínio
Força de quebra
break_force
número · N 0 0 … 1000000000
Torque de quebra
break_torque
número · N·m 0 0 … 1000000000

Força de quebra · break_force

Onde: Inspector → Junta → Quebra → Força de quebra.

Uso e efeito: Limite de força para quebra da junta; zero conserva sem quebra por força. A quebra é estado do Play, não exclusão do componente autoral.

Valor: 0 · Tipo: número · Unidade: N · Domínio: 0 … 1000000000.

Torque de quebra · break_torque

Onde: Inspector → Junta → Quebra → Torque de quebra.

Uso e efeito: Limite de torque para quebra; zero conserva sem quebra por torque. Ligue um receptor ao evento para uma regra de gameplay.

Valor: 0 · Tipo: número · Unidade: N·m · Domínio: 0 … 1000000000.

Propriedade Tipo / unidade Padrão Domínio
Ativa
enabled
booleano verdadeiro verdadeiro | falso
Tipo
kind
enumeração Distância Ponto | Dobradiça | Deslizante | Distância | Fixa | Cone | Swing / Twist | Configurável 6DOF | Mola

Ativa · enabled

Onde: Inspector → Junta → Geral → Ativa.

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.

Tipo · kind

Onde: Inspector → Junta → Geral → Tipo.

Uso e efeito: Escolhe a variante de luz/junta no domínio indicado; siga os campos e requisitos condicionais.

Valor: Distância · Tipo: enumeração · Domínio: Ponto | Dobradiça | Deslizante | Distância | Fixa | Cone | Swing / Twist | Configurável 6DOF | Mola.

Física 3D e motores. 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.

  1. Crie Junta 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.

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. Essa referência não representa paridade funcional.

No Behavior, a fachada permite inscrever um receptor usando o owner vivo; a inscrição pertence ao lifecycle daquela execução. Uma Conexão de evento precisa de emissor, evento, receptor e ação: adicionar a conexão não define a regra do jogo.

Evento / ID Quando ocorre Dados enviados
Quebrou · broken Força ou torque passou do limite; a junta saiu do solver até o fim do Play (Unity OnJointBreak) Força ou torque: número