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.
IsDynamic bool
Indicates whether the PhysicsBody participates in dynamic simulation.
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.
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.
Rotation Quaternion
The rotation of the DynamicInstance. This is a shortcut for setting CMatrix.Rotation.
RotationDegrees Vector3
The rotation of the DynamicInstance in Euler angles (degrees). This is a shortcut for setting Rotation using Euler angles.
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.
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)
Re-attaches an existing component ref (used by detach-undo to preserve identity).
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)
Detaches a specific component by reference. Use this to remove a broken component, which has no live file to identify it by.
FindFirstChild(name: string) Instance?
GetChildren() Instance[]
Returns an array of the 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.
Functions
IsA(className: string) bool