SlidingBallConstraint¶
The base class for constraints that allow their attachments to slide along an axis.
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¶
SlidingBallConstraint is the base class for constraints that allow their attachments to slide along an axis, including PrismaticConstraint and CylindricalConstraint. The base class does not restrict rotation. PrismaticConstraint prevents rotation, while CylindricalConstraint allows rotation about an axis.
When configuring this constraint, it may be helpful to study Roblox Units to understand how Roblox units compare to metric units.
Linear Power¶
If this constraint's ActuatorType is set to Motor, it attempts to translate the attachments with the goal of reaching Velocity. You can further control this translation through both MotorMaxAcceleration and MotorMaxForce.
If this constraint's ActuatorType is set to Servo, it attempts to translate the attachments to a set separation specified by TargetPosition. This translation is controlled by Speed, LinearResponsiveness, and ServoMaxForce.
Limits¶
You can set limits to restrict this constraint's sliding range. Enabling the LimitsEnabled property exposes the LowerLimit and UpperLimit values, as well as Restitution which defines the elasticity of the attachments when they reach either limit.
Inheritance¶
Object → Instance → Constraint → SlidingBallConstraint
Known subclasses: CylindricalConstraint, PrismaticConstraint
Properties¶
| Member | Signature | Summary |
|---|---|---|
ActuatorType |
ActuatorType: ActuatorType |
Sets whether the translation of the SlidingBallConstraint is actuated and, if so, what kind of actuation. |
CurrentPosition |
CurrentPosition: float |
The current offset between the constraint's Attachments. |
LimitsEnabled |
LimitsEnabled: bool |
Sets whether the SlidingBallConstraint will limit the range of translation. |
LinearResponsiveness |
LinearResponsiveness: float |
Specifies the "sharpness" of the linear servo motor in reaching the TargetPosition. |
LowerLimit |
LowerLimit: float |
The lower positional limit along the X axis of Attachment0 if LimitsEnabled is true. |
MotorMaxAcceleration |
MotorMaxAcceleration: float |
The constraint's maximum acceleration when ActuatorType is set to Motor as the constraint attempts t… |
MotorMaxForce |
MotorMaxForce: float |
The constraint's maximum force when ActuatorType is set to Motor, as the constraint attempts to reac… |
Restitution |
Restitution: float |
The elasticity of the constraint's Attachments when they reach the end of the range specified by UpperLimit and [… |
ServoMaxForce |
ServoMaxForce: float |
The constraint's maximum force when ActuatorType is set to Servo, as the constraint attempts to reac… |
Size |
Size: float |
The constraint's visualized size. |
SoftlockServoUponReachingTarget |
SoftlockServoUponReachingTarget: bool |
— |
Speed |
Speed: float |
The constraint's desired speed when ActuatorType is set to Servo, as the constraint translates towar… |
TargetPosition |
TargetPosition: float |
The constraint's attempted target position when ActuatorType is set to Servo. Measured in studs. |
UpperLimit |
UpperLimit: float |
The upper positional limit along the X axis of Attachment0 if LimitsEnabled is true. |
Velocity |
Velocity: float |
The constraint's attempted velocity when ActuatorType is set to Motor. Measured in studs per second. |
Roblox reference: SlidingBallConstraint
Generated from Nova's API dump and Roblox creator-docs. Nova-only members come from the engine's reflection metadata.