Sistema de sono

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

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:

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.

LimiteValorMudança de estado
Velocidade Linear0.33 studs/sacordado ⟩ dormindo
Velocidade Rotacional0.42 studs/sacordado ⟩ dormindo
Aceleração Linear0.24 studs/s²acordado ⟩ dormindo
Aceleração Rotacional0.24 studs/s²acordado ⟩ dormindo
Velocidade Linear Vizinha0.48 studs/sverificando sono ⟩ acordado
Velocidade Rotacional Vizinha0.59 studs/sverificando sono ⟩ acordado
Aceleração Linear de Despertar16.9 studs/s²acordado ⟩ dormindo
Aceleração Rotacional de Despertar16.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:

Situações adicionais de despertar

Além das situações descritas em verificando sono e dormindo, um conjunto entra no estado acordado quando:

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 visão aproximada da viewport 3D com o botão de Opções de Visualização indicado no canto superior direito.

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.

Partes simuladas contornadas pela cor representando seu estado de sono atual
©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.