Návod · Herné systémy

Pathfinding NPC v Roblox Studiu: ako urobiť, aby NPC chodilo za hráčom

Aby NPC obchádzalo steny a dostalo sa k najbližšiemu hráčovi, potrebujete tri veci: rig, ktorý sa môže hýbať, trasu od PathfindingService a cyklus, ktorý ide po trase a nebije sa s fyzikálnym enginom. V tomto návode poskladáme všetky tri a na konci dostaneme jeden serverový skript, ktorý stačí vložiť do rigu NPC.

Aktualizované 20. novembra 202614 min čítaniaAutor:

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 Action waypointu Jump, a počítajte novú cestu, keď sa Path.Blocked spustí pre waypoint pred NPC.
  • Keď je hráč priamo na dohľad, preskočte pathfinding a urobte MoveTo priamo 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
  1. Ako funguje pathfinding
  2. 1. Nastavenie NPC
  3. 2. Chôdza k bodu
  4. 3. Skript naháňačky
  5. Ako funguje naháňačka
  6. Odstránenie zadrhávania
  7. 4. Poškodenie dotykom
  8. Modifikátory a odkazy
  9. Common errors
  10. With RoCode
  11. Časté otázky
  12. Zdroje a ďalšie čítanie

Ako funguje pathfinding NPC

IlustráciaChaser nájde cestu okolo steny, vyskočí na rímsu a zastaví sa 4 study od vás.

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, ktoré používa tento návod
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.BlockedSpustí sa s indexom waypointu, keď niečo zablokuje vypočítanú trasu.
Humanoid:MoveTo(position)Vedie NPC k bodu.
Humanoid.MoveToFinishedSpustí 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.

Čo potrebuje model NPC
PožiadavkaPrečo je to dôležité
Humanoid s názvom HumanoidMoveTo, WalkSpeed a skoky patria Humanoidu.
HumanoidRootPartPart, 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ť.
  1. 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.
  2. Premenujte rig na Chaser a postavte ho na otvorené miesto.
  3. 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.
Explorer: model NPC na konci tohto návodu
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.

  1. Vložte Part do Workspace, pomenujte ho Goal, zapnite Anchored, vypnite CanCollide a postavte ho na podlahu tak, aby NPC muselo obísť stenu.
  2. V Exploreri prejdite kurzorom na Chaser, kliknite na tlačidlo + a vložte Script. Pomenujte ho WalkToGoal a vložte doň kód nižšie.
  3. Stlačte Play. NPC obíde stenu a ide k partu Goal.
Script v model Chaser s názvom 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

-- 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ť.

Parametre agenta pre CreatePath
KľúčPredvolenéČo určuje
AgentRadius2Polomer NPC v studoch. Zväčšite ho pre široké NPC, aby sa cesty držali ďalej od stien.
AgentHeight5Výška NPC. Miesta nižšie, napríklad pod schodmi, sa považujú za zablokované.
AgentCanJumptruePovoľuje trasy, kde treba skok. Takéto waypointy majú Action rovné Jump.
AgentCanClimbfalsePovoľuje lezenie po TrussPart. Takéto waypointy majú štítok Climb.
WaypointSpacing4Vzdialenosť v studoch medzi priebežnými waypointmi. math.huge ich odstráni.
CostsžiadneAko 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.

  1. Vymažte WalkToGoal z Chaser, ak ste ho pridali.
  2. Prejdite kurzorom na Chaser, kliknite na +, vložte Script s názvom ChaseAI a vložte doň kód nižšie.
  3. 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.
Script v model Chaser s názvom 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

-- 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.

Zadrhávanie pri pathfindingu: príčiny a opravy
Čo vidítePríčinaOprava
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 stienMoveTo 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 rohyPevné 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 sekunduNová 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 ďalejMoveToFinished: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.

  1. V ChaseAI nastavte STOP_DISTANCE na 0, aby NPC išlo až do hráčov a nezastavovalo sa pri nich.
  2. Vložte do Chaser Script s názvom TouchDamage a vložte doň kód nižšie.
Script v model Chaser s názvom 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 -- 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

  1. Prekryte oblasť partom so zapnutým Anchored a vypnutým CanCollide.
  2. Vložte do tohto partu PathfindingModifier a nastavte jeho Label na DangerZone.
  3. To je všetko. Skript naháňačky už dáva DangerZone cenu math.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.

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.

Napíšete

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.

RoCode urobí
  • 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

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.

Vyskúšajte RoCode vo svojej hre.

Kredity zadarmo každý deň, bez karty. Nainštalujte plugin, opíšte funkciu a pozrite sa, čo sa objaví v Studiu.