要点
NPC のモデルの中に Script を入れます。PathfindingService:CreatePath() でパスを作り、pcall の中で path:ComputeAsync(start, goal) を使って計算し、ウェイポイントを1つずつ Humanoid:MoveTo() で進みます。次に進む前に MoveToFinished を待ちます。NPC にプレイヤーを追わせるには、いちばん近いキャラクターを選び、毎フレームではなく、そのキャラクターが数スタッド動いたときにパスを計算し直します。
- Humanoid と、Anchored でない HumanoidRootPart が必要です。ルートパーツで
SetNetworkOwner(nil)を呼び、サーバーにシミュレーションさせてください。プレイヤーの近くで NPC がカクつくときの定番の直し方です。 - ウェイポイントの
ActionがJumpならジャンプし、NPC より先にあるウェイポイントでPath.Blockedが発火したら新しいパスを計算します。 - プレイヤーがまっすぐ見えているときは Pathfinding を飛ばして、プレイヤーへ直接
MoveToします。数スタッド手前で止まるか、NPC が接触でダメージを与えるならぴったりまで近づきます。
このページの内容
NPC の Pathfinding の仕組み
Roblox は、キャラクターが歩ける面からナビゲーションメッシュ(navigation mesh)を作ります。PathfindingService はこのメッシュ上で2点間のルートを探し、ウェイポイントのリストとして返します。各ウェイポイントには位置と、歩くやジャンプといったアクションがあります。そのあと NPC の Humanoid が、ウェイポイントから次のウェイポイントへと歩きます。Pathfinding はルートを計画するだけで、それに沿って動かすのはあなたのスクリプトです。
| 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
下の表の3つがそろっていれば、どんなモデルでもパスに沿って歩けます。Toolbox のリグや古いプレイスのリグには何かが足りないことがあり、たいていは NPC がその場に立ったまま、エラーも出ないという形で現れます。
| 必要なもの | なぜ重要か |
|---|---|
名前が Humanoid の Humanoid | MoveTo、WalkSpeed、ジャンプは Humanoid のものです。 |
HumanoidRootPart | Humanoid が動かすパーツです。パスはこのパーツの位置から始まります。 |
| 何も Anchored になっていない | Anchored のパーツは動けず、それにつながったパーツも動けません。Anchored のパーツは常にサーバーが所有するので、下で説明するカクつきの直し方も使えません。 |
- Avatar タブか Home タブを開き、Character を押して Rig Generator を開きます。R15 を選び、次に Block Avatar を選びます。Workspace にリグが現れます。R6 のリグでも同じスクリプトで動きます。
- リグの名前を
Chaserに変え、開けた場所に置きます。 - その HumanoidRootPart を選択し、Properties ウィンドウで Anchored がオフになっていることを確認します。モデル内のほかの 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 が歩く場合に何が変わるかを説明しています。追跡を始める前にボスをカメラで見せたいなら、カットシーンのガイドを見てください。
ステップ2: NPC を地点まで歩かせる
まずはいちばん小さな動くスクリプトから始めます。動かないパーツまで歩くだけのものです。追跡のロジックなしで、Pathfinding の各段階が見えます。
- 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 はこれをエージェントと呼びます)を表し、NPC が通り抜けられない隙間をルートが避けるようにします。上のスクリプトは、どこを変えればよいか分かるように、最初の3つのキーを初期値と同じ値に設定しています。
| キー | 初期値 | 設定する内容 |
|---|---|---|
AgentRadius | 2 | NPC の半径(スタッド)。幅の広い NPC では大きくして、パスが壁から離れるようにします。 |
AgentHeight | 5 | NPC の高さ。階段の下など、これより低い場所はふさがっているとみなされます。 |
AgentCanJump | true | ジャンプが必要なルートを許可します。そうしたウェイポイントの Action は Jump です。 |
AgentCanClimb | false | TrussPart を登ることを許可します。そうしたウェイポイントのラベルは Climb です。 |
WaypointSpacing | 4 | 途中のウェイポイントの間隔(スタッド)。math.huge にすると途中のウェイポイントがなくなります。 |
Costs | なし | 素材やラベル付きの領域を通るコストの高さ。モディファイアーとリンクを見てください。 |
ループでは2つの点が重要です。最初のウェイポイントは NPC 自身の位置なので、ループはそれを飛ばします。そして MoveTo のたびに MoveToFinished:Wait() が続きます。新しい MoveTo は前の目標を置き換えるので、待たないループでは NPC が最後のウェイポイントへまっすぐ向かい、回り込むはずの壁そのものにぶつかります。
ジャンプでは、ウェイポイントの Action が Jump になり、スクリプトは ChangeState(Enum.HumanoidStateType.Jumping) を呼びます。Roblox の Humanoid のリファレンスには、サーバーのスクリプトが状態を変えられるのは、サーバーがキャラクターの物理を所有しているときだけとあります。スクリプトが最初に所有者を設定する理由の1つがこれです。
Roblox の Pathfinding のページでは、プレイヤー自身のキャラクターを Humanoid:Move() で動かし、毎フレーム到着をチェックしていて、これが Humanoid をパスに沿って動かす最善の方法だとされています。サーバーの NPC には MoveTo と MoveToFinished のほうが短く分かりやすいので、このガイドではそちらを使います。あとでもっと細かく制御したくなったら、公式のスクリプトを読み解いてください。
ステップ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 -- これより遠いプレイヤーには気づかない
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 -- 1つのウェイポイントにこれ以上かかったらパスを捨てる
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 を待つが、組み込みの 8 秒ではなく timeout 秒であきらめる。
-- そうすれば引っかかった 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 をすすめており、このスクリプトもそちらを使っています。
追跡スクリプトの仕組み
メインループは1周ごとに1つの判断をして、1つの小さな行動をします。立ち止まる、プレイヤーへまっすぐ1歩進む、次のウェイポイントまで進む、のどれかです。1つのウェイポイントより先のことは何も決めないので、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 秒より長くかかったウェイポイントも、新しいルートのきっかけになります。
見えているプレイヤーへまっすぐ向かう
開けた場所でプレイヤーが見えているときは、Pathfinding は不要です。DIRECT_CHASE_RANGE 以内では、canSeeDirectly 関数が低い壁にも気づけるよう、腰の高さと膝のあたりの2本の光線をプレイヤーへ飛ばし、両方のキャラクターを無視します。どちらの光線も何にも当たらず、プレイヤーがほぼ同じ高さにいれば、NPC は MoveTo(targetRoot.Position, targetRoot) を呼びます。2番目の引数で目標がプレイヤーと一緒に動くようになり、0.15 秒ごとに呼び直すことで8秒のタイムアウトが常にリセットされます。
光線が通れば途中に固いものがないことは分かりますが、そこに床があることまでは分かりません。マップで NPC とプレイヤーの間に穴や崖があるなら、DIRECT_CHASE_RANGE を小さくするか 0 にして、常に Pathfinding を使うようにしてください。
ちょうどよい距離で止まる
プレイヤーが STOP_DISTANCE より近くにいると、NPC は自分の位置へ MoveTo を呼び、それで止まります。プレイヤーのそばに立つ NPC には 4 スタッドが合います。距離を保つペットや付き添いなら 6 か 8 にします。接触で攻撃する敵なら、ステップ4のようにぴったりまで近づくよう 0 にします。
NPC がカクつく理由と直し方
NPC がカクつく、ウェイポイントごとに止まる、後ろに下がる、という場合、原因はたいてい下のどれかです。追跡スクリプトはすでにそれぞれに対処しているので、この表は自分で書いたスクリプトを直すためのものです。
| 見える症状 | 原因 | 直し方 |
|---|---|---|
| 1体だけならなめらかで、プレイヤーが近くにいるとガクガクする | Network ownership です。Roblox は Anchored でないパーツの物理を近くのプレイヤーの端末に渡すので、サーバーが命令を出している間も NPC がそのプレイヤーの端末でシミュレーションされることがあり、受け渡しのたびにガクッと見えることがあります。 | サーバーから HumanoidRootPart で一度だけ SetNetworkOwner(nil) を呼びます。これはそれにつながったすべてのパーツに効きます。 |
| 最後のウェイポイントへまっすぐ向かい、壁にぶつかる | ループの中で、待たずにウェイポイントごとに MoveTo を呼んでいます。呼ぶたびに前の目標が置き換わります。 | 次のウェイポイントへ進む前に MoveToFinished を待ちます。 |
| ウェイポイントごとに少し止まる、または角を近道する | 到着を待つ代わりに、ウェイポイントの間で固定の task.wait() を使っています。長すぎると NPC が立ち止まり、短すぎると先へ飛び越えます。 | タイムアウト付きで MoveToFinished を待ちます。 |
| 1秒に何度もカクついたり後ろに下がったりする | 毎フレーム新しいパスを作っています。どれも NPC 自身の位置から始まるので、ウェイポイント 1 へのパスで後ろを向いてしまいます。 | 目標が数スタッド動いたときだけ、1秒に2回までパスを計算し直し、ウェイポイント 2 から始めます。 |
| 数秒固まってから、また歩き出す | たどり着けないウェイポイントで MoveToFinished:Wait() が8秒のタイムアウトを待っています。 | 自分でもっと短いタイムアウトを使い、切れたら新しいパスを計算します。 |
誰が NPC を所有しているか見るには、プレイテスト中に Visualization Options を開いて Network owners をオンにします。自分のクライアントがシミュレーションしているパーツは緑の輪郭になり、サーバーやほかのクライアントのパーツは白か灰色の輪郭になります。
ステップ4: 接触でプレイヤーにダメージ(任意)
敵にするなら、触れたプレイヤーにダメージを与える2つ目のスクリプトを 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 は1秒に何度も発火する
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 は ForceField を考慮するので、スポーン後の ForceField が続いている間、プレイヤーは安全です。ForceField を無視するには Humanoid.Health を直接減らしてください。
クールダウンはプレイヤーごとに別々に記録されます。パーツがこすれ合っている間 Touched は1秒に何度も発火するので、クールダウンがないと1回の接触で一瞬のうちにプレイヤーの体力がゼロになりかねません。記録はそのプレイヤーが退出すると削除されるので、サーバーが動いている間テーブルがずっと増え続けることはありません。
プレイヤーが反撃できるようにするには、剣かレイキャストの銃を渡してください。どちらも Humanoid を持つものすべてにサーバーでダメージを与えるので、Chaser にも当たります。
Pathfinding のモディファイアーとリンク
初期設定では、パスはできるだけジャンプのない最短ルートです。これを変える方法は3つあります。コストとモディファイアーは、追跡スクリプトがすでに 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 がふだんは行き来できない2点、たとえばボートで渡る川の両岸をつなぎます。両端に Attachment を置き、リンクの Attachment0 と Attachment1 を設定し、UseBoat などの Label を付けて、Costs に Water より低いコストで UseBoat を追加します。するとパスにそのラベルの付いたウェイポイントが現れるので、walkToNextWaypoint で waypoint.Label をチェックし、MoveTo の代わりに、NPC をボートに乗せるなどの独自の動作を実行します。IsBidirectional をオフにしない限り、リンクは双方向に使えます。
よくあるエラーと対処法
まず Output ウィンドウを確認してください。Window メニューか Script タブから開けます。このページのスクリプトは、パスのリクエストが失敗したときやリグが動けないときに警告を出します。
NPC がまったく動かない
NPC が動けない(cannot move)と Output に出ていれば、リグの一部が Anchored になっています。HumanoidRootPart とほかのパーツの Anchored を外してください。そうでなければ、コードが LocalScript ではなく Script にあること、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 が足を動かさずに滑る
これは Pathfinding ではなくアニメーションの問題です。プレイヤーのキャラクターには Animate スクリプトが自動で入りますが、NPC が歩くアニメーションを再生するには専用のスクリプトが必要です。Roblox の NPC kit の NPC にはどれも Animate という名前の Script があるので、読み解いてみてください。サーバーの Script から NPC にアニメーションを読み込んで再生する方法は、NPC のアニメーションの項目を見てください。
NPC が角で引っかかる、またはジャンプしても障害物を越えられない
特に幅の広い NPC では、AgentRadius を大きくしてルートが壁から離れるようにします。ジャンプしてもどうしても越えられないなら、障害物が Humanoid のジャンプできる高さより高いので、Humanoid の JumpHeight か JumpPower を上げるか、レベルを変えてください。
接触ダメージが多すぎる、またはまったく入らない
多すぎる場合: クールダウンがないか、プレイヤーごとではなくパーツごとに記録されています。まったく入らない場合: STOP_DISTANCE が 0 より大きいので NPC はたいてい誰かに触れる前に止まっているか、プレイヤーにまだスポーン後の ForceField が残っています。
RoCode で作る
NPC を手で組み立てるより説明するほうが楽なら、RoCode が開いているプレイスにこれらのスクリプトを書けます。RoCode は Roblox Studio 向けの独立した AI エージェントです。ウェブチャットで書くと、Studio プラグインがあなたの Explorer でスクリプトを作成、編集します。
Workspace の Chaser モデルが、Pathfinding で 80 スタッド以内のいちばん近いプレイヤーを追いかけ、近くに誰もいなければ家に帰り、接触で 10 ダメージをクールダウン 1 秒で与えるようにして。
- まず Get Properties でモデルを見て、パーツの Anchored や Humanoid の WalkSpeed などの主な値を読むことがあります。チャットで / を入力すると、モデルの正確なパスを添付できます
- Create Script でモデルの中に追跡とダメージのスクリプトを書き、リグに必要なら Set Property で Anchored を外すこともできます
- 両方のスクリプトのコンパイルを Studio の中で Check Script で確認します。これでコンパイルエラーや、task.wait() ではなく wait() を使っている点などは見つかりますが、プレイヤーにたどり着かないルートのようなロジックのバグは見つかりません
- 変更をまとまりごとに送り、各まとまりが Studio の履歴の取り消しポイントになります
プラグイン 3.9 以降なら RoCode は短いプレイテストを実行してエラーを読め、プラグイン 3.9.11 以降ならテスト用のキャラクターを操作してゲームが動くか確かめられます。ただしプレイ中はスクリーンショットを撮らないので、Play を押して NPC を自分で見てください。思った動きをしなければ、見たことを RoCode に伝えてください。Check Output で前回のプレイテストの Server と Client の行を読めます。NPC は多くのシステムの1つにすぎません。AI で Roblox のゲーム全体を作る方法: まず遊べる核を作り、そのあとラウンドごとに進めるを見てください。RoCode が Studio に接続する仕組み。
よくある質問
NPC の Pathfinding はサーバーとクライアントのどちらで実行しますか?
サーバーの Script です。Roblox 自身の Pathfinding の例は LocalScript で動きますが、そこで動いているのはプレイヤー自身のキャラクターです。NPC は全員で共有するもので、NPC が与えるダメージはサーバーが決める必要があります。Script、LocalScript、ModuleScript を見てください。
1台のサーバーで追跡する NPC を何体まで動かせますか?
Roblox のドキュメントに正確な数はなく、マップとパスを計算する頻度によります。いちばん重いのはパスの計算なので、追跡スクリプトは NPC ごとに1秒2回までに制限し、プレイヤーが見えているときは計算を飛ばします。NPC が多い場合、スクリプトの置き場所についての Roblox の推奨では、各モデルにスクリプトを入れるのではなく、タグを付けて1つの ModuleScript から CollectionService で処理するようすすめています。
死んだ NPC を復活させるには?
NPC のコピーを ServerStorage に置き、復活は ServerScriptService のスクリプトから行います。NPC の中のスクリプトは NPC と一緒に破棄されるからです。Humanoid の Died イベントが発火したら数秒待ち、古いモデルを破棄して、コピーの Clone() を Workspace に入れます。サーバースクリプトは Workspace に入るとすぐ動くので、クローンの中の ChaseAI スクリプトは自動で動き出します。
ラウンド中だけ 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 でテストしてください。