要点
把一个 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 靠接触造成伤害,就一直走到贴身。
NPC 寻路的原理
Roblox 会根据角色可以行走的表面生成一张 导航网格(navigation mesh)。PathfindingService 在这张网格上寻找两点之间的路线,并以 路径点 列表的形式返回:每个路径点都有位置和动作,例如行走或跳跃。然后 NPC 的 Humanoid 从一个路径点走到下一个。寻路只负责规划路线:沿着路线移动要靠你的脚本。
| 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 站着不动,也没有任何报错。
| 要求 | 为什么重要 |
|---|---|
名为 Humanoid 的 Humanoid | MoveTo、WalkSpeed 和跳跃都属于 Humanoid。 |
HumanoidRootPart | Humanoid 控制的零件。路径从它的位置开始。 |
| 没有任何东西被锚固 | 锚固的零件不能移动,和它相连的零件也一样。锚固零件始终归服务器所有,所以下面讲的抖动修复对它们不适用。 |
- 打开 Avatar 或 Home 选项卡,点击 Character 打开 Rig Generator。选择 R15,然后选 Block Avatar。Workspace 中会出现一个角色模型。R6 模型也能用同样的脚本。
- 把角色模型重命名为
Chaser,放在一块空地上。 - 选中它的 HumanoidRootPart,确认 Properties 窗口中的 Anchored 已取消勾选。模型中任何其他锚固的零件也照此处理。想快速找到它们,可以在 3D 视口右上角的 Visualization Options 小部件中开启 Anchored parts。
Workspace
Chaser Model
Humanoid Humanoid
HumanoidRootPart Part
Head, UpperTorso, LowerTorso ... (身体部位)
ChaseAI Script new
TouchDamage Script new
如果还想让 NPC 说话,NPC 对话教程 会加上带回答选项的 Talk 提示,并说明 NPC 会走动时有什么不同。想在 Boss 开始追逐之前用镜头展示它,请看 过场动画教程。
第 2 步:让 NPC 走到一个点
先从能工作的最小脚本开始:走到一个固定的零件。它展示了寻路的每个阶段,但没有追逐逻辑。
- 在 Workspace 中插入一个 Part,命名为
Goal,勾选 Anchored,取消勾选 CanCollide,并把它放在地面上,让 NPC 必须绕过一堵墙才能到达。 - 在 Explorer 中把鼠标悬停在 Chaser 上,点击 + 按钮并插入一个 Script。把它命名为
WalkToGoal,粘贴下面的代码。 - 点击 Play。NPC 绕过墙,走向 Goal 零件。
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),这样路线就会避开它钻不过去的缝隙。上面的脚本把前三个键设为默认值,方便你看到该在哪里修改。
| 键 | 默认 | 设定什么 |
|---|---|---|
AgentRadius | 2 | NPC 的半径(格)。对于宽大的 NPC 调大它,让路径离墙远一些。 |
AgentHeight | 5 | NPC 的高度。低于这个高度的地方,例如楼梯下方,被视为不可通行。 |
AgentCanJump | true | 允许需要跳跃的路线。这类路径点的 Action 为 Jump。 |
AgentCanClimb | false | 允许攀爬 TrussPart。这类路径点带有 Climb 标签。 |
WaypointSpacing | 4 | 中间路径点之间的距离(格)。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 格范围内最近的玩家,绕过墙壁,在路线需要的地方跳跃,有东西挡路时找新路线,附近没人时回家。
- 如果加过
WalkToGoal,先把它从 Chaser 中删掉。 - 把鼠标悬停在 Chaser 上,点击 +,插入一个名为
ChaseAI的 Script,粘贴下面的代码。 - 点击 Play,走到墙后面,再跑出范围。NPC 会绕过墙追你,然后回到它出发的地方。
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 里再加一个脚本,在接触时对玩家造成伤害。它在服务端运行,所以玩家的客户端无法修改伤害或绕过冷却。
- 在 ChaseAI 中把
STOP_DISTANCE设为0,让 NPC 走到玩家贴身处,而不是停在旁边。 - 在 Chaser 中插入一个名为
TouchDamage的 Script,粘贴下面的代码。
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
- 用一个勾选了 Anchored、取消了 CanCollide 的零件盖住这个区域。
- 在这个零件里插入一个 PathfindingModifier,把它的
Label设为DangerZone。 - 就这样。追逐脚本已经给
DangerZone设置了math.huge的代价,所以 NPC 会绕开这个区域。在 Visualization Options 中开启 Pathfinding modifiers,就能在导航网格上看到这个标签。
开启了 PassThrough 的修饰器作用正好相反:路线会穿过实心障碍物,例如一扇关着的门,就像它不存在一样。NPC 仍然无法穿过门,但会朝门走去,就像听到了门另一边的玩家。
自定义通道:PathfindingLink
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 秒。
- 可以先用 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 Creator Docs: Pathfinding(英文). 代理参数、路径点、被挡住的路径、修饰器、链接和限制
- Roblox Creator Docs: PathfindingService(英文). CreatePath 和默认值
- Roblox Creator Docs: Path(英文). ComputeAsync、GetWaypoints、Status 和 Blocked 事件
- Roblox Creator Docs: Humanoid(英文). MoveTo、MoveToFinished 的 8 秒超时、ChangeState 和 TakeDamage
- Roblox Creator Docs: Network ownership(英文). 自动所有权、SetNetworkOwner 和 Network owners 模式
- Roblox Creator Docs: RaycastParams(英文). ExcludeInstances 和 RespectCanCollide
- Roblox Creator Docs: NPC kit(英文). 带有自己 Animate 脚本的 NPC 示例
代码如何验证:本页的所有脚本都已用 Roblox API 类型定义(luau-lsp,2026年11月20日)通过 Luau strict 类型检查。类型检查能发现 API 名称写错和类型不匹配,但发现不了游戏逻辑上的错误。发布前请务必在 Studio 中测试。