Ve zkratce
Dejte Script dovnitř modelu NPC. Vytvořte cestu přes PathfindingService:CreatePath(), spočítejte ji přes path:ComputeAsync(start, goal) uvnitř pcall a pak procházejte waypointy po jednom přes Humanoid:MoveTo() a před dalším počkejte na MoveToFinished. Aby NPC pronásledovalo hráče, vybírejte nejbližší postavu a přepočítejte cestu, když se posunula o několik studů, ne každý snímek.
- Potřebujete Humanoid a neukotvený HumanoidRootPart. Zavolejte
SetNetworkOwner(nil)na root partu, aby ho simuloval server: to je běžná oprava NPC, které cuká u hráčů. - Skákejte, když je
ActionwaypointuJump, a počítejte novou cestu, když sePath.Blockedspustí pro waypoint před NPC. - Když je hráč přímo vidět, pathfinding vynechte a dejte
MoveTopřímo k němu. Zastavte se o několik studů dřív, nebo jděte až k němu, pokud NPC způsobuje poškození dotykem.
Na této stránce
Jak pathfinding NPC funguje
Roblox staví navigační síť (navigation mesh) z povrchů, po kterých může postava chodit. PathfindingService hledá v této síti trasu mezi dvěma body a vrací ji jako seznam waypointů: každý má pozici a akci, například chůzi nebo skok. Pak Humanoid NPC jde od jednoho waypointu k dalšímu. Pathfinding trasu jen plánuje: hýbat se po ní musí váš skript.
| API | Co dělá |
|---|---|
PathfindingService:CreatePath() | Vytvoří objekt Path, který lze použít mnohokrát, podle velikosti vašeho NPC přes parametry agenta. |
Path:ComputeAsync(start, finish) | Spočítá trasu. Pozastaví běh (yield) a může selhat, proto ho volejte uvnitř pcall a kontrolujte Path.Status. |
Path:GetWaypoints() | Vrátí trasu jako pole hodnot PathWaypoint, každá má Position, Action a Label. |
Path.Blocked | Spustí se s indexem waypointu, když něco zablokuje spočítanou trasu. |
Humanoid:MoveTo(position) | Vede NPC k bodu. |
Humanoid.MoveToFinished | Spustí se s true, když NPC dojde k bodu zhruba na stud, nebo s false, pokud nedošlo do 8 sekund. |
Všechno to spouštějte v serverovém Scriptu: server vidí celou mapu i se streamingem, všichni hráči vidí stejné NPC a poškození se rozhoduje tam, kde ho klient nemůže podvrhnout. Script, LocalScript a ModuleScript toto rozdělení vysvětluje.
Krok 1: NPC, které se může hýbat
Po cestě může chodit jakýkoli model, pokud má tři věci z tabulky níže. Rigům z Toolboxu nebo starých place někdy něco chybí a obvykle to vypadá tak, že NPC stojí na místě a chyba není.
| Požadavek | Proč na tom záleží |
|---|---|
Humanoid s názvem Humanoid | MoveTo, WalkSpeed a skoky patří Humanoidu. |
HumanoidRootPart | Part, který Humanoid řídí. Cesty začínají od jeho pozice. |
| Nic není ukotvené | Ukotvený part se nemůže hýbat, stejně jako party s ním spojené. Ukotvené party vždy vlastní server, takže oprava cukání popsaná níže na ně nejde použít. |
- Otevřete kartu Avatar nebo Home a klikněte na Character, otevře se Rig Generator. Vyberte R15, pak Block Avatar. Ve Workspace se objeví rig. Rigy R6 fungují se stejnými skripty.
- Přejmenujte rig na
Chasera postavte ho na otevřené místo. - Vyberte jeho HumanoidRootPart a ověřte, že je Anchored v okně Properties vypnuté. Stejně to udělejte u každého dalšího ukotveného partu v modelu. Chcete-li je rychle najít, zapněte Anchored parts ve widgetu Visualization Options vpravo nahoře ve 3D viewportu.
Workspace
Chaser Model
Humanoid Humanoid
HumanoidRootPart Part
Head, UpperTorso, LowerTorso ... (části těla)
ChaseAI Script new
TouchDamage Script new
Aby NPC také mluvilo, návod k dialogu s NPC přidá výzvu Talk s možnostmi odpovědi a vysvětlí, co se změní, když NPC chodí. Chcete-li bosse ukázat kamerou dřív, než začne pronásledovat, viz návod k cutscénám.
Krok 2: Pošleme NPC k bodu
Začněte nejmenším funkčním skriptem: dojít k nehybnému partu. Ukazuje každou fázi pathfindingu bez logiky pronásledování.
- Vložte Part do Workspace, pojmenujte ho
Goal, zapněte Anchored, vypněte CanCollide a postavte ho na podlahu tak, aby ho NPC muselo obejít kolem zdi. - V Exploreru najeďte myší na Chaser, klikněte na tlačítko + a vložte Script. Pojmenujte ho
WalkToGoala vložte kód níže. - Klikněte na Play. NPC obejde zeď a jde 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í vlastnit server, jinak ChangeState (skok) ze Scriptu nebude fungovat
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 pozastaví běh a může vyhodit chybu, proto je uvnitř 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 -- první waypoint je místo, 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, až NPC dojde k tomuto waypointu, a teprve pak jdeme k dalšímu
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, protože cesta nemůže končit uvnitř pevného partu: Status cesty by byl NoPath.
Tabulka, kterou dostane CreatePath, popisuje NPC (Roblox ho nazývá agent), aby trasa obcházela mezery, kterými neprojde. Skript výše nastavuje první tři klíče na výchozí hodnoty, aby bylo vidět, kde je měnit.
| Klíč | Výchozí | Co určuje |
|---|---|---|
AgentRadius | 2 | Poloměr NPC ve studech. U širokých NPC ho zvětšete, aby se cesty držely dál od zdí. |
AgentHeight | 5 | Výška NPC. Místa nižší než tato, například pod schody, se počítají jako zablokovaná. |
AgentCanJump | true | Povolí trasy, kde je potřeba skok. Takové waypointy mají Action rovnou Jump. |
AgentCanClimb | false | Povolí lezení po TrussPart. Takové waypointy mají štítek Climb. |
WaypointSpacing | 4 | Vzdálenost ve studech mezi mezilehlými waypointy. math.huge je odstraní. |
Costs | žádné | Jak drahé je procházet materiály a označené oblasti. Viz modifikátory a odkazy. |
Ve smyčce jsou důležité dva detaily. První waypoint je pozice samotného NPC, takže ho smyčka přeskočí. A po každém MoveTo následuje MoveToFinished:Wait(): nový MoveTo nahradí předchozí cíl, takže smyčka bez čekání pošle NPC rovnou k poslednímu waypointu, přímo do zdi, kterou má obejít.
U skoků je Action waypointu Jump a skript zavolá ChangeState(Enum.HumanoidStateType.Jumping). Referenční příručka Robloxu k Humanoidu uvádí, že serverový skript může měnit stav, jen když server vlastní fyziku postavy. To je jeden z důvodů, proč skript nejdřív nastavuje vlastníka.
Na stránce Robloxu o pathfindingu se vlastní postava hráče pohybuje přes Humanoid:Move() s kontrolou příchodu každý snímek a je to označeno jako nejlepší způsob, jak vést Humanoid po cestě. MoveTo s MoveToFinished je pro serverové NPC kratší a srozumitelnější, proto ho návod používá; pokud později budete potřebovat přesnější kontrolu, projděte si oficiální skript.
Krok 3: Celý skript pronásledování
Tohle je skript, který většina lidí hledá. NPC pronásleduje nejbližšího hráče do 80 studů, obchází zdi, skáče tam, kde to trasa potřebuje, najde novou trasu, když ji něco zablokuje, a jde domů, když nikdo není poblíž.
- Smažte
WalkToGoalz Chaser, pokud jste ho přidali. - Najeďte myší na Chaser, klikněte na +, vložte Script s názvem
ChaseAIa vložte kód níže. - Klikněte na Play, zajděte za zeď a pak utečte mimo dosah. NPC za vámi obejde zeď a pak se vrátí tam, odkud vyšlo.
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
-- Nastavení (vzdálenosti ve studech, čas v sekundách)
local DETECTION_RANGE = 80 -- hráče dál než toto NPC nezaznamená
local STOP_DISTANCE = 4 -- zastavit v takové vzdálenosti od cíle (0 = jít až k němu, kvůli poškození dotykem)
local DIRECT_CHASE_RANGE = 30 -- blíž než toto pathfinding vynecháme, pokud v cestě nic není
local REPATH_DISTANCE = 4 -- o kolik se musí cíl posunout, aby se cesta přepočítala
local MIN_REPATH_INTERVAL = 0.5 -- nikdy nepočítat cesty častěji než toto
local WAYPOINT_TIMEOUT = 2 -- zahodit cestu, pokud jeden waypoint trvá déle než toto
local CHASE_SPEED = 14 -- hráč ve výchozím stavu chodí rychlostí 16, takže tomuto NPC může utéct
local HOME_RADIUS = 4 -- takhle blízko domova už se počítá jako doma
local RAY_HEIGHTS = { 0, -2 } -- paprsky přímé viditelnosti ve výšce pasu a u kolen
local HOME = rootPart.Position -- kam se NPC vrací, když v dosahu nikdo není
humanoid.WalkSpeed = CHASE_SPEED
-- Ať NPC simuluje server. Jinak může Roblox dát jeho fyziku zařízení
-- hráče poblíž a NPC cuká, když se vlastník změní.
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, -- jít přes vodu, jen aby se neudělala velká zajížďka
DangerZone = math.huge, -- nikdy nevstupovat do oblastí se štítkem DangerZone
},
})
-- Cesta, po které NPC právě jde
local waypoints: { PathWaypoint } = {}
local nextIndex = 0
local pathGoal: Vector3? = nil
local pathBlocked = false
local lastComputeTime = -math.huge
-- Blocked se může spustit u waypointu, který už NPC prošlo. Důležitá je jen překážka vpředu.
path.Blocked:Connect(function(blockedIndex: number)
if blockedIndex >= nextIndex then
pathBlocked = true
end
end)
local rayParams = RaycastParams.new()
rayParams.RespectCanCollide = true -- party, se kterými nic nekoliduje, nezakrývají výhled
local function clearPath()
waypoints = {}
nextIndex = 0
pathGoal = nil
end
local function stopMoving()
clearPath()
humanoid:MoveTo(rootPart.Position)
end
-- HumanoidRootPart nejbližšího živého hráče v DETECTION_RANGE, nebo 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, když je cíl zhruba ve stejné výšce a mezi nimi není nic pevného.
-- Volný paprsek nedokazuje, že se po zemi dá projít, proto je to jen na krátkou vzdálenost.
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čtu, aby Blocked ze staré trasy neoznačil novou
pathBlocked = false
if ok and path.Status == Enum.PathStatus.Success then
waypoints = path:GetWaypoints()
nextIndex = 2 -- waypoint 1 je místo, kde NPC stojí
pathGoal = goal
else
if not ok then
warn(`{npc.Name}: path request failed: {err}`)
end
clearPath() -- trasa zatím není; hlavní smyčka to brzy zkusí znovu
end
end
local function needsNewPath(goal: Vector3): boolean
if os.clock() - lastComputeTime < MIN_REPATH_INTERVAL then
return false -- právě spočítáno: jdeme po současné cestě
end
local currentGoal = pathGoal
if currentGoal == nil or pathBlocked or nextIndex > #waypoints then
return true
end
return (goal - currentGoal).Magnitude > REPATH_DISTANCE
end
-- Čeká na MoveToFinished, ale vzdá to po timeout sekundách místo vestavěných 8,
-- aby zaseknuté NPC rychle dostalo novou 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() -- zaseklo se nebo ho někdo vystrčil z kurzu: počítáme novou 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() -- dost blízko: stojíme vedle cíle
task.wait(0.2)
continue
end
if distance <= DIRECT_CHASE_RANGE and canSeeDirectly(targetRoot) then
clearPath()
-- Pokud předáte i part, NPC ho následuje, dokud se pohybuje
humanoid:MoveTo(targetRoot.Position, targetRoot)
task.wait(0.15)
continue
end
goal = targetRoot.Position
else
if (HOME - rootPart.Position).Magnitude <= HOME_RADIUS then
stopMoving() -- nikdo poblíž a NPC už je 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 zatím není, například cíl je nedosažitelný
end
end
Všechna nastavení jsou nahoře. Pro víc NPC Chaser zduplikujte: každá kopie spustí vlastní ChaseAI a pamatuje si vlastní domov. Starší skripty filtrují paprsky přes FilterDescendantsInstances; referenční příručka Robloxu teď pro novou práci doporučuje ExcludeInstances a tento skript používá právě ten.
Jak skript pronásledování funguje
Každý průchod hlavní smyčkou udělá jedno rozhodnutí a jednu malou akci: stát, udělat krok přímo k hráči, nebo dojít k dalšímu waypointu. Nic se nerozhoduje na déle než jeden waypoint, takže NPC pořád reaguje.
Hledání nejbližšího hráče
findNearestTarget projde Players:GetPlayers(), přeskočí všechny bez postavy, živého Humanoidu nebo HumanoidRootPart (hráče, kteří se respawnují nebo odcházejí) a vrátí nejbližší root part v DETECTION_RANGE. Hledá se při každém průchodu, takže NPC samo přepne na bližšího hráče a hráč, který odešel, se prostě už nenajde: není žádný stav pro každého hráče, který by se musel uklízet.
Přepočet cesty, zatímco se hráč hýbe, ale ne každý snímek
Výpočet cesty pozastaví běh a stojí čas serveru. needsNewPath žádá o novou cestu, jen když cesta není, stará skončila nebo je zablokovaná, nebo když hráč odešel víc než REPATH_DISTANCE studů od konce současné cesty, a nikdy dřív než MIN_REPATH_INTERVAL sekund po minulé. Zatímco se cesta počítá, NPC dál jde k současnému waypointu a nová cesta se prochází od waypointu 2, takže se NPC neotočí k místu, kde cesta začala.
Zablokované cesty
Dveře se zavírají, party padají. Path.Blocked se spustí s indexem zablokovaného waypointu, který může být za NPC, proto skript reaguje jen při blockedIndex >= nextIndex: nastaví příznak a smyčka spočítá novou trasu. Waypoint, ke kterému NPC jde déle než WAYPOINT_TIMEOUT sekund, protože do něj někdo strčil nebo se zachytilo, také spustí novou trasu.
Přímo k viditelnému hráči
Pathfinding není potřeba, když je hráč vidět na otevřeném místě. V DIRECT_CHASE_RANGE funkce canSeeDirectly vystřelí na hráče dva paprsky, ve výšce pasu a u kolen, aby si všimla nízkých zdí, a obě postavy ignoruje. Pokud žádný paprsek nic netrefí a hráč je zhruba ve stejné výšce, NPC zavolá MoveTo(targetRoot.Position, targetRoot). Druhý argument nechá cíl pohybovat se s hráčem a opakování volání každých 0.15 sekundy pořád resetuje 8sekundový časový limit.
Volný paprsek dokazuje, že v cestě není nic pevného, ale ne to, že tam je podlaha. Pokud jsou na mapě mezi NPC a hráči propasti nebo útesy, zmenšete DIRECT_CHASE_RANGE, nebo nastavte 0 a vždy se použije pathfinding.
Zastavení ve správné vzdálenosti
Když je hráč blíž než STOP_DISTANCE, NPC zavolá MoveTo na svou vlastní pozici, a tím se zastaví. 4 study se hodí pro NPC, které má stát vedle hráče; pro mazlíčka nebo doprovod, který drží odstup, nastavte 6 nebo 8. Pro nepřítele, který útočí dotykem, nastavte 0, aby šel až k hráči, jako v kroku 4.
Proč NPC cuká a jak to opravit
Pokud NPC cuká, zamrzá na každém waypointu nebo couvá, je příčinou obvykle jeden z bodů níže. Skript pronásledování už s každým počítá; tabulka je tu na opravu skriptu, který jste napsali sami.
| Co vidíte | Příčina | Oprava |
|---|---|---|
| Plynule, dokud je samo, a trhaně, když je poblíž hráč | Network ownership. Roblox dá fyziku neukotvených partů zařízení hráče poblíž, takže NPC se může simulovat na zařízení tohoto hráče, zatímco příkazy dává server, a každé předání může vypadat jako trhnutí. | Jednou zavolejte SetNetworkOwner(nil) na HumanoidRootPart ze serveru. Platí to pro všechny party s ním spojené. |
| Jde rovnou k poslednímu waypointu a do zdí | MoveTo se volá pro každý waypoint ve smyčce bez čekání. Každé volání nahradí předchozí cíl. | Před přechodem k dalšímu waypointu počkejte na MoveToFinished. |
| Na každém waypointu se na chvíli zastaví nebo zkracuje rohy | Pevné task.wait() mezi waypointy místo čekání na příchod. Moc dlouho, a NPC stojí; moc krátce, a přeskočí dopředu. | Čekejte na MoveToFinished s časovým limitem. |
| Cuká nebo couvá několikrát za sekundu | Nová cesta každý snímek. Každá začíná od pozice samotného NPC, takže cesta k waypointu 1 ho otočí dozadu. | Cestu přepočítejte, jen když se cíl posunul o několik studů, nejvýš dvakrát za sekundu, a začínejte od waypointu 2. |
| Na několik sekund zamrzne a pak jde dál | MoveToFinished:Wait() na nedosažitelném waypointu čeká 8sekundový časový limit. | Použijte vlastní, kratší časový limit a po jeho vypršení spočítejte novou cestu. |
Chcete-li vidět, kdo NPC vlastní, otevřete během playtestu Visualization Options a zapněte Network owners. Party, které simuluje váš klient, dostanou zelený obrys; party serveru nebo jiného klienta mají obrys bílý nebo šedý.
Krok 4: Poškození hráčů dotykem (volitelné)
Pro nepřítele přidejte do NPC druhý skript, který hráče při dotyku zraní. Běží na serveru, takže klient hráče nemůže poškození změnit ani obejít cooldown.
- V ChaseAI nastavte
STOP_DISTANCEna0, aby NPC šlo až do hráčů, a nezastavovalo se vedle nich. - Vložte do Chaser Script s názvem
TouchDamagea vložte kód níže.
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 -- poražené NPC nezpůsobuje poškození
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 se spouští mnohokrát za sekundu, dokud se party překrý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 respektuje silová pole, takže hráči jsou v bezpečí, dokud platí silové pole po spawnu. Chcete-li silová pole ignorovat, snižujte přímo Humanoid.Health.
Cooldown se ukládá zvlášť pro každého hráče. Touched se spouští mnohokrát za sekundu, dokud se party o sebe třou, a bez cooldownu by jeden dotyk mohl hráči během okamžiku vynulovat zdraví. Záznam se smaže, když jeho hráč odejde, takže tabulka nenarůstá po celou dobu, co server běží.
Aby se hráči mohli bránit, dejte jim meč nebo zbraň na raycastu. Obojí způsobuje poškození na serveru všemu, co má Humanoid, takže zasáhnou i Chaser.
Modifikátory a odkazy pathfindingu
Ve výchozím stavu je cesta nejkratší trasa, kde se pokud možno neskáče. Změnit to můžete třemi způsoby. Ceny a modifikátory fungují se skriptem pronásledování tak, jak je, protože už předává tabulku Costs do CreatePath; odkazy potřebují pár vlastních řádků.
Cena materiálů
Klíči v Costs mohou být názvy materiálů, například Water, Mud nebo CrackedLava, pro terén i party. Ve výchozím stavu stojí každý materiál 1. Vyšší číslo přiměje NPC tento materiál obcházet, pokud zajížďka není horší, a math.huge ho udělá neprůchodným. Skript pronásledování nastavuje Water = 20.
Oblasti, které je třeba obcházet: PathfindingModifier
- Zakryjte oblast partem se zapnutým Anchored a vypnutým CanCollide.
- Vložte do tohoto partu PathfindingModifier a nastavte jeho
LabelnaDangerZone. - To je všechno. Skript pronásledování už dává
DangerZonecenumath.huge, takže NPC tuto oblast obchází. Zapněte Pathfinding modifiers ve Visualization Options a štítek uvidíte na navigační síti.
Modifikátor se zapnutým PassThrough dělá opak: trasa vede skrz pevnou překážku, například zavřené dveře, jako by tam nebyla. NPC dveřmi stejně neprojde, ale jde k nim, jako by slyšelo hráče na druhé straně.
Vlastní přechody: PathfindingLink
PathfindingLink spojí dva body, mezi kterými NPC normálně neprojde, například břehy řeky, kterou přeplouvá na lodi. Na každý konec dejte Attachment, nastavte u odkazu Attachment0 a Attachment1, dejte mu Label, například UseBoat, a přidejte UseBoat do Costs s cenou nižší než u Water. Pak se v cestě objeví waypoint s tímto štítkem: kontrolujte waypoint.Label ve walkToNextWaypoint a místo MoveTo spusťte vlastní akci, například posaďte NPC do lodi. Odkazy fungují oběma směry, pokud nevypnete IsBidirectional.
Časté chyby a řešení
Nejdřív zkontrolujte okno Output. Otevírá se z menu Window nebo na kartě Script. Skripty na této stránce vypíšou varování, když požadavek na cestu selhal nebo se rig nemůže hýbat.
NPC se vůbec nehýbe
Pokud Output píše, že se NPC nemůže hýbat (cannot move), je část rigu ukotvená: odškrtněte Anchored u HumanoidRootPart a ostatních partů. Pokud ne, ověřte, že kód je ve Scriptu, ne v LocalScriptu, že leží uvnitř modelu ve Workspace a že Humanoid není mrtvý.
Output píše "Infinite yield possible" u WaitForChild
Skript čeká na objekt, který neexistuje: Humanoid nebo HumanoidRootPart s jiným názvem, nebo chybějící part Goal pro skript z kroku 2. Přejmenujte objekt nebo řádek ve skriptu. Návod k chybám ve skriptech toto varování vysvětluje.
Cesta se nesestaví, nebo NPC ignoruje hráče, ke kterému by mohlo dojít
Path.Status po ComputeAsync je NoPath, když začátek nebo konec leží uvnitř pevného partu, když jediná trasa vyžaduje skok a AgentCanJump je false, nebo když je AgentHeight nebo AgentRadius moc velký pro mezeru na cestě. Dokumentace Robloxu uvádí i pevná omezení: nejvýš 3,000 studů vzdušnou čarou od začátku do konce a rozpočet hledání 20,000 uzlů, který obrovským otevřeným světům nebo bludištím nemusí stačit. Zapněte Navigation mesh a trasu zkontrolujte.
NPC klouže a nehýbe nohama
To je problém animace, ne pathfindingu. Postavy hráčů dostávají skript Animate automaticky, ale NPC potřebuje vlastní skript, aby přehrávalo animace chůze. Každé NPC z NPC kitu od Robloxu má Script s názvem Animate, který si můžete prostudovat. Jak načíst a přehrát animaci na NPC ze serverového Scriptu, najdete v části animace na NPC.
NPC se zasekává v rozích nebo skáče, ale překážku nepřeskočí
Zvětšete AgentRadius, aby se trasy držely dál od zdí, hlavně u širokých NPC. Pokud skáče, ale nikdy se nedostane přes, je překážka vyšší, než Humanoid umí skočit: zvyšte Humanoidu JumpHeight nebo JumpPower, nebo upravte level.
Poškození dotykem se spouští moc často, nebo nikdy
Moc často: chybí cooldown, nebo se ukládá pro každý part, ne pro každého hráče. Nikdy: STOP_DISTANCE je větší než 0, takže se NPC obvykle zastaví dřív, než se někoho dotkne, nebo má hráč ještě silové pole po spawnu.
Postavte to s RoCode
Pokud je pro vás jednodušší NPC popsat než ho stavět ručně, RoCode může tyto skripty napsat ve vašem otevřeném place. Je to nezávislý AI agent pro Roblox Studio: píšete ve webovém chatu a jeho plugin pro Studio vytváří a upravuje skripty ve vašem Exploreru.
Udělej, aby model Chaser ve Workspace pronásledoval nejbližšího hráče do 80 studů přes pathfinding, vracel se domů, když nikdo není poblíž, a dotykem způsoboval 10 poškození s cooldownem 1 sekunda.
- Může si nejdřív prohlédnout model přes Get Properties a přečíst klíčové hodnoty, například Anchored na jeho partech a WalkSpeed u Humanoidu. Napište v chatu / a připojíte přesnou cestu k modelu
- Napíše skripty pronásledování a poškození uvnitř modelu přes Create Script a může vypnout Anchored přes Set Property, pokud to rig potřebuje
- Ověří kompilaci obou skriptů přes Check Script přímo ve Studiu. To chytá chyby kompilace a věci jako wait() místo task.wait(), ale ne logické chyby jako trasu, která se k hráči nikdy nedostane
- Posílá změny po dávkách a každá dávka je bod pro vrácení v historii Studia
S pluginem 3.9 nebo novějším může RoCode spustit krátký playtest a přečíst chyby a s pluginem 3.9.11 nebo novějším ovládat testovací postavu, aby ověřil, že hra funguje, ale během hry nedělá snímky obrazovky, takže klikněte na Play a podívejte se na NPC sami. Pokud se chová jinak, řekněte RoCode, co jste viděli: Check Output umí přečíst řádky Server a Client z vašeho posledního playtestu. NPC je jeden systém z mnoha; podívejte se, jak postavit celou hru v Robloxu s AI: nejdřív hratelné jádro, pak kola. Jak se RoCode připojuje ke Studiu.
Časté otázky
Kde spouštět pathfinding NPC: na serveru, nebo na klientu?
Na serveru, ve Scriptu. Vlastní příklad pathfindingu od Robloxu běží v LocalScriptu, ale tam se hýbe postava samotného hráče. NPC je společné pro všechny a poškození, které způsobuje, musí rozhodovat server. Viz Script, LocalScript a ModuleScript.
Kolik pronásledujících NPC jeden server zvládne?
Dokumentace Robloxu přesné číslo neuvádí; záleží na mapě a na tom, jak často se cesty počítají. Nejdražší je výpočet cesty, proto ho skript pronásledování omezuje na dvakrát za sekundu na NPC a vynechává ho, když je hráč vidět. Pro velký počet NPC radí doporučení Robloxu o tom, kde skripty uchovávat, označit je tagy a zpracovávat přes CollectionService z jednoho ModuleScriptu, místo aby se skript dával do každého modelu.
Jak udělat, aby se NPC po smrti respawnulo?
Kopii NPC uchovávejte ve ServerStorage a respawn dělejte ze skriptu v ServerScriptService, protože skript uvnitř NPC se zničí spolu s ním. Když se spustí událost Died u Humanoidu, počkejte pár sekund, zničte starý model a dejte Clone() kopie do Workspace. Skript ChaseAI uvnitř klonu se spustí sám, protože serverové skripty běží, jakmile jsou ve Workspace.
Dá se udělat, aby NPC pronásledovala hráče jen během kola?
Ano. Ať váš skript kol naklonuje NPC do Workspace, když kolo začne, a zničí je, když skončí. Návod k systému kol staví smyčku přestávky a kola, ke které se to připojí.
Zdroje a další čtení
- Roblox Creator Docs: Pathfinding (anglicky). parametry agenta, waypointy, zablokované cesty, modifikátory, odkazy a omezení
- Roblox Creator Docs: PathfindingService (anglicky). CreatePath a výchozí hodnoty
- Roblox Creator Docs: Path (anglicky). ComputeAsync, GetWaypoints, Status a událost Blocked
- Roblox Creator Docs: Humanoid (anglicky). MoveTo, 8sekundový časový limit MoveToFinished, ChangeState a TakeDamage
- Roblox Creator Docs: Network ownership (anglicky). automatické vlastnictví, SetNetworkOwner a režim Network owners
- Roblox Creator Docs: RaycastParams (anglicky). ExcludeInstances a RespectCanCollide
- Roblox Creator Docs: NPC kit (anglicky). příklady NPC s vlastními skripty Animate
Jak byl kód ověřen: každý skript na této stránce prochází přísnou kontrolou typů Luau s definicemi Roblox API (luau-lsp, 20. listopadu 2026). Kontrola typů zachytí chyby v názvech API a špatné typy, ale ne chyby v herní logice, proto vše otestujte ve Studiu před publikováním.