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
Actionwaypointu toJump, i licz nową ścieżkę, gdyPath.Blockedodpala się dla waypointu przed NPC. - Gdy gracza widać bezpośrednio, pomiń pathfinding i rób
MoveToprosto do niego. Zatrzymuj się kilka studów wcześniej albo podchodź na styk, jeśli NPC zadaje obrażenia dotykiem.
Na tej stronie
Jak działa pathfinding NPC
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 | Co 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.Blocked | Odpala się z indeksem waypointu, gdy coś zablokuje policzoną trasę. |
Humanoid:MoveTo(position) | Prowadzi NPC do punktu. |
Humanoid.MoveToFinished | Odpala 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.
| Wymaganie | Dlaczego to ważne |
|---|---|
Humanoid o nazwie Humanoid | MoveTo, WalkSpeed i skoki należą do Humanoid. |
HumanoidRootPart | Part, którym steruje Humanoid. Ścieżki zaczynają się od jego pozycji. |
| Nic nie jest zakotwiczone | Zakotwiczony 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ć. |
- 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.
- Zmień nazwę riga na
Chaseri postaw go w otwartym miejscu. - 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.
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.
- 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ę. - W Explorerze najedź kursorem na Chaser, kliknij przycisk + i wstaw Script. Nazwij go
WalkToGoali wklej kod poniżej. - Kliknij Play. NPC obchodzi ścianę i idzie do partu Goal.
local PathfindingService = game:GetService("PathfindingService")
local npc = script.Parent :: Model
local humanoid = npc:WaitForChild("Humanoid") :: Humanoid
local rootPart = npc:WaitForChild("HumanoidRootPart") :: BasePart
local goalPart = workspace:WaitForChild("Goal") :: BasePart
-- 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ć.
| Klucz | Domyślnie | Co ustawia |
|---|---|---|
AgentRadius | 2 | Promień NPC w studach. Zwiększ go dla szerokich NPC, żeby ścieżki trzymały się z dala od ścian. |
AgentHeight | 5 | Wysokość NPC. Miejsca niższe niż to, na przykład pod schodami, liczą się jako zablokowane. |
AgentCanJump | true | Pozwala na trasy, które wymagają skoku. Takie waypointy mają Action równe Jump. |
AgentCanClimb | false | Pozwala wspinać się po TrussPart. Takie waypointy mają etykietę Climb. |
WaypointSpacing | 4 | Odległość w studach między pośrednimi waypointami. math.huge je usuwa. |
Costs | brak | Jak 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.
- Usuń
WalkToGoalz Chaser, jeśli go dodałeś. - Najedź kursorem na Chaser, kliknij +, wstaw Script o nazwie
ChaseAIi wklej kod poniżej. - Kliknij Play, wejdź za ścianę, potem uciekaj poza zasięg. NPC obchodzi ścianę za tobą, a potem wraca tam, skąd zaczął.
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.
| Co widzisz | Przyczyna | Poprawka |
|---|---|---|
| Płynnie, gdy jest sam, i skokami, gdy obok jest gracz | Network 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 ściany | MoveTo 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 rogi | Stał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 dalej | MoveToFinished: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.
- W ChaseAI ustaw
STOP_DISTANCEna0, żeby NPC podchodził do graczy na styk, zamiast zatrzymywać się obok. - Wstaw do Chaser Script o nazwie
TouchDamagei wklej kod poniżej.
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
- Przykryj obszar partem z włączonym Anchored i wyłączonym CanCollide.
- Wstaw do tego partu PathfindingModifier i ustaw jego
LabelnaDangerZone. - To wszystko. Skrypt pościgu już daje
DangerZonekosztmath.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.
Własne przejścia: PathfindingLink
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.
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.
- 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
- Roblox Creator Docs: Pathfinding (po angielsku). parametry agenta, waypointy, zablokowane ścieżki, modyfikatory, linki i ograniczenia
- Roblox Creator Docs: PathfindingService (po angielsku). CreatePath i wartości domyślne
- Roblox Creator Docs: Path (po angielsku). ComputeAsync, GetWaypoints, Status i event Blocked
- Roblox Creator Docs: Humanoid (po angielsku). MoveTo, 8-sekundowy limit czasu MoveToFinished, ChangeState i TakeDamage
- Roblox Creator Docs: Network ownership (po angielsku). automatyczna własność, SetNetworkOwner i tryb Network owners
- Roblox Creator Docs: RaycastParams (po angielsku). ExcludeInstances i RespectCanCollide
- Roblox Creator Docs: NPC kit (po angielsku). przykłady NPC z własnymi skryptami Animate
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ą.