Туториал · Игровые системы

Pathfinding NPC в Roblox Studio: как сделать, чтобы NPC ходил за игроком

Чтобы NPC обходил стены и добирался до ближайшего игрока, нужны три вещи: риг, который может двигаться, маршрут от PathfindingService и цикл, который идёт по маршруту и не спорит с физическим движком. В этом гайде мы собираем все три и в конце получаем один серверный скрипт, который можно просто положить в риг NPC.

Обновлено 14 ноября 2026 г.13 мин чтенияАвтор:

Коротко

Положите 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 наносит урон касанием.
На этой странице
  1. Как работает pathfinding
  2. 1. Настройка NPC
  3. 2. Идём к точке
  4. 3. Скрипт погони
  5. Как работает погоня
  6. Убираем дёрганье
  7. 4. Урон касанием
  8. Модификаторы и ссылки
  9. Common errors
  10. With RoCode
  11. Частые вопросы
  12. Источники и что почитать

Как работает pathfinding NPC

ИллюстрацияChaser находит путь вокруг стены, запрыгивает на уступ и останавливается в 4 стадах от вас.

Roblox строит навигационную сетку (navigation mesh) из поверхностей, по которым может ходить персонаж. PathfindingService ищет по этой сетке маршрут между двумя точками и возвращает его как список вейпоинтов: у каждого есть позиция и действие, например ходьба или прыжок. Затем Humanoid NPC идёт от одного вейпоинта к следующему. Pathfinding только планирует маршрут: двигаться по нему должен ваш скрипт.

API, которые использует этот гайд
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 стоит на месте, а ошибки нет.

Что нужно модели NPC
ТребованиеПочему это важно
Humanoid с именем HumanoidMoveTo, WalkSpeed и прыжки принадлежат Humanoid.
HumanoidRootPartПарт, которым управляет Humanoid. Пути начинаются от его позиции.
Ничего не заанкереноАнкерный парт не может двигаться, как и парты, соединённые с ним. Анкерными партами всегда владеет сервер, поэтому исправление дёрганья, о котором ниже, к ним не применить.
  1. Откройте вкладку Avatar или Home и нажмите Character, чтобы открыть Rig Generator. Выберите R15, затем Block Avatar. В Workspace появится риг. Риги R6 работают с теми же скриптами.
  2. Переименуйте риг в Chaser и поставьте его на открытое место.
  3. Выделите его HumanoidRootPart и проверьте, что Anchored в окне Properties выключен. То же самое сделайте для любого другого анкерного парта в модели. Чтобы быстро их найти, включите Anchored parts в виджете Visualization Options в правом верхнем углу 3D-вьюпорта.
Explorer: модель NPC в конце этого гайда
Workspace
  Chaser Model
    Humanoid Humanoid
    HumanoidRootPart Part
    Head, UpperTorso, LowerTorso ... (части тела)
    ChaseAI Script new
    TouchDamage Script new

Чтобы NPC ещё и разговаривал, гайд по диалогу с NPC добавляет подсказку Talk с вариантами ответа и объясняет, что меняется, когда NPC ходит. Чтобы показать босса камерой до того, как он начнёт погоню, смотрите гайд по катсценам.

Шаг 2: Отправляем NPC к точке

Начните с самого маленького рабочего скрипта: дойти до неподвижного парта. Он показывает каждый этап pathfinding без логики погони.

  1. Вставьте Part в Workspace, назовите его 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 должен владеть сервер, иначе 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 называет его агентом), чтобы маршрут обходил щели, в которые он не пролезет. Скрипт выше задаёт первые три ключа равными значениям по умолчанию, чтобы было видно, где их менять.

Параметры агента для CreatePath
КлючПо умолчаниюЧто задаёт
AgentRadius2Радиус NPC в стадах. Увеличьте его для широких NPC, чтобы пути держались подальше от стен.
AgentHeight5Высота NPC. Места ниже этого, например под лестницей, считаются перекрытыми.
AgentCanJumptrueРазрешает маршруты, где нужен прыжок. У таких вейпоинтов Action равен Jump.
AgentCanClimbfalseРазрешает лазать по TrussPart. У таких вейпоинтов метка Climb.
WaypointSpacing4Расстояние в стадах между промежуточными вейпоинтами. 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 стадов, обходит стены, прыгает там, где это нужно маршруту, находит новый маршрут, когда что-то его перекрывает, и уходит домой, когда рядом никого нет.

  1. Удалите WalkToGoal из Chaser, если добавляли его.
  2. Наведите курсор на Chaser, нажмите +, вставьте Script с именем ChaseAI и вставьте код ниже.
  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

-- Настройки (расстояния в стадах, время в секундах)
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 дёргается, замирает на каждом вейпоинте или шагает назад, обычно причина в одном из пунктов ниже. Скрипт погони уже учитывает каждый из них; таблица нужна, чтобы починить скрипт, который вы написали сами.

Дёрганье при pathfinding: причины и исправления
Что вы видитеПричинаИсправление
Плавно, пока один, и рывками, когда рядом игрок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 второй скрипт, который наносит урон игрокам при касании. Он работает на сервере, поэтому клиент игрока не может изменить урон или обойти кулдаун.

  1. В ChaseAI поставьте STOP_DISTANCE равным 0, чтобы NPC шёл в игроков вплотную, а не останавливался рядом.
  2. Вставьте в Chaser Script с именем TouchDamage и вставьте код ниже.
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

По умолчанию путь это кратчайший маршрут, где по возможности нет прыжков. Изменить это можно тремя способами. Стоимости и модификаторы работают со скриптом погони как есть, потому что он уже передаёт таблицу Costs в CreatePath; для ссылок нужно несколько своих строк.

Стоимость материалов

Ключами в Costs могут быть названия материалов, например Water, Mud или CrackedLava, и для террейна, и для партов. По умолчанию каждый материал стоит 1. Большее число заставляет NPC обходить этот материал, если крюк не хуже, а math.huge делает его непроходимым. Скрипт погони задаёт Water = 20.

Области, которые нужно обходить: PathfindingModifier

  1. Накройте область партом с включённым Anchored и выключенным CanCollide.
  2. Вставьте в этот парт PathfindingModifier и задайте его Label равным DangerZone.
  3. Это всё. Скрипт погони уже даёт DangerZone стоимость math.huge, поэтому NPC обходит эту область. Включите Pathfinding modifiers в Visualization Options, чтобы увидеть метку на навигационной сетке.

Модификатор с включённым PassThrough делает обратное: маршрут идёт сквозь твёрдое препятствие, например закрытую дверь, как будто его нет. NPC всё равно не может пройти сквозь дверь, но идёт к ней, будто услышал игрока с другой стороны.

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 секунда.

RoCode делает
  • Может сначала просмотреть модель через 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, когда раунд начинается, и уничтожает их, когда он заканчивается. Гайд по системе раундов собирает цикл перерыва и раунда, к которому это подключается.

Источники и что почитать

Как проверялся код: каждый скрипт на этой странице проходит строгую проверку типов Luau с определениями Roblox API (luau-lsp, 14 ноября 2026 г.). Проверка типов ловит опечатки в API и неверные типы, но не ошибки игровой логики, поэтому протестируйте всё в Studio перед публикацией.

Попробуйте RoCode в своей игре.

Бесплатные кредиты каждый день, без карты. Установите плагин, опишите функцию и проверьте, что появилось в Studio.