local ghost = Part()
ghost.CanCollide = false
ghost.Transparency = 0.5
ghost.Parent = world
PhysicsInstance
Inherits: DynamicInstance
PhysicsBody is a dynamic instance that can be moved and interacted with in the game world.
Properties
Anchored bool
Indicates whether the PhysicsBody is anchored in place.
AngularVelocity Vector3
The angular velocity of the PhysicsBody.
CanCollide bool
Indicates whether the PhysicsBody can collide with other objects.
LinearVelocity Vector3
The linear velocity of the PhysicsBody.
local ball = Part()
ball.Shape = PartShape.Ball
ball.Parent = world
ball.LinearVelocity = Vector3(0, 50, 0)NetworkOwnerClientId int
The client ID that has local physics authority over this body. 0 means the server simulates it.
TouchSensitive bool
Functions
Returns an array of all PhysicsInstances currently touching this PhysicsInstance.
local sensor = world.FindFirstChild("Sensor")
if sensor:
for hit in sensor.GetTouching():
if hit.IsA("Part"):
hit.Color = Color3(1, 0, 0)local bodyA = world.FindFirstChild("BodyA")
local bodyB = world.FindFirstChild("BodyB")
if bodyA and bodyB:
local weld = bodyA.MakeJoint(bodyB)Removes any welds between this PhysicsBody and the other PhysicsBody.
SetNetworkOwner(player: Player)
Grants physics authority over this body (nil releases it to the server).
Signals
Properties
CMatrix CMatrix
The coordinate matrix (CMatrix) representing the DynamicInstance's position and rotation transform in the world, in local space.
Position Vector3
The position of the DynamicInstance. This is a shortcut for setting CMatrix.Position.
Quaternion Quaternion
The rotation of the DynamicInstance as a quaternion. This is a shortcut for setting Types.CMatrix.Quaternion.
Rotation Vector3
The rotation of the DynamicInstance in Euler angles (degrees). This is a shortcut for setting Quaternion using Euler angles.
Functions
Speak(text: string)
Creates a child speech bubble attached to this DynamicInstance with the given text.
Properties
Transparency float
The transparency of the VisualInstance.
Visible bool
Whether the VisualInstance is visible in the game world.
Properties
Archivable bool
Whether this Instance or any of its descendants should be included when saving or copying via Clone()
Id Guid
The unique identifier for this Instance.
Locked bool
If true, this instance and all of its descendants cannot be selected in the editor.
Name string
The name of this Instance.
Parent Instance?
The parent of this Instance in the hierarchy.
ScriptData InstanceScriptData
SortIndex ushort
The sort index of this Instance among its siblings. If this Instance has no parent, this value is ignored.
Functions
AttachScript(path: string)
Attaches a script to this instance by its file path. The path should be relative to the root assets directory, e.g. "Scripts/MyScript".
Clone() Instance
Creates a deep clone of this Instance and all its descendants.
Destroy()
Removes this Instance, and all its descendants, from the DataModel, and locks its parent property.
DestroyAfter(delaySeconds: float)
Schedules this Instance to be destroyed after the specified delay in seconds. This function will error if called multiple times.
DetachScript(path: string)
Removes a script from this instance by its file path. The path should be relative to the root assets directory, e.g. "Scripts/MyScript".
FindFirstChild(name: string) Instance?
GetChildren() Instance[]
Returns an array of the children of this Instance.
GetContentsGlobalBoundsBox() BoundsBox?
Gets the global bounding box that encapsulates all DynamicInstance children of this Instance.
GetDescendants() Instance[]
GetScriptCount() int
GetScriptPath(index: int) string
Returns the path of the script component at , or an empty string if the script file no longer exists.
IsDescendantOf(ancestor: Instance) bool
Determines if this Instance is a descendant of the specified ancestor Instance.
Properties
ClassName string read-only
Functions
IsA(className: string) bool