PathfindingService
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
PathfindingService se usa para encontrar caminos lógicos entre dos puntos, asegurando que los personajes se puedan mover entre los puntos sin chocar contra paredes o otros obstáculos. Por defecto, el camino más corto se calcula, pero puede implementar modificadores de camino para calcular caminos más inteligentes entre varios materiales, alrededor de regiones definidas o a través de obstáculos.
Vea Character Pathfinding para obtener detalles de uso.
Resumen
Métodos
Encuentra un Path entre los dos puntos proporcionados.
Propiedades
Métodos
CreatePath
Crea un objeto Path basado en varios parámetros de agente. Las llaves y valores válidos en la tabla agentParameters son los siguientes:
| Clave | Tipo | Por defecto | Descripción |
|---|
Parámetros
Tabla Lua que le permite ajustar el camino para el tamaño del agente (el humanoide que se moverá por el camino). Vea arriba para ver las llaves, tipos y descripciones válidas.
Devuelve
Muestras de código
Demonstrates creating a path using PathfindingService:CreatePath()
'PathOptions' represents a Model with three paths made of different materials. When creating the path we define a large 'Cost' for two of the three paths materials. This will ensure the path created steers towards the path with the material of the lowest 'Cost'.
Once the path is created, small parts are created at each waypoint to visualize the path.
local Workspace = game:GetService("Workspace")
local PathfindingService = game:GetService("PathfindingService")
-- This model contains a start, end and three paths between the player can walk on: Snow, Metal and LeafyGrass
local PathOptionsModel = script.Parent.PathOptions
local startPosition = PathOptionsModel.Start.Position
local finishPosition = PathOptionsModel.End.Position
-- Create a path that avoids Snow and Metal materials
-- This will ensure the path created avoids the Snow and Metal paths and guides
-- the user towards the LeafyGrass path
local path = PathfindingService:CreatePath({
AgentRadius = 3,
AgentHeight = 6,
AgentCanJump = false,
Costs = {
Snow = math.huge,
Metal = math.huge,
},
})
-- Compute the path
local success, errorMessage = pcall(function()
path:ComputeAsync(startPosition, finishPosition)
end)
-- Confirm the computation was successful
if success and path.Status == Enum.PathStatus.Success then
-- For each waypoint, create a part to visualize the path
for _, waypoint in path:GetWaypoints() do
local part = Instance.new("Part")
part.Position = waypoint.Position
part.Size = Vector3.new(0.5, 0.5, 0.5)
part.Color = Color3.new(1, 0, 1)
part.Anchored = true
part.CanCollide = false
part.Parent = Workspace
end
else
print(`Path unable to be computed, error: {errorMessage}`)
end
FindPathAsync
Esta función se usa para encontrar un Path entre dos puntos proporcionados. Este camino usa la cuadrícula de navegación creada por PathfindingService y asegura que el camino se puede seguir por un personaje de Roblox de tamaño regular.
Esta función devuelve un objeto Path que contiene las coordenadas del camino. Si no se encuentra ningún camino entre los dos puntos, esta función todavía devolverá un objeto Path , pero su estado de Path.Status será 1> Enum.PathStatus.NoPath1> .
Para obtener los puntos de referencia de un objeto Path, puedes usar la función Path:GetWaypoints().