Strahlenverfolgung

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Auf der grundlegendsten Ebene ist Strahlenverfolgung der Akt, einen unsichtbaren Strahl von einem Vector3 Punkt in eine bestimmte Richtung mit einer definierten Länge auszusenden. Sobald der Strahl ausgesendet wurde, können Sie überprüfen, ob der Strahl auf ein BasePart oder eine Terrain-Zelle trifft.

Laser werden von schwebenden Kugeln abgefeuert, und die Strahlenverfolgung bestimmt, ob ein Laser auf eine Plattform trifft. Plattformen, die von den Lasern berührt werden, werden vorübergehend zerstört.

Sie können einen Strahl mit der Methode WorldRoot:Raycast() (Workspace:Raycast()) von einem Vector3-Ursprung in eine Vector3-Richtung auscasten.

Einfache Strahlenverfolgung
local Workspace = game:GetService("Workspace")

local rayOrigin = Vector3.new(0, 0, 0)
local rayDirection = Vector3.new(0, -100, 0)

local raycastResult = Workspace:Raycast(rayOrigin, rayDirection)

Beim Auscasten eines Strahls sollte der Richtungsparameter die gewünschte Länge des Strahls umfassen. Wenn die Magnitude der Richtung beispielsweise 10 beträgt, hat der resultierende Strahl auch die Länge 10. Die maximale Länge beträgt 15.000 Studs.

Wenn zutreffend, können Sie einen unbekannten Richtungsvektor (rayDirection) unter Verwendung eines bekannten Ursprungs und Ziels berechnen. Dies ist nützlich, wenn Sie einen Strahl zwischen zwei Punkten auscasten, die sich ändern können, beispielsweise von einem Spielercharakter zum anderen.

Der Ursprung plus ein Richtungsvektor geben das Ziel des Strahls an:

$\text{rayOrigin} + \text{rayDirection} = \text{rayDestination}$
Subtrahieren Sie $\text{rayOrigin}$ von beiden Seiten der Gleichung:

$\text{rayOrigin} + \text{rayDirection} - \text{rayOrigin} = \text{rayDestination} - \text{rayOrigin}$
Die Richtung des Strahls entspricht dem Ziel minus dem Ursprung:

$\text{rayDirection} = \text{rayDestination} - \text{rayOrigin}$


local Workspace = game:GetService("Workspace")

local rayOrigin = Workspace.TestOrigin.Position
local rayDestination = Workspace.TestDestination.Position

local rayDirection = rayDestination - rayOrigin

local raycastResult = Workspace:Raycast(rayOrigin, rayDirection)

Filteroptionen

WorldRoot:Raycast() akzeptiert ein optionelles RaycastParams-Objekt, das dem Strahlenverfolger mitteilt, dass bestimmte BaseParts ein- oder ausgeschlossen werden sollen, das Wasser-Material für Terrain ignoriert werden soll oder eine Kollisionsgruppe verwendet werden soll.

Schlüssel	Beschreibung
FilterDescendantsInstances	Array von Objekten, deren Nachfahren bei der Filterung der Strahlenverfolgungs-Kandidaten verwendet werden.
FilterType	Enum.RaycastFilterType-Enum, das bestimmt, wie das FilterDescendantsInstances-Array in der Strahlenverfolgung verwendet wird. Exclude — Jedes BasePart wird außer denen, die Nachfahren der Objekte im Array sind, berücksichtigt. Include — Nur BaseParts, die Nachfahren von Objekten im Array sind, werden berücksichtigt.
IgnoreWater	Boolean, der bestimmt, ob das Wasser-Material bei der Strahlenverfolgung gegen Terrain berücksichtigt wird.
CollisionGroup	String-Name der Kollisionsgruppe, die für die Strahlenverfolgungsoperation verwendet wird.

Strahlenverfolgungsfilterung
local Workspace = game:GetService("Workspace")

local rayOrigin = Vector3.zero
local rayDirection = Vector3.new(0, -100, 0)

local raycastParams = RaycastParams.new()
raycastParams.FilterDescendantsInstances = {script.Parent}
raycastParams.FilterType = Enum.RaycastFilterType.Exclude
raycastParams.IgnoreWater = true

local raycastResult = Workspace:Raycast(rayOrigin, rayDirection, raycastParams)

Treffererkennung

Wenn die Strahlenverfolgungsoperation auf ein berechtigtes BasePart oder eine Terrain-Zelle trifft, wird ein RaycastResult-Objekt zurückgegeben, das die Ergebnisse enthält. Um auf einen Treffer zu testen, stellen Sie sicher, dass das Ergebnis nicht nil ist, und verwenden Sie die folgenden Eigenschaften nach Bedarf.

Eigenschaft	Beschreibung
Instance	Das BasePart oder die Terrain-Zelle, mit der der Strahl interagiert hat.
Position	Vector3-Position des Schnittpunkts zwischen dem Strahl und der Instance.
Distance	Abstand zwischen dem Strahlursprung und dem Schnittpunkt.
Material	Das Enum.Material des BasePart oder der Terrain am Schnittpunkt.
Normal	Vector3 des Normalenvektors der durchdrungenen Fläche.

Wenn in einem Ort mit aktivierter Instanz-Streaming verwendet, hat ein Client möglicherweise weit entfernte BaseParts nicht gestreamt, sodass ein Strahlenverlauf möglicherweise keinen Treffer erkennt. Darüber hinaus sind niederauflösende "Imposter"-Terrain und Models, die vom Streaming-System generiert werden, rein visuell und sind keine berechtigten Zielobjekte für die Strahlenverfolgung.

Sie können jedes BasePart von der Treffererkennung ausschließen, indem Sie seine BasePart.CanQuery-Eigenschaft auf false setzen.

Strahlenverfolgung Treffererkennung
local Workspace = game:GetService("Workspace")

local rayOrigin = Vector3.zero
local rayDirection = Vector3.new(0, -100, 0)

local raycastResult = Workspace:Raycast(rayOrigin, rayDirection)

if raycastResult then
	print("Instance:", raycastResult.Instance)
	print("Position:", raycastResult.Position)
	print("Distance:", raycastResult.Distance)
	print("Material:", raycastResult.Material)
	print("Normal:", raycastResult.Normal)
else
	warn("Kein Strahlenverfolgungsergebnis!")
end

Deutsch