Learn
Engine Class
GeometryService
Not Creatable
Service

Summary
Inherited Members

API Reference
Methods
CalculateConstraintsToPreserve
Capabilities: CSG
GeometryService:CalculateConstraintsToPreserve(
source:Instance, destination:{any}, options:Dictionary
Parameters
source:Instance
destination:{any}
options:Dictionary
Default Value: "nil"
Returns
Code Samples
Preserve Constraints
local GeometryService = game:GetService("GeometryService")
local main, other = workspace.Part1, workspace.Part2
local success, newParts = pcall(function()
return GeometryService:SubtractAsync(main, {other})
end)
if success and newParts then
for _, p in newParts do p.Parent = workspace end
for _, rec in GeometryService:CalculateConstraintsToPreserve(main, newParts) do
if rec.Constraint then
rec.Constraint.Parent = rec.ConstraintParent
end
end
end
main:Destroy()
other:Destroy()

FragmentAsync
Yields
Capabilities: CSG
GeometryService:FragmentAsync(
part:BasePart, sites:{any}, options:Dictionary
Parameters
sites:{any}
options:Dictionary
Default Value: "nil"
Returns
Code Samples
Fragment a Part
local GeometryService = game:GetService("GeometryService")
local inputPart = Instance.new("Part")
inputPart.Position = Vector3.new(0, 0.7, 20)
local sites = GeometryService:GenerateFragmentSites(inputPart)
local success, fragments = pcall( function()
return GeometryService:FragmentAsync(inputPart, sites)
end)
if success and fragments then
for _, item in fragments do
local instance = item.Instance
instance.Parent = workspace
end
end

GenerateFragmentSites
Capabilities: CSG
GeometryService:GenerateFragmentSites(
part:BasePart, options:Dictionary
Parameters
options:Dictionary
Default Value: "nil"
Returns
Code Samples
Localized Fragment
local GeometryService = game:GetService("GeometryService")
local inputPart = workspace.Part
local pos = inputPart.Position + inputPart.Size / 2
local sites = GeometryService:GenerateFragmentSites(inputPart, {Origin = pos, Radius = 1.5})
local success, fragments = pcall( function()
return GeometryService:FragmentAsync(inputPart, sites)
end)
if success and fragments then
for _, item in fragments do
local instance = item.Instance
instance.Parent = inputPart.Parent
end
inputPart:Destroy()
end

IntersectAsync
Yields
Capabilities: CSG
GeometryService:IntersectAsync(
part:Instance, parts:{any}, options:Dictionary
Parameters
parts:{any}
options:Dictionary
Default Value: "nil"
Returns
Code Samples
Union two parts
local GeometryService = game:GetService("GeometryService")
local mainPart = Instance.new("Part")
local otherPart = Instance.new("Part")
otherPart.Position = Vector3.new(1, 0.5, 1)
local success, newParts = pcall(function()
return GeometryService:IntersectAsync(mainPart, {otherPart})
end)
if success and newParts then
for _, newPart in pairs(newParts) do
newPart.Parent = workspace
end
end

SubtractAsync
Yields
Capabilities: CSG
GeometryService:SubtractAsync(
part:Instance, parts:{any}, options:Dictionary
Parameters
parts:{any}
options:Dictionary
Default Value: "nil"
Returns
Code Samples
Subtract two parts
local GeometryService = game:GetService("GeometryService")
local mainPart = Instance.new("Part")
local otherPart = Instance.new("Part")
otherPart.Position = Vector3.new(1, 0.5, 1)
local success, newParts = pcall(function()
return GeometryService:SubtractAsync(mainPart, {otherPart})
end)
if success and newParts then
for _, newPart in pairs(newParts) do
newPart.Parent = workspace
end
end

SweepPartAsync
Yields
Capabilities: CSG
GeometryService:SweepPartAsync(
part:BasePart, cframes:{any}, options:Dictionary
Parameters
cframes:{any}
options:Dictionary
Default Value: "nil"
Returns
Code Samples
Sweep a Part
local GeometryService = game:GetService("GeometryService")
local inputPart = Instance.new("Part")
inputPart.Shape = Enum.PartType.Ball
local cframeList = {}
for i = 1, 50 do
local rotation = CFrame.Angles(0, i * 0.2, 0)
local position = Vector3.new(0, i * 0.1, -1)
table.insert(cframeList, rotation * CFrame.new(position))
end
local success, sweptPart = pcall( function()
return GeometryService:SweepPartAsync(inputPart, cframeList)
end)
if success and sweptPart then
sweptPart.Parent = workspace
end

UnionAsync
Yields
Capabilities: CSG
GeometryService:UnionAsync(
part:Instance, parts:{any}, options:Dictionary
Parameters
parts:{any}
options:Dictionary
Default Value: "nil"
Returns
Code Samples
Union two parts
local GeometryService = game:GetService("GeometryService")
local mainPart = Instance.new("Part")
local otherPart = Instance.new("Part")
otherPart.Position = Vector3.new(1, 0.5, 1)
local success, newParts = pcall(function()
return GeometryService:UnionAsync(mainPart, {otherPart})
end)
if success and newParts then
for _, newPart in pairs(newParts) do
newPart.Parent = workspace
end
end

©2026 Roblox Corporation. Roblox, the Roblox logo and Powering Imagination are among our registered and unregistered trademarks in the U.S. and other countries.