Cada conjunto no Roblox Engine corresponde a um único corpo rígido. A posição e a velocidade de cada corpo rígido descrevem onde ele está localizado e quão rápido está se movendo, e uma das principais tarefas do motor é atualizar as posições e velocidades de cada conjunto.
Os conjuntos podem ser conectados entre si com restrições mecânicas e restrições de mover para formar mecanismos como carros ou aviões. À medida que o número de conjuntos e restrições em um mecanismo aumenta, o tempo necessário para simular o mecanismo também aumenta. Felizmente, esse aumento é compensado quando o sistema de sono determina que o motor pode pular a simulação de conjuntos não-moventes.
Estados de sono
Cada conjunto pode estar em um de três estados: acordado, dormindo ou verificando sono.
Acordado
Um conjunto acordado está se movendo ou acelerando e, portanto, é simulado. Os conjuntos entram neste estado a partir de situações descritas em dormindo e verificando sono, bem como situações adicionais de despertar.
Dormindo
Um conjunto dormindo não está se movendo nem acelerando e, portanto, não é simulado.
Um conjunto é considerado não-movente ao verificar sua velocidade linear e velocidade rotacional. Se sua velocidade linear for menor que o limite de Velocidade Linear e sua velocidade rotacional for menor que o limite de Velocidade Rotacional, o conjunto é considerado não-movente.
Em alguns casos, simplesmente verificar a falta de movimento faria com que um conjunto entrasse incorretamente no estado de dormir. Por exemplo, se uma bola for lançada para cima, sua velocidade se aproxima de zero à medida que atinge sua altura máxima, tornando-a um candidato a dormir e nunca cair de volta. Para lidar com tais casos, o motor considera um conjunto como acelerando se sua aceleração linear ou aceleração rotacional forem maiores que os limites de Aceleração Linear e Aceleração Rotacional, respectivamente, e impedirá que o conjunto adormeça.
Verificando sono
Um conjunto não-movente que compartilha uma restrição com pelo menos um conjunto acordado vizinho é colocado no estado de verificando sono e não é simulado. A cada passo do mundo, um conjunto em verificação de sono verifica se:
- Sua aceleração linear é maior que o limite de Aceleração Linear de Despertar.
- Sua aceleração rotacional é maior que o limite de Aceleração Rotacional de Despertar.
- A velocidade linear de um conjunto vizinho é maior que o limite de Velocidade Linear Vizinha.
- A velocidade rotacional de um conjunto vizinho é maior que o limite de Velocidade Rotacional Vizinha.
Se alguma dessas condições for verdadeira, ou sob qualquer uma das situações adicionais de despertar, o conjunto em verificação de sono entra no estado acordado.
Referência de limites
A tabela a seguir fornece os vários limites de velocidade e aceleração usados para determinar se um conjunto está se movendo ou acelerando.
| Limite | Valor | Mudança de estado |
|---|---|---|
| Velocidade Linear | 0.33 studs/s | acordado ⟩ dormindo |
| Velocidade Rotacional | 0.42 studs/s | acordado ⟩ dormindo |
| Aceleração Linear | 0.24 studs/s² | acordado ⟩ dormindo |
| Aceleração Rotacional | 0.24 studs/s² | acordado ⟩ dormindo |
| Velocidade Linear Vizinha | 0.48 studs/s | verificando sono ⟩ acordado |
| Velocidade Rotacional Vizinha | 0.59 studs/s | verificando sono ⟩ acordado |
| Aceleração Linear de Despertar | 16.9 studs/s² | acordado ⟩ dormindo |
| Aceleração Rotacional de Despertar | 16.9 studs/s² | acordado ⟩ dormindo |
Os limites de velocidade e aceleração rotacional refletem a velocidade e a aceleração de um ponto localizado na esfera delimitadora do conjunto (uma esfera que contém todas as partes em um conjunto) que se move rigidamente com o conjunto.
Juntas atuadas
Às vezes, os desenvolvedores querem mover partes muito lentamente usando uma junta atuada, uma restrição que aplica força ou movimento para impulsionar partes conectadas, como um HingeConstraint usando um Motor. Para suportar esses cenários, conjuntos conectados a juntas atuadas usam um limite de velocidade de sono mais rigoroso. Isso atrasa quando esses conjuntos adormecem, permitindo movimento lento e controlado sem que o sistema de física os coloque para dormir prematuramente.
As seguintes são consideradas juntas atuadas:
| Restrição | Configuração | Propriedades não nulas necessárias |
|---|---|---|
| AlignOrientation | RigidityEnabled = false | |
| AlignPosition | RigidityEnabled = false | |
| AngularVelocity | — | |
| AnimationConstraint | IsKinematic = false | |
| CylindricalConstraint | ActuatorType = Motor | |
| ActuatorType = Servo | ||
| CylindricalConstraint | AngularActuatorType = Motor | |
| AngularActuatorType = Servo | ||
| HingeConstraint | ActuatorType = Motor | |
| ActuatorType = Servo | ||
| LinearVelocity | VelocityConstraintMode = Line |
|
| VelocityConstraintMode = Plane | ||
| VelocityConstraintMode = Vector | ||
| PrismaticConstraint | ActuatorType = Motor | |
| ActuatorType = Servo | ||
| RopeConstraint | WinchEnabled = true |
Situações adicionais de despertar
Além das situações descritas em verificando sono e dormindo, um conjunto entra no estado acordado quando:
Ele colide com outro conjunto se movendo mais rápido que 1 studs/s.
Qualquer propriedade relacionada à física de qualquer BasePart dentro do conjunto muda, incluindo:
Um impulso não nulo é aplicado a qualquer BasePart dentro do conjunto via ApplyImpulse(), ApplyImpulseAtPosition(), ou ApplyAngularImpulse().
Qualquer mudança de propriedade relacionada à física no Workspace que afetaria o conjunto, incluindo:
Um novo Constraint é criado com um Attachment que está parentado a um BasePart dentro do conjunto.
Qualquer mudança de propriedade para um Constraint com um Attachment que está parentado a um BasePart dentro do conjunto.
A propriedade CurrentAngle muda para um Motor que está conectado a um BasePart dentro do conjunto.
O conjunto contém um VehicleSeat com um personagem jogador sentado.
O conjunto está dentro do BlastRadius de uma Explosion.
Visualização de depuração
Durante os testes de jogo, você pode visualizar os estados de sono dos conjuntos ativando as Partes Acordadas no widget de Opções de Visualização no canto superior direito da viewport 3D.

Uma vez ativado, as partes simuladas serão contornadas pelo seu estado de sono atual, com partes acordadas contornadas em vermelho, partes verificando sono contornadas em laranja e partes dormindo sem contorno.