Cada ensamblaje en el motor de Roblox corresponde a un único cuerpo rígido. La posición y la velocidad de cada cuerpo rígido describen dónde se encuentra y qué tan rápido se está moviendo, y una de las tareas principales del motor es actualizar las posiciones y velocidades de cada ensamblaje.
Los ensamblajes pueden estar conectados entre sí mediante restricciones mecánicas y restricciones de movimiento para formar mecanismos como coches o aviones. A medida que aumenta el número de ensamblajes y restricciones en un mecanismo, también aumenta el tiempo requerido para simular el mecanismo. Afortunadamente, este aumento se compensa cuando el sistema de sueño determina que el motor puede omitir la simulación de ensamblajes que no se mueven.
Estados de sueño
Cada ensamblaje puede estar en uno de tres estados: despierto, durmiendo o verificando sueño.
Despierto
Un ensamblaje despierto se está moviendo o acelerando, y por lo tanto se simula. Los ensamblajes entran en este estado desde situaciones descritas en durmiendo y verificando sueño, así como en situaciones adicionales de despertar.
Durmiendo
Un ensamblaje durmiendo no se está moviendo ni acelerando, y por lo tanto no se simula.
Se determina que un ensamblaje no se está moviendo al verificar su velocidad lineal y velocidad rotacional. Si su velocidad lineal es menor que el umbral de Velocidad Lineal y su velocidad rotacional es menor que el umbral de Velocidad Rotacional, se considera que el ensamblaje no se está moviendo.
En algunos casos, simplemente verificar la falta de movimiento podría hacer que un ensamblaje entre incorrectamente en el estado de dormir. Por ejemplo, si se lanza una pelota hacia arriba, su velocidad se acerca a cero a medida que alcanza su altura máxima, lo que la convierte en una candidata para dormir y nunca volver a caer. Para manejar tales casos, el motor considera que un ensamblaje está acelerando si su aceleración lineal o aceleración rotacional son mayores que los umbrales de Aceleración Lineal y Aceleración Rotacional, respectivamente, y evitará que el ensamblaje se duerma.
Verificando sueño
Un ensamblaje que no se mueve y que comparte una restricción con al menos un ensamblaje despierto se coloca en el estado de verificando sueño y no se simula. En cada paso del mundo, un ensamblaje en verificación de sueño verifica si:
- Su aceleración lineal es mayor que el umbral de Despertar Aceleración Lineal.
- Su aceleración rotacional es mayor que el umbral de Despertar Aceleración Rotacional.
- La velocidad lineal de un ensamblaje vecino es mayor que el umbral de Vecino Velocidad Lineal.
- La velocidad rotacional de un ensamblaje vecino es mayor que el umbral de Vecino Velocidad Rotacional.
Si alguna de estas condiciones es verdadera, o bajo cualquiera de las situaciones adicionales de despertar, el ensamblaje en verificación de sueño entra en el estado despierto.
Referencia de umbrales
La siguiente tabla proporciona los diversos umbrales de velocidad y aceleración utilizados para determinar si un ensamblaje se está moviendo o acelerando.
| Umbral | Valor | Cambio de estado |
|---|---|---|
| Velocidad Lineal | 0.33 studs/s | despierto ⟩ durmiendo |
| Velocidad Rotacional | 0.42 studs/s | despierto ⟩ durmiendo |
| Aceleración Lineal | 0.24 studs/s² | despierto ⟩ durmiendo |
| Aceleración Rotacional | 0.24 studs/s² | despierto ⟩ durmiendo |
| Vecino Velocidad Lineal | 0.48 studs/s | verificando sueño ⟩ despierto |
| Vecino Velocidad Rotacional | 0.59 studs/s | verificando sueño ⟩ despierto |
| Despertar Aceleración Lineal | 16.9 studs/s² | despierto ⟩ durmiendo |
| Despertar Aceleración Rotacional | 16.9 studs/s² | despierto ⟩ durmiendo |
Los umbrales de velocidad y aceleración rotacional reflejan la velocidad y aceleración de un punto ubicado en la esfera de contorno del ensamblaje (una esfera que contiene todas las partes en un ensamblaje) que se mueve rígidamente con el ensamblaje.
Juntas actuadas
A veces, los desarrolladores quieren mover partes muy lentamente utilizando una junta actuada, una restricción que aplica fuerza o movimiento para impulsar partes conectadas, como un HingeConstraint utilizando un Motor. Para apoyar estos escenarios, los ensamblajes conectados a juntas actuadas utilizan un umbral de velocidad de sueño más estricto. Esto retrasa cuando esos ensamblajes se duermen, permitiendo un movimiento lento y controlado sin que el sistema de física los ponga a dormir prematuramente.
Las siguientes se consideran juntas actuadas:
| Restricción | Configuración | Propiedades no cero requeridas |
|---|---|---|
| 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 |
Situaciones adicionales de despertar
Además de las situaciones descritas en verificando sueño y durmiendo, un ensamblaje entra en el estado despierto cuando:
Colisiona con otro ensamblaje que se mueve más rápido que 1 studs/s.
Cualquier propiedad relacionada con la física de cualquier BasePart dentro del ensamblaje cambia, incluyendo:
Se aplica un impulso no cero a cualquier BasePart dentro del ensamblaje a través de ApplyImpulse(), ApplyImpulseAtPosition(), o ApplyAngularImpulse().
Cualquier cambio de propiedad relacionado con la física en el Workspace que afectaría al ensamblaje, incluyendo:
Se crea una nueva Constraint con un Attachment que está parentado a un BasePart dentro del ensamblaje.
Cualquier cambio de propiedad para una Constraint con un Attachment que está parentado a un BasePart dentro del ensamblaje.
La propiedad CurrentAngle cambia para un Motor que está conectado a un BasePart dentro del ensamblaje.
El ensamblaje contiene un VehicleSeat con un personaje jugador sentado.
El ensamblaje está dentro del BlastRadius de una Explosion.
Visualización de depuración
Durante las pruebas de juego, puedes visualizar los estados de sueño de los ensamblajes activando las Partes Despiertas desde el widget de Opciones de Visualización en la esquina superior derecha de la vista 3D.

Una vez habilitado, las partes simuladas estarán contorneadas por su estado de sueño actual, con las partes despiertas contorneadas en rojo, las partes verificando sueño contorneadas en naranja, y las partes durmiendo sin contorno.