Tutoriál · Herní systémy

Pathfinding NPC v Roblox Studiu: jak udělat, aby NPC chodilo za hráčem

Aby NPC obcházelo zdi a dostalo se k nejbližšímu hráči, potřebuje tři věci: rig, který se může hýbat, trasu od PathfindingService a smyčku, která jde po trase a nepere se s fyzikálním enginem. V tomto návodu postavíme všechny tři a na konci dostaneme jeden serverový skript, který stačí vložit do rigu NPC.

Aktualizováno 20. listopadu 202613 min čteníAutor:

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 Action waypointu Jump, a počítejte novou cestu, když se Path.Blocked spustí pro waypoint před NPC.
  • Když je hráč přímo vidět, pathfinding vynechte a dejte MoveTo pří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
  1. Jak funguje pathfinding
  2. 1. Nastavení NPC
  3. 2. Jdeme k bodu
  4. 3. Skript pronásledování
  5. Jak funguje pronásledování
  6. Odstraňujeme cukání
  7. 4. Poškození dotykem
  8. Modifikátory a odkazy
  9. Common errors
  10. With RoCode
  11. Časté otázky
  12. Zdroje a další čtení

Jak pathfinding NPC funguje

IlustraceChaser najde cestu kolem zdi, vyskočí na římsu a zastaví se 4 study od vás.

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, která tento návod používá
APICo 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.BlockedSpustí se s indexem waypointu, když něco zablokuje spočítanou trasu.
Humanoid:MoveTo(position)Vede NPC k bodu.
Humanoid.MoveToFinishedSpustí 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í.

Co model NPC potřebuje
PožadavekProč na tom záleží
Humanoid s názvem HumanoidMoveTo, WalkSpeed a skoky patří Humanoidu.
HumanoidRootPartPart, 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.
  1. 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.
  2. Přejmenujte rig na Chaser a postavte ho na otevřené místo.
  3. 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.
Explorer: model NPC na konci tohoto návodu
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í.

  1. 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.
  2. V Exploreru najeďte myší na Chaser, klikněte na tlačítko + a vložte Script. Pojmenujte ho WalkToGoal a vložte kód níže.
  3. Klikněte na Play. NPC obejde zeď a jde k partu Goal.
Script v modelu Chaser s názvem 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í 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.

Parametry agenta pro CreatePath
KlíčVýchozíCo určuje
AgentRadius2Poloměr NPC ve studech. U širokých NPC ho zvětšete, aby se cesty držely dál od zdí.
AgentHeight5Výška NPC. Místa nižší než tato, například pod schody, se počítají jako zablokovaná.
AgentCanJumptruePovolí trasy, kde je potřeba skok. Takové waypointy mají Action rovnou Jump.
AgentCanClimbfalsePovolí lezení po TrussPart. Takové waypointy mají štítek Climb.
WaypointSpacing4Vzdá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íž.

  1. Smažte WalkToGoal z Chaser, pokud jste ho přidali.
  2. Najeďte myší na Chaser, klikněte na +, vložte Script s názvem ChaseAI a vložte kód níže.
  3. 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.
Script v modelu Chaser s názvem 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

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

Cukání při pathfindingu: příčiny a opravy
Co vidítePříčinaOprava
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 rohyPevné 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 sekunduNová 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álMoveToFinished: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.

  1. V ChaseAI nastavte STOP_DISTANCE na 0, aby NPC šlo až do hráčů, a nezastavovalo se vedle nich.
  2. Vložte do Chaser Script s názvem TouchDamage a vložte kód níže.
Script v modelu Chaser s názvem 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 -- 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

  1. Zakryjte oblast partem se zapnutým Anchored a vypnutým CanCollide.
  2. Vložte do tohoto partu PathfindingModifier a nastavte jeho Label na DangerZone.
  3. To je všechno. Skript pronásledování už dává DangerZone cenu math.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ě.

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.

Napíšete

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.

RoCode udělá
  • 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í

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.

Vyzkoušejte RoCode ve své hře.

Kredity zdarma každý den, bez karty. Nainstalujte plugin, popište funkci a podívejte se, co se objeví ve Studiu.