Коротко
Положите 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, 14 ноября 2026 г.). Проверка типов ловит опечатки в API и неверные типы, но не ошибки игровой логики, поэтому протестируйте всё в Studio перед публикацией.