Poradnik · Systemy gry

Pathfinding NPC w Roblox Studio: jak sprawić, żeby NPC chodził za graczem

Żeby NPC omijał ściany i docierał do najbliższego gracza, potrzebne są trzy rzeczy: rig, który może się ruszać, trasa od PathfindingService i pętla, która idzie trasą i nie kłóci się z silnikiem fizyki. W tym poradniku budujemy wszystkie trzy i na końcu dostajemy jeden skrypt serwerowy, który wystarczy włożyć do riga NPC.

Zaktualizowano 20 listopada 202614 min czytaniaAutor:

W skrócie

Włóż Script do modelu NPC. Utwórz ścieżkę przez PathfindingService:CreatePath(), policz ją przez path:ComputeAsync(start, goal) wewnątrz pcall, a potem przechodź waypointy po jednym przez Humanoid:MoveTo(), czekając na MoveToFinished przed następnym. Żeby NPC gonił gracza, wybieraj najbliższą postać i przeliczaj ścieżkę, gdy przesunęła się o kilka studów, a nie co klatkę.

  • Potrzebne są Humanoid i niezakotwiczony HumanoidRootPart. Wywołaj SetNetworkOwner(nil) na root part, żeby symulował go serwer: to zwykła poprawka dla NPC, który szarpie przy graczach.
  • Skacz, gdy Action waypointu to Jump, i licz nową ścieżkę, gdy Path.Blocked odpala się dla waypointu przed NPC.
  • Gdy gracza widać bezpośrednio, pomiń pathfinding i rób MoveTo prosto do niego. Zatrzymuj się kilka studów wcześniej albo podchodź na styk, jeśli NPC zadaje obrażenia dotykiem.
Na tej stronie
  1. Jak działa pathfinding
  2. 1. Ustawienie NPC
  3. 2. Idziemy do punktu
  4. 3. Skrypt pościgu
  5. Jak działa pościg
  6. Usuwamy szarpanie
  7. 4. Obrażenia dotykiem
  8. Modyfikatory i linki
  9. Common errors
  10. With RoCode
  11. Najczęstsze pytania
  12. Źródła i dalsza lektura

Jak działa pathfinding NPC

IlustracjaChaser znajduje drogę wokół ściany, wskakuje na półkę i zatrzymuje się 4 study od ciebie.

Roblox buduje siatkę nawigacyjną (navigation mesh) z powierzchni, po których może chodzić postać. PathfindingService szuka po tej siatce trasy między dwoma punktami i zwraca ją jako listę waypointów: każdy ma pozycję i akcję, na przykład chód albo skok. Potem Humanoid NPC idzie od jednego waypointu do następnego. Pathfinding tylko planuje trasę: poruszać się po niej musi twój skrypt.

API, których używa ten poradnik
APICo robi
PathfindingService:CreatePath()Tworzy obiekt Path, którego można używać wiele razy, pod rozmiar twojego NPC przez parametry agenta.
Path:ComputeAsync(start, finish)Liczy trasę. Oddaje wykonanie (yield) i może się wywalić, więc wywołuj go w pcall i sprawdzaj Path.Status.
Path:GetWaypoints()Zwraca trasę jako tablicę wartości PathWaypoint, każda ma Position, Action i Label.
Path.BlockedOdpala się z indeksem waypointu, gdy coś zablokuje policzoną trasę.
Humanoid:MoveTo(position)Prowadzi NPC do punktu.
Humanoid.MoveToFinishedOdpala się z true, gdy NPC podejdzie do punktu na około stud, albo z false, jeśli nie doszedł w 8 sekund.

Uruchamiaj to wszystko w serwerowym Script: serwer widzi całą mapę nawet ze streamingiem, wszyscy gracze widzą tego samego NPC, a obrażenia są rozstrzygane tam, gdzie klient nie może ich podrobić. Script, LocalScript i ModuleScript wyjaśnia ten podział.

Krok 1: NPC, który może się ruszać

Ścieżką może chodzić dowolny model, jeśli ma trzy rzeczy z tabeli poniżej. Rigom z Toolboxa albo starych gier czasem czegoś brakuje, a zwykle wygląda to tak: NPC stoi w miejscu i nie ma błędu.

Czego potrzebuje model NPC
WymaganieDlaczego to ważne
Humanoid o nazwie HumanoidMoveTo, WalkSpeed i skoki należą do Humanoid.
HumanoidRootPartPart, którym steruje Humanoid. Ścieżki zaczynają się od jego pozycji.
Nic nie jest zakotwiczoneZakotwiczony part nie może się ruszać, tak samo jak party z nim połączone. Zakotwiczonymi partami zawsze zarządza serwer, więc poprawki szarpania, o której niżej, nie da się do nich zastosować.
  1. Otwórz kartę Avatar albo Home i kliknij Character, żeby otworzyć Rig Generator. Wybierz R15, potem Block Avatar. W Workspace pojawi się rig. Rigi R6 działają z tymi samymi skryptami.
  2. Zmień nazwę riga na Chaser i postaw go w otwartym miejscu.
  3. Zaznacz jego HumanoidRootPart i sprawdź, czy Anchored w oknie Properties jest wyłączone. To samo zrób dla każdego innego zakotwiczonego partu w modelu. Żeby szybko je znaleźć, włącz Anchored parts w widżecie Visualization Options w prawym górnym rogu widoku 3D.
Explorer: model NPC na końcu tego poradnika
Workspace
  Chaser Model
    Humanoid Humanoid
    HumanoidRootPart Part
    Head, UpperTorso, LowerTorso ... (części ciała)
    ChaseAI Script new
    TouchDamage Script new

Żeby NPC jeszcze rozmawiał, poradnik o dialogach z NPC dodaje podpowiedź Talk z opcjami odpowiedzi i wyjaśnia, co się zmienia, gdy NPC chodzi. Żeby pokazać bossa kamerą, zanim zacznie pościg, zobacz poradnik o cutscenkach.

Krok 2: wysyłamy NPC do punktu

Zacznij od najmniejszego działającego skryptu: dojść do nieruchomego partu. Pokazuje każdy etap pathfindingu bez logiki pościgu.

  1. Wstaw Part do Workspace, nazwij go Goal, włącz Anchored, wyłącz CanCollide i postaw go na podłodze tak, żeby NPC musiał obejść ścianę.
  2. W Explorerze najedź kursorem na Chaser, kliknij przycisk + i wstaw Script. Nazwij go WalkToGoal i wklej kod poniżej.
  3. Kliknij Play. NPC obchodzi ścianę i idzie do partu Goal.
Script w modelu Chaser o nazwie 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

-- Fizyką NPC musi zarządzać serwer, inaczej ChangeState (skok) ze Script nie zadziała
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 oddaje wykonanie i może rzucić błąd, dlatego jest w 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 -- pierwszy waypoint to miejsce, gdzie NPC już stoi
		end
		humanoid:MoveTo(waypoint.Position)
		if waypoint.Action == Enum.PathWaypointAction.Jump then
			humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
		end
		-- Czekamy, aż NPC dojdzie do tego waypointu, i dopiero potem idziemy do następnego
		local reached = humanoid.MoveToFinished:Wait()
		if not reached then
			warn(`{npc.Name} got stuck on the way to the goal`)
			break
		end
	end
end

Part Goal ma wyłączone CanCollide, bo ścieżka nie może kończyć się wewnątrz twardego partu: Status ścieżki byłby NoPath.

Tabela, którą dostaje CreatePath, opisuje NPC (Roblox nazywa go agentem), żeby trasa omijała szczeliny, przez które się nie przeciśnie. Skrypt wyżej ustawia pierwsze trzy klucze na wartości domyślne, żeby było widać, gdzie je zmieniać.

Parametry agenta dla CreatePath
KluczDomyślnieCo ustawia
AgentRadius2Promień NPC w studach. Zwiększ go dla szerokich NPC, żeby ścieżki trzymały się z dala od ścian.
AgentHeight5Wysokość NPC. Miejsca niższe niż to, na przykład pod schodami, liczą się jako zablokowane.
AgentCanJumptruePozwala na trasy, które wymagają skoku. Takie waypointy mają Action równe Jump.
AgentCanClimbfalsePozwala wspinać się po TrussPart. Takie waypointy mają etykietę Climb.
WaypointSpacing4Odległość w studach między pośrednimi waypointami. math.huge je usuwa.
CostsbrakJak drogie jest przechodzenie przez materiały i oznaczone obszary. Zobacz modyfikatory i linki.

W pętli ważne są dwa szczegóły. Pierwszy waypoint to pozycja samego NPC, więc pętla go pomija. A po każdym MoveTo idzie MoveToFinished:Wait(): nowe MoveTo zastępuje poprzedni cel, więc pętla bez czekania wysyła NPC prosto do ostatniego waypointu, w tę samą ścianę, którą powinien obejść.

Przy skokach Action waypointu to Jump i skrypt wywołuje ChangeState(Enum.HumanoidStateType.Jumping). W dokumentacji Roblox o Humanoid napisano, że serwerowy skrypt może zmieniać stan tylko wtedy, gdy serwer zarządza fizyką postaci. To jeden z powodów, dla których skrypt najpierw ustawia właściciela.

Na stronie Roblox o pathfindingu własna postać gracza porusza się przez Humanoid:Move() ze sprawdzaniem dotarcia co klatkę i to nazwano najlepszym sposobem prowadzenia Humanoid po ścieżce. MoveTo z MoveToFinished jest krótsze i czytelniejsze dla serwerowego NPC, więc poradnik go używa; jeśli później będziesz potrzebować dokładniejszej kontroli, przeanalizuj oficjalny skrypt.

Krok 3: pełny skrypt pościgu

To skrypt, którego szuka większość. NPC goni najbliższego gracza w promieniu 80 studów, omija ściany, skacze tam, gdzie wymaga tego trasa, znajduje nową trasę, gdy coś ją zablokuje, i wraca do domu, gdy w pobliżu nikogo nie ma.

  1. Usuń WalkToGoal z Chaser, jeśli go dodałeś.
  2. Najedź kursorem na Chaser, kliknij +, wstaw Script o nazwie ChaseAI i wklej kod poniżej.
  3. Kliknij Play, wejdź za ścianę, potem uciekaj poza zasięg. NPC obchodzi ścianę za tobą, a potem wraca tam, skąd zaczął.
Script w modelu Chaser o nazwie 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

-- Ustawienia (odległości w studach, czas w sekundach)
local DETECTION_RANGE = 80 -- graczy dalej niż to NPC nie zauważa
local STOP_DISTANCE = 4 -- zatrzymać się w takiej odległości od celu (0 = iść na styk, dla obrażeń dotykiem)
local DIRECT_CHASE_RANGE = 30 -- bliżej niż to pomijamy pathfinding, jeśli po drodze nic nie ma
local REPATH_DISTANCE = 4 -- o ile musi przesunąć się cel, żeby ścieżka się przeliczyła
local MIN_REPATH_INTERVAL = 0.5 -- nigdy nie liczyć ścieżek częściej niż to
local WAYPOINT_TIMEOUT = 2 -- porzucić ścieżkę, jeśli jeden waypoint trwa dłużej niż to
local CHASE_SPEED = 14 -- gracz domyślnie chodzi z prędkością 16, więc może uciec temu NPC
local HOME_RADIUS = 4 -- tak blisko domu to już dom
local RAY_HEIGHTS = { 0, -2 } -- promienie bezpośredniej widoczności na wysokości pasa i przy kolanach

local HOME = rootPart.Position -- dokąd NPC wraca, gdy w promieniu nikogo nie ma

humanoid.WalkSpeed = CHASE_SPEED

-- Niech NPC symuluje serwer. Inaczej Roblox może oddać jego fizykę urządzeniu
-- pobliskiego gracza i NPC szarpie, gdy zmienia się właściciel.
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, -- iść przez wodę tylko po to, żeby nie robić dużego objazdu
		DangerZone = math.huge, -- nigdy nie wchodzić w obszary z etykietą DangerZone
	},
})

-- Ścieżka, którą NPC idzie w tej chwili
local waypoints: { PathWaypoint } = {}
local nextIndex = 0
local pathGoal: Vector3? = nil
local pathBlocked = false
local lastComputeTime = -math.huge

-- Blocked może odpalić się dla waypointu, który NPC już minął. Ważna jest tylko przeszkoda z przodu.
path.Blocked:Connect(function(blockedIndex: number)
	if blockedIndex >= nextIndex then
		pathBlocked = true
	end
end)

local rayParams = RaycastParams.new()
rayParams.RespectCanCollide = true -- party, z którymi nic się nie zderza, nie zasłaniają widoku

local function clearPath()
	waypoints = {}
	nextIndex = 0
	pathGoal = nil
end

local function stopMoving()
	clearPath()
	humanoid:MoveTo(rootPart.Position)
end

-- HumanoidRootPart najbliższego żywego gracza w zasięgu DETECTION_RANGE albo 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, gdy cel jest mniej więcej na tym samym poziomie i między nimi nie ma nic twardego.
-- Czysty promień nie dowodzi, że po ziemi da się przejść, więc to tylko na małym dystansie.
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)
	-- Resetujemy po obliczeniu, żeby Blocked ze starej trasy nie oznaczył nowej
	pathBlocked = false
	if ok and path.Status == Enum.PathStatus.Success then
		waypoints = path:GetWaypoints()
		nextIndex = 2 -- waypoint 1 to miejsce, gdzie stoi NPC
		pathGoal = goal
	else
		if not ok then
			warn(`{npc.Name}: path request failed: {err}`)
		end
		clearPath() -- na razie nie ma trasy; główna pętla zaraz spróbuje znowu
	end
end

local function needsNewPath(goal: Vector3): boolean
	if os.clock() - lastComputeTime < MIN_REPATH_INTERVAL then
		return false -- dopiero co policzone: idziemy bieżącą ścieżką
	end
	local currentGoal = pathGoal
	if currentGoal == nil or pathBlocked or nextIndex > #waypoints then
		return true
	end
	return (goal - currentGoal).Magnitude > REPATH_DISTANCE
end

-- Czeka na MoveToFinished, ale odpuszcza po timeout sekundach zamiast wbudowanych 8,
-- żeby utknięty NPC szybko dostał nową ścieżkę
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() -- utknął albo zepchnięto go z kursu: liczymy nową ścieżkę
	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() -- wystarczająco blisko: stoimy przy celu
			task.wait(0.2)
			continue
		end
		if distance <= DIRECT_CHASE_RANGE and canSeeDirectly(targetRoot) then
			clearPath()
			-- Jeśli przekażesz też part, NPC idzie za nim, dopóki ten się porusza
			humanoid:MoveTo(targetRoot.Position, targetRoot)
			task.wait(0.15)
			continue
		end
		goal = targetRoot.Position
	else
		if (HOME - rootPart.Position).Magnitude <= HOME_RADIUS then
			stopMoving() -- w pobliżu nikogo, a NPC jest już w domu
			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) -- na razie nie ma działającej ścieżki, na przykład cel jest nieosiągalny
	end
end

Wszystkie ustawienia są na górze. Dla kilku NPC zduplikuj Chaser: każda kopia uruchamia własny ChaseAI i pamięta własny dom. Stare skrypty filtrują promienie przez FilterDescendantsInstances; dokumentacja Roblox teraz zaleca do nowej pracy ExcludeInstances i ten skrypt używa właśnie jego.

Jak działa skrypt pościgu

Każde przejście głównej pętli podejmuje jedną decyzję i robi jedną małą rzecz: stoi, robi krok prosto do gracza albo idzie do następnego waypointu. Nic nie jest decydowane na dłużej niż jeden waypoint, więc NPC cały czas reaguje.

Szukanie najbliższego gracza

findNearestTarget przegląda Players:GetPlayers(), pomija wszystkich bez postaci, żywego Humanoid albo HumanoidRootPart (graczy, którzy się respawnują albo wychodzą) i zwraca najbliższy root part w zasięgu DETECTION_RANGE. Szukanie odbywa się przy każdym przejściu, więc NPC sam przełącza się na bliższego gracza, a gracz, który wyszedł, po prostu przestaje być znajdowany: nie ma stanu na gracza, który trzeba czyścić.

Przeliczanie ścieżki, gdy gracz się rusza, ale nie co klatkę

Liczenie ścieżki oddaje wykonanie i zużywa czas serwera. needsNewPath prosi o nową ścieżkę tylko wtedy, gdy ścieżki nie ma, stara się skończyła albo jest zablokowana, albo gracz oddalił się o więcej niż REPATH_DISTANCE studów od końca bieżącej ścieżki, i nigdy wcześniej niż MIN_REPATH_INTERVAL sekund po poprzedniej. Gdy ścieżka się liczy, NPC dalej idzie do bieżącego waypointu, a nową ścieżkę przechodzi od waypointu 2, więc NPC nie zawraca do miejsca, gdzie ścieżka się zaczęła.

Zablokowane ścieżki

Drzwi się zamykają, party spadają. Path.Blocked odpala się z indeksem zablokowanego waypointu, który może być za NPC, więc skrypt reaguje tylko przy blockedIndex >= nextIndex: ustawia flagę, a pętla liczy nową trasę. Waypoint, do którego NPC idzie dłużej niż WAYPOINT_TIMEOUT sekund, bo go popchnięto albo o coś zahaczył, też uruchamia nową trasę.

Prosto do widocznego gracza

Pathfinding nie jest potrzebny, gdy gracz jest na widoku na otwartej przestrzeni. W zasięgu DIRECT_CHASE_RANGE funkcja canSeeDirectly puszcza w gracza dwa promienie, na wysokości pasa i przy kolanach, żeby zauważyć niskie ściany, i ignoruje obie postacie. Jeśli żaden promień w nic nie trafił, a gracz jest mniej więcej na tym samym poziomie, NPC wywołuje MoveTo(targetRoot.Position, targetRoot). Drugi argument sprawia, że cel porusza się razem z graczem, a powtarzanie wywołania co 0.15 sekundy cały czas resetuje 8-sekundowy limit czasu.

Czysty promień dowodzi, że po drodze nie ma nic twardego, ale nie tego, że jest tam podłoga. Jeśli na mapie między NPC a graczami są przepaście albo urwiska, zmniejsz DIRECT_CHASE_RANGE albo ustaw 0, żeby zawsze używać pathfindingu.

Zatrzymanie w odpowiedniej odległości

Gdy gracz jest bliżej niż STOP_DISTANCE, NPC wywołuje MoveTo na własną pozycję, co go zatrzymuje. 4 study pasują do NPC, który ma stać obok gracza; dla peta albo towarzysza, który trzyma dystans, ustaw 6 albo 8. Dla wroga, który bije dotykiem, ustaw 0, żeby podchodził na styk, jak w kroku 4.

Dlaczego NPC szarpie i jak to naprawić

Jeśli NPC szarpie, zamiera na każdym waypoincie albo cofa się, zwykle przyczyną jest jeden z punktów poniżej. Skrypt pościgu już uwzględnia każdy z nich; tabela przyda się do naprawy skryptu, który napisałeś sam.

Szarpanie przy pathfindingu: przyczyny i poprawki
Co widziszPrzyczynaPoprawka
Płynnie, gdy jest sam, i skokami, gdy obok jest graczNetwork ownership. Roblox oddaje fizykę niezakotwiczonych partów urządzeniu pobliskiego gracza, więc NPC może być symulowany na urządzeniu tego gracza, gdy polecenia wydaje serwer, a każde przekazanie może wyglądać jak szarpnięcie.Raz wywołaj SetNetworkOwner(nil) na HumanoidRootPart z serwera. Działa to na wszystkie party z nim połączone.
Idzie prosto do ostatniego waypointu i w ścianyMoveTo jest wywoływane dla każdego waypointu w pętli bez czekania. Każde wywołanie zastępuje poprzedni cel.Czekaj na MoveToFinished przed przejściem do następnego waypointu.
Na chwilę zatrzymuje się na każdym waypoincie albo ścina rogiStały task.wait() między waypointami zamiast czekania na dotarcie. Za długo i NPC stoi; za krótko i przeskakuje do przodu.Czekaj na MoveToFinished z limitem czasu.
Szarpie albo cofa się kilka razy na sekundęNowa ścieżka co klatkę. Każda zaczyna się od pozycji samego NPC, więc droga do waypointu 1 obraca go do tyłu.Przeliczaj ścieżkę tylko wtedy, gdy cel przesunął się o kilka studów, nie częściej niż dwa razy na sekundę, i zaczynaj od waypointu 2.
Zamiera na kilka sekund, potem idzie dalejMoveToFinished:Wait() na nieosiągalnym waypoincie czeka 8-sekundowy limit czasu.Używaj własnego, krótszego limitu czasu i licz nową ścieżkę, gdy minął.

Żeby zobaczyć, kto zarządza NPC, otwórz Visualization Options w trakcie playtestu i włącz Network owners. Party symulowane przez twojego klienta dostają zieloną obwódkę; party serwera albo innego klienta mają obwódkę białą albo szarą.

Krok 4: obrażenia dla graczy przy dotyku (opcjonalnie)

Dla wroga dodaj do NPC drugi skrypt, który zadaje graczom obrażenia przy dotyku. Działa na serwerze, więc klient gracza nie może zmienić obrażeń ani obejść cooldownu.

  1. W ChaseAI ustaw STOP_DISTANCE na 0, żeby NPC podchodził do graczy na styk, zamiast zatrzymywać się obok.
  2. Wstaw do Chaser Script o nazwie TouchDamage i wklej kod poniżej.
Script w modelu Chaser o nazwie 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 -- pokonany NPC nie zadaje obrażeń
	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 odpala się wiele razy na sekundę, gdy party się przecinają
	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 uwzględnia pola siłowe, więc gracze są bezpieczni, dopóki działa pole siłowe po spawnie. Żeby ignorować pola siłowe, zmniejszaj Humanoid.Health bezpośrednio.

Cooldown jest trzymany osobno dla każdego gracza. Touched odpala się wiele razy na sekundę, gdy party ocierają się o siebie, i bez cooldownu jedno dotknięcie mogłoby w mgnieniu oka wyzerować zdrowie gracza. Wpis jest usuwany, gdy jego gracz wychodzi, więc tabela nie rośnie przez cały czas życia serwera.

Żeby gracze mogli się bronić, daj im miecz albo broń na raycaście. Obie zadają obrażenia na serwerze wszystkiemu, co ma Humanoid, więc trafią też w Chaser.

Modyfikatory i linki pathfindingu

Domyślnie ścieżka to najkrótsza trasa, na której w miarę możliwości nie ma skoków. Można to zmienić na trzy sposoby. Koszty i modyfikatory działają ze skryptem pościgu bez zmian, bo już przekazuje on tabelę Costs do CreatePath; linki wymagają kilku własnych linii.

Koszt materiałów

Kluczami w Costs mogą być nazwy materiałów, na przykład Water, Mud albo CrackedLava, zarówno dla terenu, jak i dla partów. Domyślnie każdy materiał kosztuje 1. Większa liczba sprawia, że NPC omija ten materiał, jeśli objazd nie jest gorszy, a math.huge czyni go nieprzechodnim. Skrypt pościgu ustawia Water = 20.

Obszary do omijania: PathfindingModifier

  1. Przykryj obszar partem z włączonym Anchored i wyłączonym CanCollide.
  2. Wstaw do tego partu PathfindingModifier i ustaw jego Label na DangerZone.
  3. To wszystko. Skrypt pościgu już daje DangerZone koszt math.huge, więc NPC omija ten obszar. Włącz Pathfinding modifiers w Visualization Options, żeby zobaczyć etykietę na siatce nawigacyjnej.

Modyfikator z włączonym PassThrough robi odwrotnie: trasa idzie przez twardą przeszkodę, na przykład zamknięte drzwi, jakby jej nie było. NPC i tak nie przejdzie przez drzwi, ale idzie do nich, jakby usłyszał gracza po drugiej stronie.

PathfindingLink łączy dwa punkty, między którymi NPC zwykle nie może przejść, na przykład brzegi rzeki, którą przepływa łodzią. Postaw Attachment na każdym końcu, ustaw w linku Attachment0 i Attachment1, daj mu Label, na przykład UseBoat, i dodaj UseBoat do Costs z kosztem niższym niż Water. Wtedy w ścieżce pojawi się waypoint z tą etykietą: sprawdzaj waypoint.Label w walkToNextWaypoint i uruchamiaj własną akcję, na przykład sadzaj NPC do łodzi, zamiast MoveTo. Linki działają w obie strony, jeśli nie wyłączysz IsBidirectional.

Częste błędy i rozwiązania

Najpierw sprawdź okno Output. Otwiera się z menu Window albo na karcie Script. Skrypty na tej stronie wypisują ostrzeżenie, gdy żądanie ścieżki się nie udało albo rig nie może się ruszać.

NPC w ogóle się nie rusza

Jeśli w Output jest napisane, że NPC nie może się ruszać (cannot move), część riga jest zakotwiczona: zdejmij Anchored z HumanoidRootPart i pozostałych partów. Jeśli nie, sprawdź, czy kod jest w Script, a nie w LocalScript, czy leży w modelu w Workspace i czy Humanoid nie zginął.

Output pisze "Infinite yield possible" przy WaitForChild

Skrypt czeka na obiekt, którego nie ma: Humanoid albo HumanoidRootPart o innej nazwie albo brakujący part Goal dla skryptu z kroku 2. Zmień nazwę obiektu albo linię w skrypcie. Poradnik o błędach skryptów wyjaśnia to ostrzeżenie.

Ścieżka się nie buduje albo NPC ignoruje gracza, do którego mógłby dojść

Path.Status po ComputeAsync to NoPath, gdy początek albo koniec jest wewnątrz twardego partu, gdy jedyna trasa wymaga skoku, a AgentCanJump jest false, albo gdy AgentHeight lub AgentRadius jest za duże dla szczeliny na drodze. Dokumentacja Roblox podaje też twarde ograniczenia: nie więcej niż 3,000 studów w linii prostej od początku do końca i budżet wyszukiwania 20,000 węzłów, którego może nie wystarczyć ogromnym otwartym światom albo labiryntom. Włącz Navigation mesh, żeby sprawdzić trasę.

NPC się ślizga i nie rusza nogami

To problem animacji, a nie pathfindingu. Postacie graczy dostają skrypt Animate automatycznie, a NPC potrzebuje własnego skryptu, żeby odtwarzać animacje chodu. W każdym NPC z NPC kit od Roblox jest Script o nazwie Animate, który można przeanalizować. Jak wczytać i odtworzyć animację na NPC z serwerowego Script, zobacz w sekcji animacja na NPC.

NPC utyka na rogach albo skacze, ale nie przeskakuje przeszkody

Zwiększ AgentRadius, żeby trasy trzymały się dalej od ścian, zwłaszcza dla szerokich NPC. Jeśli skacze, ale nie może się przedostać, przeszkoda jest wyższa, niż Humanoid potrafi skoczyć: zwiększ JumpHeight albo JumpPower w Humanoid albo zmień poziom.

Obrażenia dotykiem odpalają się za często albo nigdy

Za często: nie ma cooldownu albo jest trzymany dla każdego partu, a nie dla każdego gracza. Nigdy: STOP_DISTANCE jest większe niż 0, więc NPC zwykle zatrzymuje się, zanim kogoś dotknie, albo gracz ma jeszcze pole siłowe po spawnie.

Zbuduj to z RoCode

Jeśli łatwiej ci opisać NPC, niż budować go ręcznie, RoCode może napisać te skrypty w grze, którą masz otwartą. To niezależny agent AI do Roblox Studio: piszesz na czacie w przeglądarce, a jego plugin do Studio tworzy i edytuje skrypty w twoim Explorerze.

Ty piszesz

Spraw, żeby model Chaser w Workspace gonił najbliższego gracza w promieniu 80 studów przez pathfinding, wracał do domu, gdy w pobliżu nikogo nie ma, i zadawał 10 obrażeń dotykiem z cooldownem 1 sekundy.

RoCode robi
  • Może najpierw obejrzeć model przez Get Properties i przeczytać kluczowe wartości, na przykład Anchored na jego partach i WalkSpeed w Humanoid. Wpisz / na czacie, żeby dołączyć dokładną ścieżkę do modelu
  • Pisze skrypty pościgu i obrażeń w modelu przez Create Script i może zdjąć Anchored przez Set Property, jeśli rig tego wymaga
  • Sprawdza kompilację obu skryptów przez Check Script prosto w Studio. To wyłapuje błędy kompilacji i rzeczy takie jak wait() zamiast task.wait(), ale nie błędy logiki w rodzaju trasy, która nigdy nie dochodzi do gracza
  • Wysyła zmiany paczkami, a każda paczka to punkt cofania w historii Studio

Z pluginem 3.9 lub nowszym RoCode może uruchomić krótki playtest i przeczytać błędy, a z pluginem 3.9.11 lub nowszym może sterować testową postacią, żeby sprawdzić, czy gra działa, ale w trakcie gry nie robi zrzutów ekranu, więc kliknij Play i popatrz na NPC sam. Jeśli zachowuje się nie tak, powiedz RoCode, co zobaczyłeś: Check Output może przeczytać linie Server i Client z twojego ostatniego playtestu. NPC to jeden system z wielu; zobacz, jak zbudować całą grę Roblox z AI: najpierw grywalny rdzeń, potem rundy. Jak RoCode łączy się ze Studio.

Najczęstsze pytania

Gdzie uruchamiać pathfinding NPC: na serwerze czy na kliencie?

Na serwerze, w Script. Własny przykład pathfindingu od Roblox działa w LocalScript, ale tam porusza się postać samego gracza. NPC jest wspólny dla wszystkich, a obrażenia, które zadaje, musi rozstrzygać serwer. Zobacz Script, LocalScript i ModuleScript.

Ilu NPC z pościgiem wytrzyma jeden serwer?

W dokumentacji Roblox nie ma dokładnej liczby; zależy to od mapy i od tego, jak często liczone są ścieżki. Najdroższe jest liczenie ścieżki, więc skrypt pościgu ogranicza je do dwóch razy na sekundę na NPC i pomija je, gdy gracza widać. Przy dużej liczbie NPC zalecenia Roblox o tym, gdzie trzymać skrypty, radzą oznaczać je tagami i obsługiwać przez CollectionService z jednego ModuleScript, a nie wkładać skrypt do każdego modelu.

Jak sprawić, żeby NPC odradzał się po śmierci?

Trzymaj kopię NPC w ServerStorage, a odradzanie rób ze skryptu w ServerScriptService, bo skrypt w NPC jest niszczony razem z nim. Gdy odpali się event Died w Humanoid, poczekaj kilka sekund, zniszcz stary model i włóż Clone() kopii do Workspace. Skrypt ChaseAI w klonie uruchomi się sam, bo skrypty serwerowe działają, gdy tylko trafią do Workspace.

Czy można sprawić, żeby NPC goniły graczy tylko w trakcie rundy?

Tak. Niech twój skrypt rund klonuje NPC do Workspace, gdy runda się zaczyna, i niszczy je, gdy się kończy. Poradnik o systemie rund buduje pętlę przerwy i rundy, do której to się podłącza.

Źródła i dalsza lektura

Jak sprawdziliśmy kod: każdy skrypt na tej stronie przechodzi ścisłe sprawdzanie typów Luau z definicjami API Robloxa (luau-lsp, 20 listopada 2026). Sprawdzanie typów wyłapuje źle wpisane API i błędne typy, ale nie logikę gry, więc przetestuj go w Studio przed publikacją.

Wypróbuj RoCode we własnej grze.

Darmowe kredyty codziennie, bez karty. Zainstaluj plugin, opisz funkcję i sprawdź, co pojawi się w Studio.