Lanzamiento de rayos

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

Puedes lanzar un rayo con el método WorldRoot:Raycast() ( Workspace:Raycast() ) desde un origen Vector3 en una dirección Vector3.

Lanzamiento de rayo básico
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)

Cuando sea aplicable, puedes calcular un vector direccional desconocido ( ) usando un origen conocido y un destino conocido .Esto es útil al lanzar un rayo entre dos puntos que pueden cambiar, como de un personaje de jugador a otro.

1. El origen más un vector direccional indican el destino del rayo:

   rayOrigin + rayDirection = rayDestination

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

   rayOrigin + rayDirection − rayOrigin = rayDestination − rayOrigin

3. La dirección del rayo iguala al destino menos el origen:

   dirección de rayo = destino de rayo − origen de rayo

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)

Opciones de filtro

acepta un objeto opcional que le dice al raycast que incluya o excluya selectivamente ciertos , ignore el material de agua para o use un grupo de colisión .

Filtrado de raycast
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)

Detección de golpes

Si la operación de lanzamiento de rayos golpea una celda elegible BasePart o Terrain, se devuelve un objeto RaycastResult que contiene los resultados.Para probar un golpe, confirma que el resultado no es nil y utiliza las siguientes propiedades según sea necesario.

Detección de golpes de raycast
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("No raycast result!")
end