Skip to content

Latest commit

 

History

History
33 lines (25 loc) · 2.59 KB

ball-socket.md

File metadata and controls

33 lines (25 loc) · 2.59 KB
title description
BallSocketConstraint
BallSocketConstraint forces its two attachments into the same position and allows them to freely rotate about all three axes, with optional limits to restrict both tilt and twist.
For an overview on creating, visualizing, and simulating mechanical constraints, including `Class.BallSocketConstraint`, see [Mechanical Constraints](../../physics/mechanical-constraints.md). Also see [Roblox Units](../../physics/units.md) to understand how Roblox units compare to metric units.

A Class.BallSocketConstraint forces its two attachments into the same position and allows them to freely rotate about all three axes. However, you can enable limits to restrict both tilt and twist.

Limits

You can set limits to restrict both tilt and twist of a ball socket, similar to how a human's head can tilt and turn within a limited axial range. Enabling the Class.BallSocketConstraint.LimitsEnabled|LimitsEnabled property exposes the Class.BallSocketConstraint.UpperAngle|UpperAngle value to restrict tilt within a cone; it also exposes the Class.BallSocketConstraint.TwistLimitsEnabled|TwistLimitsEnabled property which, when enabled, lets you restrict twist rotation through the Class.BallSocketConstraint.TwistLowerAngle|TwistLowerAngle and Class.BallSocketConstraint.TwistUpperAngle|TwistUpperAngle limits.

UpperAngle = **30** TwistLimitsEnabled = **true**

Enabling Class.BallSocketConstraint.LimitsEnabled|LimitsEnabled also exposes the Class.BallSocketConstraint.Restitution|Restitution value which defines the elasticity of the attachments at their tilt and/or twist limits.

When `Class.BallSocketConstraint.LimitsEnabled|LimitsEnabled` is enabled, orientation of a ball socket's attachments affects how it rotates. To ensure rotation occurs around the desired axis, each attachment's `Class.Attachment.Axis|Axis`, visualized by the yellow arrow, should point in the same direction.