教程 · 游戏系统

Roblox Studio NPC 寻路:怎么让 NPC 追着玩家走

要让 NPC 绕过墙壁走到最近的玩家身边,需要三样东西:一个能移动的角色模型(rig),一条来自 PathfindingService 的路线,以及一个沿着路线走、又不和物理引擎较劲的循环。本教程把这三样都搭好,最后得到一个服务端脚本,直接放进 NPC 的角色模型就能用。

更新于 2026年11月20日阅读约 3 分钟作者

要点

把一个 Script 放进 NPC 模型里。用 PathfindingService:CreatePath() 创建路径,在 pcall 中用 path:ComputeAsync(start, goal) 计算它,然后用 Humanoid:MoveTo() 逐个走过路径点(waypoint),每走一个都等 MoveToFinished 之后再走下一个。要让 NPC 追玩家,选出最近的角色,并在他移动了几格之后重新计算路径,而不是每一帧都算。

  • 需要 Humanoid 和一个没有锚固的 HumanoidRootPart。对根零件调用 SetNetworkOwner(nil),让服务器来模拟它:这是解决 NPC 在玩家附近抖动的常用办法。
  • 当路径点的 Action 为 Jump 时跳跃;当 Path.Blocked 对 NPC 前方的路径点触发时,计算新路径。
  • 当能直接看到玩家时,跳过寻路,直接 MoveTo 到他身边。在几格之外停下,如果 NPC 靠接触造成伤害,就一直走到贴身。
本页内容
  1. 寻路原理
  2. 1. 设置 NPC
  3. 2. 走到一个点
  4. 3. 追逐脚本
  5. 追逐的工作方式
  6. 消除抖动
  7. 4. 接触伤害
  8. 修饰器和链接
  9. Common errors
  10. With RoCode
  11. 常见问题
  12. 参考资料

NPC 寻路的原理

示意图Chaser 找到绕过墙的路,跳上台阶,在离你 4 格的地方停下。

Roblox 会根据角色可以行走的表面生成一张 导航网格(navigation mesh)。PathfindingService 在这张网格上寻找两点之间的路线,并以 路径点 列表的形式返回:每个路径点都有位置和动作,例如行走或跳跃。然后 NPC 的 Humanoid 从一个路径点走到下一个。寻路只负责规划路线:沿着路线移动要靠你的脚本。

本教程用到的 API
API作用
PathfindingService:CreatePath()通过代理参数,按你的 NPC 的尺寸创建一个可以反复使用的 Path 对象。
Path:ComputeAsync(start, finish)计算路线。它会让出执行(yield)并且可能失败,所以要在 pcall 中调用并检查 Path.Status。
Path:GetWaypoints()以 PathWaypoint 值数组的形式返回路线,每个都有 Position、Action 和 Label。
Path.Blocked当有东西挡住已计算的路线时触发,并带上路径点的索引。
Humanoid:MoveTo(position)让 NPC 走向一个点。
Humanoid.MoveToFinished当 NPC 走到离目标点约 1 格时带 true 触发,如果 8 秒内没有走到则带 false 触发。

这一切都在服务端 Script 中运行:即使开启了流式加载,服务器也能看到整张地图,所有玩家看到的是同一个 NPC,而伤害在客户端无法伪造的地方结算。Script、LocalScript 和 ModuleScript 解释了这种划分。

第 1 步:一个能移动的 NPC

任何模型只要具备下表中的三样东西,都能沿路径行走。来自 Toolbox 或旧场景的角色模型有时会缺少某样东西,通常表现为:NPC 站着不动,也没有任何报错。

NPC 模型需要什么
要求为什么重要
名为 Humanoid 的 HumanoidMoveTo、WalkSpeed 和跳跃都属于 Humanoid。
HumanoidRootPartHumanoid 控制的零件。路径从它的位置开始。
没有任何东西被锚固锚固的零件不能移动,和它相连的零件也一样。锚固零件始终归服务器所有,所以下面讲的抖动修复对它们不适用。
  1. 打开 Avatar 或 Home 选项卡,点击 Character 打开 Rig Generator。选择 R15,然后选 Block Avatar。Workspace 中会出现一个角色模型。R6 模型也能用同样的脚本。
  2. 把角色模型重命名为 Chaser,放在一块空地上。
  3. 选中它的 HumanoidRootPart,确认 Properties 窗口中的 Anchored 已取消勾选。模型中任何其他锚固的零件也照此处理。想快速找到它们,可以在 3D 视口右上角的 Visualization Options 小部件中开启 Anchored parts。
Explorer:本教程完成时的 NPC 模型
Workspace
  Chaser Model
    Humanoid Humanoid
    HumanoidRootPart Part
    Head, UpperTorso, LowerTorso ... (身体部位)
    ChaseAI Script new
    TouchDamage Script new

如果还想让 NPC 说话,NPC 对话教程 会加上带回答选项的 Talk 提示,并说明 NPC 会走动时有什么不同。想在 Boss 开始追逐之前用镜头展示它,请看 过场动画教程。

第 2 步:让 NPC 走到一个点

先从能工作的最小脚本开始:走到一个固定的零件。它展示了寻路的每个阶段,但没有追逐逻辑。

  1. 在 Workspace 中插入一个 Part,命名为 Goal,勾选 Anchored,取消勾选 CanCollide,并把它放在地面上,让 NPC 必须绕过一堵墙才能到达。
  2. 在 Explorer 中把鼠标悬停在 Chaser 上,点击 + 按钮并插入一个 Script。把它命名为 WalkToGoal,粘贴下面的代码。
  3. 点击 Play。NPC 绕过墙,走向 Goal 零件。
Script 位置: 模型 Chaser 名称: WalkToGoal
local PathfindingService = game:GetService("PathfindingService")

local npc = script.Parent :: Model
local humanoid = npc:WaitForChild("Humanoid") :: Humanoid
local rootPart = npc:WaitForChild("HumanoidRootPart") :: BasePart
local goalPart = workspace:WaitForChild("Goal") :: BasePart

-- NPC 的物理必须归服务器所有,否则 Script 中的 ChangeState(跳跃)不会生效
local canSetOwner, ownerProblem = rootPart:CanSetNetworkOwnership()
if not canSetOwner then
	warn(`{npc.Name} cannot move: {ownerProblem}. Untick Anchored on every part of the rig.`)
	return
end
rootPart:SetNetworkOwner(nil)

local path = PathfindingService:CreatePath({
	AgentRadius = 2,
	AgentHeight = 5,
	AgentCanJump = true,
})

-- ComputeAsync 会让出执行并可能抛出错误,所以放在 pcall 里
local ok, err = pcall(function()
	path:ComputeAsync(rootPart.Position, goalPart.Position)
end)

if not ok then
	warn(`Path request failed: {err}`)
elseif path.Status ~= Enum.PathStatus.Success then
	warn(`No path to the goal: {path.Status.Name}`)
else
	for index, waypoint in path:GetWaypoints() do
		if index == 1 then
			continue -- 第一个路径点就是 NPC 现在站的位置
		end
		humanoid:MoveTo(waypoint.Position)
		if waypoint.Action == Enum.PathWaypointAction.Jump then
			humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
		end
		-- 等 NPC 走到这个路径点,再走向下一个
		local reached = humanoid.MoveToFinished:Wait()
		if not reached then
			warn(`{npc.Name} got stuck on the way to the goal`)
			break
		end
	end
end

Goal 零件取消了 CanCollide,因为路径不能终止在实心零件内部:那样路径的 Status 会是 NoPath。

传给 CreatePath 的表描述了 NPC(Roblox 称之为 代理,agent),这样路线就会避开它钻不过去的缝隙。上面的脚本把前三个键设为默认值,方便你看到该在哪里修改。

CreatePath 的代理参数
键默认设定什么
AgentRadius2NPC 的半径(格)。对于宽大的 NPC 调大它,让路径离墙远一些。
AgentHeight5NPC 的高度。低于这个高度的地方,例如楼梯下方,被视为不可通行。
AgentCanJumptrue允许需要跳跃的路线。这类路径点的 Action 为 Jump。
AgentCanClimbfalse允许攀爬 TrussPart。这类路径点带有 Climb 标签。
WaypointSpacing4中间路径点之间的距离(格)。math.huge 会去掉它们。
Costs无穿过各种材质和带标签区域的代价有多高。见 修饰器和链接。

循环里有两个要点。第一个路径点是 NPC 自己的位置,所以循环跳过它。而且每次 MoveTo 之后都有 MoveToFinished:Wait():新的 MoveTo 会替换之前的目标,所以不等待的循环会让 NPC 直接走向最后一个路径点,撞进它本该绕过的那堵墙。

对于跳跃,路径点的 Action 为 Jump,脚本会调用 ChangeState(Enum.HumanoidStateType.Jumping)。Roblox 的 Humanoid 参考文档说明,只有当服务器拥有角色的物理时,服务端脚本才能改变状态。这也是脚本先设置所有者的原因之一。

在 Roblox 关于寻路的页面上,玩家自己的角色是通过 Humanoid:Move() 移动,每帧检查是否到达,这被称为引导 Humanoid 走路径的最佳方式。MoveTo 配合 MoveToFinished 对服务端 NPC 来说更短、更清楚,所以本教程用它;如果以后需要更精细的控制,可以研究官方脚本。

第 3 步:完整的追逐脚本

这是大多数人在找的脚本。NPC 追逐 80 格范围内最近的玩家,绕过墙壁,在路线需要的地方跳跃,有东西挡路时找新路线,附近没人时回家。

  1. 如果加过 WalkToGoal,先把它从 Chaser 中删掉。
  2. 把鼠标悬停在 Chaser 上,点击 +,插入一个名为 ChaseAI 的 Script,粘贴下面的代码。
  3. 点击 Play,走到墙后面,再跑出范围。NPC 会绕过墙追你,然后回到它出发的地方。
Script 位置: 模型 Chaser 名称: ChaseAI
local Players = game:GetService("Players")
local PathfindingService = game:GetService("PathfindingService")

local npc = script.Parent :: Model
local humanoid = npc:WaitForChild("Humanoid") :: Humanoid
local rootPart = npc:WaitForChild("HumanoidRootPart") :: BasePart

-- 设置(距离单位为格,时间单位为秒)
local DETECTION_RANGE = 80 -- 比这更远的玩家 NPC 注意不到
local STOP_DISTANCE = 4 -- 在离目标这么远的地方停下(0 = 走到贴身,用于接触伤害)
local DIRECT_CHASE_RANGE = 30 -- 比这更近且路上没有东西时跳过寻路
local REPATH_DISTANCE = 4 -- 目标要移动多远才重新计算路径
local MIN_REPATH_INTERVAL = 0.5 -- 计算路径的频率永远不超过这个
local WAYPOINT_TIMEOUT = 2 -- 如果一个路径点花的时间超过这个就放弃这条路径
local CHASE_SPEED = 14 -- 玩家默认以 16 的速度行走,所以能跑过这个 NPC
local HOME_RADIUS = 4 -- 离家这么近就算到家了
local RAY_HEIGHTS = { 0, -2 } -- 腰部高度和膝盖附近的视线射线

local HOME = rootPart.Position -- 范围内没人时 NPC 回到这里

humanoid.WalkSpeed = CHASE_SPEED

-- 让服务器模拟 NPC。否则 Roblox 可能把它的物理交给附近玩家的设备,
-- 所有者变化时 NPC 就会抖动。
local canSetOwner, ownerProblem = rootPart:CanSetNetworkOwnership()
if not canSetOwner then
	warn(`{npc.Name} cannot move: {ownerProblem}. Untick Anchored on every part of the rig.`)
	return
end
rootPart:SetNetworkOwner(nil)

local path = PathfindingService:CreatePath({
	AgentRadius = 2,
	AgentHeight = 5,
	AgentCanJump = true,
	Costs = {
		Water = 20, -- 只有为了不绕一大圈才会走水路
		DangerZone = math.huge, -- 永远不进入带 DangerZone 标签的区域
	},
})

-- NPC 当前正在走的路径
local waypoints: { PathWaypoint } = {}
local nextIndex = 0
local pathGoal: Vector3? = nil
local pathBlocked = false
local lastComputeTime = -math.huge

-- Blocked 可能对 NPC 已经走过的路径点触发。只有前方的障碍才重要。
path.Blocked:Connect(function(blockedIndex: number)
	if blockedIndex >= nextIndex then
		pathBlocked = true
	end
end)

local rayParams = RaycastParams.new()
rayParams.RespectCanCollide = true -- 什么都不会撞上的零件不会挡住视线

local function clearPath()
	waypoints = {}
	nextIndex = 0
	pathGoal = nil
end

local function stopMoving()
	clearPath()
	humanoid:MoveTo(rootPart.Position)
end

-- DETECTION_RANGE 内最近的活着的玩家的 HumanoidRootPart,或者 nil
local function findNearestTarget(): BasePart?
	local nearestRoot: BasePart? = nil
	local nearestDistance = DETECTION_RANGE
	for _, player in Players:GetPlayers() do
		local character = player.Character
		local targetHumanoid = character and character:FindFirstChildOfClass("Humanoid")
		local targetRoot = character and character:FindFirstChild("HumanoidRootPart")
		if targetHumanoid and targetHumanoid.Health > 0 and targetRoot and targetRoot:IsA("BasePart") then
			local distance = (targetRoot.Position - rootPart.Position).Magnitude
			if distance < nearestDistance then
				nearestDistance = distance
				nearestRoot = targetRoot
			end
		end
	end
	return nearestRoot
end

-- 当目标大致在同一高度且中间没有实心物体时为 true。
-- 射线畅通并不能证明地面可以走,所以只用于近距离。
local function canSeeDirectly(targetRoot: BasePart): boolean
	local offset = targetRoot.Position - rootPart.Position
	if math.abs(offset.Y) > 3 then
		return false
	end
	local character = targetRoot.Parent
	rayParams.ExcludeInstances = if character then { npc, character } else { npc }
	for _, height in RAY_HEIGHTS do
		local origin = rootPart.Position + Vector3.new(0, height, 0)
		if workspace:Raycast(origin, offset, rayParams) then
			return false
		end
	end
	return true
end

local function computePath(goal: Vector3)
	lastComputeTime = os.clock()
	local ok, err = pcall(function()
		path:ComputeAsync(rootPart.Position, goal)
	end)
	-- 计算之后再重置,这样旧路线的 Blocked 不会标记新路线
	pathBlocked = false
	if ok and path.Status == Enum.PathStatus.Success then
		waypoints = path:GetWaypoints()
		nextIndex = 2 -- 路径点 1 是 NPC 站的位置
		pathGoal = goal
	else
		if not ok then
			warn(`{npc.Name}: path request failed: {err}`)
		end
		clearPath() -- 暂时没有路线;主循环很快会再试
	end
end

local function needsNewPath(goal: Vector3): boolean
	if os.clock() - lastComputeTime < MIN_REPATH_INTERVAL then
		return false -- 刚算过:沿当前路径走
	end
	local currentGoal = pathGoal
	if currentGoal == nil or pathBlocked or nextIndex > #waypoints then
		return true
	end
	return (goal - currentGoal).Magnitude > REPATH_DISTANCE
end

-- 等待 MoveToFinished,但在 timeout 秒后放弃,而不是内置的 8 秒,
-- 这样卡住的 NPC 能很快得到新路径
local function waitForMoveToFinished(timeout: number): boolean
	local finished = false
	local reachedGoal = false
	local connection = humanoid.MoveToFinished:Connect(function(reached: boolean)
		finished = true
		reachedGoal = reached
	end)
	local deadline = os.clock() + timeout
	while not finished and os.clock() < deadline do
		task.wait()
	end
	connection:Disconnect()
	return reachedGoal
end

local function walkToNextWaypoint()
	local waypoint = waypoints[nextIndex]
	humanoid:MoveTo(waypoint.Position)
	if waypoint.Action == Enum.PathWaypointAction.Jump then
		humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
	end
	if waitForMoveToFinished(WAYPOINT_TIMEOUT) then
		nextIndex += 1
	else
		clearPath() -- 卡住了或被撞离路线:计算新路径
	end
end

while humanoid.Health > 0 do
	local targetRoot = findNearestTarget()
	local goal: Vector3

	if targetRoot then
		local distance = (targetRoot.Position - rootPart.Position).Magnitude
		if distance <= STOP_DISTANCE then
			stopMoving() -- 足够近了:站在目标旁边
			task.wait(0.2)
			continue
		end
		if distance <= DIRECT_CHASE_RANGE and canSeeDirectly(targetRoot) then
			clearPath()
			-- 如果再传入一个零件,NPC 会在它移动时跟着它走
			humanoid:MoveTo(targetRoot.Position, targetRoot)
			task.wait(0.15)
			continue
		end
		goal = targetRoot.Position
	else
		if (HOME - rootPart.Position).Magnitude <= HOME_RADIUS then
			stopMoving() -- 附近没人,NPC 已经在家了
			task.wait(0.5)
			continue
		end
		goal = HOME
	end

	if needsNewPath(goal) then
		computePath(goal)
	end

	if nextIndex >= 2 and nextIndex <= #waypoints then
		walkToNextWaypoint()
	else
		task.wait(0.1) -- 暂时没有可用的路径,例如目标无法到达
	end
end

所有设置都在顶部。要做多个 NPC,复制 Chaser:每个副本运行自己的 ChaseAI,并记住自己的家。旧脚本用 FilterDescendantsInstances 过滤射线;Roblox 参考文档现在建议新代码使用 ExcludeInstances,这个脚本用的就是它。

追逐脚本的工作方式

主循环的每一轮只做一个决定和一个小动作:站着、直接朝玩家走一步,或者走到下一个路径点。没有任何决定会持续超过一个路径点,所以 NPC 始终在做出反应。

寻找最近的玩家

findNearestTarget 遍历 Players:GetPlayers(),跳过所有没有角色、没有活着的 Humanoid 或没有 HumanoidRootPart 的人(正在重生或离开的玩家),并返回 DETECTION_RANGE 内最近的根零件。每一轮都会重新查找,所以 NPC 会自动切换到更近的玩家,离开的玩家也就不会再被找到:不存在需要清理的每个玩家的状态。

玩家移动时重新计算路径,但不是每一帧

计算路径会让出执行并占用服务器时间。needsNewPath 只在以下情况请求新路径:没有路径,旧路径走完了或被挡住,或者玩家离当前路径终点超过了 REPATH_DISTANCE 格;而且距离上一次计算永远不少于 MIN_REPATH_INTERVAL 秒。计算路径时 NPC 继续走向当前路径点,新路径从路径点 2 开始走,所以 NPC 不会掉头回到路径的起点。

被挡住的路径

门会关上,零件会掉落。Path.Blocked 触发时会带上被挡住的路径点的索引,这个点可能在 NPC 身后,所以脚本只在 blockedIndex >= nextIndex 时做出反应:它设置一个标志,循环就会计算新路线。如果 NPC 走向某个路径点用了超过 WAYPOINT_TIMEOUT 秒,因为被推开或被卡住,也会触发新路线。

直接走向看得见的玩家

当玩家在空旷处清晰可见时,不需要寻路。在 DIRECT_CHASE_RANGE 范围内,canSeeDirectly 向玩家发射两条射线,一条在腰部高度,一条在膝盖附近,以便发现矮墙,并忽略两个角色。如果两条射线都没碰到任何东西,而且玩家大致在同一高度,NPC 就调用 MoveTo(targetRoot.Position, targetRoot)。第二个参数让目标随玩家移动,而每 0.15 秒重复调用一次会不断重置 8 秒的超时。

射线畅通只能证明路上没有实心物体,不能证明那里有地面。如果地图上 NPC 和玩家之间有深坑或悬崖,请减小 DIRECT_CHASE_RANGE,或者设为 0 让它始终使用寻路。

在合适的距离停下

当玩家比 STOP_DISTANCE 更近时,NPC 对自己的位置调用 MoveTo,这样它就会停下。4 格适合应该站在玩家身边的 NPC;对于保持距离的宠物或随从,设为 6 或 8。对于靠接触攻击的敌人,设为 0 让它走到贴身,就像 第 4 步 那样。

NPC 为什么会抖动,怎么修复

如果 NPC 抖动、在每个路径点停顿或者往回走,原因通常是下面其中一条。追逐脚本已经考虑了每一条;这张表是用来修复你自己写的脚本的。

寻路时的抖动:原因和修复
你看到的现象原因修复
独自一人时很流畅,玩家在附近时一顿一顿Network ownership(网络所有权)。Roblox 把未锚固零件的物理交给附近玩家的设备,所以服务器发出指令时,NPC 可能在那个玩家的设备上模拟,每次交接都可能看起来像一次卡顿。在服务端对 HumanoidRootPart 调用一次 SetNetworkOwner(nil)。这会作用于所有和它相连的零件。
直接走向最后一个路径点并撞墙在循环中对每个路径点调用 MoveTo 却不等待。每次调用都会替换之前的目标。在走向下一个路径点之前等待 MoveToFinished。
在每个路径点短暂停顿,或者抄近路切角路径点之间用固定的 task.wait() 而不是等待到达。太长 NPC 会站着;太短它会跳到前面。带超时地等待 MoveToFinished。
每秒抖动或往回走好几次每一帧都算新路径。每条路径都从 NPC 自己的位置开始,所以走向路径点 1 会让它掉头。只在目标移动了几格之后重新计算路径,每秒不超过两次,并从路径点 2 开始。
停住几秒,然后继续走在无法到达的路径点上 MoveToFinished:Wait() 要等 8 秒超时。使用你自己的更短的超时,超时后计算新路径。

要查看谁拥有 NPC,在试玩测试时打开 Visualization Options 并开启 Network owners。由你的客户端模拟的零件显示绿色轮廓;由服务器或其他客户端模拟的零件显示白色或灰色轮廓。

第 4 步:接触时伤害玩家(可选)

对于敌人,在 NPC 里再加一个脚本,在接触时对玩家造成伤害。它在服务端运行,所以玩家的客户端无法修改伤害或绕过冷却。

  1. 在 ChaseAI 中把 STOP_DISTANCE 设为 0,让 NPC 走到玩家贴身处,而不是停在旁边。
  2. 在 Chaser 中插入一个名为 TouchDamage 的 Script,粘贴下面的代码。
Script 位置: 模型 Chaser 名称: TouchDamage
local Players = game:GetService("Players")

local npc = script.Parent :: Model
local humanoid = npc:WaitForChild("Humanoid") :: Humanoid

local DAMAGE = 10
local COOLDOWN_SECONDS = 1

local lastHit: { [Player]: number } = {}

local function onTouched(hit: BasePart)
	if humanoid.Health <= 0 then
		return -- 被打败的 NPC 不造成伤害
	end
	local character = hit:FindFirstAncestorOfClass("Model")
	local player = character and Players:GetPlayerFromCharacter(character)
	local targetHumanoid = character and character:FindFirstChildOfClass("Humanoid")
	if not player or not targetHumanoid or targetHumanoid.Health <= 0 then
		return
	end

	local now = os.clock()
	local last = lastHit[player]
	if last and now - last < COOLDOWN_SECONDS then
		return -- 零件重叠时 Touched 每秒会触发很多次
	end
	lastHit[player] = now

	targetHumanoid:TakeDamage(DAMAGE)
end

for _, descendant in npc:GetDescendants() do
	if descendant:IsA("BasePart") then
		descendant.Touched:Connect(onTouched)
	end
end

Players.PlayerRemoving:Connect(function(player: Player)
	lastHit[player] = nil
end)

TakeDamage 会考虑力场,所以出生后力场有效期间玩家是安全的。要无视力场,直接减少 Humanoid.Health。

冷却时间为每个玩家单独记录。零件互相摩擦时 Touched 每秒会触发很多次,如果没有冷却,一次接触就可能瞬间把玩家的生命值清零。玩家离开时会删除他的记录,所以这张表不会在服务器运行期间一直变大。

要让玩家能够反击,给他们一把 剑 或 射线检测枪。两者都在服务端对任何有 Humanoid 的东西造成伤害,所以也能打中 Chaser。

寻路修饰器和链接

默认情况下,路径是尽量不跳跃的最短路线。有三种方式可以改变它。代价和修饰器可以直接配合追逐脚本使用,因为它已经把 Costs 表传给了 CreatePath;链接则需要自己加几行代码。

材质代价

Costs 的键可以是材质名称,例如 Water、Mud 或 CrackedLava,对地形和零件都有效。默认每种材质的代价为 1。更大的数字会让 NPC 在绕路不太差时避开这种材质,而 math.huge 让它无法通行。追逐脚本设置了 Water = 20。

需要避开的区域:PathfindingModifier

  1. 用一个勾选了 Anchored、取消了 CanCollide 的零件盖住这个区域。
  2. 在这个零件里插入一个 PathfindingModifier,把它的 Label 设为 DangerZone。
  3. 就这样。追逐脚本已经给 DangerZone 设置了 math.huge 的代价,所以 NPC 会绕开这个区域。在 Visualization Options 中开启 Pathfinding modifiers,就能在导航网格上看到这个标签。

开启了 PassThrough 的修饰器作用正好相反:路线会穿过实心障碍物,例如一扇关着的门,就像它不存在一样。NPC 仍然无法穿过门,但会朝门走去,就像听到了门另一边的玩家。

PathfindingLink 连接两个 NPC 通常无法在其间行走的点,例如它要坐船渡过的河的两岸。在两端各放一个 Attachment,设置链接的 Attachment0 和 Attachment1,给它一个 Label,例如 UseBoat,再把 UseBoat 加进 Costs,代价低于 Water。这样路径中就会出现带这个标签的路径点:在 walkToNextWaypoint 中检查 waypoint.Label,并执行你自己的动作,例如让 NPC 上船,而不是 MoveTo。除非关闭 IsBidirectional,否则链接是双向的。

常见错误与解决办法

先检查 Output 窗口。它可以从 Window 菜单或 Script 选项卡打开。当路径请求失败或角色模型无法移动时,本页的脚本会输出警告。

NPC 完全不动

如果 Output 里写着 NPC 无法移动(cannot move),说明角色模型的某个部分被锚固了:取消 HumanoidRootPart 和其他零件的 Anchored。如果不是,检查代码是否在 Script 而不是 LocalScript 中,是否放在 Workspace 中的模型里,以及 Humanoid 是否已经死亡。

Output 对 WaitForChild 提示 "Infinite yield possible"

脚本在等待一个不存在的对象:名字不同的 Humanoid 或 HumanoidRootPart,或者第 2 步脚本需要的 Goal 零件不存在。重命名对象或者改脚本里的那一行。脚本错误教程 解释了这个警告。

路径算不出来,或者 NPC 无视一个本可以走到的玩家

在以下情况下,ComputeAsync 之后的 Path.Status 为 NoPath:起点或终点在实心零件内部,唯一的路线需要跳跃而 AgentCanJump 为 false,或者 AgentHeight 或 AgentRadius 对路上的缝隙来说太大。Roblox 文档还给出了硬性限制:从起点到终点的直线距离不超过 3,000 格,搜索预算为 20,000 个节点,对于巨大的开放世界或迷宫可能不够。开启 Navigation mesh 来检查路线。

NPC 在滑行,腿不动

这是动画问题,不是寻路问题。玩家角色会自动得到 Animate 脚本,而 NPC 需要自己的脚本来播放行走动画。Roblox 的 NPC kit 中每个 NPC 都有一个名为 Animate 的 Script,可以拿来研究。如何在服务端 Script 中给 NPC 加载和播放动画,请看 NPC 动画 部分。

NPC 卡在拐角,或者跳了却跳不过障碍

增大 AgentRadius,让路线离墙远一些,尤其是对于宽大的 NPC。如果它跳了却怎么也过不去,说明障碍物比 Humanoid 能跳的还高:增大 Humanoid 的 JumpHeight 或 JumpPower,或者修改关卡。

接触伤害触发得太频繁,或者从不触发

太频繁:没有冷却,或者冷却按每个零件而不是每个玩家记录。从不触发:STOP_DISTANCE 大于 0,所以 NPC 通常在碰到任何人之前就停下了,或者玩家出生后的力场还在生效。

用 RoCode 构建

如果你觉得描述 NPC 比手动搭建更简单,RoCode 可以在你打开的场景里写好这些脚本。它是独立的 Roblox Studio AI 代理:你在网页聊天里写下需求,它的 Studio 插件就会在你的 Explorer 中创建和编辑脚本。

你输入

让 Workspace 中的 Chaser 模型通过寻路追逐 80 格内最近的玩家,附近没人时回家,并在接触时造成 10 点伤害,冷却 1 秒。

RoCode 的操作
  • 可以先用 Get Properties 查看模型,读取关键值,例如它的零件上的 Anchored 和 Humanoid 的 WalkSpeed。在聊天中输入 / 可以附上模型的准确路径
  • 用 Create Script 在模型里写追逐和伤害脚本,如果角色模型需要,还可以用 Set Property 取消 Anchored
  • 直接在 Studio 中用 Check Script 检查两个脚本能否编译。这能发现编译错误以及用 wait() 代替 task.wait() 之类的问题,但发现不了逻辑错误,比如一条永远到不了玩家身边的路线
  • 分批发送改动,每一批都是 Studio 历史记录中的一个撤销点

使用插件 3.9 及以上时,RoCode 可以运行简短的试玩测试并读取错误;使用插件 3.9.11 及以上时,它可以操控一个测试角色来检查游戏是否正常运行,但它在游戏过程中不会截图,所以请点击 Play 亲自看看 NPC。如果它的表现不对,把你看到的告诉 RoCode:Check Output 可以读取你上一次试玩测试中的 Server 和 Client 输出行。NPC 只是众多系统之一;请看 怎么用 AI 做一整个 Roblox 游戏:先做可玩的核心,再做回合。RoCode 如何连接到 Studio。

常见问题

NPC 寻路应该在服务端还是客户端运行?

在服务端,放在 Script 中。Roblox 自己的寻路示例运行在 LocalScript 中,但那里移动的是玩家自己的角色。NPC 是所有人共享的,它造成的伤害应该由服务器决定。请看 Script、LocalScript 和 ModuleScript。

一个服务器能承受多少个会追逐的 NPC?

Roblox 文档中没有确切的数字;这取决于地图以及计算路径的频率。最耗资源的是路径计算,所以追逐脚本把它限制为每个 NPC 每秒两次,并在能看到玩家时跳过。对于大量 NPC,Roblox 关于脚本存放位置的建议是给它们打上标签,并在一个 ModuleScript 中通过 CollectionService 统一处理,而不是在每个模型里放一个脚本。

怎么让 NPC 死后重生?

在 ServerStorage 中保存一份 NPC 副本,并在 ServerScriptService 的脚本中处理重生,因为 NPC 里面的脚本会和它一起被销毁。当 Humanoid 的 Died 事件触发时,等几秒,销毁旧模型,再把副本的 Clone() 放进 Workspace。克隆体里的 ChaseAI 脚本会自己启动,因为服务端脚本一进入 Workspace 就会运行。

能让 NPC 只在回合进行时追玩家吗?

可以。让你的回合脚本在回合开始时把 NPC 克隆到 Workspace,在回合结束时销毁它们。回合系统教程 搭建了休息和回合的循环,可以把这个接进去。

参考资料

代码如何验证:本页的所有脚本都已用 Roblox API 类型定义(luau-lsp,2026年11月20日)通过 Luau strict 类型检查。类型检查能发现 API 名称写错和类型不匹配,但发现不了游戏逻辑上的错误。发布前请务必在 Studio 中测试。

在你自己的游戏里试试 RoCode。

每天有免费额度,无需绑定银行卡。安装插件,描述你想要的功能,然后看看它在 Studio 里做了什么。