TorsionSpringConstraint¶
A rotational spring that opposes the angular motion between two axes.
Not implemented yet
This class exists in the current Roblox API but is not implemented in Nova yet. Scripts that reference it will fail at runtime.
Description¶
A TorsionSpringConstraint applies a torque based on a relative angle and a relative angular velocity. Specifically, torsion springs try to bring two axes from two parts together in a compliant way.
Correct orientation of a torsion spring's attachments is important. The constraint will attempt to bring the SecondaryAxis of each attachment into alignment. When building mechanisms like swinging doors, ensure that the secondary axes are perpendicular to the intended axis of rotation.
When configuring this constraint, it may be helpful to study Roblox Units to understand how Roblox units compare to metric units.
Damping¶
The Damping value controls how fast the spring's oscillation dies down. A value of 0 allows the spring to oscillate endlessly, while higher values bring the spring to a rest more quickly.
Stiffness¶
Stiffness sets the torsional strength of the spring. Higher values create a spring that responds with more force.
Limits¶
Enabling the LimitsEnabled property exposes the MaxAngle value to restrict the spring's range within a cone; it also exposes the Restitution value which defines the elasticity of the attachments when they reach their limit.
Inheritance¶
Object → Instance → Constraint → TorsionSpringConstraint
Properties¶
| Member | Signature | Summary |
|---|---|---|
Coils |
Coils: float |
The number of coils visualized for the constraint. |
CurrentAngle |
CurrentAngle: float |
The current angle, in degrees, of the limiting cone. |
Damping |
Damping: float |
Damping constant for the TorsionSpringConstraint. Multiplied to the velocity of the constraint's Attachments to reduce the… |
LimitEnabled |
LimitEnabled: bool |
— |
LimitsEnabled |
LimitsEnabled: bool |
Limits the relative angular motion of the secondary axes of attachments through a cone constraint. |
MaxAngle |
MaxAngle: float |
The maximum angle of the constraint's limiting cone. |
MaxTorque |
MaxTorque: float |
The maximum allowable torque provided by the torsion spring. |
Radius |
Radius: float |
The visualization radius of the spring. |
Restitution |
Restitution: float |
The restitution coefficient of the cone constraint. |
Stiffness |
Stiffness: float |
The torsional stiffness of the spring. |
Roblox reference: TorsionSpringConstraint
Generated from Nova's API dump and Roblox creator-docs. Nova-only members come from the engine's reflection metadata.