V skratke
Vložte Script dovnútra modelu NPC. Vytvorte cestu cez PathfindingService:CreatePath(), vypočítajte ju cez path:ComputeAsync(start, goal) vnútri pcall a potom prechádzajte waypointy po jednom cez Humanoid:MoveTo(), pričom pred ďalším počkajte na MoveToFinished. Aby NPC prenasledovalo hráča, vyberajte najbližšiu postavu a cestu prepočítajte, keď sa posunula o niekoľko studov, nie každý snímok.
- Potrebujete Humanoid a neukotvený HumanoidRootPart. Zavolajte
SetNetworkOwner(nil)na root part, aby ho simuloval server: to je bežná oprava pre NPC, ktoré sa zadrháva pri hráčoch. - Skáčte, keď je
ActionwaypointuJump, a počítajte novú cestu, keď saPath.Blockedspustí pre waypoint pred NPC. - Keď je hráč priamo na dohľad, preskočte pathfinding a urobte
MoveTopriamo k nemu. Zastavte sa niekoľko studov od neho alebo choďte až k nemu, ak NPC spôsobuje poškodenie dotykom.
Na tejto stránke
Ako funguje pathfinding NPC
Roblox stavia navigačnú sieť (navigation mesh) z povrchov, po ktorých môže postava chodiť. PathfindingService hľadá v tejto sieti trasu medzi dvoma bodmi a vráti ju ako zoznam waypointov: každý má pozíciu a akciu, napríklad chôdzu alebo skok. Potom Humanoid NPC ide od jedného waypointu k ďalšiemu. Pathfinding trasu len plánuje: pohyb po nej musí zabezpečiť váš skript.
| API | Čo robí |
|---|---|
PathfindingService:CreatePath() | Vytvorí objekt Path, ktorý môžete použiť veľakrát, prispôsobený veľkosti vášho NPC cez parametre agenta. |
Path:ComputeAsync(start, finish) | Vypočíta trasu. Prepúšťa vykonávanie (yield) a môže zlyhať, preto ho volajte vnútri pcall a kontrolujte Path.Status. |
Path:GetWaypoints() | Vráti trasu ako pole hodnôt PathWaypoint, každá má Position, Action a Label. |
Path.Blocked | Spustí sa s indexom waypointu, keď niečo zablokuje vypočítanú trasu. |
Humanoid:MoveTo(position) | Vedie NPC k bodu. |
Humanoid.MoveToFinished | Spustí sa s true, keď NPC príde k bodu približne na stud, alebo s false, ak tam nedošlo do 8 sekúnd. |
Spúšťajte to všetko v serverovom Script: server vidí celú mapu aj so streamingom, všetci hráči vidia to isté NPC a o poškodení sa rozhoduje tam, kde ho klient nemôže sfalšovať. Script, LocalScript a ModuleScript vysvetľuje toto rozdelenie.
Krok 1: NPC, ktoré sa môže hýbať
Po ceste môže chodiť akýkoľvek model, ak má tri veci z tabuľky nižšie. Rigom z Toolboxu alebo zo starých placov občas niečo chýba a zvyčajne to vyzerá takto: NPC stojí na mieste a chyba nikde.
| Požiadavka | Prečo je to dôležité |
|---|---|
Humanoid s názvom Humanoid | MoveTo, WalkSpeed a skoky patria Humanoidu. |
HumanoidRootPart | Part, ktorý Humanoid ovláda. Cesty začínajú od jeho pozície. |
| Nič nie je ukotvené | Ukotvený part sa nemôže hýbať, rovnako ani party s ním spojené. Ukotvené party vždy vlastní server, preto sa na ne oprava zadrhávania, o ktorej je reč nižšie, nedá použiť. |
- Otvorte kartu Avatar alebo Home a kliknite na Character, čím otvoríte Rig Generator. Vyberte R15, potom Block Avatar. Vo Workspace sa objaví rig. Rigy R6 fungujú s tými istými skriptmi.
- Premenujte rig na
Chasera postavte ho na otvorené miesto. - Označte jeho HumanoidRootPart a skontrolujte, že Anchored v okne Properties je vypnuté. To isté urobte pre každý iný ukotvený part v modeli. Aby ste ich rýchlo našli, zapnite Anchored parts vo widgete Visualization Options v pravom hornom rohu 3D viewportu.
Workspace
Chaser Model
Humanoid Humanoid
HumanoidRootPart Part
Head, UpperTorso, LowerTorso ... (časti tela)
ChaseAI Script new
TouchDamage Script new
Ak chcete, aby NPC aj rozprávalo, návod na dialóg s NPC pridá výzvu Talk s možnosťami odpovede a vysvetlí, čo sa mení, keď NPC chodí. Ak chcete ukázať bossa kamerou predtým, ako začne naháňačku, pozrite si návod na cutscény.
Krok 2: Pošleme NPC k bodu
Začnite najmenším funkčným skriptom: dôjsť k nehybnému partu. Ukazuje každú fázu pathfindingu bez logiky naháňačky.
- Vložte Part do Workspace, pomenujte ho
Goal, zapnite Anchored, vypnite CanCollide a postavte ho na podlahu tak, aby NPC muselo obísť stenu. - V Exploreri prejdite kurzorom na Chaser, kliknite na tlačidlo + a vložte Script. Pomenujte ho
WalkToGoala vložte doň kód nižšie. - Stlačte Play. NPC obíde stenu a ide k 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
-- Fyziku NPC musí vlastniť server, inak ChangeState (skok) zo Script nezaberie
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 prepúšťa vykonávanie a môže vyhodiť chybu, preto je vnútri 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 -- prvý waypoint je miesto, kde NPC už stojí
end
humanoid:MoveTo(waypoint.Position)
if waypoint.Action == Enum.PathWaypointAction.Jump then
humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
end
-- Počkáme, kým NPC dôjde k tomuto waypointu, a až potom ideme k ďalšiemu
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 má vypnuté CanCollide, pretože cesta nemôže končiť vnútri pevného partu: Status cesty by bol NoPath.
Tabuľka, ktorú dostane CreatePath, opisuje NPC (Roblox ho volá agent), aby trasa obchádzala škáry, ktorými sa nepretlačí. Skript vyššie nastavuje prvé tri kľúče na predvolené hodnoty, aby bolo vidieť, kde ich meniť.
| Kľúč | Predvolené | Čo určuje |
|---|---|---|
AgentRadius | 2 | Polomer NPC v studoch. Zväčšite ho pre široké NPC, aby sa cesty držali ďalej od stien. |
AgentHeight | 5 | Výška NPC. Miesta nižšie, napríklad pod schodmi, sa považujú za zablokované. |
AgentCanJump | true | Povoľuje trasy, kde treba skok. Takéto waypointy majú Action rovné Jump. |
AgentCanClimb | false | Povoľuje lezenie po TrussPart. Takéto waypointy majú štítok Climb. |
WaypointSpacing | 4 | Vzdialenosť v studoch medzi priebežnými waypointmi. math.huge ich odstráni. |
Costs | žiadne | Ako drahé je prechádzať materiálmi a označenými oblasťami. Pozrite si modifikátory a odkazy. |
V cykle sú dôležité dva detaily. Prvý waypoint je pozícia samotného NPC, preto ho cyklus preskakuje. A po každom MoveTo nasleduje MoveToFinished:Wait(): nové MoveTo nahradí predchádzajúci cieľ, takže cyklus bez čakania pošle NPC rovno k poslednému waypointu, do tej istej steny, ktorú má obísť.
Pri skokoch je Action waypointu Jump a skript zavolá ChangeState(Enum.HumanoidStateType.Jumping). V referencii Robloxu k Humanoidu sa píše, že serverový skript môže meniť stav, len keď server vlastní fyziku postavy. To je jeden z dôvodov, prečo skript najprv nastaví vlastníka.
Na stránke Robloxu o pathfindingu sa vlastná postava hráča hýbe cez Humanoid:Move() s kontrolou príchodu každý snímok a označuje sa to ako najlepší spôsob, ako viesť Humanoid po ceste. MoveTo s MoveToFinished je kratšie a zrozumiteľnejšie pre serverové NPC, preto ho návod používa; ak budete neskôr potrebovať presnejšiu kontrolu, preštudujte si oficiálny skript.
Krok 3: Celý skript naháňačky
Toto je skript, ktorý hľadá väčšina ľudí. NPC prenasleduje najbližšieho hráča do 80 studov, obchádza steny, skáče tam, kde to trasa potrebuje, nájde novú trasu, keď ju niečo zablokuje, a odíde domov, keď nablízku nikto nie je.
- Vymažte
WalkToGoalz Chaser, ak ste ho pridali. - Prejdite kurzorom na Chaser, kliknite na +, vložte Script s názvom
ChaseAIa vložte doň kód nižšie. - Stlačte Play, zájdite za stenu a potom utečte mimo dosah. NPC obíde stenu za vami a potom sa vráti tam, kde začalo.
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
-- Nastavenia (vzdialenosti v studoch, čas v sekundách)
local DETECTION_RANGE = 80 -- hráčov ďalej než toto NPC nezbadá
local STOP_DISTANCE = 4 -- zastaviť v takejto vzdialenosti od cieľa (0 = ísť až k nemu, pre poškodenie dotykom)
local DIRECT_CHASE_RANGE = 30 -- bližšie než toto preskočíme pathfinding, ak v ceste nič nie je
local REPATH_DISTANCE = 4 -- o koľko sa musí cieľ posunúť, aby sa cesta prepočítala
local MIN_REPATH_INTERVAL = 0.5 -- nikdy nepočítať cesty častejšie než toto
local WAYPOINT_TIMEOUT = 2 -- zahodiť cestu, ak jeden waypoint trvá dlhšie než toto
local CHASE_SPEED = 14 -- predvolený hráč chodí rýchlosťou 16, takže tomuto NPC môže utiecť
local HOME_RADIUS = 4 -- takto blízko pri dome sa už počíta ako doma
local RAY_HEIGHTS = { 0, -2 } -- lúče priamej viditeľnosti vo výške pása a pri kolenách
local HOME = rootPart.Position -- kam sa NPC vráti, keď v dosahu nikto nie je
humanoid.WalkSpeed = CHASE_SPEED
-- Nech NPC simuluje server. Inak môže Roblox odovzdať jeho fyziku zariadeniu
-- hráča nablízku a NPC sa zadrháva, keď sa vlastník zmení.
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, -- ísť cez vodu, len aby sa nerobila veľká obchádzka
DangerZone = math.huge, -- nikdy nevstupovať do oblastí so štítkom DangerZone
},
})
-- Cesta, po ktorej NPC ide práve teraz
local waypoints: { PathWaypoint } = {}
local nextIndex = 0
local pathGoal: Vector3? = nil
local pathBlocked = false
local lastComputeTime = -math.huge
-- Blocked sa môže spustiť pre waypoint, ktorý NPC už prešlo. Dôležitá je len prekážka vpredu.
path.Blocked:Connect(function(blockedIndex: number)
if blockedIndex >= nextIndex then
pathBlocked = true
end
end)
local rayParams = RaycastParams.new()
rayParams.RespectCanCollide = true -- party, s ktorými nič nekoliduje, nezakrývajú výhľad
local function clearPath()
waypoints = {}
nextIndex = 0
pathGoal = nil
end
local function stopMoving()
clearPath()
humanoid:MoveTo(rootPart.Position)
end
-- HumanoidRootPart najbližšieho živého hráča v rámci DETECTION_RANGE alebo 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, keď je cieľ približne na tej istej úrovni a medzi nimi nie je nič pevné.
-- Čistý lúč nedokazuje, že sa po zemi dá prejsť, preto je to len na krátku vzdialenosť.
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)
-- Resetujeme po výpočte, aby Blocked zo starej trasy neoznačil novú
pathBlocked = false
if ok and path.Status == Enum.PathStatus.Success then
waypoints = path:GetWaypoints()
nextIndex = 2 -- waypoint 1 je miesto, kde NPC stojí
pathGoal = goal
else
if not ok then
warn(`{npc.Name}: path request failed: {err}`)
end
clearPath() -- trasa zatiaľ nie je; hlavný cyklus to čoskoro skúsi znova
end
end
local function needsNewPath(goal: Vector3): boolean
if os.clock() - lastComputeTime < MIN_REPATH_INTERVAL then
return false -- práve sme počítali: ideme po aktuálnej ceste
end
local currentGoal = pathGoal
if currentGoal == nil or pathBlocked or nextIndex > #waypoints then
return true
end
return (goal - currentGoal).Magnitude > REPATH_DISTANCE
end
-- Čaká na MoveToFinished, ale vzdá sa po timeout sekundách namiesto vstavaných 8,
-- aby zaseknuté NPC rýchlo dostalo novú cestu
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() -- zasekol sa alebo ho zrazili z kurzu: počítame novú cestu
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() -- dosť blízko: stojíme pri cieli
task.wait(0.2)
continue
end
if distance <= DIRECT_CHASE_RANGE and canSeeDirectly(targetRoot) then
clearPath()
-- Ak odovzdáme aj part, NPC ide za ním, kým sa hýbe
humanoid:MoveTo(targetRoot.Position, targetRoot)
task.wait(0.15)
continue
end
goal = targetRoot.Position
else
if (HOME - rootPart.Position).Magnitude <= HOME_RADIUS then
stopMoving() -- nablízku nikto a NPC je už doma
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) -- funkčná cesta zatiaľ nie je, napríklad cieľ je nedosiahnuteľný
end
end
Všetky nastavenia sú hore. Pre viac NPC duplikujte Chaser: každá kópia spúšťa svoj ChaseAI a pamätá si svoj domov. Staršie skripty filtrujú lúče cez FilterDescendantsInstances; referencia Robloxu teraz pre novú prácu odporúča ExcludeInstances a tento skript používa práve ten.
Ako funguje skript naháňačky
Každý prechod hlavného cyklu urobí jedno rozhodnutie a jednu malú akciu: stáť, vykročiť priamo k hráčovi alebo prejsť k ďalšiemu waypointu. Nič sa nerozhoduje dlhšie než na jeden waypoint, preto NPC stále reaguje.
Hľadanie najbližšieho hráča
findNearestTarget prechádza Players:GetPlayers(), preskočí každého bez postavy, živého Humanoidu alebo HumanoidRootPart (hráčov, ktorí sa respawnujú alebo odchádzajú) a vráti najbližší root part v rámci DETECTION_RANGE. Hľadá sa pri každom prechode, preto NPC samo prepne na bližšieho hráča a hráč, ktorý odišiel, sa jednoducho už nenájde: žiadny stav pre každého hráča, ktorý treba čistiť, neexistuje.
Prepočet cesty, kým sa hráč hýbe, ale nie každý snímok
Výpočet cesty prepúšťa vykonávanie a míňa čas servera. needsNewPath žiada novú cestu, len keď cesta nie je, stará skončila alebo je zablokovaná, alebo sa hráč vzdialil o viac než REPATH_DISTANCE studov od konca aktuálnej cesty, a nikdy skôr než MIN_REPATH_INTERVAL sekúnd po predchádzajúcej. Kým sa cesta počíta, NPC ďalej ide k aktuálnemu waypointu a nová cesta sa prechádza od waypointu 2, takže sa NPC neotočí k miestu, kde cesta začala.
Zablokované cesty
Dvere sa zatvárajú, party padajú. Path.Blocked sa spustí s indexom zablokovaného waypointu, ktorý môže byť za NPC, preto skript reaguje len pri blockedIndex >= nextIndex: nastaví príznak a cyklus vypočíta novú trasu. Waypoint, ku ktorému NPC ide dlhšie než WAYPOINT_TIMEOUT sekúnd, pretože ho strčili alebo sa zachytilo, tiež spustí novú trasu.
Priamo k viditeľnému hráčovi
Pathfinding netreba, keď je hráč na dohľad na otvorenom priestore. V rámci DIRECT_CHASE_RANGE funkcia canSeeDirectly vyšle na hráča dva lúče, vo výške pása a pri kolenách, aby zachytila nízke steny, a ignoruje obe postavy. Ak ani jeden lúč do ničoho nenarazí a hráč je približne na tej istej úrovni, NPC zavolá MoveTo(targetRoot.Position, targetRoot). Druhý argument spôsobí, že sa cieľ hýbe spolu s hráčom, a opakovanie volania každých 0.15 sekundy stále resetuje 8-sekundový časový limit.
Čistý lúč dokazuje, že v ceste nie je nič pevné, ale nie to, že je tam podlaha. Ak sú na mape medzi NPC a hráčmi priepasti alebo útesy, zmenšite DIRECT_CHASE_RANGE alebo nastavte 0, aby sa vždy použil pathfinding.
Zastavenie v správnej vzdialenosti
Keď je hráč bližšie než STOP_DISTANCE, NPC zavolá MoveTo na svoju vlastnú pozíciu, a to ho zastaví. 4 study sa hodia pre NPC, ktoré má stáť pri hráčovi; pre peta alebo sprievodcu, ktorý drží odstup, nastavte 6 alebo 8. Pre nepriateľa, ktorý útočí dotykom, nastavte 0, aby išiel až k hráčovi, ako v kroku 4.
Prečo sa NPC zadrháva a ako to opraviť
Ak sa NPC zadrháva, zamŕza na každom waypointe alebo cúva, príčinou je zvyčajne jeden z bodov nižšie. Skript naháňačky už počíta s každým z nich; tabuľka slúži na opravu skriptu, ktorý ste napísali sami.
| Čo vidíte | Príčina | Oprava |
|---|---|---|
| Plynulo, keď je samo, a trhane, keď je nablízku hráč | Network ownership. Roblox odovzdáva fyziku neukotvených partov zariadeniu hráča nablízku, takže NPC sa môže simulovať na zariadení tohto hráča, kým príkazy dáva server, a každé odovzdanie môže vyzerať ako trhnutie. | Raz zavolajte SetNetworkOwner(nil) na HumanoidRootPart zo servera. Platí to pre všetky party s ním spojené. |
| Ide rovno k poslednému waypointu a do stien | MoveTo sa volá pre každý waypoint v cykle bez čakania. Každé volanie nahradí predchádzajúci cieľ. | Pred prechodom k ďalšiemu waypointu počkajte na MoveToFinished. |
| Na chvíľu sa zastaví na každom waypointe alebo skracuje rohy | Pevné task.wait() medzi waypointmi namiesto čakania na príchod. Príliš dlho a NPC stojí; príliš krátko a preskočí dopredu. | Čakajte na MoveToFinished s časovým limitom. |
| Trhá sa alebo cúva niekoľkokrát za sekundu | Nová cesta každý snímok. Každá začína od pozície samotného NPC, takže cesta k waypointu 1 ho otočí späť. | Cestu prepočítajte, len keď sa cieľ posunul o niekoľko studov, nie častejšie než dvakrát za sekundu, a začínajte od waypointu 2. |
| Na niekoľko sekúnd zamrzne, potom ide ďalej | MoveToFinished:Wait() na nedosiahnuteľnom waypointe čaká 8-sekundový časový limit. | Použite vlastný, kratší časový limit a po jeho uplynutí vypočítajte novú cestu. |
Ak chcete vidieť, kto vlastní NPC, otvorte počas playtestu Visualization Options a zapnite Network owners. Party, ktoré simuluje váš klient, dostanú zelený obrys; party servera alebo iného klienta majú biely alebo sivý obrys.
Krok 4: Poškodenie hráčov dotykom (voliteľné)
Pre nepriateľa pridajte do NPC druhý skript, ktorý zraňuje hráčov pri dotyku. Beží na serveri, preto klient hráča nemôže zmeniť poškodenie ani obísť cooldown.
- V ChaseAI nastavte
STOP_DISTANCEna0, aby NPC išlo až do hráčov a nezastavovalo sa pri nich. - Vložte do Chaser Script s názvom
TouchDamagea vložte doň kód nižšie.
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 -- porazené NPC nespôsobuje poškodenie
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 sa spúšťa veľakrát za sekundu, kým sa party prekrývajú
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 berie do úvahy silové polia, takže hráči sú v bezpečí, kým platí silové pole po spawne. Ak chcete silové polia ignorovať, znižujte Humanoid.Health priamo.
Cooldown sa ukladá zvlášť pre každého hráča. Touched sa spúšťa veľakrát za sekundu, kým sa party o seba trú, a bez cooldownu by jeden dotyk mohol v okamihu vynulovať zdravie hráča. Záznam sa vymaže, keď jeho hráč odíde, takže tabuľka nerastie celý čas, čo server beží.
Aby sa hráči mohli brániť, dajte im meč alebo zbraň na raycaste. Obe spôsobujú poškodenie na serveri všetkému, čo má Humanoid, takže zasiahnu aj Chaser.
Modifikátory a odkazy pathfindingu
Predvolene je cesta najkratšia trasa, kde podľa možnosti nie sú skoky. Zmeniť to môžete tromi spôsobmi. Ceny a modifikátory fungujú so skriptom naháňačky tak, ako je, pretože už odovzdáva tabuľku Costs do CreatePath; pre odkazy treba niekoľko vlastných riadkov.
Cena materiálov
Kľúčmi v Costs môžu byť názvy materiálov, napríklad Water, Mud alebo CrackedLava, pre terén aj pre party. Predvolene stojí každý materiál 1. Väčšie číslo prinúti NPC obchádzať tento materiál, ak obchádzka nie je horšia, a math.huge ho urobí nepriechodným. Skript naháňačky nastavuje Water = 20.
Oblasti, ktorým sa treba vyhnúť: PathfindingModifier
- Prekryte oblasť partom so zapnutým Anchored a vypnutým CanCollide.
- Vložte do tohto partu PathfindingModifier a nastavte jeho
LabelnaDangerZone. - To je všetko. Skript naháňačky už dáva
DangerZonecenumath.huge, preto NPC túto oblasť obchádza. Zapnite Pathfinding modifiers vo Visualization Options, aby ste videli štítok na navigačnej sieti.
Modifikátor so zapnutým PassThrough robí opak: trasa ide cez pevnú prekážku, napríklad zatvorené dvere, akoby tam nebola. NPC cez dvere aj tak neprejde, ale ide k nim, akoby počulo hráča na druhej strane.
Vlastné prechody: PathfindingLink
PathfindingLink spája dva body, medzi ktorými NPC bežne nemôže prejsť, napríklad brehy rieky, ktorú prekoná loďou. Na každý koniec dajte Attachment, nastavte odkazu Attachment0 a Attachment1, dajte mu Label, napríklad UseBoat, a pridajte UseBoat do Costs s cenou nižšou ako Water. Potom sa v ceste objaví waypoint s týmto štítkom: kontrolujte waypoint.Label vo walkToNextWaypoint a spustite vlastnú akciu, napríklad posaďte NPC do lode, namiesto MoveTo. Odkazy fungujú oboma smermi, ak nevypnete IsBidirectional.
Časté chyby a riešenia
Najprv skontrolujte okno Output. Otvoríte ho z menu Window alebo na karte Script. Skripty na tejto stránke vypíšu varovanie, keď požiadavka na cestu zlyhala alebo sa rig nemôže hýbať.
NPC sa vôbec nehýbe
Ak Output píše, že NPC sa nemôže hýbať (cannot move), časť rigu je ukotvená: zrušte Anchored na HumanoidRootPart a ostatných partoch. Ak nie, skontrolujte, že kód je v Script, nie v LocalScript, že leží vnútri modelu vo Workspace a že Humanoid nie je mŕtvy.
Output píše "Infinite yield possible" pri WaitForChild
Skript čaká na objekt, ktorý neexistuje: Humanoid alebo HumanoidRootPart s iným názvom alebo chýbajúci part Goal pre skript z kroku 2. Premenujte objekt alebo reťazec v skripte. Návod na chyby v skriptoch vysvetľuje toto varovanie.
Cesta sa nevytvorí alebo NPC ignoruje hráča, ku ktorému by mohlo dôjsť
Path.Status po ComputeAsync je NoPath, keď je začiatok alebo koniec vnútri pevného partu, keď jediná trasa vyžaduje skok a AgentCanJump je false, alebo keď je AgentHeight či AgentRadius príliš veľký pre škáru na ceste. Dokumentácia Robloxu uvádza aj pevné obmedzenia: najviac 3,000 studov vzdušnou čiarou od začiatku po koniec a rozpočet hľadania 20,000 uzlov, ktorý obrovským otvoreným svetom alebo labyrintom nemusí stačiť. Zapnite Navigation mesh a skontrolujte trasu.
NPC kĺže a nehýbe nohami
To je problém animácie, nie pathfindingu. Postavy hráčov dostanú skript Animate automaticky, ale NPC potrebuje vlastný skript, aby prehrávalo animácie chôdze. Každé NPC z NPC kitu od Robloxu má Script s názvom Animate, ktorý si môžete preštudovať. Ako načítať a prehrať animáciu na NPC zo serverového Script, nájdete v časti animácia na NPC.
NPC sa zasekáva na rohoch alebo skáče, ale prekážku nepreskočí
Zväčšite AgentRadius, aby sa trasy držali ďalej od stien, najmä pri širokých NPC. Ak skáče, ale nikdy sa nedostane cez, prekážka je vyššia, než Humanoid dokáže vyskočiť: zvýšte JumpHeight alebo JumpPower na Humanoide alebo upravte level.
Poškodenie dotykom sa spúšťa príliš často alebo nikdy
Príliš často: chýba cooldown alebo sa ukladá pre každý part, nie pre každého hráča. Nikdy: STOP_DISTANCE je väčšie než 0, takže NPC sa zvyčajne zastaví skôr, než sa niekoho dotkne, alebo hráč má ešte silové pole po spawne.
Postavte to s RoCode
Ak je pre vás jednoduchšie NPC opísať, než ho skladať ručne, RoCode môže tieto skripty napísať vo vašom otvorenom place. Je to nezávislý AI agent pre Roblox Studio: píšete vo webovom chate a jeho plugin pre Studio vytvára a upravuje skripty vo vašom Exploreri.
Urob, aby model Chaser vo Workspace prenasledoval najbližšieho hráča do 80 studov cez pathfinding, odišiel domov, keď nablízku nikto nie je, a dával 10 poškodenia dotykom s cooldownom 1 sekunda.
- Môže si najprv prezrieť model cez Get Properties a prečítať kľúčové hodnoty, napríklad Anchored na jeho partoch a WalkSpeed na Humanoide. Napíšte / v chate, aby ste pripojili presnú cestu k modelu
- Píše skripty naháňačky a poškodenia vnútri modelu cez Create Script a môže zrušiť Anchored cez Set Property, ak to rig potrebuje
- Overí kompiláciu oboch skriptov cez Check Script priamo v Studiu. To zachytí chyby kompilácie a veci ako wait() namiesto task.wait(), ale nie logické chyby, napríklad trasu, ktorá nikdy nedôjde k hráčovi
- Posiela zmeny v dávkach a každá dávka je bod na vrátenie v histórii Studia
S pluginom 3.9 alebo novším môže RoCode spustiť krátky playtest a prečítať chyby a s pluginom 3.9.11 alebo novším môže ovládať testovaciu postavu, aby overil, že hra funguje, ale počas hry nerobí snímky obrazovky, preto stlačte Play a pozrite sa na NPC sami. Ak sa správa inak, povedzte RoCode, čo ste videli: Check Output dokáže prečítať riadky Server a Client z vášho posledného playtestu. NPC je jeden systém z mnohých; pozrite si, ako postaviť celú hru v Robloxe s AI: najprv hrateľné jadro, potom kolá. Ako sa RoCode pripája k Studiu.
Časté otázky
Kde spúšťať pathfinding NPC: na serveri alebo na klientovi?
Na serveri, v Script. Vlastný príklad pathfindingu od Robloxu beží v LocalScript, ale tam sa hýbe postava samotného hráča. NPC je spoločné pre všetkých a o poškodení, ktoré spôsobuje, musí rozhodovať server. Pozrite si Script, LocalScript a ModuleScript.
Koľko NPC s naháňačkou zvládne jeden server?
Dokumentácia Robloxu presné číslo neuvádza; závisí to od mapy a od toho, ako často sa cesty počítajú. Najdrahší je výpočet cesty, preto ho skript naháňačky obmedzuje na dvakrát za sekundu na NPC a preskakuje, keď je hráč na dohľad. Pri veľkom počte NPC odporúčania Robloxu o tom, kde mať skripty, radia označiť ich tagmi a spracovať cez CollectionService z jedného ModuleScript, namiesto vkladania skriptu do každého modelu.
Ako urobiť, aby sa NPC po smrti respawnulo?
Kópiu NPC majte v ServerStorage a respawn robte zo skriptu v ServerScriptService, pretože skript vnútri NPC sa zničí spolu s ním. Keď sa spustí udalosť Died na Humanoide, počkajte niekoľko sekúnd, zničte starý model a vložte Clone() kópie do Workspace. Skript ChaseAI vnútri klonu sa spustí sám, pretože serverové skripty bežia hneď, ako sa ocitnú vo Workspace.
Dá sa urobiť, aby NPC naháňali hráčov len počas kola?
Áno. Nech váš skript kôl klonuje NPC do Workspace, keď kolo začne, a zničí ich, keď skončí. Návod na systém kôl poskladá cyklus prestávky a kola, ku ktorému sa to pripojí.
Zdroje a ďalšie čítanie
- Roblox Creator Docs: Pathfinding (po anglicky). parametre agenta, waypointy, zablokované cesty, modifikátory, odkazy a obmedzenia
- Roblox Creator Docs: PathfindingService (po anglicky). CreatePath a predvolené hodnoty
- Roblox Creator Docs: Path (po anglicky). ComputeAsync, GetWaypoints, Status a udalosť Blocked
- Roblox Creator Docs: Humanoid (po anglicky). MoveTo, 8-sekundový časový limit MoveToFinished, ChangeState a TakeDamage
- Roblox Creator Docs: Network ownership (po anglicky). automatické vlastníctvo, SetNetworkOwner a režim Network owners
- Roblox Creator Docs: RaycastParams (po anglicky). ExcludeInstances a RespectCanCollide
- Roblox Creator Docs: NPC kit (po anglicky). príklady NPC s vlastnými skriptmi Animate
Ako bol kód overený: každý skript na tejto stránke prechádza prísnou kontrolou typov Luau s definíciami Roblox API (luau-lsp, 20. novembra 2026). Kontrola typov zachytí chyby v názvoch API a nesprávne typy, ale nie chyby v hernej logike, preto všetko pred publikovaním otestujte v Studiu.