A common type of
BasePart that comes in different primitive shapes.- Memory category
- BaseParts
- Own members
- 3
- Inherited members
- 202
- Subclasses
- 5
- Siblings
- 2
Properties112
Property categoryBehavior
- Determines if an
Instanceand its descendants can be cloned usingInstance:Clone(), and can be saved/published. - Deprecated: This deprecated property is a variant of
Instance.Archivablewhich should be used instead.Use Archivable instead.
Property categoryData
Property categoryPermissions
- The set of capabilities allowed to be used for scripts inside this container.
- Indicates whether the instance is inside a sandboxed container.
- When enabled, the instance can only access abilities in its
Capabilitieslist.
Property categoryPivot
- Editor-only property that displays and edits the pivot's
CFramerelative to the instance, moving only the pivot and leaving the instance in place.
Property categoryTransform
- Editor-only property that reads and sets the world
CFrameof thePVInstance's pivot, moving the entire instance when changed from the Studio Properties window.
Property categoryAppearance
- Determines the color of a part.
- Determines whether or not a part casts a shadow.
- Determines the color of a part.
- Determines the texture and default physical properties of a part.
- The name of
MaterialVariant. - Determines how much a part reflects the skybox.
- Determines how much a part can be seen through (the inverse of part opacity).
- Deprecated: This deprecated property is an old Camel Case variant of the Pascal Case
BasePart.BrickColor, which should be used instead.Use BrickColor instead.
Property categoryAssembly
- The angular velocity of the part's assembly.
- The center of mass of the part's assembly in world space.
- The linear velocity of the part's assembly.
- The total mass of the part's assembly.
- A reference to the root part of the assembly.
Property categoryBehavior
- Used to enable or disable aerodynamic forces on parts and assemblies.
Property categoryCollision
- Determines whether the part will physically interact with audio simulation, similar to
CastShadowfor lighting. - Determines whether a part may collide with other parts.
- Determines whether the part is considered during spatial query operations.
- Determines if
TouchedandTouchEndedevents fire on the part. - Describes the name of a part's collision group.
- Deprecated:
Describes the automatically set ID number of a part's collision group.Use CollisionGroup instead.
Property categoryData
- Determines a multiplier for
BasePart.Transparencythat is only visible to the local client. - Determines whether a part is selectable in Studio.
- Describes the faces on which a part may be resized.
- Describes the smallest change in size allowable by the
Resize()method. - The rotation of the part in degrees for the three axes.
- Deprecated: This property is deprecated. Use
AssemblyAngularVelocityinstead.
Determines a part's change in orientation over time.Use AssemblyAngularVelocity instead.
- Deprecated: This item is deprecated. See
BasePart.CustomPhysicalPropertiesto see how to configure the physical properties of BaseParts. Do not use it for new work.
The ratio of the part's density to the density of water determined by theBasePart.Material.Use SpecificGravity instead.
- Deprecated: This property is deprecated. Use
AssemblyLinearVelocityinstead.
Determines a part's change in position over time.Use AssemblyLinearVelocity instead.
Property categoryPart
- Determines whether a part is immovable by physics.
- Describes the world position in which a part's center of mass is located.
- Indicates the current physical properties of the part.
- Determines several physical properties of a part.
- Describes the mass of the part, the product of its density and volume.
- Determines whether the part contributes to the total mass or inertia of its rigid body.
- Time since last recorded physics update.
- The main rule in determining the root part of an assembly.
- Deprecated: This is only one of multiple physics-related properties. It has been deprecated in favor of
BasePart.CustomPhysicalProperties, which combines these properties into one.
Used to control the Elasticity of the part, but it no longer does anything. - Deprecated: This is only one of multiple physics-related properties. It has been deprecated in favor of
BasePart.CustomPhysicalProperties, which combines these properties into one.
Used to control the Friction of the part, but now it no longer does anything.
Property categorySurface
- Determines the type of surface for the back face of a part.
- Determines the type of surface for the bottom face of a part.
- Determines the type of surface for the front face of a part.
- Determines the type of surface for the left face of a part.
- Determines the type of surface for the right face of a part.
- Determines the type of surface for the top face of a part.
Property categorySurface Inputs
- Deprecated:
Determines the first parameter for the SurfaceType on the Back face of a part. - Deprecated:
Determines the second parameter for the SurfaceType on the Back face of a part. - Deprecated:
Determines the kind of input for the Back face of a part. - Deprecated:
Determines the first parameter for the SurfaceType on the Bottom face of a part. - Deprecated:
Determines the second parameter for the SurfaceType on the Bottom face of a part. - Deprecated:
Determines the kind of input for the Bottom face of a part. - Deprecated:
Determines the first parameter for the SurfaceType on the Front face of a part. - Deprecated:
Determines the second parameter for the SurfaceType on the Front face of a part. - Deprecated:
Determines the kind of input for the Front face of a part (-Z direction). - Deprecated:
Determines the first parameter for the SurfaceType on the Left face of a part. - Deprecated:
Determines the second parameter for the SurfaceType on the Left face of a part. - Deprecated:
Determines the kind of input for the Left face of a part. - Deprecated:
Determines the first parameter for the SurfaceType on the Right face of a part. - Deprecated:
Determines the second parameter for the SurfaceType on the Right face of a part. - Deprecated:
Determines the kind of input for the Right face of a part (-X direction). - Deprecated:
Determines the first parameter for the SurfaceType on the Top face of a part. - Deprecated:
Determines the second parameter for the SurfaceType on the Top face of a part. - Deprecated:
Determines the kind of input for the Top face of a part (+Y direction).
Property categoryTransform
- Determines the position and orientation of the
BasePartin the world. - The actual physical size of the
BasePartas regarded by the physics engine. - Describes the rotation of the part in the world.
- Describes the position of the part in the world.
- Determines the dimensions of a part (length, height, width).
Property categoryPart
- Deprecated: This property has been deprecated and should not be used in new work.
- Deprecated: This property has been deprecated and should not be used in new work.
Defined byPart3
Property categoryPart
Part.Shape: Enum.PartType = Enum.PartType.Block Sets the overall shape of the object.Part.shap: Enum.PartType Part.shape: Enum.PartType = Enum.PartType.Block
No properties match the filters.
Methods77
Object:GetPropertyChangedSignal( property: string): RBXScriptSignal Get an event that fires when a given property of the object changes.Parameters Parameter Description property: stringThe property to connect to.Returns Type Description RBXScriptSignalA signal that fires whenever the property changes.- Returns true if an object's class matches or inherits from a given class.
Parameters Parameter Description className: stringThe class against which the Object's class will be checked. Case-sensitive.Returns Type Description booleanDescribes whether the Object's class matched or is a subclass of the given class. - Deprecated: This deprecated function is a variant of
Object:IsA()which should be used instead.Parameters Parameter className: stringReturns Type booleanUse IsA instead.
- Applies a tag to the instance.
Parameters Parameter Description tag: stringThe tag to apply to the instance. - This method destroys all of an instance's children.
- Create a copy of an instance and all its descendants, ignoring instances that are not
Archivable.Returns Type Description InstanceA copy of the instance, ornilif the instance is notArchivable. - Sets the
Instance.Parentproperty tonil, locks theInstance.Parentproperty, disconnects all connections, and callsDestroy()on all children. Instance:FindFirstAncestor( name: string): Instance Returns the first ancestor of theInstancewhoseInstance.Nameis equal to the given name.Parameters Parameter Description name: stringTheInstance.Nameto be looked for.Instance:FindFirstAncestorOfClass( className: string): Instance Returns the first ancestor of theInstancewhoseObject.ClassNameis equal to the given className.Parameters Parameter Description className: stringTheObject.ClassNameto be looked for.Instance:FindFirstAncestorWhichIsA( className: string): Instance Returns the first ancestor of theInstancefor whomObject:IsA()returns true for the given className.Parameters Parameter Description className: stringTheObject.ClassNameto be looked for.Instance:FindFirstChild( name: string, recursive: boolean? = false): Instance Returns the first child of theInstancefound with the given name.Parameters Parameter Description name: stringTheInstance.Nameto be searched for.recursive: boolean? = falseWhether or not the search should be conducted recursively.Instance:FindFirstChildOfClass( className: string): Instance Parameters Parameter Description className: stringTheObject.ClassNameto be looked for.Instance:FindFirstChildWhichIsA(className: string,recursive: boolean? = false,): Instance Returns the first child of theInstancefor whomObject:IsA()returns true for the given className.Parameters Parameter Description className: stringTheObject.ClassNameto be searched for.recursive: boolean? = falseWhether or not the search should be conducted recursively.Instance:FindFirstDescendant( name: string): Instance Returns the first descendant found with the givenInstance.Name.Parameters Parameter Description name: stringTheInstance.Nameto search for.- Returns the
Actorassociated with the Instance, if any. Instance:GetAttribute( attribute: string): any Returns the value which has been assigned to the given attribute name.Parameters Parameter Description attribute: stringThe name of the attribute being retrieved.Returns Type Description anyThe value which has been assigned to the given attribute name. If no attribute has been assigned,nilis returned.Instance:GetAttributeChangedSignal( attribute: string): RBXScriptSignal Returns an event that fires when the given attribute changes.Parameters Parameter Description attribute: stringThe name of the specified attribute for which the change signal is being returned.Returns Type Description RBXScriptSignalAn event that fires when the given attribute changes.- Returns a dictionary of the instance's attributes.
Returns Type Description { [string]: any }A dictionary of string → variant pairs for each attribute where the string is the name of the attribute and the variant is a non-nil value. - Returns an array containing all of the instance's children.
Returns Type Description { Instance }An array containing the instance's children. Instance:GetDebugId( scopeLength: number? = 4): string Returns a coded string of the debug ID used internally by Roblox.Parameters Parameter Description scopeLength: number? = 4The scope length.Returns Type Description stringThe Debug ID string.- Returns an array containing all of the descendants of the instance.
Returns Type Description { Instance }An array containing the instance's descendants. - Returns a string describing the instance's ancestry.
- Returns the styled or explicitly modified value of the specified property, or else the default property value if it hasn't been styled/modified.
Parameters Parameter Description name: stringName of the property to query.selector: string?Optional selector for the pseudo instance you are targeting on the instance.Returns Type Description anyThe styled or explicitly modified value of the specified property, or else the default property value if it hasn't been styled/modified. Instance:GetStyledPropertyChangedSignal( property: string): RBXScriptSignal Returns an event that fires when the given style property changes on the instance.Parameters Parameter Description property: stringName of the style property for which to listen for changes.Returns Type Description RBXScriptSignalEvent that fires when the given style property changes.- Gets an array of all tags applied to the instance.
Returns Type Description { any }An array of strings, each representing a tag applied to the instance. - Check whether the instance has a given tag.
Parameters Parameter Description tag: stringThe tag to check for on the instance.Returns Type Description booleantrueif the instance has the given tag,falseotherwise. Instance:IsAncestorOf( descendant: Instance): boolean Returns true if anInstanceis an ancestor of the given descendant.Instance:IsDescendantOf( ancestor: Instance): boolean Returnstrueif anInstanceis a descendant of the given ancestor.Instance:IsPropertyModified( property: string): boolean Returnstrueif the value stored in the specified property is not equal to the code-instantiated default.Parameters Parameter Description property: stringName of the property to query.Returns Type Description booleanBoolean indicating whether the property is modified from its code‑instantiated default.Instance:QueryDescendants( selector: string): { Instance } Returns an array containing all descendants of the instance that match theselectorstring.Parameters Parameter Description selector: stringSelector string used to filter elements.Returns Type Description { Instance }An array of instances (empty if nothing matched the selector).- Removes a tag from the instance.
Parameters Parameter Description tag: stringThe tag to remove from the instance. Instance:ResetPropertyToDefault( property: string) Resets a property to its default value.Parameters Parameter Description property: stringName of the property to reset.Instance:SetAttribute( attribute: string, value: any) Sets the attribute with the given name to the given value.Instance:WaitForChild( childName: string, timeOut: number): Instance Returns the child of theInstancewith the given name. If the child does not exist, it will yield the current thread until it does.Parameters Parameter Description childName: stringTheInstance.Nameto be looked for.timeOut: numberAn optional time out parameter.- Deprecated: This item is deprecated in favor of
Instance:Destroy()andInstance:ClearAllChildren(). If you must remove an object from the game, and wish to use the object later, set itsParentproperty tonilinstead of using this method.
Sets the object'sParenttonil, and does the same for all its descendants. - Deprecated: This item has been superseded by
Instance:GetChildren()which should be used in all new work.
Returns an array of the object's children.Returns Type Description { Instance }Array of child objects/instances.Use GetChildren instead.
- Deprecated: This deprecated function is a variant of
Instance:Clone()which should be used instead.Returns Type InstanceUse Clone instead.
- Deprecated: This deprecated function is a variant of
Instance:Destroy()which should be used instead.Use Destroy instead.
Instance:findFirstChild( name: string, recursive: boolean? = false): Instance Deprecated: This deprecated function is a variant ofInstance:FindFirstChild()which should be used instead.Returns Type InstanceUse FindFirstChild instead.
- Deprecated: This deprecated function is a variant of
Instance:GetChildren()which should be used instead.Returns Type { Instance }Use GetChildren instead.
Instance:isDescendantOf( ancestor: Instance): boolean Deprecated: This deprecated function is a variant ofInstance:IsDescendantOf()which should be used instead.Parameters Parameter ancestor: InstanceReturns Type booleanUse IsDescendantOf instead.
- Deprecated: This deprecated function is a variant of
Instance:Remove()which has also been deprecated. Neither function should be used in new work.Use Remove instead.
- Gets the pivot of a
PVInstance. PVInstance:PivotTo( targetCFrame: CFrame) Transforms thePVInstancealong with all of its descendantPVInstancessuch that the pivot is now located at the specifiedCFrame.Parameters Parameter Description targetCFrame: CFrameTheCFramethat thePVInstancepivot should equal after moving it.
BasePart:AngularAccelerationToTorque(angAcceleration: Vector3,angVelocity: Vector3? = Vector3.zero,): Vector3 Returns the torque needed to achieve a given angular acceleration on this part's assembly, optionally accounting for gyroscopic effects.Parameters Parameter Description angAcceleration: Vector3The desired angular acceleration vector in world space.angVelocity: Vector3? = Vector3.zeroThe current angular velocity of the assembly in world space. Defaults to(0, 0, 0). Supply the assembly's angular velocity to account for gyroscopic effects.BasePart:ApplyAngularImpulse( impulse: Vector3) Apply an angular impulse to the assembly.Parameters Parameter Description impulse: Vector3An angular impulse vector to be applied to the assembly.BasePart:ApplyImpulse( impulse: Vector3) Apply an impulse to the assembly at the assembly'scenter of mass.Parameters Parameter Description impulse: Vector3A linear impulse vector to be applied to the assembly.BasePart:ApplyImpulseAtPosition( impulse: Vector3, position: Vector3) Apply an impulse to the assembly at specified position.Parameters Parameter callback: (...any) -> ...anyReturns Type RBXScriptConnectionBasePart:CanCollideWith( part: BasePart): boolean Returns whether the parts can collide with each other.Parameters Parameter Description part: BasePartThe specified part being checked for collidability.Returns Type Description booleanWhether the parts can collide with each other.- Checks whether you can set a part's network ownership.
Returns Type Description ...anyWhether you can modify or read the network ownership and the reason. BasePart:GetClosestPointOnSurface( position: Vector3): Vector3 Returns the closest point on the part's surface to the given point.Parameters Parameter Description position: Vector3The world-space point to find the closest surface point to.Returns Type Description Vector3The closest point on the part's surface in world space.BasePart:GetConnectedParts( recursive: boolean? = false): { Instance } Returns a table of parts connected to the object by any kind of rigid joint.Parameters Parameter Description recursive: boolean? = falseA table of parts connected to the object by any kind ofjoint.Returns Type Description { Instance }An array ofBasePartsconnected to this part by rigid joints. Ifrecursiveis true, includes all parts in the assembly.- Return all Joints or Constraints that is connected to this Part.
Returns Type Description { Instance }An array of all Joints or Constraints connected to the Part. - Returns the value of the
Massproperty.Returns Type Description numberThe part's mass. - Returns the current player who is the network owner of this part, or
nilin case of the server.Returns Type Description InstanceThe current player who is the network owner of this part, ornilin case of the server. - Returns true if the game engine automatically decides the network owner for this part.
Returns Type Description booleanWhether the game engine automatically decides the network owner for this part. - Returns the enabled
NoCollisionConstraintobjects currently registered for this part in its physics world.Returns Type Description { Instance }An array of the enabledNoCollisionConstraintobjects currently registered for this part in its physics world. Returns Type number- Returns a table of all
BasePart.CanCollidetrue parts that intersect with this part.Returns Type Description { Instance }A table of all parts that intersect and can collide with this part. BasePart:GetVelocityAtPosition( position: Vector3): Vector3 Returns the linear velocity of the part's assembly at the given position relative to this part.Parameters Parameter Description position: Vector3The world-space position at which to compute the assembly's linear velocity.BasePart:IntersectAsync(parts: { Instance },collisionfidelity: Enum.CollisionFidelity? = Enum.CollisionFidelity.Default,renderFidelity: Enum.RenderFidelity? = Enum.RenderFidelity.Automatic,): Instance Creates a newIntersectOperationfrom the overlapping geometry of the part and the other parts in the given array.Parameters Parameter Description parts: { Instance }The objects taking part in the intersection.collisionfidelity: Enum.CollisionFidelity? = Enum.CollisionFidelity.DefaultTheCollisionFidelityvalue for the resultingIntersectOperation.renderFidelity: Enum.RenderFidelity? = Enum.RenderFidelity.AutomaticTheRenderFidelityvalue of the resultingPartOperation.Returns Type Description InstanceResultingIntersectOperationwith default name Intersect.- Returns true if the object is connected to a part that will hold it in place (eg an
Anchoredpart), otherwise returns false.Returns Type Description booleanWhether the object is connected to a part that will hold it in place. BasePart:Resize( normalId: Enum.NormalId, deltaAmount: number): boolean Changes the size of an object just like using the Studio resize tool.Parameters Parameter Description normalId: Enum.NormalIdThe side to resize.deltaAmount: numberHow much to grow/shrink on the specified side.Returns Type Description booleanWhether the part is resized.BasePart:SetNetworkOwner( playerInstance: Player? = nil) Sets the given player as network owner for this and all connected parts.Parameters Parameter Description playerInstance: Player? = nilThe player being given network ownership of the part.- Lets the game engine dynamically decide who will handle the part's physics (one of the clients or the server).
BasePart:SubtractAsync(parts: { Instance },collisionfidelity: Enum.CollisionFidelity? = Enum.CollisionFidelity.Default,renderFidelity: Enum.RenderFidelity? = Enum.RenderFidelity.Automatic,): Instance Creates a newUnionOperationfrom the part, minus the geometry occupied by the parts in the given array.Parameters Parameter Description parts: { Instance }The objects taking part in the subtraction.collisionfidelity: Enum.CollisionFidelity? = Enum.CollisionFidelity.DefaultTheCollisionFidelityvalue for the resultingUnionOperation.renderFidelity: Enum.RenderFidelity? = Enum.RenderFidelity.AutomaticTheRenderFidelityvalue of the resultingPartOperation.Returns Type Description InstanceResultingUnionOperationwith default name Union.BasePart:TorqueToAngularAcceleration(torque: Vector3,angVelocity: Vector3? = Vector3.zero,): Vector3 Returns the angular acceleration that would result from applying a given torque to this part's assembly, optionally accounting for gyroscopic effects.BasePart:UnionAsync(parts: { Instance },collisionfidelity: Enum.CollisionFidelity? = Enum.CollisionFidelity.Default,renderFidelity: Enum.RenderFidelity? = Enum.RenderFidelity.Automatic,): Instance Creates a newUnionOperationfrom the part, plus the geometry occupied by the parts in the given array.Parameters Parameter Description parts: { Instance }The objects taking part in the union with the calling part.collisionfidelity: Enum.CollisionFidelity? = Enum.CollisionFidelity.DefaultTheCollisionFidelityvalue for the resultingUnionOperation.renderFidelity: Enum.RenderFidelity? = Enum.RenderFidelity.AutomaticTheRenderFidelityvalue of the resultingPartOperation.Returns Type Description InstanceResultingUnionOperationwith default name Union.- Deprecated: This method is deprecated. To break specific joints, iterate over the part's connections using
BasePart:GetJoints()and callInstance:Destroy()on the joints you want to remove.
Breaks any surface connection with any adjacent part, includingWeldand otherJointInstance. - Deprecated: This item is been deprecated since interpolation is now applied to the
CFramedirectly. Do not use it for new work.
OBSOLETE. Returns a CFrame describing where the part is being rendered at. - Deprecated:
Returns the base part of an assembly of parts.Returns Type Description InstanceThe base part of an assembly (a collection of parts connected together).Use AssemblyRootPart instead.
- Deprecated: SurfaceType based joining is deprecated, do not use MakeJoints for new projects.
WeldConstraintsandHingeConstraintsshould be used instead.
Creates a joint on any side of the object that has a surface ID that can make a joint. - Deprecated: This deprecated function is a variant of
BasePart:BreakJoints()which should be used instead.Use BreakJoints instead.
- Deprecated: This Camel Case property has been deprecated in favor of its Pascal Case variant,
BasePart:GetMass().Returns Type numberUse GetMass instead.
- Deprecated: This deprecated function is a variant of
BasePart:MakeJoints()which should be used instead. BasePart:resize( normalId: Enum.NormalId, deltaAmount: number): boolean Deprecated: This deprecated function is a variant ofBasePart:Resize()which should be used instead.Parameters Parameter normalId: Enum.NormalIddeltaAmount: numberReturns Type booleanUse Resize instead.
No methods match the filters.
Events16
Object.Changed: RBXScriptSignal<( property: string)> Fires immediately after a property of the object changes, with some limitations.Parameters Parameter property: string
Instance.AncestryChanged: RBXScriptSignal<( child: Instance, parent: Instance)> Fires when theInstance.Parentproperty of this object or one of its ancestors is changed.Instance.AttributeChanged: RBXScriptSignal<( attribute: string)> Fires whenever an attribute is changed on theInstance.Parameters Parameter attribute: stringInstance.ChildAdded: RBXScriptSignal<( child: Instance)> Fires after an object is parented to thisInstance.Parameters Parameter child: InstanceInstance.ChildRemoved: RBXScriptSignal<( child: Instance)> Fires after a child is removed from thisInstance.Parameters Parameter child: InstanceInstance.DescendantAdded: RBXScriptSignal<( descendant: Instance)> Fires after a descendant is added to theInstance.Parameters Parameter descendant: InstanceInstance.DescendantRemoving: RBXScriptSignal<( descendant: Instance)> Fires immediately before a descendant of theInstanceis removed.Parameters Parameter descendant: Instance- Fires immediately before (or is deferred until after) the instance is destroyed via
Instance:Destroy(). - Fires whenever any style property is changed on the instance, including when a property is set to
nil. Instance.childAdded: RBXScriptSignal<( child: Instance)> Deprecated: This deprecated event is a variant ofInstance.ChildAddedwhich should be used instead.Parameters Parameter child: InstanceUse ChildAdded instead.
BasePart.NetworkOwnerChanged: RBXScriptSignal<( systemAddress: SystemAddress)> Parameters Parameter systemAddress: SystemAddressBasePart.Touched: RBXScriptSignal<( otherPart: BasePart)> Fires when a part touches another part as a result of physical movement.Parameters Parameter otherPart: BasePartBasePart.TouchEnded: RBXScriptSignal<( otherPart: BasePart)> Fires when a part stops touching another part as a result of physical movement.Parameters Parameter otherPart: BasePart- Deprecated: This event is deprecated in favor of
BasePart.Touched.
Fires on the local client when another part comes in contact with this part.Parameters Parameter part: BasePart - Deprecated: This event is deprecated. Do not use it for new work.
Fires when the part's appearance changes due to aShirt. BasePart.StoppedTouching: RBXScriptSignal<( otherPart: BasePart)> Deprecated: This event is deprecated in favor ofBasePart.TouchEnded, which should be used instead.
Fires on the local client when a part stops touching another part.Parameters Parameter otherPart: BasePartUse TouchEnded instead.
No events match the filters.