Chaque assemblage dans le moteur Roblox correspond à un corps rigide unique. La position et la vitesse de chaque corps rigide décrivent où il se trouve et à quelle vitesse il se déplace, et l'une des tâches principales du moteur est de mettre à jour les positions et les vitesses de chaque assemblage.
Les assemblages peuvent être connectés ensemble avec des contraintes mécaniques et des contraintes de mouvement pour former des mécanismes tels que des voitures ou des avions. À mesure que le nombre d'assemblages et de contraintes dans un mécanisme augmente, le temps nécessaire pour simuler le mécanisme augmente également. Heureusement, cette augmentation est compensée lorsque le système de sommeil détermine que le moteur peut ignorer la simulation des assemblages non mobiles.
États de sommeil
Chaque assemblage peut être dans l'un des trois états : éveillé, endormi ou vérification de sommeil.
Éveillé
Un assemblage éveillé est en mouvement ou en accélération, et est donc simulé. Les assemblages entrent dans cet état à partir des situations décrites dans endormi et vérification de sommeil, ainsi que des situations de réveil supplémentaires.
Endormi
Un assemblage endormi n'est ni en mouvement ni en accélération, et n'est donc pas simulé.
Un assemblage est déterminé comme non mobile en vérifiant sa vitesse linéaire et sa vitesse de rotation. Si sa vitesse linéaire est inférieure au seuil de Vitesse linéaire et que sa vitesse de rotation est inférieure au seuil de Vitesse de rotation, l'assemblage est considéré comme non mobile.
Dans certains cas, vérifier simplement l'absence de mouvement pourrait amener un assemblage à entrer incorrectement dans l'état de sommeil. Par exemple, si une balle est lancée directement vers le haut, sa vitesse approche de zéro lorsqu'elle atteint sa hauteur maximale, ce qui en fait un candidat pour dormir et ne jamais retomber. Pour gérer de tels cas, le moteur considère un assemblage comme étant en accélération si son accélération linéaire ou son accélération de rotation sont supérieures aux seuils de Vitesse linéaire et Vitesse de rotation, respectivement, et empêchera l'assemblage de s'endormir.
Vérification de sommeil
Un assemblage non mobile qui partage une contrainte avec au moins un assemblage éveillé est placé dans l'état de vérification de sommeil et n'est pas simulé. À chaque étape du monde, un assemblage en vérification de sommeil vérifie si :
- Son accélération linéaire est supérieure au seuil de Réveil Accélération linéaire.
- Son accélération de rotation est supérieure au seuil de Réveil Accélération de rotation.
- La vitesse linéaire d'un assemblage voisin est supérieure au seuil de Vitesse linéaire voisine.
- La vitesse de rotation d'un assemblage voisin est supérieure au seuil de Vitesse de rotation voisine.
Si l'une de ces conditions est vraie, ou dans l'une des situations de réveil supplémentaires, l'assemblage en vérification de sommeil entre dans l'état éveillé.
Référence des seuils
Le tableau suivant fournit les différents seuils de vitesse et d'accélération utilisés pour déterminer si un assemblage est en mouvement ou en accélération.
| Seuil | Valeur | Changement d'état |
|---|---|---|
| Vitesse Linéaire | 0.33 studs/s | éveillé ⟩ endormi |
| Vitesse de Rotation | 0.42 studs/s | éveillé ⟩ endormi |
| Accélération Linéaire | 0.24 studs/s² | éveillé ⟩ endormi |
| Accélération de Rotation | 0.24 studs/s² | éveillé ⟩ endormi |
| Vitesse Linéaire Voisine | 0.48 studs/s | vérification de sommeil ⟩ éveillé |
| Vitesse de Rotation Voisine | 0.59 studs/s | vérification de sommeil ⟩ éveillé |
| Réveil Accélération Linéaire | 16.9 studs/s² | éveillé ⟩ endormi |
| Réveil Accélération de Rotation | 16.9 studs/s² | éveillé ⟩ endormi |
Les seuils de vitesse et d'accélération de rotation reflètent la vitesse et l'accélération d'un point situé sur la sphère englobante de l'assemblage (une sphère qui contient toutes les parties d'un assemblage) qui se déplace rigidement avec l'assemblage.
Joints actionnés
Parfois, les développeurs souhaitent déplacer des parties très lentement à l'aide d'un joint actionné, une contrainte qui applique une force ou un mouvement pour entraîner des parties connectées, comme un HingeConstraint utilisant un Motor. Pour prendre en charge ces scénarios, les assemblages connectés à des joints actionnés utilisent un seuil de vitesse de sommeil plus strict. Cela retarde le moment où ces assemblages s'endorment, permettant un mouvement lent et contrôlé sans que le système physique ne les mette prématurément au sommeil.
Les éléments suivants sont considérés comme des joints actionnés :
| Contrainte | Configuration | Propriétés non nulles requises |
|---|---|---|
| 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 |
Situations de réveil supplémentaires
En plus des situations décrites dans vérification de sommeil et endormi, un assemblage entre dans l'état éveillé lorsque :
Il entre en collision avec un autre assemblage se déplaçant plus vite que 1 studs/s.
Toute propriété liée à la physique de n'importe quel BasePart au sein de l'assemblage change, y compris :
Une impulsion non nulle est appliquée à n'importe quel BasePart au sein de l'assemblage via ApplyImpulse(), ApplyImpulseAtPosition(), ou ApplyAngularImpulse().
Tout changement de propriété lié à la physique sur le Workspace qui affecterait l'assemblage, y compris :
Un nouveau Constraint est créé avec un Attachment qui est parenté à un BasePart au sein de l'assemblage.
Tout changement de propriété pour un Constraint avec un Attachment qui est parenté à un BasePart au sein de l'assemblage.
La propriété CurrentAngle change pour un Motor qui est connecté à un BasePart au sein de l'assemblage.
L'assemblage contient un VehicleSeat avec un personnage joueur assis.
L'assemblage est à l'intérieur du BlastRadius d'une Explosion.
Visualisation de débogage
Lors des tests de jeu, vous pouvez visualiser les états de sommeil des assemblages en activant les Pièces éveillées depuis le widget Options de visualisation dans le coin supérieur droit de la vue 3D.

Une fois activé, les pièces simulées seront entourées par leur état de sommeil actuel, avec les pièces éveillées entourées de rouge, les pièces vérification de sommeil entourées d'orange, et les pièces endormies non entourées.