WorldRoot

ArePartsTouchingOthers renvoie vrai si au moins un des BasePart donnés touche une autre partie. Deux parties sont considérées comme « touchant » si elles sont dans la distance seuil, overlapIgnored.

Si aucune partie n'est fournie, false est renvoyé.

Paramètres

Retours

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

Définit une forme de bloc dans une direction donnée et renvoie la première collision avec un BasePart ou Terrain cellule. Ceci est similaire à la façon dont WorldRoot:Raycast() cast un rayon linéaire dans une direction pour trouver une collision, mais il utilise une forme 3D au lieu d'un rayon.

Contrairement à WorldRoot:GetPartsInPart(), cette méthode ne détecte pas BaseParts qui initialement intersecte la forme.

Si un hit est détecté, un RaycastResult est renvoyé contenant les informations sur le hit. La propriété Distance représente la distance que le forme doit parcourir pour trouver un hit, et la propriété Position représente le point d'intersection qui cause le hit.

Cette méthode lance une erreur si elle est passée invalide CFrame, la taille ou les entrées de direction.

Paramètres

Retours

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

Cette fonction déplace une table de BaseParts à une table de CFrames sans nécessairement lancer les événements de propriété par défaut Changed. Cela fournit un moyen très rapide de déplacer de grandes quantités de parties, car vous n'avez pas à payer le coût des ensembles de propriété séparés pour chaque partie individuelle.

Le troisième argument vous permet d'optimiser davantage l'opération de déplacement. Par défaut, l'événement Changed de chaque partie se

Notez que vous ne devriez utiliser cette fonction que si vous êtes sûr que le mouvement de partie est un bottleneck dans votre code. En simplement設置 le CFrame propriété de chaque partie et modèles soudeur, est assez rapide dans la plupart des cas.

Paramètres

Retours

WorldRoot:GetPartBoundsInBox() renvoie un tableau de parties dont les limites de boîte se chevauchent sur une boîte dont le volume est décrit à l'aide du centre ( CFrame ) et de la taille ( 0> Datatype.Vector30> ).

Comme souligné, cette méthode de requête spatiale prend en compte efficacement le volume des parties' boîtes de délimitation plutôt que leur volume occupé réel. Ceci peut être important lorsque vous considérez des cylindres, des sphères, des unions et MeshParts qui ont des formes non bloquées. Pour les cas où la précision est importante, utilisez WorldRoot:GetPartsInPart() au lieu

Cette méthode utilise un objet OverlapParams pour décrire les parties réutilisables de la recherche/requêtespatiale, telles qu'une liste d'inclusion ou d'exclusion, le nombre maximum de parties à requérir et le fait que la requête préfère la valeur Class.BasePart.CanCollide de sa valeur BasePart.CanCollide.

Paramètres

Retours

WorldRoot:GetPartBoundsInRadius() renvoie un tableau de parties dont les boîtes de délimitation se chevauchent sur une sphère dont le volume est décrit en utilisant le centre donné ( Vector3 ) et le rayon (number).

Comme souligné, cette méthode de requête spatiale prend en compte efficacement le volume des parties' boîtes de délimitation plutôt que leur volume occupé réel. Ceci peut être important lorsque vous considérez des cylindres, des sphères, des unions et MeshParts qui ont des formes non bloquées. Pour les cas où la précision est importante, utilisez WorldRoot:GetPartsInPart() au lieu

Cette méthode utilise un objet OverlapParams pour décrire les parties réutilisables de la recherche/requêtespatiale, telles qu'une liste d'inclusion ou d'exclusion, le nombre maximum de parties à requérir et le fait que la requête préfère la valeur Class.BasePart.CanCollide de sa valeur BasePart.CanCollide.

Paramètres

Retours

WorldRoot:GetPartsInPart() renvoie un tableau de pièces dont l'espace occupé est partagé avec la pièce donnée (qui doit exister dans le même WorldRoot que les pièces à rechercher). Cette méthode peut être utilisée à la place de BasePart:GetTouchingParts() et est généralement un meilleur choix.

Comme noté, cette méthode de requête spatiale prend en compte le volume exact occupé par la partie donnée en utilisant un vérifierde collision géométrique complet. Par exemple, une partie concave/hollow ne correspond pas aux parties requises à l'intérieur s'il n'y a pas de point d'intersection/de contact dans la partie. Pour les volumes plus simples, considérez l'utilisation de Class.WorldRoot

Cette méthode utilise un objet OverlapParams pour décrire les parties réutilisables de la recherche/requêtespatiale, telles qu'une liste d'inclusion ou d'exclusion, le nombre maximum de parties à requérir et le fait que la requête préfère la valeur Class.BasePart.CanCollide de sa valeur BasePart.CanCollide.

Paramètres

Retours

Cette fonction déplace la partie spécifiée à l'emplacement spécifié via kinétique inverse plutôt que de le déplacer directement, afin de garantir que les jointures, constraints ou les collisions que la partie participe à restent physiquement satisfaites. Actuellement, cette fonction n'est disponible que dans Studio pour plugins, car elle implique actuellement la physique d'un jeu en cours.

Traduire la souplesse est un nombre entre 0 et 1 spécifiant à quel point la position de la partie est correspondante à la position de la cible CFrame. Tourner la souplesse est un nombre entre 0 et 1 spécifiant à quel point la rotation de la partie est correspondante à la rotation part de la cible CFrame.

Par exemple :

• Si la souplesse de traduction et la souplesse de rotation sont toutes deux égales à 1, la partie sera déplacée exactement à la cible CFrame indépendamment des contraintes physiques qui s'y trouvent.
• Si la souplesse de traduction et la souplesse de rotation sont toutes deux égales à 0,5, la partie essaie de se déplacer exactement vers la cible CFrame, mais peut être déplacée en dehors du chemin par des contraintes physiques dessus.
• Si la souplesse de traduction et la souplesse de rotation sont toutes deux égales à 0, la cible CFrame sera ignorée et les contraintes physiques seront résolues pour l'objet à la position où il se trouve.

Paramètres

Retours

Lance une rayon à l'aide d'une origine, d'une direction et d'un RaycastParams . Si elle trouve un élément éligible BasePart ou Terrain, un 2> Datatype

Notez que la longueur (magnitude) du vécteur directionnel est importante, car les objets/terrain plus loin que sa longueur ne seront pas testés. Si vous utilisez un CFrame pour aider à créer les composants de rayon, considérez l'utilisation de CFrame.LookVector comme le vécteur directionnel et multipliez

Cette méthode ne utilise pas d'objet Ray, mais ses composantes d'origine et de direction peuvent être empruntées à partir de Ray.Origin et 2>Datatype.Ray.Direction2>.

Paramètres

Retours

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

Paramètres

Retours

Lance une forme sphérique dans une direction donnée et renvoie la première collision avec un BasePart ou Terrain cellule. Ceci est similaire à la façon dont WorldRoot:Raycast() lance un rayon linéaire dans une direction pour trouver une collision, mais il utilise une forme 3D au lieu d'un rayon.

Contrairement à WorldRoot:GetPartsInPart(), cette méthode ne détecte pas BaseParts qui initialement intersecte la forme.

Si un hit est détecté, un RaycastResult est renvoyé contenant les informations sur le hit. La propriété Distance représente la distance que le forme doit parcourir pour trouver un hit, et la propriété Position représente le point d'intersection qui cause le hit.

Cette méthode lance une erreur si elle reçoit des entrées de rayon ou de direction invalides.

Paramètres

Retours

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

Avance la simulation pour les parties dans le monde en fonction d'un augmentation de temps spécifiée et d'un ensemble facultat

Paramètres

Retours

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)