PcoWSkbVqDnWTu_dm2ix
Collapse Sidebar
  1. API Reference
  2. Attachment

Attachment

Show deprecated
Hide content
  1. apireference
  2. attachment

Attachment

Show deprecated

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

Attachments are used by several kinds of Constraint and are also valid parents for many objects that are otherwise parented directly to a BasePart, such as:

  • Particle-emitting objects like ParticleEmitter, Fire, etc, emit from the attachment
  • Light-emitting objects like PointLight and SpotLight shine from the attachment
  • Sound will use the attachment as the focal point of the sound

Properties

Vector3

Axis

[NotReplicated]

Represents the direction of the X-Axis, relative to the Attachment’s Attachment/Rotation, as a unit Vector3 with a length of 1.
CFrame

CFrame

Represents the CFrame offset of the Attachment.
Vector3

Orientation

[NotReplicated]

A Vector3 that describes the orientation of the Attachment relative to the orientation of its parent, in degrees. Rotations are applied in Z, X, Y order.
Vector3

Position

[NotReplicated]

A Vector3 that describes the positional offset of the Attachment, relative to the position and orientation of its parent.
Vector3

Rotation

[Hidden] [NotReplicated] [Deprecated]

A Vector3 that describes the rotation of the Attachment relative to the rotation of its parent, in degrees. Rotations are applied in Z, Y, X order.
Vector3

SecondaryAxis

[NotReplicated]

Represents the direction of the Y-Axis, relative to the Attachment’s Attachment/Rotation, as a unit Vector3 with a length of 1.
bool

Visible

Toggles the visibility of the Attachment in-game.
Vector3

WorldAxis

[NotReplicated]

Represents the direction of the Attachment|Attachment's Attachment/Axis|X-Axisrelative to the world, as a unitDataType/Vector3` with a length of 1
CFrame

WorldCFrame

[NotReplicated]

Describes the exact CFrame of the attachment in world-space coordinates
Vector3

WorldOrientation

[NotReplicated]

Describes the orientation (in degrees) of the Attachment|attachment relative to the world, rather than the parent of the Attachment.
Vector3

WorldPosition

[NotReplicated]

Describes the position of the attachment relative to the world, rather than the parent of the Attachment
Vector3

WorldRotation

[Hidden] [ReadOnly] [NotReplicated] [Deprecated]

Determines the rotation (in degrees) of the attachment relative to the world
Vector3

WorldSecondaryAxis

[NotReplicated]

Represents the direction of the Attachment/SecondaryAxis|Y-Axis of the Attachment, relative to the world, as a unit DataType/Vector3 with a length of 1

Inherited from Instance: Show Hide

bool

Archivable

Determines if an Instance can be cloned using /Instance/Clone or saved to file.
string

ClassName

[ReadOnly] [NotReplicated]

A read-only string representing the class this Instance belongs to
int

DataCost

[Hidden] [ReadOnly] [NotReplicated] [Deprecated]

The cost of saving the instance using data persistence.
string

Name

A non-unique identifier of the Instance
Instance

Parent

[NotReplicated]

Determines the hierarchical parent of the Instance
bool

RobloxLocked

[Hidden]

A deprecated property that used to protect CoreGui objects
bool

archivable

[Hidden] [NotReplicated] [Deprecated]
string

className

[ReadOnly] [NotReplicated] [Deprecated]

Functions

Vector3

GetAxis ( )

[Deprecated]

Returns the value of the Attachment’s Attachment/Axis
Vector3

GetSecondaryAxis ( )

[Deprecated]

Returns the value of the Attachment’s Attachment/SecondaryAxis
void

SetAxis ( Vector3 axis )

[Deprecated]

Sets the value of the Attachment’s Attachment/Axis
void

SetSecondaryAxis ( Vector3 axis )

[Deprecated]

Sets the value of the Attachment’s Attachment/SecondaryAxis

Inherited from Instance: Show Hide

void

ClearAllChildren ( )

This function destroys all of an Instance’s children.
Instance

Clone ( )

Create a copy of an object and all its descendants, ignoring objects that are not Instance/Archivable|Archivable
void

Destroy ( )

Sets the Instance/Parent property to nil, locks the Instance/Parent property, disconnects all connections and calls Destroy on all children.
Instance

FindFirstAncestor ( string name )

Returns the first ancestor of the Instance whose Instance/Name is equal to the given name.
Instance

FindFirstAncestorOfClass ( string className )

Returns the first ancestor of the Instance whose Instance/ClassName is equal to the given className.
Instance

FindFirstAncestorWhichIsA ( string className )

Returns the first ancestor of the Instance for whom Instance/IsA returns true for the given className.
Instance

FindFirstChild ( string name , bool recursive )

Returns the first child of the Instance found with the given name.
Instance

FindFirstChildOfClass ( string className )

Returns the first child of the Instance whose Instance/ClassName|ClassName is equal to the given className.
Instance

FindFirstChildWhichIsA ( string className , bool recursive )

Returns the first child of the Instance for whom Instance/IsA returns true for the given className.
Instance

FindFirstDescendant ( string name )

Actor

GetActor ( )

Variant

GetAttribute ( string attribute )

Returns the attribute which has been assigned to the given name
RBXScriptSignal

GetAttributeChangedSignal ( string attribute )

Returns an event that fires when the given attribute changes
Dictionary

GetAttributes ( )

Returns a dictionary of string → variant pairs for each of the Instance|Instance’s attributes
Objects

GetChildren ( )

Returns an array containing all of the Instance’s children.
string

GetDebugId ( int scopeLength )

[NotBrowsable]

Returns a coded string of the Instances DebugId used internally by Roblox.
Array

GetDescendants ( )

[CustomLuaState]

Returns an array containing all of the descendants of the instance
string

GetFullName ( )

Returns a string describing the Instance’s ancestry.
RBXScriptSignal

GetPropertyChangedSignal ( string property )

Get an event that fires when a given property of an object changes.
bool

IsA ( string className )

[CustomLuaState]

Returns true if an Instance’s class matches or inherits from a given class
bool

IsAncestorOf ( Instance descendant )

Returns true if an Instance is an ancestor of the given descendant.
bool

IsDescendantOf ( Instance ancestor )

Returns true if an Instance is a descendant of the given ancestor.
void

Remove ( )

[Deprecated]

Sets the object’s Parent to nil, and does the same for all its descendants.
void

SetAttribute ( string attribute , Variant value )

Sets the attribute with the given name to the given value
Instance

WaitForChild ( string childName , double timeOut )

[CustomLuaState] [CanYield]

Returns the child of the Instance with the given name. If the child does not exist, it will yield the current thread until it does.
Objects

children ( )

[Deprecated]

Returns an array of the object’s children.
Instance

clone ( )

[Deprecated]
void

destroy ( )

[Deprecated]
Instance

findFirstChild ( string name , bool recursive )

[Deprecated]
Objects

getChildren ( )

[Deprecated]
bool

isA ( string className )

[Deprecated] [CustomLuaState]
bool

isDescendantOf ( Instance ancestor )

[Deprecated]
void

remove ( )

[Deprecated]

Events

Inherited from Instance: Show Hide

RBXScriptSignal

AncestryChanged ( Instance child , Instance parent )

Fires when the Instance/Parent property of the object or one of its ancestors is changed.
RBXScriptSignal

AttributeChanged ( string attribute )

Fires whenever an attribute is changed on the Instance
RBXScriptSignal

Changed ( string property )

Fired immediately after a property of an object changes.
RBXScriptSignal

ChildAdded ( Instance child )

Fires when an object is parented to this Instance.
RBXScriptSignal

ChildRemoved ( Instance child )

Fires when a child is removed from this Instance.
RBXScriptSignal

DescendantAdded ( Instance descendant )

Fires when a descendant is added to the Instance
RBXScriptSignal

DescendantRemoving ( Instance descendant )

Fires immediately before a descendant of the Instance is removed.
RBXScriptSignal

childAdded ( Instance child )

[Deprecated]
AngularVelocity BallSocketConstraint