Roblox Pathfinding导航至需跳跃目标时NPC来回移动问题排查

• 跳跃触发时机错误：当前代码在到达当前路点后，才判定下一个路点是否需要跳跃，而需要跳跃的路点通常位于平台边缘，到达边缘再起跳会错过最佳跳跃时机，NPC掉落回低处后路径重新计算，就会出现来回切换方向的现象。
• 缺少MoveTo超时处理：Roblox的Humanoid的MoveTo方法默认8秒未抵达目标点就会自动终止，你没有监听超时失败的情况，NPC卡滞时不会重新触发路径计算或移动指令。
• 路径重算时未清空旧状态：触发Blocked事件重新计算路径时，没有终止当前正在执行的MoveTo指令，新旧移动指令冲突导致方向来回切换。
• 寻路代理参数未适配：你创建路径时没有传入和你的NPC尺寸匹配的代理参数，默认参数可能和NPC的碰撞体积、跳跃高度不匹配，生成的路径本身不符合NPC的移动能力。

1. 调整路径创建逻辑，传入适配的代理参数 #

创建路径时根据你的NPC实际尺寸配置AgentRadius、AgentHeight、AgentJumpHeight参数，保证生成的路径符合NPC的移动能力。

2. 调整跳跃触发时机 #

在开始移动到下一个路点时就判定是否需要跳跃，提前触发起跳动作。

3. 增加MoveTo失败监听 #

监听Humanoid.MoveToFinished的reached参数为false的情况，触发路径重新计算。

4. 重算路径前终止当前移动 #

调用Humanoid:MoveTo(Vector3.new())清空当前移动指令，避免新旧指令冲突。

local PathfindingService = game:GetService("PathfindingService")
-- 替换为你自己的NPC引用
local enemyNPC = script.Parent
local humanoid = enemyNPC:WaitForChild("Humanoid")
local animationTrack = nil -- 替换为你自己的动画引用
local destination = nil -- 替换为你自己的目标点引用

-- 创建路径时传入适配NPC的参数，数值根据你NPC的实际尺寸调整
local path = PathfindingService:CreatePath({
    AgentRadius = 2, -- NPC碰撞半径
    AgentHeight = 5, -- NPC碰撞高度
    AgentJumpHeight = humanoid.JumpPower * 0.6, -- 适配NPC跳跃高度
    AgentCanJump = true -- 允许生成跳跃路径
})

local waypoints = {}
local currentWaypointIndex = 1

local function followPath(destinationObject)
    -- 重算路径前先终止当前移动，避免指令冲突
    humanoid:MoveTo(Vector3.new())
    
    path:ComputeAsync(enemyNPC.HumanoidRootPart.Position, destinationObject.Position)
    waypoints = {}

    if path.Status == Enum.PathStatus.Success then
        waypoints = path:GetWaypoints()
        currentWaypointIndex = 1
        -- 移动前先判断第一个路点是否需要跳跃
        if waypoints[currentWaypointIndex].Action == Enum.PathWaypointAction.Jump then
            humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
        end
        humanoid:MoveTo(waypoints[currentWaypointIndex].Position)
    else
        warn("路径计算失败")
    end
end

local function onWaypointReached(reached)
    -- 处理移动超时/失败的情况
    if not reached then
        followPath(destination)
        return
    end

    if currentWaypointIndex < #waypoints then
        currentWaypointIndex += 1
        -- 移动到下一个路点前就触发跳跃，不要等到了再跳
        if waypoints[currentWaypointIndex].Action == Enum.PathWaypointAction.Jump then
            humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
        end
        humanoid:MoveTo(waypoints[currentWaypointIndex].Position)
    else
        print("Target reached!")
        if animationTrack then
            animationTrack:Stop()
        end
    end
end

local function onPathBlocked(blockWaypointIndex)
    if blockWaypointIndex > currentWaypointIndex then
        followPath(destination)
    end
end

path.Blocked:Connect(onPathBlocked)
humanoid.MoveToFinished:Connect(onWaypointReached)
followPath(destination)

内容的提问来源于stack exchange，提问作者niu