Attachment

Show Deprecated

An Attachment defines a point and orientation relative to a parent BasePart, Bone, or another Attachment. The offset is stored in the CFrame property. The offset can also be set through other properties, such as WorldCFrame.

Attachments are used by several kinds of Constraints and are also valid alternatives to BasePart as a parent for objects such as:

  • ParticleEmitters which will emit particles from the attachment's specific position/orientation instead of the BasePart bounds.
  • Light-emitting objects like PointLight and SpotLight which will shine from the attachment's position/orientation instead of the BasePart center.
  • Sound which will use the attachment's position as the sound's focal point, instead of the BasePart center.

Summary

Properties

Direction of the X axis of the attachment, represented as a unit Vector3.

NOT REPLICATED

CFrame offset of the attachment.

Orientation of the attachment relative to the orientation of its parent.

HIDDEN
NOT REPLICATED

Positional offset of the attachment, relative to the position and orientation of its parent.

HIDDEN
NOT REPLICATED

Direction of the Y axis of the attachment, represented as a unit Vector3.

NOT REPLICATED

Toggles the in-experience visibility of the attachment.

Direction of the X axis of the attachment relative to the world, represented as a unit Vector3 with a length of 1.

NOT REPLICATED

The exact CFrame of the attachment in world space coordinates.

NOT REPLICATED

Orientation of the attachment relative to the world rather than its own parent.

HIDDEN
NOT REPLICATED

Position of the attachment relative to the world rather than its own parent.

HIDDEN
NOT REPLICATED

Direction of the Y axis of the attachment relative to the world, represented as a unit Vector3 with a length of 1.

NOT REPLICATED

Methods

Events

Properties

Not Replicated

Direction of the X axis of the attachment, represented as a unit Vector3.

CFrame

The CFrame offset of the attachment. Changes to this property will reflect onto the Attachment.Position and Attachment.Rotation properties of this object. Similarly, a change to either of those properties will reflect onto this property.

Orientation

Hidden
Not Replicated

Orientation of the attachment relative to the orientation of its parent. Rotations are in ZXY order.

Position

Hidden
Not Replicated

Positional offset of the attachment, relative to the position and orientation of its parent.

SecondaryAxis

Not Replicated

Direction of the Y axis of the attachment, represented as a unit Vector3.

Visible

Toggles the in-experience visibility of the attachment.

WorldAxis

Not Replicated

Direction of the X axis of the attachment relative to the world, represented as a unit Vector3 with a length of 1.

WorldCFrame

Not Replicated

The exact CFrame of the attachment in world space coordinates, independent of its parent. The value of this property is equivalent to multiplying the CFrame of the attachment's parent by its own CFrame.

WorldOrientation

Hidden
Not Replicated

Orientation of the attachment relative to the world rather than its own parent. Rotations are in ZXY order.

WorldPosition

Hidden
Not Replicated

Position of the attachment relative to the world rather than its own parent.

WorldSecondaryAxis

Not Replicated

Direction of the Y axis of the attachment relative to the world, represented as a unit Vector3 with a length of 1.

Methods

GetConstraints


Returns

Events