Tutorial · Spillsystemer

NPC-pathfinding i Roblox Studio: slik får du en NPC til å følge spilleren

For at en NPC skal gå rundt vegger og komme seg frem til nærmeste spiller, trenger du tre ting: en rig som kan bevege seg, en rute fra PathfindingService og en løkke som følger ruten uten å krangle med fysikkmotoren. I denne guiden bygger vi alle tre, og til slutt har vi ett serverskript som du bare kan legge i NPC-ens rig.

Oppdatert 20. november 202615 min lesingSkrevet av

Kort fortalt

Legg et Script inni NPC-modellen. Lag en path med PathfindingService:CreatePath(), beregn den med path:ComputeAsync(start, goal) inni en pcall, og gå deretter gjennom waypointene ett om gangen med Humanoid:MoveTo(), og vent på MoveToFinished før det neste. For at NPC-en skal jage spilleren, velger du nærmeste figur og beregner veien på nytt når den har flyttet seg noen studs, ikke hver frame.

  • Du trenger en Humanoid og en HumanoidRootPart som ikke er anchored. Kall SetNetworkOwner(nil) på root part slik at serveren simulerer den: det er den vanlige løsningen for en NPC som hakker nær spillere.
  • Hopp når Action på waypointet er Jump, og beregn en ny vei når Path.Blocked utløses for et waypoint foran NPC-en.
  • Når spilleren er rett i synsfeltet, hopper du over pathfinding og gjør MoveTo rett mot spilleren. Stopp noen studs unna, eller gå helt inntil hvis NPC-en gjør skade ved berøring.
På denne siden
  1. Slik fungerer pathfinding
  2. 1. Sette opp NPC-en
  3. 2. Gå til et punkt
  4. 3. Jaktskriptet
  5. Slik fungerer jakten
  6. Fjerne hakking
  7. 4. Skade ved berøring
  8. Modifikatorer og lenker
  9. Common errors
  10. With RoCode
  11. Ofte stilte spørsmål
  12. Kilder og videre lesing

Slik fungerer NPC-pathfinding

IllustrasjonChaser finner veien rundt veggen, hopper opp på avsatsen og stopper 4 studs fra deg.

Roblox bygger et navigasjonsnett (navigation mesh) av flatene en figur kan gå på. PathfindingService søker i dette nettet etter en rute mellom to punkter og returnerer den som en liste med waypoints: hvert har en posisjon og en handling, for eksempel gå eller hoppe. Deretter går NPC-ens Humanoid fra ett waypoint til det neste. Pathfinding planlegger bare ruten: det er skriptet ditt som må bevege NPC-en langs den.

API-ene denne guiden bruker
APIHva det gjør
PathfindingService:CreatePath()Lager et Path-objekt som kan brukes mange ganger, tilpasset størrelsen på NPC-en din via agentparametere.
Path:ComputeAsync(start, finish)Beregner ruten. Den gir fra seg kjøringen (yield) og kan feile, så kall den inni en pcall og sjekk Path.Status.
Path:GetWaypoints()Returnerer ruten som en array med PathWaypoint-verdier, der hver har Position, Action og Label.
Path.BlockedUtløses med indeksen til et waypoint når noe sperrer den beregnede ruten.
Humanoid:MoveTo(position)Fører NPC-en mot et punkt.
Humanoid.MoveToFinishedUtløses med true når NPC-en kommer innenfor omtrent én stud fra punktet, eller med false hvis den ikke kom frem innen 8 sekunder.

Kjør alt dette i et server-Script: serveren ser hele kartet selv med streaming, alle spillere ser den samme NPC-en, og skade avgjøres der klienten ikke kan forfalske den. Script, LocalScript og ModuleScript forklarer denne delingen.

Steg 1: En NPC som kan bevege seg

Enhver modell kan gå langs en vei hvis den har de tre tingene i tabellen nedenfor. Rigger fra Toolbox eller gamle places mangler noen ganger noe, og det ser vanligvis slik ut: NPC-en står stille, og det kommer ingen feil.

Hva NPC-modellen trenger
KravHvorfor det er viktig
En Humanoid med navnet HumanoidMoveTo, WalkSpeed og hopping hører til Humanoid.
HumanoidRootPartParten som Humanoid styrer. Veier starter fra posisjonen dens.
Ingenting er anchoredEn anchored part kan ikke bevege seg, og det kan heller ikke parts som er koblet til den. Anchored parts eies alltid av serveren, så løsningen på hakking som beskrives nedenfor kan ikke brukes på dem.
  1. Åpne fanen Avatar eller Home og trykk Character for å åpne Rig Generator. Velg R15, deretter Block Avatar. En rig dukker opp i Workspace. R6-rigger fungerer med de samme skriptene.
  2. Gi riggen navnet Chaser og sett den på et åpent sted.
  3. Merk HumanoidRootPart og sjekk at Anchored er slått av i Properties-vinduet. Gjør det samme for alle andre anchored parts i modellen. For å finne dem raskt slår du på Anchored parts i widgeten Visualization Options øverst til høyre i 3D-viewporten.
Explorer: NPC-modellen ved slutten av denne guiden
Workspace
  Chaser Model
    Humanoid Humanoid
    HumanoidRootPart Part
    Head, UpperTorso, LowerTorso ... (kroppsdeler)
    ChaseAI Script new
    TouchDamage Script new

For at NPC-en også skal snakke, legger guiden om NPC-dialog til en Talk-prompt med svaralternativer og forklarer hva som endres når NPC-en går. For å vise bossen med kameraet før den begynner å jage, se guiden om cutscener.

Steg 2: Send NPC-en til et punkt

Begynn med det minste skriptet som virker: gå til en part som står stille. Det viser hver fase av pathfinding uten jaktlogikk.

  1. Sett inn en Part i Workspace, gi den navnet Goal, slå på Anchored, slå av CanCollide og plasser den på gulvet slik at NPC-en må gå rundt en vegg.
  2. I Explorer holder du musepekeren over Chaser, trykker +-knappen og setter inn et Script. Gi det navnet WalkToGoal og lim inn koden nedenfor.
  3. Trykk Play. NPC-en går rundt veggen og frem til Goal-parten.
Script i Chaser-modellen med navnet 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

-- Serveren må eie NPC-ens fysikk, ellers virker ikke ChangeState (hopp) fra et Script
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 gir fra seg kjøringen og kan kaste en feil, derfor ligger den inni 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 -- det første waypointet er der NPC-en allerede står
		end
		humanoid:MoveTo(waypoint.Position)
		if waypoint.Action == Enum.PathWaypointAction.Jump then
			humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
		end
		-- Vent til NPC-en har nådd dette waypointet, og gå først da videre til det neste
		local reached = humanoid.MoveToFinished:Wait()
		if not reached then
			warn(`{npc.Name} got stuck on the way to the goal`)
			break
		end
	end
end

Goal-parten har CanCollide slått av fordi en vei ikke kan slutte inni en solid part: Status for veien ville blitt NoPath.

Tabellen som CreatePath får, beskriver NPC-en (Roblox kaller den en agent), slik at ruten unngår åpninger den ikke kommer gjennom. Skriptet ovenfor setter de tre første nøklene til standardverdiene, så du ser hvor du endrer dem.

Agentparametere for CreatePath
NøkkelStandardHva den bestemmer
AgentRadius2NPC-ens radius i studs. Øk den for brede NPC-er slik at veiene holder seg lenger unna vegger.
AgentHeight5NPC-ens høyde. Steder som er lavere enn dette, for eksempel under en trapp, regnes som sperret.
AgentCanJumptrueTillater ruter som krever et hopp. Slike waypoints har Action lik Jump.
AgentCanClimbfalseTillater klatring i TrussPart. Slike waypoints har merket Climb.
WaypointSpacing4Avstanden i studs mellom mellomliggende waypoints. math.huge fjerner dem.
CostsingenHvor dyrt det er å krysse materialer og merkede områder. Se modifikatorer og lenker.

To detaljer i løkken er viktige. Det første waypointet er NPC-ens egen posisjon, så løkken hopper over det. Og etter hver MoveTo kommer MoveToFinished:Wait(): en ny MoveTo erstatter det forrige målet, så en løkke uten venting sender NPC-en rett mot det siste waypointet, inn i nettopp den veggen den skulle gå rundt.

For hopp er Action på waypointet lik Jump, og skriptet kaller ChangeState(Enum.HumanoidStateType.Jumping). Robloxs referanse for Humanoid sier at et serverskript bare kan endre tilstanden når serveren eier figurens fysikk. Det er en av grunnene til at skriptet setter eieren først.

På Robloxs side om pathfinding beveges spillerens egen figur med Humanoid:Move() og en sjekk av ankomst hver frame, og det kalles den beste måten å føre en Humanoid langs en vei. MoveTo med MoveToFinished er kortere og lettere å forstå for en server-NPC, så guiden bruker det; trenger du mer presis kontroll senere, kan du se nærmere på det offisielle skriptet.

Steg 3: Det komplette jaktskriptet

Dette er skriptet de fleste leter etter. NPC-en jager nærmeste spiller innenfor 80 studs, går rundt vegger, hopper der ruten krever det, finner en ny rute når noe sperrer den, og går hjem når ingen er i nærheten.

  1. Slett WalkToGoal fra Chaser hvis du la det til.
  2. Hold musepekeren over Chaser, trykk +, sett inn et Script med navnet ChaseAI og lim inn koden nedenfor.
  3. Trykk Play, gå bak veggen, og løp så utenfor rekkevidden. NPC-en går rundt veggen etter deg og vender deretter tilbake dit den startet.
Script i Chaser-modellen med navnet 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

-- Innstillinger (avstander i studs, tid i sekunder)
local DETECTION_RANGE = 80 -- spillere lenger unna enn dette legger ikke NPC-en merke til
local STOP_DISTANCE = 4 -- stopp på denne avstanden fra målet (0 = gå helt inntil, for skade ved berøring)
local DIRECT_CHASE_RANGE = 30 -- nærmere enn dette hopper vi over pathfinding hvis ingenting er i veien
local REPATH_DISTANCE = 4 -- hvor langt målet må flytte seg før veien beregnes på nytt
local MIN_REPATH_INTERVAL = 0.5 -- beregn aldri veier oftere enn dette
local WAYPOINT_TIMEOUT = 2 -- forlat veien hvis ett waypoint tar lengre tid enn dette
local CHASE_SPEED = 14 -- spilleren går med fart 16 som standard, så den kan løpe fra denne NPC-en
local HOME_RADIUS = 4 -- så nær hjemmet regnes allerede som hjemme
local RAY_HEIGHTS = { 0, -2 } -- siktlinjestråler i hoftehøyde og rundt knærne

local HOME = rootPart.Position -- dit NPC-en vender tilbake når ingen er innenfor rekkevidde

humanoid.WalkSpeed = CHASE_SPEED

-- La serveren simulere NPC-en. Ellers kan Roblox gi fysikken til enheten
-- til en spiller i nærheten, og NPC-en hakker når eieren skifter.
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, -- gå gjennom vann bare for å slippe en stor omvei
		DangerZone = math.huge, -- gå aldri inn i områder merket DangerZone
	},
})

-- Veien NPC-en følger akkurat nå
local waypoints: { PathWaypoint } = {}
local nextIndex = 0
local pathGoal: Vector3? = nil
local pathBlocked = false
local lastComputeTime = -math.huge

-- Blocked kan utløses for et waypoint NPC-en allerede har passert. Bare hindringer foran betyr noe.
path.Blocked:Connect(function(blockedIndex: number)
	if blockedIndex >= nextIndex then
		pathBlocked = true
	end
end)

local rayParams = RaycastParams.new()
rayParams.RespectCanCollide = true -- parts som ingenting kolliderer med, blokkerer ikke sikten

local function clearPath()
	waypoints = {}
	nextIndex = 0
	pathGoal = nil
end

local function stopMoving()
	clearPath()
	humanoid:MoveTo(rootPart.Position)
end

-- HumanoidRootPart til nærmeste levende spiller innenfor DETECTION_RANGE, eller 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 når målet er på omtrent samme nivå og det ikke er noe solid mellom dem.
-- En fri stråle beviser ikke at bakken kan gås på, så dette brukes bare på kort avstand.
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)
	-- Nullstill etter beregningen, så en Blocked fra den gamle ruten ikke merker den nye
	pathBlocked = false
	if ok and path.Status == Enum.PathStatus.Success then
		waypoints = path:GetWaypoints()
		nextIndex = 2 -- waypoint 1 er der NPC-en står
		pathGoal = goal
	else
		if not ok then
			warn(`{npc.Name}: path request failed: {err}`)
		end
		clearPath() -- ingen rute ennå; hovedløkken prøver snart igjen
	end
end

local function needsNewPath(goal: Vector3): boolean
	if os.clock() - lastComputeTime < MIN_REPATH_INTERVAL then
		return false -- nettopp beregnet: følg den nåværende veien
	end
	local currentGoal = pathGoal
	if currentGoal == nil or pathBlocked or nextIndex > #waypoints then
		return true
	end
	return (goal - currentGoal).Magnitude > REPATH_DISTANCE
end

-- Venter på MoveToFinished, men gir opp etter timeout sekunder i stedet for de innebygde 8,
-- slik at en NPC som sitter fast, raskt får en ny vei
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() -- sitter fast eller ble dyttet ut av kurs: beregn en ny vei
	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() -- nær nok: stå ved siden av målet
			task.wait(0.2)
			continue
		end
		if distance <= DIRECT_CHASE_RANGE and canSeeDirectly(targetRoot) then
			clearPath()
			-- Sender du også med parten, følger NPC-en etter den mens den beveger seg
			humanoid:MoveTo(targetRoot.Position, targetRoot)
			task.wait(0.15)
			continue
		end
		goal = targetRoot.Position
	else
		if (HOME - rootPart.Position).Magnitude <= HOME_RADIUS then
			stopMoving() -- ingen i nærheten, og NPC-en er allerede hjemme
			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) -- ingen brukbar vei ennå, for eksempel fordi målet ikke kan nås
	end
end

Alle innstillingene står øverst. For flere NPC-er dupliserer du Chaser: hver kopi kjører sin egen ChaseAI og husker sitt eget hjem. Eldre skript filtrerer stråler med FilterDescendantsInstances; Robloxs referanse anbefaler nå ExcludeInstances for nytt arbeid, og det er det dette skriptet bruker.

Slik fungerer jaktskriptet

Hver runde i hovedløkken tar én beslutning og gjør én liten handling: stå stille, gå rett mot spilleren eller gå til neste waypoint. Ingenting bestemmes for mer enn ett waypoint om gangen, så NPC-en reagerer hele tiden.

Finne nærmeste spiller

findNearestTarget går gjennom Players:GetPlayers(), hopper over alle uten figur, levende Humanoid eller HumanoidRootPart (spillere som respawner eller forlater spillet) og returnerer nærmeste root part innenfor DETECTION_RANGE. Søket skjer i hver runde, så NPC-en bytter selv til en spiller som er nærmere, og en spiller som har gått ut, blir rett og slett ikke funnet lenger: det finnes ingen tilstand per spiller som må ryddes opp.

Beregne veien på nytt mens spilleren beveger seg, men ikke hver frame

Å beregne en vei gir fra seg kjøringen og bruker servertid. needsNewPath ber om en ny vei bare når det ikke finnes noen vei, den gamle er ferdig eller sperret, eller spilleren har flyttet seg mer enn REPATH_DISTANCE studs fra slutten av den nåværende veien, og aldri tidligere enn MIN_REPATH_INTERVAL sekunder etter forrige gang. Mens veien beregnes, fortsetter NPC-en mot det nåværende waypointet, og den nye veien følges fra waypoint 2, så NPC-en snur ikke tilbake mot stedet der veien begynte.

Sperrede veier

Dører lukkes, parts faller ned. Path.Blocked utløses med indeksen til det sperrede waypointet, som kan ligge bak NPC-en, så skriptet reagerer bare når blockedIndex >= nextIndex: det setter et flagg, og løkken beregner en ny rute. Et waypoint som NPC-en bruker mer enn WAYPOINT_TIMEOUT sekunder på å nå, fordi den ble dyttet eller hektet seg fast, starter også en ny rute.

Rett mot en synlig spiller

Pathfinding trengs ikke når spilleren er synlig på et åpent sted. Innenfor DIRECT_CHASE_RANGE sender funksjonen canSeeDirectly to stråler mot spilleren, i hoftehøyde og rundt knærne for å oppdage lave vegger, og ignorerer begge figurene. Hvis ingen av strålene treffer noe og spilleren er på omtrent samme nivå, kaller NPC-en MoveTo(targetRoot.Position, targetRoot). Det andre argumentet får målet til å bevege seg sammen med spilleren, og når kallet gjentas hvert 0.15 sekund, nullstilles tidsavbruddet på 8 sekunder hele tiden.

En fri stråle beviser at det ikke er noe solid i veien, men ikke at det er gulv der. Hvis kartet har kløfter eller stup mellom NPC-en og spillerne, reduserer du DIRECT_CHASE_RANGE eller setter den til 0 for alltid å bruke pathfinding.

Stoppe på riktig avstand

Når spilleren er nærmere enn STOP_DISTANCE, kaller NPC-en MoveTo på sin egen posisjon, og det stopper den. 4 studs passer for en NPC som skal stå ved siden av spilleren; for et kjæledyr eller en følgesvenn som holder avstand, setter du 6 eller 8. For en fiende som slår ved berøring, setter du 0 slik at den går helt inntil, som i steg 4.

Hvorfor NPC-en hakker, og hvordan du fikser det

Hvis NPC-en hakker, fryser ved hvert waypoint eller tar et steg tilbake, er årsaken vanligvis ett av punktene nedenfor. Jaktskriptet tar allerede høyde for hvert av dem; tabellen er der for å reparere et skript du har skrevet selv.

Hakking ved pathfinding: årsaker og løsninger
Hva du serÅrsakLøsning
Jevnt når den er alene, og rykkvis når en spiller er i nærhetenNetwork ownership. Roblox gir fysikken til parts som ikke er anchored til enheten til en spiller i nærheten, så NPC-en kan simuleres på den spillerens enhet mens serveren gir kommandoene, og hver overlevering kan se ut som et rykk.Kall SetNetworkOwner(nil) på HumanoidRootPart fra serveren én gang. Det gjelder alle parts som er koblet til den.
Går rett mot det siste waypointet og inn i veggerMoveTo kalles for hvert waypoint i en løkke uten venting. Hvert kall erstatter det forrige målet.Vent på MoveToFinished før du går videre til neste waypoint.
Stopper kort ved hvert waypoint eller kutter hjørnerEn fast task.wait() mellom waypoints i stedet for å vente på ankomst. For lenge, og NPC-en står; for kort, og den hopper fremover.Vent på MoveToFinished med et tidsavbrudd.
Hakker eller tar et steg tilbake flere ganger i sekundetEn ny vei hver frame. Hver av dem starter fra NPC-ens egen posisjon, så veien til waypoint 1 snur den bakover.Beregn veien på nytt bare når målet har flyttet seg noen studs, ikke oftere enn to ganger i sekundet, og start fra waypoint 2.
Fryser i noen sekunder og går så videreMoveToFinished:Wait() på et waypoint som ikke kan nås, venter på tidsavbruddet på 8 sekunder.Bruk ditt eget, kortere tidsavbrudd og beregn en ny vei når det har gått ut.

For å se hvem som eier NPC-en, åpner du Visualization Options under en playtest og slår på Network owners. Parts som klienten din simulerer, får en grønn kontur; parts som eies av serveren eller en annen klient, har hvit eller grå kontur.

Steg 4: Skade på spillere ved berøring (valgfritt)

For en fiende legger du til et andre skript i NPC-en som gjør skade på spillere ved berøring. Det kjører på serveren, så spillerens klient kan ikke endre skaden eller omgå nedkjølingen.

  1. I ChaseAI setter du STOP_DISTANCE til 0, slik at NPC-en går helt inntil spillerne i stedet for å stoppe ved siden av dem.
  2. Sett inn et Script med navnet TouchDamage i Chaser og lim inn koden nedenfor.
Script i Chaser-modellen med navnet 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 -- en beseiret NPC gjør ikke skade
	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 utløses mange ganger i sekundet mens parts overlapper
	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 tar hensyn til kraftfelt, så spillere er trygge mens kraftfeltet etter spawn varer. For å ignorere kraftfelt reduserer du Humanoid.Health direkte.

Nedkjølingen lagres separat for hver spiller. Touched utløses mange ganger i sekundet mens parts gnis mot hverandre, og uten nedkjøling kunne én berøring tømt spillerens helse på et øyeblikk. Oppføringen slettes når spilleren går ut, så tabellen vokser ikke hele tiden mens serveren lever.

For at spillerne skal kunne slå tilbake, gir du dem et sverd eller et raycast-våpen. Begge gjør skade på serveren mot alt som har en Humanoid, så de treffer også Chaser.

Modifikatorer og lenker i pathfinding

Som standard er veien den korteste ruten, uten hopp der det er mulig. Du kan endre dette på tre måter. Kostnader og modifikatorer fungerer med jaktskriptet som det er, fordi det allerede sender en Costs-tabell til CreatePath; lenker krever noen egne linjer.

Kostnad for materialer

Nøklene i Costs kan være materialnavn, for eksempel Water, Mud eller CrackedLava, både for terreng og for parts. Som standard koster hvert materiale 1. Et høyere tall får NPC-en til å gå rundt materialet hvis omveien ikke er verre, og math.huge gjør det ufremkommelig. Jaktskriptet setter Water = 20.

Områder som skal unngås: PathfindingModifier

  1. Dekk området med en part der Anchored er slått på og CanCollide er slått av.
  2. Sett inn en PathfindingModifier i den parten og sett Label til DangerZone.
  3. Det er alt. Jaktskriptet gir allerede DangerZone kostnaden math.huge, så NPC-en går rundt området. Slå på Pathfinding modifiers i Visualization Options for å se merket på navigasjonsnettet.

En modifikator med PassThrough slått på gjør det motsatte: ruten går gjennom en solid hindring, for eksempel en lukket dør, som om den ikke var der. NPC-en kan fortsatt ikke gå gjennom døren, men går mot den, som om den hørte spilleren på den andre siden.

PathfindingLink kobler sammen to punkter som NPC-en vanligvis ikke kan gå mellom, for eksempel breddene av en elv den krysser med båt. Sett et Attachment i hver ende, sett Attachment0 og Attachment1 på lenken, gi den en Label, for eksempel UseBoat, og legg til UseBoat i Costs med lavere kostnad enn Water. Da dukker det opp et waypoint med dette merket i veien: sjekk waypoint.Label i walkToNextWaypoint og kjør din egen handling, for eksempel sett NPC-en i båten, i stedet for MoveTo. Lenker virker begge veier hvis du ikke slår av IsBidirectional.

Vanlige feil og løsninger

Sjekk Output-vinduet først. Det åpnes fra menyen Window eller i fanen Script. Skriptene på denne siden skriver en advarsel når en veiforespørsel feiler eller riggen ikke kan bevege seg.

NPC-en beveger seg ikke i det hele tatt

Hvis Output sier at NPC-en ikke kan bevege seg (cannot move), er en del av riggen anchored: fjern Anchored fra HumanoidRootPart og de andre partene. Hvis ikke, sjekker du at koden ligger i et Script, ikke i et LocalScript, at det ligger inni en modell i Workspace, og at Humanoid ikke er død.

Output skriver "Infinite yield possible" på WaitForChild

Skriptet venter på et objekt som ikke finnes: en Humanoid eller HumanoidRootPart med et annet navn, eller en manglende Goal-part for skriptet i steg 2. Gi objektet nytt navn eller endre strengen i skriptet. Guiden om skriptfeil forklarer denne advarselen.

Veien bygges ikke, eller NPC-en ignorerer en spiller den kunne nådd

Path.Status etter ComputeAsync er NoPath når start eller slutt er inni en solid part, når den eneste ruten krever et hopp og AgentCanJump er false, eller når AgentHeight eller AgentRadius er for stor for en åpning på veien. Robloxs dokumentasjon har også harde grenser: ikke mer enn 3,000 studs i rett linje fra start til slutt, og et søkebudsjett på 20,000 noder, som kanskje ikke holder for enorme åpne verdener eller labyrinter. Slå på Navigation mesh for å sjekke ruten.

NPC-en glir og beveger ikke beina

Dette er et animasjonsproblem, ikke pathfinding. Spillerfigurer får Animate-skriptet automatisk, mens en NPC trenger sitt eget skript for å spille av gåanimasjoner. Hver NPC i Robloxs NPC kit har et Script med navnet Animate som du kan se nærmere på. Hvordan du laster inn og spiller av en animasjon på en NPC fra et server-Script, finner du i delen animasjon på NPC.

NPC-en setter seg fast i hjørner, eller hopper uten å komme over hindringen

Øk AgentRadius slik at rutene holder seg lenger unna vegger, særlig for brede NPC-er. Hvis den hopper, men aldri kommer over, er hindringen høyere enn Humanoid kan hoppe: øk JumpHeight eller JumpPower på Humanoid, eller endre banen.

Skade ved berøring utløses for ofte eller aldri

For ofte: det er ingen nedkjøling, eller den lagres per part i stedet for per spiller. Aldri: STOP_DISTANCE er større enn 0, så NPC-en stopper vanligvis før den berører noen, eller spilleren har fortsatt kraftfeltet etter spawn.

Bygg det med RoCode

Hvis det er lettere for deg å beskrive NPC-en enn å bygge den for hånd, kan RoCode skrive disse skriptene i placet du har åpent. Det er en uavhengig AI-agent for Roblox Studio: du skriver i en nettchat, og Studio-pluginen lager og redigerer skript i Explorer-en din.

Du skriver

Få Chaser-modellen i Workspace til å jage nærmeste spiller innenfor 80 studs med pathfinding, gå hjem når ingen er i nærheten, og gjøre 10 skade ved berøring med 1 sekunds nedkjøling.

RoCode gjør
  • Kan først se gjennom modellen med Get Properties og lese nøkkelverdier, for eksempel Anchored på partene og WalkSpeed på Humanoid. Skriv / i chatten for å legge ved den nøyaktige stien til modellen
  • Skriver jakt- og skadeskriptene inni modellen med Create Script og kan fjerne Anchored med Set Property hvis riggen trenger det
  • Sjekker at begge skriptene kompilerer med Check Script rett i Studio. Det fanger kompileringsfeil og ting som wait() i stedet for task.wait(), men ikke logiske feil som en rute som aldri når frem til spilleren
  • Sender endringene i omganger, og hver omgang er et angrepunkt i Studios historikk

Med plugin 3.9 eller nyere kan RoCode kjøre en kort playtest og lese feilene, og med plugin 3.9.11 eller nyere kan den styre en testfigur for å sjekke at spillet virker, men den tar ikke skjermbilder mens spillet kjører, så trykk Play og se på NPC-en selv. Hvis den ikke oppfører seg som den skal, forteller du RoCode hva du så: Check Output kan lese Server- og Client-linjene fra din siste playtest. En NPC er ett system av mange; se hvordan du bygger et helt Roblox-spill med AI: først en spillbar kjerne, så runder. Slik kobler RoCode seg til Studio.

Ofte stilte spørsmål

Hvor skal NPC-pathfinding kjøre: på serveren eller på klienten?

På serveren, i et Script. Robloxs eget pathfinding-eksempel kjører i et LocalScript, men der er det spillerens egen figur som beveger seg. En NPC er felles for alle, og skaden den gjør, må avgjøres av serveren. Se Script, LocalScript og ModuleScript.

Hvor mange jagende NPC-er tåler én server?

Robloxs dokumentasjon oppgir ikke noe nøyaktig tall; det avhenger av kartet og hvor ofte veier beregnes. Det dyreste er å beregne veier, så jaktskriptet begrenser det til to ganger i sekundet per NPC og hopper over det når spilleren er synlig. For mange NPC-er anbefaler Robloxs råd om hvor skript bør ligge, å merke dem med tagger og håndtere dem via CollectionService fra én ModuleScript, i stedet for å legge et skript i hver modell.

Hvordan får jeg NPC-en til å respawne etter at den dør?

Hold en kopi av NPC-en i ServerStorage, og gjør respawnen fra et skript i ServerScriptService, fordi et skript inni NPC-en ødelegges sammen med den. Når Died-hendelsen på Humanoid utløses, venter du noen sekunder, ødelegger den gamle modellen og legger en Clone() av kopien i Workspace. ChaseAI-skriptet inni klonen starter av seg selv, fordi serverskript kjører så snart de havner i Workspace.

Kan jeg få NPC-er til å jage spillere bare under en runde?

Ja. La rundeskriptet ditt klone NPC-ene inn i Workspace når runden starter, og ødelegge dem når den slutter. Guiden om rundesystem bygger løkken med pause og runde som dette kobles til.

Kilder og videre lesing

Slik ble koden sjekket: hvert skript på denne siden går gjennom streng Luau-typesjekk med Roblox API-definisjonene (luau-lsp, 20. november 2026). Typesjekken fanger feil i API-navn og feil typer, men ikke feil i spillogikken, så test alt i Studio før du publiserer.

Prøv RoCode i ditt eget spill.

Gratis credits hver dag, uten kort. Installer pluginen, beskriv en funksjon og se hva som dukker opp i Studio.