Skip to content

TorsionSpringConstraint

Not yet Class Physics

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.

0 Nova members · 15 modern Roblox members not implemented yet

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.