Коротко
Покладіть Script усередину моделі NPC. Створіть шлях через PathfindingService:CreatePath(), порахуйте його через path:ComputeAsync(start, goal) усередині pcall, а потім проходьте вейпоінти по одному через Humanoid:MoveTo(), чекаючи на MoveToFinished перед наступним. Щоб NPC переслідував гравця, обирайте найближчого персонажа і перераховуйте шлях, коли він зрушив на кілька стадів, а не щокадру.
- Потрібні Humanoid і незаанкерений HumanoidRootPart. Викличте
SetNetworkOwner(nil)на root part, щоб його симулював сервер: це звичайне виправлення для NPC, який смикається поруч із гравцями. - Стрибайте, коли
Actionвейпоінта дорівнюєJump, і рахуйте новий шлях, колиPath.Blockedспрацьовує для вейпоінта попереду NPC. - Коли гравця видно напряму, пропускайте pathfinding і робіть
MoveToпросто до нього. Зупиняйтеся за кілька стадів або йдіть впритул, якщо NPC завдає шкоди дотиком.
На цій сторінці
Як працює pathfinding NPC
Roblox будує навігаційну сітку (navigation mesh) з поверхонь, якими може ходити персонаж. PathfindingService шукає цією сіткою маршрут між двома точками й повертає його як список вейпоінтів: кожен має позицію і дію, наприклад ходьбу чи стрибок. Потім Humanoid NPC іде від одного вейпоінта до наступного. Pathfinding лише планує маршрут: рухатися ним має ваш скрипт.
| API | Що робить |
|---|---|
PathfindingService:CreatePath() | Створює об'єкт Path, який можна використовувати багато разів, під розмір вашого NPC через параметри агента. |
Path:ComputeAsync(start, finish) | Рахує маршрут. Він поступається виконанням (yield) і може впасти, тому викликайте його всередині pcall і перевіряйте Path.Status. |
Path:GetWaypoints() | Повертає маршрут як масив значень PathWaypoint, кожне має Position, Action і Label. |
Path.Blocked | Спрацьовує з індексом вейпоінта, коли щось перекриває порахований маршрут. |
Humanoid:MoveTo(position) | Веде NPC до точки. |
Humanoid.MoveToFinished | Спрацьовує з true, коли NPC підходить до точки приблизно на стад, або з false, якщо він не дійшов за 8 секунд. |
Запускайте все це в серверному 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 і перевірте, що Anchored у вікні Properties вимкнено. Те саме зробіть для будь-якого іншого заанкереного парта в моделі. Щоб швидко їх знайти, увімкніть Anchored parts у віджеті Visualization Options у правому верхньому куті 3D-в'юпорта.
Workspace
Chaser Model
Humanoid Humanoid
HumanoidRootPart Part
Head, UpperTorso, LowerTorso ... (частини тіла)
ChaseAI Script new
TouchDamage Script new
Щоб NPC ще й розмовляв, гайд з діалогу з NPC додає підказку Talk з варіантами відповіді й пояснює, що змінюється, коли NPC ходить. Щоб показати боса камерою до того, як він почне погоню, дивіться гайд з катсцен.
Крок 2: Відправляємо NPC до точки
Почніть з найменшого робочого скрипта: дійти до нерухомого парта. Він показує кожен етап pathfinding без логіки погоні.
- Вставте Part у Workspace, назвіть його
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 має володіти сервер, інакше ChangeState (стрибок) зі Script не спрацює
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 називає його агентом), щоб маршрут обходив щілини, у які він не пролізе. Скрипт вище задає перші три ключі рівними значенням за замовчуванням, щоб було видно, де їх змінювати.
| Ключ | За замовчуванням | Що задає |
|---|---|---|
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 про pathfinding власний персонаж гравця рухається через Humanoid:Move() з перевіркою прибуття щокадру, і це названо найкращим способом вести Humanoid шляхом. MoveTo з MoveToFinished коротший і зрозуміліший для серверного NPC, тому гайд використовує його; якщо згодом знадобиться точніший контроль, розберіть офіційний скрипт.
Крок 3: Повний скрипт погоні
Це скрипт, який шукає більшість. NPC переслідує найближчого гравця в межах 80 стадів, обходить стіни, стрибає там, де цього потребує маршрут, знаходить новий маршрут, коли щось його перекриває, і йде додому, коли поруч нікого немає.
- Видаліть
WalkToGoalз Chaser, якщо додавали його. - Наведіть курсор на Chaser, натисніть +, вставте Script з назвою
ChaseAIі вставте код нижче. - Натисніть 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 -- ближче за це пропускаємо 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
-- HumanoidRootPart найближчого живого гравця в межах DETECTION_RANGE або 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 (гравців, які респавняться або виходять) і повертає найближчий root part у межах 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 пускає в гравця два промені, на рівні пояса і біля колін, щоб помітити низькі стіни, і ігнорує обох персонажів. Якщо жоден промінь ні в що не влучив і гравець приблизно на тому самому рівні, NPC викликає MoveTo(targetRoot.Position, targetRoot). Другий аргумент змушує ціль рухатися разом із гравцем, а повтор виклику кожні 0.15 секунди весь час скидає 8-секундний тайм-аут.
Чистий промінь доводить, що на шляху немає нічого твердого, але не те, що там є підлога. Якщо на карті між NPC і гравцями є прірви чи урвища, зменште DIRECT_CHASE_RANGE або поставте 0, щоб завжди використовувати pathfinding.
Зупинка на потрібній відстані
Коли гравець ближче за STOP_DISTANCE, NPC викликає MoveTo на свою ж позицію, і це його зупиняє. 4 стади підходять NPC, який має стояти поруч із гравцем; для улюбленця чи супутника, який тримає дистанцію, поставте 6 або 8. Для ворога, який б'є дотиком, поставте 0, щоб він ішов впритул, як у кроці 4.
Чому NPC смикається і як це виправити
Якщо NPC смикається, завмирає на кожному вейпоінті або ступає назад, зазвичай причина в одному з пунктів нижче. Скрипт погоні вже враховує кожен із них; таблиця потрібна, щоб полагодити скрипт, який ви написали самі.
| Що ви бачите | Причина | Виправлення |
|---|---|---|
| Плавно, поки сам, і ривками, коли поруч гравець | Network ownership. Roblox віддає фізику незаанкерених партів пристрою гравця поблизу, тому NPC може симулюватися на пристрої цього гравця, поки команди віддає сервер, і кожна передача може виглядати як ривок. | Один раз викличте SetNetworkOwner(nil) на HumanoidRootPart із сервера. Це діє на всі з'єднані з ним парти. |
| Іде просто до останнього вейпоінта і в стіни | 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 Script з назвою
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
За замовчуванням шлях це найкоротший маршрут, де за змоги немає стрибків. Змінити це можна трьома способами. Вартості й модифікатори працюють зі скриптом погоні як є, бо він уже передає таблицю Costs у CreatePath; для посилань потрібно кілька власних рядків.
Вартість матеріалів
Ключами в Costs можуть бути назви матеріалів, наприклад Water, Mud або CrackedLava, і для террейну, і для партів. За замовчуванням кожен матеріал коштує 1. Більше число змушує NPC обходити цей матеріал, якщо гак не гірший, а math.huge робить його непрохідним. Скрипт погоні задає Water = 20.
Ділянки, які треба обходити: PathfindingModifier
- Накрийте ділянку партом з увімкненим Anchored і вимкненим CanCollide.
- Вставте в цей парт PathfindingModifier і задайте його
LabelрівнимDangerZone. - Це все. Скрипт погоні вже дає
DangerZoneвартістьmath.huge, тому NPC обходить цю ділянку. Увімкніть Pathfinding modifiers у Visualization Options, щоб побачити мітку на навігаційній сітці.
Модифікатор з увімкненим PassThrough робить протилежне: маршрут іде крізь тверду перешкоду, наприклад зачинені двері, ніби її немає. NPC однаково не може пройти крізь двері, але йде до них, ніби почув гравця з іншого боку.
Власні переходи: PathfindingLink
PathfindingLink з'єднує дві точки, між якими NPC зазвичай не може пройти, наприклад береги річки, яку він перетинає на човні. Поставте Attachment на кожному кінці, задайте в посилання Attachment0 і Attachment1, дайте йому Label, наприклад UseBoat, і додайте UseBoat у Costs з вартістю, нижчою, ніж у Water. Тоді в шляху з'явиться вейпоінт з цією міткою: перевіряйте waypoint.Label у walkToNextWaypoint і запускайте свою дію, наприклад садіть NPC у човен, замість MoveTo. Посилання працюють в обидва боки, якщо не вимкнути IsBidirectional.
Поширені помилки та рішення
Спочатку перевірте вікно Output. Воно відкривається з меню Window або на вкладці Script. Скрипти на цій сторінці виводять попередження, коли запит шляху не вдався або риг не може рухатися.
NPC узагалі не рухається
Якщо в Output написано, що NPC не може рухатися (cannot move), частину рига заанкерено: зніміть Anchored з HumanoidRootPart та інших партів. Якщо ні, перевірте, що код у Script, а не в LocalScript, що він лежить усередині моделі у Workspace і що Humanoid не помер.
Output пише "Infinite yield possible" на WaitForChild
Скрипт чекає об'єкт, якого немає: Humanoid чи HumanoidRootPart з іншою назвою або відсутній парт Goal для скрипта з кроку 2. Перейменуйте об'єкт або рядок у скрипті. Гайд з помилок скриптів пояснює це попередження.
Шлях не будується, або NPC ігнорує гравця, до якого міг би дійти
Path.Status після ComputeAsync дорівнює NoPath, коли початок чи кінець усередині твердого парта, коли єдиний маршрут потребує стрибка, а AgentCanJump дорівнює false, або коли AgentHeight чи AgentRadius завеликий для щілини на шляху. У документації Roblox є й жорсткі обмеження: не більше 3,000 стадів по прямій від початку до кінця і бюджет пошуку в 20,000 вузлів, якого величезним відкритим світам чи лабіринтам може не вистачити. Увімкніть Navigation mesh, щоб перевірити маршрут.
NPC ковзає і не рухає ногами
Це проблема анімації, а не pathfinding. Персонажі гравців отримують скрипт Animate автоматично, а NPC потрібен власний скрипт, щоб програвати анімації ходьби. У кожному NPC з NPC kit від Roblox є Script з назвою Animate, який можна розібрати. Як завантажити і програти анімацію на NPC із серверного Script, дивіться в розділі анімація на NPC.
NPC застрягає на кутах або стрибає, але не перестрибує перешкоду
Збільште AgentRadius, щоб маршрути трималися далі від стін, особливо для широких NPC. Якщо він стрибає, але ніяк не перебирається, перешкода вища, ніж Humanoid може стрибнути: збільште JumpHeight або JumpPower у Humanoid або змініть рівень.
Шкода дотиком спрацьовує надто часто або ніколи
Надто часто: немає кулдауну, або він зберігається для кожного парта, а не для кожного гравця. Ніколи: STOP_DISTANCE більше за 0, тому NPC зазвичай зупиняється раніше, ніж когось торкнеться, або в гравця ще діє силове поле після спавну.
Зберіть це з RoCode
Якщо вам простіше описати NPC, ніж збирати його вручну, RoCode може написати ці скрипти у відкритому у вас плейсі. Це незалежний ШІ-агент для Roblox Studio: ви пишете у вебчаті, а його плагін для Studio створює і редагує скрипти у вашому Explorer.
Зроби так, щоб модель Chaser у Workspace переслідувала найближчого гравця в межах 80 стадів через pathfinding, ішла додому, коли поруч нікого немає, і завдавала 10 шкоди дотиком з кулдауном 1 секунда.
- Може спочатку переглянути модель через Get Properties і прочитати ключові значення, наприклад Anchored на її партах і WalkSpeed у Humanoid. Наберіть / у чаті, щоб прикріпити точний шлях до моделі
- Пише скрипти погоні й шкоди всередині моделі через Create Script і може зняти Anchored через Set Property, якщо це потрібно ригу
- Перевіряє компіляцію обох скриптів через Check Script просто в Studio. Це ловить помилки компіляції і такі речі, як wait() замість task.wait(), але не логічні баги на кшталт маршруту, який ніколи не доходить до гравця
- Надсилає зміни пачками, і кожна пачка це точка скасування в історії Studio
З плагіном 3.9 або новішим RoCode може запустити короткий плейтест і прочитати помилки, а з плагіном 3.9.11 або новішим може керувати тестовим персонажем, щоб перевірити, що гра працює, але під час гри він не робить скриншотів, тому натисніть Play і подивіться на NPC самі. Якщо він поводиться не так, розкажіть RoCode, що ви побачили: Check Output може прочитати рядки Server і Client з вашого останнього плейтесту. NPC це одна система з багатьох; дивіться, як зібрати цілу гру Roblox з ШІ: спочатку ігрове ядро, потім раунди. Як RoCode підключається до Studio.
Поширені запитання
Де запускати pathfinding NPC: на сервері чи на клієнті?
На сервері, у Script. Власний приклад pathfinding від Roblox працює в LocalScript, але там рухається персонаж самого гравця. NPC спільний для всіх, і шкоду, яку він завдає, має вирішувати сервер. Дивіться Script, LocalScript і ModuleScript.
Скільки NPC з погонею витримає один сервер?
У документації Roblox немає точного числа; це залежить від карти й від того, як часто рахуються шляхи. Найдорожчий розрахунок шляху, тому скрипт погоні обмежує його двома разами на секунду на NPC і пропускає, коли гравця видно. Для великої кількості NPC рекомендації Roblox про те, де зберігати скрипти, радять позначати їх тегами й обробляти через CollectionService з одного ModuleScript, а не класти скрипт у кожну модель.
Як зробити, щоб NPC респавнився після смерті?
Зберігайте копію NPC у ServerStorage, а респавн робіть зі скрипта в ServerScriptService, бо скрипт усередині NPC знищується разом із ним. Коли спрацьовує подія Died у Humanoid, зачекайте кілька секунд, знищіть стару модель і покладіть 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, 8-секундний тайм-аут MoveToFinished, ChangeState і TakeDamage
- Roblox Creator Docs: Network ownership (англійською). автоматичне володіння, SetNetworkOwner і режим Network owners
- Roblox Creator Docs: RaycastParams (англійською). ExcludeInstances і RespectCanCollide
- Roblox Creator Docs: NPC kit (англійською). приклади NPC з власними скриптами Animate
Як перевірявся код: кожен скрипт на цій сторінці проходить сувору перевірку типів Luau з визначеннями Roblox API (luau-lsp, 20 листопада 2026 р.). Перевірка типів ловить помилки в назвах API та неправильні типи, але не помилки ігрової логіки, тому протестуйте все в Studio перед публікацією.