自动寻路：让机器人绕过障碍

Learning route

先准备，再动手；看到结果后，记得保存。

每完成一小步，就测试一次。先说出你预计会看到什么，再用 Play 和 Output 检查，不用急着一次写完所有代码。

Step by step

01 · 给机器人留一条真实可走的路

保留 PatrolBot，在前方放一面墙，让左右至少有一侧可以绕行。不要把目标塞进封闭箱子里，然后期待算法穿墙。

插入 Goal 路标，并禁用旧 Patrol。相同 Humanoid 同时接收两个脚本的 MoveTo，会让结果难以理解。

1. Goal：Position=0,0.5,-30，Size=4,1,4，Anchored=true、CanCollide=false。
2. 墙：Position=0,5,-15，Size=12,10,2，Anchored=true。
3. 在 ServerScriptService 创建 PathToGoal。
4. 确认机器人附近地面足够宽，墙两侧有绕行空间。

Step by step

02 · 先规划，再查看结果

CreatePath 中的 AgentRadius 和 AgentHeight 描述机器人需要的空间。通道太窄，规划器就不应把它当作可通过路线。

ComputeAsync 可能出错，因此用 pcall 包住；计算结束后还要检查 path.Status 是否为 Success。pcall 成功只代表调用没抛错，不代表一定有路。

1. 阅读完整代码中的 ok 与 PathStatus 两层检查。
2. 用默认比例的 R15 Rig 开始，之后再根据角色尺寸调整参数。

Step by step

03 · 依次走路点，必要时跳跃

路点包含 Position 和 Action。Action 为 Jump 时，先让 Humanoid.Jump=true，再走向路点。

Blocked 只关心当前或后方将要经过的路点。如果前方路线被阻挡，本例停止并提示重新测试；它没有实现动态重新规划，避免把入门课变成追逐 AI。

1. 把完整代码放进 PathToGoal。
2. Play 后观察机器人绕过墙，抵达 Goal。
3. 若失败，先查看 Output，再检查地面、墙边空隙和角色尺寸。

local PathfindingService = game:GetService("PathfindingService")
local bot = workspace:WaitForChild("PatrolBot")
local humanoid = bot:WaitForChild("Humanoid")
local root = bot:WaitForChild("HumanoidRootPart")
local goal = workspace:WaitForChild("Goal")
root:SetNetworkOwner(nil)
humanoid.WalkSpeed = 8
local path = PathfindingService:CreatePath({
    AgentRadius = 2,
    AgentHeight = 5,
    AgentCanJump = true,
})
local ok, message = pcall(function()
    path:ComputeAsync(root.Position, goal.Position)
end)
if not ok or path.Status ~= Enum.PathStatus.Success then
    warn("No usable path:", message, path.Status.Name)
    return
end

local nextIndex = 2
local blocked = false
local connection = path.Blocked:Connect(function(index)
    if index >= nextIndex then
        blocked = true
        humanoid:MoveTo(root.Position)
    end
end)
local finished = true
local waypoints = path:GetWaypoints()
for index = 2, #waypoints do
    nextIndex = index
    if blocked or humanoid.Health <= 0 then finished = false; break end
    local waypoint = waypoints[index]
    if waypoint.Action == Enum.PathWaypointAction.Jump then humanoid.Jump = true end
    humanoid:MoveTo(waypoint.Position)
    local reached = humanoid.MoveToFinished:Wait()
    if not reached or blocked then finished = false; break end
end
connection:Disconnect()
if finished then print("Reached goal") else warn("Route interrupted; test a new route") end

Step by step

04 · 看导航网格，不只看漂亮地面

Studio 的可视化选项可以显示 Navigation Mesh。它帮助你观察系统认为哪里能行走，而不是只看模型表面似乎连着。

图片中的彩色区域和路点属于官方寻路示例。你的墙与 Goal 更简单，但检查方式相同：有没有足够空间绕过去。

1. 启用导航网格显示，观察墙两侧通路。
2. 把通道收窄，再计算一次，看结果如何变化。
3. 完成检查后可关闭网格显示，让场景恢复清楚。

Step by step

05 · 给无路可走一个明确答案

可靠的机器人不需要每次都成功，但必须让你知道为什么停止。没有可用路径、移动超时和前路被阻挡，都是需要处理的正常情况。

本例适合固定小场景。持续追踪移动玩家时，需要节流重算、取消旧任务和处理流式加载，不能简单每帧调用 ComputeAsync。

1. 开放一侧：应该绕行成功。
2. 完全封闭目标：应该报告 No usable path。
3. 恢复空隙：再次 Play 应成功。
4. 确认结束后 Blocked 连接已经断开。

Exit questions

先自己回答，再展开看看。

Explore further

需要查资料时，从这里出发。

正文代码可以直接复制。先确认脚本类型、放置位置，以及这段代码是完整版本还是小实验；不要把同一脚本的多个版本叠加运行。界面参考图已标注来源，图中的对象名可能与本课不同，请以操作步骤为准。

• 角色自动寻路 ↗