PathfindingService 用于在两个点之间找到有道理的路径，确保角色可以在角色之间移动，而不会碰到墙壁或其他障碍。 默认情况下，最短路径是计算，但您可以实现路径找模式来在各种材料、周围区域或通过障碍物计算更聪明的路径。
请参阅角色路径探索获取使用详细信息。
概要
方法
在提供的两个点之间找到一个 Path 。
属性
方法
CreatePath
创建一个 Path 对象，基于各个代理参数。有效的钥匙和值在 agentParameters 表中如下所示：
| 钥匙 | 类型 | 默认 | 描述 |
|---|
参数
可让您微调代理大小的 Lua 桌子（人形将沿着路径移动的人形）。见上方的有效钥匙、类型和描述。
返回
代码示例
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
此函数用于将 Path 找到在两个指定点之间。此路径使用 PathfindingService 创建的导航网格，并确保路径可以跟随正常大小的 Roblox 角色。
此函数将返回一个 Path 对象，该对象包含路径的坐标。如果没有找到两个点之间的路径，该函数仍将返回一个 Path 对象，但该对象的 Path.Status 将为 2>Ennum.PathStatus.NoPath2>。
要获得 Path 对象的方向点，您可以使用 Path:GetWaypoints() 函数。