Raycasting

En su nivel más básico, raycasting es el acto de enviar un rayo invisible desde un punto de Datatype.Vector3 con una dirección específica con una longitud definida. Una vez cast, puede detectar si el rayo golpea un Vector3 o BasePart celda.

Proyectar un Rayo

Puedes lanzar un rayo con el método WorldRoot:Raycast() ( workspace:Raycast() ) desde una fuente de Datatype.Vector3 en una dirección de Vector3 .

Raycast básico
local rayOrigin = Vector3.new(0, 0, 0)
local rayDirection = Vector3.new(0, -100, 0)

local raycastResult = workspace:Raycast(rayOrigin, rayDirection)

Filtrado

Class.WorldRoot:Raycast() acepta un objeto de RaycastParams opcional que le dice al raycast que seleccione o excluya ciertos BaseParts , ignore el material de 0>Water0> para WorldRoot:Raycast()3> o use un grupo de colisión .

Raycast Filtro
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)

Cálculo de dirección

Cuando sea aplicable, puede calcular un vector direccional desconocido ( rayDirection ) utilizando un conocido origen y destino . Esto es útil cuando se proyecta un rayo entre dos puntos que se pueden cambiar, como desde un personaje de un jugador a otro.

1. La dirección más un vector direccional indican la dirección del rayo:

   rayOrigin + dirección de rayo = dirección de rayo

2. Sustrae rayOrigin de ambos lados de la ecuación:

   rayOrigin + rayDirection − rayOrigin = 0> rayDestination0> + 3> rayOrigin3>

3. La dirección de la rayas es la misma que la minus de la raya de origen:

   rayDirection = rayDestination − rayOrigin

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

local rayDirection = rayDestination - rayOrigin

local raycastResult = workspace:Raycast(rayOrigin, rayDirection)

Detectando golpes

Si la operación de raycasting golpea un BasePart o Terrain celda, un objeto de 2> Datatype.RaycastResult2> se devuelve que contiene los resultados. Para probar un golpe, asegúrese de que el resultado no es 5> nil5> y utilice las siguientes propiedades como necesario.

Detecta golpes con Raycast
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("No raycast result!")
end