Reference API Roblox

Engine API

Website

Related

Reference API Roblox

SlidingBallConstraint

The base class for constraints that allow their attachments to slide along an axis but not rotate.

This class is not creatable. Instances of this class cannot be created with Instance.new.
Memory categoryPhysicsParts
Tags: [NotCreatable]

Member index 15

HistoryMember
553ActuatorType: ActuatorType
553CurrentPosition: float
553LimitsEnabled: bool
553LinearResponsiveness: float
553LowerLimit: float
553MotorMaxAcceleration: float
553MotorMaxForce: float
553Restitution: float
553ServoMaxForce: float
553Size: float
611SoftlockServoUponReachingTarget: bool
553Speed: float
553TargetPosition: float
553UpperLimit: float
553Velocity: float
inherited from Constraint
553Active: bool
553Attachment0: Attachment
553Attachment1: Attachment
553Color: BrickColor
553Enabled: bool
553Visible: bool
604GetDebugAppliedForce(bodyId: int): Vector3
604GetDebugAppliedTorque(bodyId: int): Vector3
inherited from Instance
553Archivable: bool
635Capabilities: SecurityCapabilities
553Name: string
553Parent: Instance
635Sandboxed: bool
616UniqueId: UniqueId
576AddTag(tag: string): null
573ClearAllChildren(): null
462Clone(): Instance
573Destroy(): null
486FindFirstAncestor(name: string): Instance
486FindFirstAncestorOfClass(className: string): Instance
486FindFirstAncestorWhichIsA(className: string): Instance
486FindFirstChild(name: string, recursive: bool = false): Instance
486FindFirstChildOfClass(className: string): Instance
486FindFirstChildWhichIsA(className: string, recursive: bool = false): Instance
486FindFirstDescendant(name: string): Instance
563GetActor(): Actor
486GetAttribute(attribute: string): Variant
462GetAttributeChangedSignal(attribute: string): RBXScriptSignal
631GetAttributes(): Dictionary
648GetChildren(): Instances
462GetDebugId(scopeLength: int = 4): string
486GetDescendants(): Array
486GetFullName(): string
641GetStyled(name: string): Variant
576GetTags(): Array
576HasTag(tag: string): bool
486IsAncestorOf(descendant: Instance): bool
486IsDescendantOf(ancestor: Instance): bool
580IsPropertyModified(name: string): bool
573Remove(): null
576RemoveTag(tag: string): null
580ResetPropertyToDefault(name: string): null
573SetAttribute(attribute: string, value: Variant): null
462WaitForChild(childName: string, timeOut: double): Instance
648children(): Instances
553clone(): Instance
573destroy(): null
553findFirstChild(name: string, recursive: bool = false): Instance
648getChildren(): Instances
553isDescendantOf(ancestor: Instance): bool
573remove(): null
462AncestryChanged(child: Instance, parent: Instance)
462AttributeChanged(attribute: string)
462ChildAdded(child: Instance)
462ChildRemoved(child: Instance)
462DescendantAdded(descendant: Instance)
462DescendantRemoving(descendant: Instance)
500Destroying()
553childAdded(child: Instance)
inherited from Object
647ClassName: string
647className: string
647GetPropertyChangedSignal(property: string): RBXScriptSignal
647IsA(className: string): bool
650isA(className: string): bool
647Changed(property: string)

Description

SlidingBallConstraint is the base class for constraints that allow their attachments to slide along an axis but not rotate, including PrismaticConstraint and CylindricalConstraint. This constrains the attachments so that their X axes are collinear but pointing in opposite directions. It also constrains the attachments so that their Y axes are parallel.

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.

History 61

Members 15

ActuatorType

TypeDefault
ActuatorType

Sets whether the translation of the SlidingBallConstraint is actuated and, if so, what kind of actuation.

Thread safetyReadSafe
CategorySlider
Loaded/Savedtrue

History 4

CurrentPosition

TypeDefault
float

The current offset between the constraint's Attachments.

This property is not replicated. Its interface does not cross the network boundary.
This property is read-only. Its value can be read, but it cannot be modified.
Thread safetyReadSafe
CategoryDerived
Loaded/Savedfalse/true

History 4

Tags: [ReadOnly, NotReplicated]

LimitsEnabled

TypeDefault
bool

Sets whether the SlidingBallConstraint will limit the range of translation. If true, this property exposes the LowerLimit and UpperLimit values, as well as Restitution which defines the elasticity of the attachments when they reach either limit.

Thread safetyReadSafe
CategorySlider
Loaded/Savedtrue

History 4

LinearResponsiveness

TypeDefault
float

Specifies the "sharpness" of the linear servo motor in reaching the TargetPosition when the derived classes' actuator type is set to Servo. Larger values correspond to faster a response and smaller values results in more damping and a slower response.

Thread safetyReadSafe
CategoryServo
Loaded/Savedtrue

History 3

LowerLimit

TypeDefault
float

The lower positional limit along the X axis of Attachment0 if LimitsEnabled is true.

Thread safetyReadSafe
CategoryLimits
Loaded/Savedtrue

History 4

MotorMaxAcceleration

TypeDefault
float

The constraint's maximum acceleration when ActuatorType is set to Motor, as the constraint attempts to reach its desired Velocity.

Thread safetyReadSafe
CategoryMotor
Loaded/Savedtrue

History 4

MotorMaxForce

TypeDefault
float

The constraint's maximum force when ActuatorType is set to Motor, as the constraint attempts to reach its desired Velocity.

Thread safetyReadSafe
CategoryMotor
Loaded/Savedtrue

History 4

Restitution

TypeDefault
float

The elasticity of the constraint's Attachments when they reach the end of the range specified by UpperLimit and LowerLimit, assuming LimitsEnabled is set to true. The valid range is between 0–1.

Thread safetyReadSafe
CategoryLimits
Loaded/Savedtrue

History 4

ServoMaxForce

TypeDefault
float

The constraint's maximum force when ActuatorType is set to Servo, as the constraint attempts to reach its desired Speed.

Thread safetyReadSafe
CategoryServo
Loaded/Savedtrue

History 4

Size

TypeDefault
float

The constraint's visualized size.

Thread safetyReadSafe
CategoryAppearance
Loaded/Savedtrue

History 4

  • 553 Change Default of Size from to
  • 486 Change ThreadSafety of Size from ReadOnly to ReadSafe
  • 462 Change ThreadSafety of Size from to ReadOnly
  • 261 Add Size

SoftlockServoUponReachingTarget

TypeDefault
bool
This property is deprecated. It exists only for backward compatibility, and should not be used for new work.
Thread safetyReadSafe
CategoryServo
Loaded/Savedtrue

History 2

Tags: [Deprecated]

Speed

TypeDefault
float

The constraint's desired speed when ActuatorType is set to Servo, as the constraint translates towards its TargetPosition. Measured in studs per second.

Thread safetyReadSafe
CategoryServo
Loaded/Savedtrue

History 4

TargetPosition

TypeDefault
float

The constraint's attempted target position when ActuatorType is set to Servo Measured in studs.

Thread safetyReadSafe
CategoryServo
Loaded/Savedtrue

History 4

UpperLimit

TypeDefault
float

The upper positional limit along the X axis of Attachment0 if LimitsEnabled is true.

Thread safetyReadSafe
CategoryLimits
Loaded/Savedtrue

History 4

Velocity

TypeDefault
float

The constraint's attempted velocity when ActuatorType is set to Motor. Measured in studs per second.

Thread safetyReadSafe
CategoryMotor
Loaded/Savedtrue

History 4

Settings