WorldRoot

ArePartsTouchingOthers gibt zurück, wenn mindestens ein der gegebenen BasePart berührt irgendeinen anderen Teil. Zwei Teile werden als "berührend" betrachtet, wenn sie innerhalb der Distanzschwelle sind, overlapIgnored.

Wenn keine Teile angegeben werden, wird false zurückgegeben.

Parameter

Rückgaben

local part1 = Instance.new("Part")
part1.Name = "Part1"
part1.Anchored = true
part1.Transparency = 0.5
part1.Color = Color3.fromRGB(185, 100, 38)
part1.Size = Vector3.new(2, 2, 2)
part1.Position = Vector3.new(0, 4, 0)
part1.Parent = workspace

local part2 = Instance.new("Part")
part2.Name = "Part2"
part2.Anchored = true
part2.Transparency = 0.5
part2.Color = Color3.fromRGB(200, 10, 0)
part2.Size = Vector3.new(2, 2, 2)
part2.Position = Vector3.new(0, 5, 0)
part2.Parent = workspace

local partList = { part1 }

print(workspace:ArePartsTouchingOthers(partList, 0)) -- True
print(workspace:ArePartsTouchingOthers(partList, 0.999)) -- True
print(workspace:ArePartsTouchingOthers(partList, 1)) -- False

Casts einen Block in einer bestimmten Richtung und gibt die erste Kollision mit einem BasePart oder Terrain-Zell ab. Dies ist ähnlich, wie WorldRoot:Raycast() einen linearen Strahl in eine Richtung kastiert, um eine Kollision zu finden, aber es verwendet eine 3D-Form anstelle eines Strahls.

Anders als WorldRoot:GetPartsInPart() , entdeckt diese Methode nicht BaseParts, die ursprünglich eine Form bildet.

Wenn ein Treffer erkannt wird, wird eine RaycastResult mit den Trefferinformationen zurückgegeben. Die Distance Eigenschaft repräsentiert die Distanz, die die Form zu finden muss, und die Position Eigenschaft repräsentiert den Interektionspunkt, der den Treffer verursacht.

Diese Methode gibt einen Fehler zurück, wenn sie ungültige CFrame , Größe oder Richtungseingaben erhalten hat.

Parameter

Rückgaben

local Workspace = game:GetService("Workspace")

local function castBlock()
	-- The initial position and rotation of the cast block shape
	local originCFrame = CFrame.new(Vector3.new(0, 50, 0))
	-- The size of the cast block shape
	local size = Vector3.new(6, 3, 9)
	-- The direction the block is cast in
	local direction = -Vector3.yAxis
	-- The maximum distance of the cast
	local distance = 50

	-- Cast the block and create a visualization of it
	local raycastResult = Workspace:Blockcast(originCFrame, size, direction * distance)

	if raycastResult then
		-- Print all properties of the RaycastResult if it exists
		print(`Block intersected with: {raycastResult.Instance:GetFullName()}`)
		print(`Intersection position: {raycastResult.Position}`)
		print(`Distance between block's initial position and result: {raycastResult.Distance}`)
		print(`The normal vector of the intersected face: {raycastResult.Normal}`)
		print(`Material hit: {raycastResult.Material.Name}`)
	else
		print("Nothing was hit")
	end
end

-- Continually cast a block every 2 seconds
while true do
	castBlock()
	task.wait(2)
end

Diese Funktion bewegt eine Tabelle von BaseParts zu einer Tabelle von CFrames ohne das Notwendige zu tun, um die Standard-Eigenschaft Changed aufzurufen. Dies bietet einen sehr schnellen Weg, um große Anzahl von Teilen zu bewegen, da Sie nicht die Kosten für separate Eigenschaftssätze für jed

Das dritte Argument ermöglicht es Ihnen, die Bewegungsoperation weiter zu optimieren. Standardmäßig wird das Ereignis Class.Object.Changed|Changed</

Beachten Sie, dass Sie diese Funktion nur verwenden sollten, wenn Sie sicher sind, dass die Bewegung der Teile ein Verbottungshemd in Ihrem Codesist. Einfach das Eigenschaft _ CFrame der einzelnen Teile und modellierten Modelle einzustellen, ist in den meisten Fällen schnell genug.

Parameter

Rückgaben

WorldRoot:GetPartBoundsInBox() gibt eine Reihe von Teilen zurück, deren Kistenkanten eine Box mit der Volumenbeschreibung mit dem angegebenen Center ( CFrame ) und Größe ( 0> Datatype.Vector30> ) übereinstimmt.

Wie betont, berücksichtigt dieser Raum-Abfrage-Prozess effizient die Volumen der Teile-Kontrollkisten, nicht aber ihre tatsächliche Volumen. Dies kann bei Zylindern, Kugeln, Verbindungen und MeshParts , bei denen nicht blockförmige Formen verwendet werden, wichtig sein. Für Fälle, in denen Genauigkeit besonders wichtig ist, verwenden Sie stattdessen Class.

Diese Methode verwendet ein OverlapParams -Objekt, um wiederverwendbare Teile der Abfragezu beschreiben, z. B. eine Inklusions- oder Ausklusionsliste, die maximale Anzahl von Teilen, die abgerufen werden sollen, und ob die Anfrage den Wert Collision-Gruppe über ihrem Wert Klassen-

Parameter

Rückgaben

WorldRoot:GetPartBoundsInRadius() gibt eine Reihe von Teilen zurück, deren Kästen eine Kugel umgeben, deren Volumen mit dem angegebenen Center ( Vector3 ) und Radius (Number) beschrieben wird.

Wie betont, berücksichtigt dieser Raum-Abfrage-Prozess effizient die Volumen der Teile-Kontrollkisten, nicht aber ihre tatsächliche Volumen. Dies kann bei Zylindern, Kugeln, Verbindungen und MeshParts , bei denen nicht blockförmige Formen verwendet werden, wichtig sein. Für Fälle, in denen Genauigkeit besonders wichtig ist, verwenden Sie stattdessen Class.

Diese Methode verwendet ein OverlapParams -Objekt, um wiederverwendbare Teile der Abfragezu beschreiben, z. B. eine Inklusions- oder Ausklusionsliste, die maximale Anzahl von Teilen, die abgerufen werden sollen, und ob die Anfrage den Wert Collision-Gruppe über ihrem Wert Klassen-

Parameter

Rückgaben

WorldRoot:GetPartsInPart() gibt eine Reihe von Teilen zurück, deren besetzter Speicher mit dem besetzten Speicher der angegebenen Teil geteilt wird (was in der gleichen WorldRoot wie die zu querenden Teile sein muss). Dieser Method kann in der Platzierung von BasePart:GetTouchingParts() verwendet werden und ist in der Regel eine bessere Wahl.

Wie bemerkt, berücksichtigt diese Raum-Abfrage-Methode die genaue Lautstärke, die von der angegebenen Teil verwendet wird, indem sie einen vollständigen geometrischen überprüfenverwendet. Als Beispiel wird eine konvekt/hollow-Teil nicht mit queried-Teilen innerhalb von ihm übereinstimmen, wenn sie nicht tatsächlich überlappen/berüh

Diese Methode verwendet ein OverlapParams -Objekt, um wiederverwendbare Teile der Abfragezu beschreiben, z. B. eine Inklusions- oder Ausklusionsliste, die maximale Anzahl von Teilen, die abgerufen werden sollen, und ob die Anfrage den Wert Collision-Gruppe über ihrem Wert Klassen-

Parameter

Rückgaben

Diese Funktion bewegt die angegebene Teil an den angegebenen Ort via umgekehrte Kinematik , anstatt sie direkt zu verschieben, um sicherzustellen, dass alle Verbindungen, constraints oder Kollisionen, die an einer teilnehmen, physisch zufrieden bleiben. Derzeit ist diese Funktion nur in Studio verfügbar, um plugins , da sie derzeit mit der Physik eines

Translate Stiffness ist eine Zahl zwischen 0 und 1, die angeben, wie aggressiv das Teil zur Position des Ziels CFrame zuordnen soll. Drehen Stiffness ist eine Zahl zwischen 0 und 1, die angeben, wie aggressiv das Teil drehen soll.

Zum Beispiel:

• Wenn die Zugfestigkeit und die Rotierung der Zugfestigkeit beide 1 betragen, wird das Teil exakt auf das Ziel CFrame verschoben, unabhängig von den physikalischen Einschränkungen.
• Wenn die Zugfestigkeit und die Rotationszugfestigkeit auf beide 0,5 gleich sind, versucht die Teil sich genau zum Ziel CFrame zu bewegen, aber kann durch physische Einschränkungen auf dem Weg aus dem Weg gedrückt werden.
• Wenn die Zugfestigkeit und die Rotierung der Zugfestigkeit beide 0 betragen, wird die Ziel-CFrame ignoriert und die physischen Einschränkungen für das Objekt in der Position, in der es sich befindet, gelöst.

Parameter

Rückgaben

Wirft einen Strahl mit einem Ursprung, einer Richtung und einer optionalen RaycastParams . Wenn es einen qualifizierten BasePart oder Terrain Zell findet, wird ein 1> Datatype.

Beachten Sie, dass die Länge (Magnitude) des direktionalen Vektors wichtig ist, da Objekte/Terrain weiter weg von seiner Länge nicht getestet werden. Wenn Sie einen CFrame verwenden, um die Ray-Komponenten zu erstellen, berücksichtigen Sie die Verwendung von CFrame.LookVector als direktional

Diese Methode verwendet kein Datatype.Ray -Objekt, aber seine Ornament- und Richtungskomponenten können von Ray und Ray.Origin ausgeliehen werden.

Parameter

Rückgaben

local Workspace = game:GetService("Workspace")

local function castRay()
	-- The origin point of the ray
	local originPosition = Vector3.new(0, 50, 0)
	-- The direction the ray is cast in
	local direction = -Vector3.yAxis
	-- The maximum distance of the ray
	local distance = 50

	-- Cast the ray and create a visualization of it
	local raycastResult = Workspace:Raycast(originPosition, direction * distance)

	if raycastResult then
		-- Print all properties of the RaycastResult if it exists
		print(`Ray intersected with: {raycastResult.Instance:GetFullName()}`)
		print(`Intersection position: {raycastResult.Position}`)
		print(`Distance between ray origin and result: {raycastResult.Distance}`)
		print(`The normal vector of the intersected face: {raycastResult.Normal}`)
		print(`Material hit: {raycastResult.Material.Name}`)
	else
		print("Nothing was hit")
	end
end

-- Continually cast a ray every 2 seconds
while true do
	castRay()
	task.wait(2)
end

Parameter

Rückgaben

Wirft eine kugelförmige Form in eine bestimmte Richtung und gibt die erste Kollision mit einem BasePart oder Terrain-Zell ab. Dies ist ähnlich, wie WorldRoot:Raycast() einen linearen Ray in einer Richtung findet, um eine Kollision zu finden, aber es verwendet eine 3D-Form anstelle eines Ray.

Anders als WorldRoot:GetPartsInPart() , entdeckt diese Methode nicht BaseParts, die ursprünglich eine Form bildet.

Wenn ein Treffer erkannt wird, wird eine RaycastResult mit den Trefferinformationen zurückgegeben. Die Distance Eigenschaft repräsentiert die Distanz, die die Form zu finden muss, und die Position Eigenschaft repräsentiert den Interektionspunkt, der den Treffer verursacht.

Diese Methode wirft einen Fehler ab, wenn sie ungültige Radius- oder Richtungseingaben überträgt.

Parameter

Rückgaben

local Workspace = game:GetService("Workspace")

local function castSphere()
	-- The initial position of the cast spherical shape
	local originPosition = Vector3.new(0, 50, 0)
	-- The radius of the cast spherical shape in studs
	local radius = 10
	-- The direction the sphere is cast in
	local direction = -Vector3.yAxis
	-- The maximum distance of the cast
	local distance = 50

	-- Cast the sphere and create a visualization of it
	local raycastResult = Workspace:Spherecast(originPosition, radius, direction * distance)

	if raycastResult then
		-- Print all properties of the RaycastResult if it exists
		print(`Sphere intersected with: {raycastResult.Instance:GetFullName()}`)
		print(`Intersection position: {raycastResult.Position}`)
		print(`Distance between sphere's initial position and result: {raycastResult.Distance}`)
		print(`The normal vector of the intersected face: {raycastResult.Normal}`)
		print(`Material hit: {raycastResult.Material.Name}`)
	else
		print("Nothing was hit")
	end
end

-- Continually cast a sphere every 2 seconds
while true do
	castSphere()
	task.wait(2)
end

Voraussetzung für die Simulation von Teilen in der Welt ist ein bestimmter Zeitpunkt und ein optionales Set von

Parameter

Rückgaben

local RunService = game:GetService("RunService")

-- Optional array of parts to simulate; otherwise all parts will be simulated
local partsToSimulate = {
	workspace.Part
}

local function simulateParts(duration)
	local time = 0.0
	local stepJob

	stepJob = RunService.RenderStepped:Connect(function(dt)
		if time + dt > duration then
			dt = duration - time
		end

		workspace:StepPhysics(dt, partsToSimulate)
		time = time + dt
		if time >= duration then
			stepJob:Disconnect()
		end
	end)
end

-- Simulate workspace parts for 5 seconds, stepping the parts once per frame
simulateParts(5.0)