Туторіал · Ігрові системи

Pathfinding NPC у Roblox Studio: як зробити, щоб NPC ходив за гравцем

Щоб NPC обходив стіни й діставався до найближчого гравця, потрібні три речі: риг, який може рухатися, маршрут від PathfindingService і цикл, який іде маршрутом і не сперечається з фізичним рушієм. У цьому гайді ми збираємо всі три й наприкінці отримуємо один серверний скрипт, який можна просто покласти в риг NPC.

Оновлено 20 листопада 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, 20 листопада 2026 р.). Перевірка типів ловить помилки в назвах API та неправильні типи, але не помилки ігрової логіки, тому протестуйте все в Studio перед публікацією.

Спробуйте RoCode у своїй грі.

Безкоштовні кредити щодня, без картки. Встановіть плагін, опишіть функцію та перевірте, що з'явилося в Studio.