WorldRoot

ArePartsTouchingOthers zwraca prawdę, jeśli co najmniej jedna z podanych BasePart dotyka innych części.Dwie części są uważane za "dotykanie", jeśli znajdują się w granicy dystansu, overlapIgnored .

Jeśli nie zostaną dostarczone części, zwracany jest fałsz.

Parametry

Zwroty

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)) -- Prawda
print(workspace:ArePartsTouchingOthers(partList, 0.999)) -- Prawda
print(workspace:ArePartsTouchingOthers(partList, 1)) -- False

Rzuca kształt bloku w określonym kierunku i zwraca pierwszą kolizję z komórką BasePart lub Terrain.Jest to analogiczne do sposobu, w jaki WorldRoot:Raycast() rzuca liniowy promień w kierunku, aby znaleźć kolizję, ale używa 3D kształtu zamiast promienia.

W przeciwieństwie do WorldRoot:GetPartsInPart() , ta metoda nie wykrywa BaseParts, że początkowo nakłada się na kształt.

Jeśli wykryto trafienie, zostanie zwrócony RaycastResult zawierający informacje o trafieniu.Właściwość Distance reprezentuje odległość, jaką musi pokonać forma, aby znaleźć trafienie, a właściwość Position reprezentuje punkt styku, który powoduje trafienie.

Ta metoda rzuca błąd, jeśli przekazano nieprawidłowe wejścia CFrame , rozmiar lub kierunek.

Parametry

Zwroty

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

Funkcja ta przenosi tabelę BaseParts do tabeli CFrames bez konieczności uruchamiania domyślnych wydarzeń właściwości Changed.Zapewnia to bardzo szybki sposób przesuwania dużej liczby części, ponieważ nie musisz płacić za oddzielne zestawy właściwości dla każdej pojedynczej części.

Trzeci argument pozwala dalej optymalizować operację przemieszczania.Domyślnie wydarzenie Changed każdej części uruchamia się dla Position, Orientation i CFrame.Jeśli jednak określisz FireCFrameChanged jako trzeci argument, uruchomi się tylko wydarzenie Changed dla właściwości CFrame.

Zauważ, że powinieneś używać tej funkcji tylko wtedy, gdy jesteś pewien, że ruch części jest butelkowany w twoim kodzie.Po prostu ustawienie właściwości CFrame poszczególnych części i spawanych modeli jest wystarczająco szybkie w większości przypadków.

Parametry

Zwroty

WorldRoot:GetPartBoundsInBox() zwraca arkusz części, których pudełka przylegające pokrywają pudełko o objętości opisanej za pomocą podanego centrum ( CFrame ) i rozmiarze ( Vector3 ).

Jak podkreślono, ta metoda zapytania przestrzennego skutecznie rozważa objętość skrzynek przylegających części, a nie ich rzeczywistą objętość zajęcia.Może to być ważne, gdy rozważa się cylindry, kule, związki i MeshParts, które mają kształty nieblokowe.W przypadkach, gdy dokładność jest szczególnie ważna, użyj WorldRoot:GetPartsInPart() zamiast tego, albo dalej filtruj wyniki tej metody samodzielnie.

Ta metoda używa obiektu do opisania ponownie używalnych części zapytania przestrzennego, takich jak lista obejmująca lub wykluczająca, maksymalna liczba części do zapytania, grupa kolizji, którą należy użyć, i czy zapytanie preferuje wartość części skrzyżowanych nad jej wartością.

Parametry

Zwroty

WorldRoot:GetPartBoundsInRadius() zwraca matrycę części, których pudełka przyłączeniowe pokrywają się z kulą, której objętość opisano za pomocą podanego centrum ( Vector3 ) i promienia (number).

Jak podkreślono, ta metoda zapytania przestrzennego skutecznie rozważa objętość skrzynek przylegających części, a nie ich rzeczywistą objętość zajęcia.Może to być ważne, gdy rozważa się cylindry, kule, związki i MeshParts, które mają kształty nieblokowe.W przypadkach, gdy dokładność jest szczególnie ważna, użyj WorldRoot:GetPartsInPart() zamiast tego, albo dalej filtruj wyniki tej metody samodzielnie.

Ta metoda używa obiektu do opisania ponownie używalnych części zapytania przestrzennego, takich jak lista obejmująca lub wykluczająca, maksymalna liczba części do zapytania, grupa kolizji, którą należy użyć, i czy zapytanie preferuje wartość części skrzyżowanych nad jej wartością.

Parametry

Zwroty

WorldRoot:GetPartsInPart() zwraca arkusz części, których przestrzeń zajęta jest współdzielona z daną częścią (która musi istnieć w tej samej WorldRoot co części, które mają być zapytane).Ta metoda może być używana w miejsce BasePart:GetTouchingParts() i jest ogólnie lepszym wyborem.

Jak wspomniano, ta metoda zapytania przestrzennego rozważa dokładną objętość zajętą przez daną część za pomocą pełnego sprawdzaćkolizji geometrycznej.Jako przykład, część wklęsła/próżniowa nie pasuje do zapytanych części w niej, chyba że rzeczywiście pokrywają się z taką częścią lub dotykają jej.Dla prostszych objętości rozważ użycie WorldRoot:GetPartBoundsInBox() lub WorldRoot:GetPartBoundsInRadius(), ponieważ są mniej dokładne, ale działają wydajniej.

Ta metoda używa obiektu do opisania ponownie używalnych części zapytania przestrzennego, takich jak lista obejmująca lub wykluczająca, maksymalna liczba części do zapytania, grupa kolizji, którą należy użyć, i czy zapytanie preferuje wartość części skrzyżowanych nad jej wartością.

Parametry

Zwroty

Funkcja ta przenosi określoną część do określonego miejsca za pomocą odwrotnej kinematyki zamiast przenosić ją bezpośrednio tam, aby zapewnić, że wszelkie stawki, constraints lub kolizje, w których uczestniczy część, pozostają fizycznie zadowolone.Obecnie funkcja ta jest dostępna w Studio tylko do plugins, ponieważ obecnie konfliktuje się z fizyką uruchomionej gra.

Tłumaczenie sztywności to liczba pomiędzy 0 a 1 określająca, jak agresywnie dopasować pozycję części do pozycji części docelowego CFrame. Obróć sztywność to liczba pomiędzy 0 a 1 określająca, jak agresywnie dopasować rotację części do rotacji części docelowego CFrame.

Na przykład:

• Jeśli tłumaczenie sztywności i obrót sztywności są obie równe 1, część zostanie przeniesiona dokładnie do ramy docelowej, niezależnie od tego, jakie są na niej ograniczenia fizyczne.
• Jeśli tłumienie i obrót sztywności są równe 0,5, część spróbuje przesunąć się dokładnie do wybranej CFrame, ale może zostać wyparta przez fizyczne ograniczenia.
• Jeśli tłumienie sztywności i obrót sztywności są obie równe 0, wówczas celowe CFrame zostanie zignorowane, a ograniczenia fizyczne zostaną rozwiązane dla obiektu w pozycji, w której się znajdował.

Parametry

Zwroty

Rzuca promień za pomocą pochodzenia, kierunku i opcjonalnego RaycastParams.Jeśli znajdzie właściwą komórkę BasePart lub Terrain, zostanie zwrócona RaycastResult, zawierająca wyniki operacji.Jeśli nie zostanie podany żaden obiekt RaycastParams, domyślne są używane (wszystkie części są rozważane, a Terrain woda nie jest ignorowana).

Zauważ, że długość (magnitudo) wektora kierunkowego jest ważna, ponieważ obiekty/teren oddalone dalej niż jej długość nie zostaną przetestowane.Jeśli używasz CFrame do pomocy w tworzeniu komponentów promienia, rozważ użycie CFrame.LookVector jako wektora kierunkowego i pomnożenie go przez żądaną długość, jak pokazano w poniższym przykładzie.Maksymalna długość wektora kierunkowego wynosi 15 000 ćwieków.

Ta metoda nie używa obiektu , ale jego komponenty pochodzenia i kierunku można pożyczyć z i .

Parametry

Zwroty

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

Parametry

Zwroty

Rzuca kulistą formę w określonym kierunku i zwraca pierwszą kolizję z komórką BasePart lub Terrain .Jest to analogiczne do sposobu, w jaki WorldRoot:Raycast() rzuca liniowy promień w kierunku, aby znaleźć kolizję, ale używa 3D kształtu zamiast promienia.

W przeciwieństwie do WorldRoot:GetPartsInPart() , ta metoda nie wykrywa BaseParts, że początkowo nakłada się na kształt.

Jeśli wykryto trafienie, zostanie zwrócony RaycastResult zawierający informacje o trafieniu.Właściwość Distance reprezentuje odległość, jaką musi pokonać forma, aby znaleźć trafienie, a właściwość Position reprezentuje punkt styku, który powoduje trafienie.

Ta metoda rzuca błąd, jeśli przekazano nieprawidłowe wpisy promienia lub kierunku.

Parametry

Zwroty

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

Przyspiesza symulację dla części na świecie w przód w oparciu o określony wzrost czasu i opcjonalny zestaw BasePart.Gdy określono zestaw części, tylko te części zostaną symulowane, a wszystkie inne części na świecie zostaną potraktowane jako zakotwiczone.Gdy ten argument zostanie pominięty, wszystkie części na świecie zostaną uwzględnione w symulacji.Określony wzrost czasu może być dowolną pozytywną liczbą, z większymi wartościami zwiększając czas wykonania funkcji.W zależności od wartości przyrostu czasu system fizyczny może podzielić go na wiele pojedynczych kroków, aby zachować dokładność i stabilność symulacji.Nawet jeśli funkcja wykonuje wiele substępów, wyniki symulacji zostaną zobaczone tylko po zakończeniu funkcji.Aby wizualizować poszczególne kroki symulacji, funkcję można wezwać raz na krok renderowania za pomocą wydarzenia RunService.RenderStepped.

Parametry

Zwroty

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)