教學 · 遊戲系統

Roblox Studio NPC 尋路:如何讓 NPC 追著玩家走

要讓 NPC 繞過牆壁、走到最近的玩家身邊,需要三樣東西:能移動的 rig、由 PathfindingService 算出的路線,以及沿著路線前進、又不和物理引擎互相拉扯的迴圈。這篇教學會把三者都做出來,最後得到一個伺服器 Script,直接放進 NPC 的 rig 就能用。

更新日期 2026年11月20日閱讀約 4 分鐘作者

重點摘要

把 Script 放進 NPC 模型裡。用 PathfindingService:CreatePath() 建立路徑,在 pcall 中用 path:ComputeAsync(start, goal) 計算它,接著用 Humanoid:MoveTo() 一個一個走過路徑點,每走一個都等 MoveToFinished 觸發後再走下一個。要讓 NPC 追著玩家跑,就選出最近的角色,並在對方移動了幾個 stud 時重新計算路徑,而不是每一幀都算。

  • 需要 Humanoid 與沒有錨定的 HumanoidRootPart。對 root part 呼叫 SetNetworkOwner(nil),讓伺服器來模擬它:這是 NPC 在玩家旁邊抖動時的標準修正方法。
  • 當路徑點的 Action 是 Jump 時就跳躍;當 Path.Blocked 對 NPC 前方的路徑點觸發時,就計算新路徑。
  • 能直接看到玩家時,就跳過 pathfinding,直接對玩家 MoveTo。在幾個 stud 外停下;如果 NPC 是碰觸造成傷害,就讓它貼上去。
本頁內容
  1. Pathfinding 的運作方式
  2. 1. 設定 NPC
  3. 2. 走到一個點
  4. 3. 追逐 Script
  5. 追逐的運作方式
  6. 修正抖動
  7. 4. 碰觸傷害
  8. 修飾器與連結
  9. Common errors
  10. With RoCode
  11. 常見問題
  12. 來源與延伸閱讀

NPC pathfinding 的運作方式

示意畫面Chaser 找到繞過牆壁的路線,跳上平台,停在離你 4 stud 的地方。

Roblox 會用角色能走的表面建立導航網格(navigation mesh)。PathfindingService 會在這張網格上找出兩點之間的路線,並以路徑點(waypoint)清單的形式傳回:每個路徑點都有位置與動作,例如走路或跳躍。接著 NPC 的 Humanoid 從一個路徑點走到下一個。Pathfinding 只負責規劃路線,沿著路線移動要靠你的 Script。

這篇教學用到的 API
API作用
PathfindingService:CreatePath()建立一個可以重複使用的 Path 物件,並透過 agent 參數配合你的 NPC 大小。
Path:ComputeAsync(start, finish)計算路線。它會讓出執行(yield),也可能失敗,所以要在 pcall 中呼叫,並檢查 Path.Status。
Path:GetWaypoints()把路線以 PathWaypoint 數值的陣列傳回,每個都有 Position、Action 與 Label。
Path.Blocked當有東西擋住已算好的路線時,帶著路徑點索引觸發。
Humanoid:MoveTo(position)讓 NPC 走向某個點。
Humanoid.MoveToFinishedNPC 走到離目標約 1 stud 時以 true 觸發,8 秒內沒走到則以 false 觸發。

這一切都在伺服器 Script 中執行:即使開了串流,伺服器也看得到整張地圖,所有玩家看到的是同一個 NPC,而傷害由用戶端無法偽造的一方決定。Script、LocalScript 與 ModuleScript 說明了這種分工。

步驟 1:能移動的 NPC

只要具備下表中的三樣東西,任何模型都能沿著路徑走。從 Toolbox 拿來或舊場景裡的 rig 有時會缺少其中一樣,通常看起來就是:NPC 站著不動,而且沒有任何錯誤。

NPC 模型需要的東西
條件為什麼重要
名稱為 Humanoid 的 HumanoidMoveTo、WalkSpeed 與跳躍都屬於 Humanoid。
HumanoidRootPart由 Humanoid 控制的零件。路徑從它的位置開始。
沒有任何零件被錨定錨定的零件無法移動,和它連接的零件也一樣。錨定零件永遠由伺服器擁有,所以下面說的抖動修正對它們無效。
  1. 打開 Avatar 或 Home 分頁,按下 Character 開啟 Rig Generator。選擇 R15,再選 Block Avatar。Workspace 中會出現一個 rig。R6 rig 也能用同樣的 Script。
  2. 把 rig 改名為 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 會走動時有哪些地方不同。想在頭目開始追逐前先用鏡頭展示它,請看過場動畫教學。

步驟 2:讓 NPC 走到一個點

先從最小、能運作的 Script 開始:走到一個不會動的零件。它會展示 pathfinding 的每個階段,但沒有追逐邏輯。

  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),讓路線避開它鑽不過去的縫隙。上面的 Script 把前三個鍵設為預設值,讓你看得出要在哪裡修改。

CreatePath 的 agent 參數
鍵預設值設定內容
AgentRadius2NPC 的半徑,單位 stud。寬的 NPC 要調大,讓路徑離牆遠一點。
AgentHeight5NPC 的高度。比這更低的地方,例如樓梯底下,會被視為擋住。
AgentCanJumptrue允許需要跳躍的路線。這類路徑點的 Action 是 Jump。
AgentCanClimbfalse允許攀爬 TrussPart。這類路徑點的標籤是 Climb。
WaypointSpacing4中間路徑點之間的距離,單位 stud。math.huge 會把它們移除。
Costs無通過各種材質與標記區域的代價有多高。請看修飾器與連結。

迴圈中有兩個重點。第一個路徑點是 NPC 自己的位置,所以迴圈跳過它。而每次 MoveTo 之後都有 MoveToFinished:Wait():新的 MoveTo 會取代前一個目標,所以不等待的迴圈會讓 NPC 直接衝向最後一個路徑點,撞進它本來該繞過的那面牆。

跳躍時,路徑點的 Action 是 Jump,Script 會呼叫 ChangeState(Enum.HumanoidStateType.Jumping)。Roblox 的 Humanoid 參考文件寫道,伺服器 Script 只有在伺服器擁有角色物理時才能改變狀態。這也是 Script 一開始先設定擁有者的原因之一。

在 Roblox 的 pathfinding 頁面上,玩家自己的角色是用 Humanoid:Move() 移動,並且每一幀檢查是否抵達,文件稱這是讓 Humanoid 沿路徑移動的最佳方式。對伺服器上的 NPC 來說,MoveTo 搭配 MoveToFinished 更短也更好懂,所以本教學使用它;如果之後需要更精細的控制,可以研究官方的 Script。

步驟 3:完整的追逐 Script

這就是大多數人在找的 Script。NPC 會追逐 80 stud 內最近的玩家、繞過牆壁、在路線需要的地方跳躍、路線被擋住時找出新路線,附近沒人時就回家。

  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

-- 設定(距離單位為 stud,時間單位為秒)
local DETECTION_RANGE = 80 -- 比這更遠的玩家 NPC 不會注意到
local STOP_DISTANCE = 4 -- 在離目標這麼遠的地方停下(0 = 貼上去,用於碰觸傷害)
local DIRECT_CHASE_RANGE = 30 -- 比這更近而且路上沒有東西時,就跳過 pathfinding
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,也記得自己的家。舊的 Script 用 FilterDescendantsInstances 過濾射線;Roblox 參考文件現在建議新作品改用 ExcludeInstances,這個 Script 用的就是它。

追逐 Script 的運作方式

主迴圈每跑一次,只做一個決定、執行一個小動作:站著、直接朝玩家走一步,或走到下一個路徑點。沒有任何決定會持續超過一個路徑點,所以 NPC 一直都在反應。

尋找最近的玩家

findNearestTarget 逐一檢查 Players:GetPlayers(),跳過沒有角色、沒有存活 Humanoid 或沒有 HumanoidRootPart 的玩家(正在重生或離開的玩家),並傳回 DETECTION_RANGE 內最近的 root part。每次都會重新搜尋,所以 NPC 會自己切換到更近的玩家,而離開的玩家就只是不再被找到:沒有任何每位玩家的狀態需要清理。

玩家移動時重新計算路徑,但不是每一幀

計算路徑會讓出執行,也會花掉伺服器時間。needsNewPath 只在以下情況要求新路徑:沒有路徑、舊路徑走完或被擋住,或玩家離目前路徑終點超過 REPATH_DISTANCE stud,而且距離上一次絕不少於 MIN_REPATH_INTERVAL 秒。計算路徑時,NPC 會繼續走向目前的路徑點,新路徑則從路徑點 2 開始走,所以 NPC 不會掉頭走回路徑的起點。

被擋住的路徑

門會關上,零件會掉落。Path.Blocked 會帶著被擋住的路徑點索引觸發,而那個點可能在 NPC 後面,所以 Script 只在 blockedIndex >= nextIndex 時反應:它設一個旗標,由迴圈計算新路線。NPC 走向某個路徑點超過 WAYPOINT_TIMEOUT 秒(因為被推開或卡住)時,也會觸發新路線。

直接走向看得到的玩家

玩家在空曠處、看得到的時候,不需要 pathfinding。在 DIRECT_CHASE_RANGE 內,canSeeDirectly 會朝玩家射出兩條射線,一條在腰部高度、一條在膝蓋附近,用來發現矮牆,並忽略兩個角色。如果兩條射線都沒打到東西,而且玩家大致在同一高度,NPC 就呼叫 MoveTo(targetRoot.Position, targetRoot)。第二個參數讓目標跟著玩家移動,而每 0.15 秒重複呼叫一次,會一直重設 8 秒的逾時。

射線暢通只證明路上沒有實心物體,不證明那裡有地板。如果地圖上 NPC 和玩家之間有深坑或懸崖,請調小 DIRECT_CHASE_RANGE,或設為 0,一律使用 pathfinding。

在適當的距離停下

玩家比 STOP_DISTANCE 更近時,NPC 會對自己的位置呼叫 MoveTo,這樣它就會停下。4 stud 適合要站在玩家旁邊的 NPC;寵物或保持距離的跟隨者可以設 6 或 8。碰觸攻擊的敵人請設 0,讓它貼上去,就像步驟 4那樣。

NPC 為什麼會抖動,以及怎麼修正

如果 NPC 抖動、在每個路徑點停頓或往後退,原因通常是下面其中一項。追逐 Script 已經處理了每一項;這張表是用來修正你自己寫的 Script。

pathfinding 抖動:原因與修正
你看到的情況原因修正方法
獨自一人時很順,有玩家靠近就一頓一頓Network ownership。Roblox 會把沒有錨定的零件的物理交給附近玩家的裝置,所以伺服器在下指令時,NPC 可能是在那位玩家的裝置上模擬的,而每次交接都可能看起來像一次頓挫。從伺服器對 HumanoidRootPart 呼叫一次 SetNetworkOwner(nil)。這會套用到所有和它連接的零件。
直接衝向最後一個路徑點,撞進牆裡在迴圈中對每個路徑點呼叫 MoveTo 而沒有等待。每次呼叫都會取代前一個目標。先等 MoveToFinished,再前往下一個路徑點。
在每個路徑點短暫停下,或抄近路切過轉角路徑點之間用固定的 task.wait(),而不是等它抵達。太久 NPC 會站著,太短它會跳到前面去。用帶逾時的方式等待 MoveToFinished。
每秒抖動或往後退好幾次每一幀都算新路徑。每條路徑都從 NPC 自己的位置開始,所以走向路徑點 1 會讓它掉頭。只在目標移動了幾個 stud 時才重新計算路徑,每秒不超過兩次,並從路徑點 2 開始走。
停住好幾秒,然後才繼續走在走不到的路徑點上,MoveToFinished:Wait() 會等滿 8 秒逾時。用你自己較短的逾時,逾時後計算新路徑。

想知道 NPC 歸誰擁有,可以在試玩測試時打開 Visualization Options,開啟 Network owners。由你的用戶端模擬的零件會有綠色外框;由伺服器或其他用戶端模擬的零件則是白色或灰色外框。

步驟 4:碰觸時對玩家造成傷害(選用)

如果是敵人,就在 NPC 中加入第二個 Script,在碰到玩家時造成傷害。它在伺服器上執行,所以玩家的用戶端無法修改傷害或略過冷卻時間。

  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。

pathfinding 的修飾器與連結

預設的路徑是最短路線,並且盡量不跳躍。有三種方式可以改變這一點。代價與修飾器可以直接搭配追逐 Script 使用,因為它已經把 Costs 表格傳給 CreatePath;連結則需要你自己寫幾行。

材質代價

Costs 的鍵可以是材質名稱,例如 Water、Mud 或 CrackedLava,地形與零件都適用。預設每種材質的代價是 1。數字越大,只要繞路不會更糟,NPC 就會避開這種材質;math.huge 則讓它完全無法通過。追逐 Script 設定了 Water = 20。

要避開的區域:PathfindingModifier

  1. 用一個開啟 Anchored、關閉 CanCollide 的零件蓋住那個區域。
  2. 在這個零件中插入 PathfindingModifier,把它的 Label 設為 DangerZone。
  3. 這樣就完成了。追逐 Script 已經把 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 分頁打開。這一頁的 Script 會在路徑請求失敗或 rig 無法移動時輸出警告。

NPC 完全不動

如果 Output 寫著 NPC 無法移動(cannot move),代表 rig 有零件被錨定:把 HumanoidRootPart 和其他零件的 Anchored 取消。如果不是,請確認程式碼在 Script 而不是 LocalScript 中、它放在 Workspace 中的模型裡,而且 Humanoid 沒有死亡。

Output 在 WaitForChild 上顯示 "Infinite yield possible"

Script 在等一個不存在的物件:名稱不同的 Humanoid 或 HumanoidRootPart,或是步驟 2 的 Script 找不到 Goal 零件。把物件或 Script 中的字串改成一致。Script 錯誤教學說明了這個警告。

路徑算不出來,或 NPC 忽略了它其實走得到的玩家

ComputeAsync 之後的 Path.Status 會是 NoPath 的情況有:起點或終點在實心零件內部、唯一的路線需要跳躍但 AgentCanJump 是 false,或 AgentHeight 或 AgentRadius 對路上的縫隙來說太大。Roblox 文件中也有硬性限制:起點到終點的直線距離不超過 3,000 stud,以及 20,000 個節點的搜尋預算,超大的開放世界或迷宮可能不夠用。開啟 Navigation mesh 來檢查路線。

NPC 在滑行,腳不會動

這是動畫的問題,不是 pathfinding 的問題。玩家角色會自動拿到 Animate Script,但 NPC 需要自己的 Script 來播放走路動畫。Roblox NPC kit 中的每個 NPC 都有一個名為 Animate 的 Script,可以拿來研究。怎麼從伺服器 Script 在 NPC 上載入並播放動畫,請看NPC 動畫一節。

NPC 卡在轉角,或會跳但跳不過障礙

調大 AgentRadius,讓路線離牆遠一點,寬的 NPC 尤其如此。如果它會跳但怎麼都過不去,代表障礙比 Humanoid 能跳的高度還高:調高 Humanoid 的 JumpHeight 或 JumpPower,或修改關卡。

碰觸傷害觸發太頻繁,或從來不觸發

太頻繁:沒有冷卻時間,或冷卻是依零件而不是依玩家記錄。從不觸發:STOP_DISTANCE 大於 0,所以 NPC 通常在碰到人之前就停下了,或是玩家重生後的力場還在。

用 RoCode 來做

如果你覺得描述 NPC 比自己動手組裝更簡單,RoCode 可以在你開啟的場景中寫出這些 Script。它是 Roblox Studio 的獨立 AI 代理:你在網頁聊天中輸入,它的 Studio 外掛程式會在你的 Explorer 中建立並編輯 Script。

你輸入

讓 Workspace 中的 Chaser 模型用 pathfinding 追逐 80 stud 內最近的玩家,附近沒人時回家,並在碰觸時造成 10 點傷害,冷卻時間 1 秒。

RoCode 會做
  • 可以先用 Get Properties 檢查模型,讀取關鍵數值,例如零件的 Anchored 與 Humanoid 的 WalkSpeed。在聊天中輸入 / 就能附上模型的精確路徑
  • 用 Create Script 在模型內寫好追逐與傷害 Script,如果 rig 需要,也可以用 Set Property 取消 Anchored
  • 直接在 Studio 中用 Check Script 確認兩個 Script 都能編譯。這能抓到編譯錯誤,以及用 wait() 而不是 task.wait() 這類問題,但抓不到邏輯錯誤,例如一條永遠走不到玩家身邊的路線
  • 分批送出變更,每一批都是 Studio 歷程中的一個復原點

外掛程式 3.9 或更新版本時,RoCode 可以執行一次簡短的試玩測試並讀取錯誤;外掛程式 3.9.11 或更新版本時,它可以操作測試角色來確認遊戲能運作,但遊戲進行中它不會截圖,所以請自己按下 Play 看看 NPC。如果它的行為不對,把你看到的情況告訴 RoCode:Check Output 可以讀取你上一次試玩測試的 Server 與 Client 訊息。NPC 只是眾多系統之一;請看如何用 AI 做出完整的 Roblox 遊戲:先做可遊玩的核心,再做回合。RoCode 如何連接到 Studio。

常見問題

NPC pathfinding 要在哪裡執行:伺服器還是用戶端?

在伺服器上,放在 Script 中。Roblox 自己的 pathfinding 範例是在 LocalScript 中執行,但那裡移動的是玩家自己的角色。NPC 是所有人共用的,它造成的傷害應該由伺服器決定。請看 Script、LocalScript 與 ModuleScript。

一台伺服器能撐住多少個會追人的 NPC?

Roblox 文件中沒有確切數字;這取決於地圖,以及路徑計算的頻率。最耗資源的是計算路徑,所以追逐 Script 把它限制在每個 NPC 每秒兩次,看得到玩家時則跳過。NPC 數量很多時,Roblox 關於 Script 放置位置的建議是幫它們加上標籤,由一個 ModuleScript 透過 CollectionService 處理,而不是在每個模型中都放一個 Script。

怎麼讓 NPC 死後重生?

把 NPC 的複本放在 ServerStorage,重生則由 ServerScriptService 中的 Script 處理,因為 NPC 裡面的 Script 會跟著它一起被銷毀。Humanoid 的 Died 事件觸發時,等幾秒,銷毀舊模型,再把複本的 Clone() 放進 Workspace。複製品裡的 ChaseAI Script 會自己啟動,因為伺服器 Script 一進入 Workspace 就會執行。

可以讓 NPC 只在回合中追逐玩家嗎?

可以。讓你的回合 Script 在回合開始時把 NPC 複製到 Workspace,在回合結束時銷毀它們。回合系統教學會做出休息與回合的循環,這部分就接在那裡。

來源與延伸閱讀

程式碼如何驗證:本頁每一段 Script 都通過 Luau 嚴格型別檢查,並使用 Roblox API 定義(luau-lsp,2026年11月20日)。型別檢查能找出拼錯的 API 與錯誤的型別,但無法檢查遊戲邏輯,所以發布前請先在 Studio 中測試。

在你自己的遊戲裡試試 RoCode。

每天都有免費點數,不需要信用卡。安裝外掛程式,描述你要的功能,再看看 Studio 裡出現了什麼。