Tutorial · Spilsystemer

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

For at en NPC kan gå uden om vægge og nå den nærmeste spiller, skal der tre ting til: en rig, der kan bevæge sig, en rute fra PathfindingService og en løkke, der følger ruten uden at kæmpe med fysikmotoren. I denne guide bygger vi alle tre og ender med ét server-script, som du bare kan lægge i NPC'ens rig.

Opdateret 20. november 202615 min. læsningSkrevet af

Kort fortalt

Læg et Script inde i NPC-modellen. Opret en sti med PathfindingService:CreatePath(), beregn den med path:ComputeAsync(start, goal) inde i pcall, og gå derefter waypoints igennem ét ad gangen med Humanoid:MoveTo(), mens du venter på MoveToFinished før det næste. For at få NPC'en til at jagte en spiller vælger du den nærmeste karakter og beregner stien igen, når den har flyttet sig nogle studs, ikke hvert frame.

  • Der skal være en Humanoid og en HumanoidRootPart, der ikke er ankret. Kald SetNetworkOwner(nil) på root part, så serveren simulerer den: det er den almindelige løsning på en NPC, der hakker nær spillere.
  • Hop, når waypointets Action er Jump, og beregn en ny sti, når Path.Blocked udløses for et waypoint foran NPC'en.
  • Når spilleren kan ses direkte, så spring pathfinding over, og lav MoveTo direkte hen til spilleren. Stop nogle studs væk, eller gå helt hen, hvis NPC'en giver skade ved berøring.
På denne side
  1. Sådan virker pathfinding
  2. 1. Opsætning af NPC
  3. 2. Gå til et punkt
  4. 3. Jagtscript
  5. Sådan virker jagten
  6. Fjern hakken
  7. 4. Skade ved berøring
  8. Modifikatorer og links
  9. Common errors
  10. With RoCode
  11. Ofte stillede spørgsmål
  12. Kilder og videre læsning

Sådan virker NPC-pathfinding

IllustrationChaser finder vejen rundt om væggen, hopper op på afsatsen og stopper 4 studs fra dig.

Roblox bygger et navigationsnet (navigation mesh) ud fra de overflader, en karakter kan gå på. PathfindingService søger i dette net efter en rute mellem to punkter og returnerer den som en liste af waypoints: hvert har en position og en handling, for eksempel gå eller hop. Derefter går NPC'ens Humanoid fra ét waypoint til det næste. Pathfinding planlægger kun ruten: dit script skal selv flytte sig ad den.

API'er, som denne guide bruger
APIHvad den gør
PathfindingService:CreatePath()Opretter et Path-objekt, der kan bruges mange gange, tilpasset størrelsen på din NPC via agentparametrene.
Path:ComputeAsync(start, finish)Beregner ruten. Den yielder og kan fejle, så kald den inde i pcall, og tjek Path.Status.
Path:GetWaypoints()Returnerer ruten som et array af PathWaypoint-værdier, hver med Position, Action og Label.
Path.BlockedUdløses med waypointets indeks, når noget spærrer den beregnede rute.
Humanoid:MoveTo(position)Fører NPC'en hen til et punkt.
Humanoid.MoveToFinishedUdløses med true, når NPC'en når cirka en stud fra punktet, eller med false, hvis den ikke nåede frem inden for 8 sekunder.

Kør alt dette i et server-Script: serveren ser hele kortet, selv med streaming, alle spillere ser den samme NPC, og skaden afgøres der, hvor klienten ikke kan forfalske den. Script, LocalScript og ModuleScript forklarer den opdeling.

Trin 1: en NPC, der kan bevæge sig

Enhver model kan gå ad en sti, hvis den har de tre ting fra tabellen nedenfor. Rigs fra Toolbox eller gamle places mangler nogle gange noget, og det ser som regel sådan ud: NPC'en står stille, og der er ingen fejl.

Hvad NPC-modellen har brug for
KravHvorfor det er vigtigt
Humanoid med navnet HumanoidMoveTo, WalkSpeed og hop hører til Humanoid.
HumanoidRootPartDen part, Humanoid styrer. Stier starter fra dens position.
Intet er ankretEn ankret part kan ikke bevæge sig, og det kan de parts, der er samlet med den, heller ikke. Ankrede parts ejes altid af serveren, så løsningen på hakken, som beskrives nedenfor, kan ikke bruges på dem.
  1. Åbn fanen Avatar eller Home, og klik på Character for at åbne Rig Generator. Vælg R15 og derefter Block Avatar. En rig dukker op i Workspace. R6-rigs virker med de samme scripts.
  2. Omdøb riggen til Chaser, og stil den et åbent sted.
  3. Markér dens HumanoidRootPart, og tjek, at Anchored er slået fra i Properties-vinduet. Gør det samme for alle andre ankrede parts i modellen. For hurtigt at finde dem slår du Anchored parts til i widgetten Visualization Options øverst til højre i 3D-viewporten.
Explorer: NPC-modellen ved slutningen af denne guide
Workspace
  Chaser Model
    Humanoid Humanoid
    HumanoidRootPart Part
    Head, UpperTorso, LowerTorso ... (kropsdele)
    ChaseAI Script new
    TouchDamage Script new

For at NPC'en også kan tale, tilføjer guiden til NPC-dialog en Talk-prompt med svarmuligheder og forklarer, hvad der ændrer sig, når NPC'en går. For at vise en boss med kameraet, før den begynder jagten, så se cutscene-guiden.

Trin 2: send NPC'en hen til et punkt

Start med det mindste fungerende script: gå hen til en part, der står stille. Det viser hvert trin i pathfinding uden jagtlogik.

  1. Indsæt en Part i Workspace, kald den Goal, slå Anchored til, slå CanCollide fra, og stil den på gulvet, så NPC'en skal gå uden om en væg.
  2. I Explorer holder du musen over Chaser, klikker på knappen + og indsætter et Script. Kald det WalkToGoal, og indsæt koden nedenfor.
  3. Tryk på Play. NPC'en går uden om væggen og hen til parten Goal.
Script i modellen Chaser 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 skal eje NPC'ens fysik, ellers virker ChangeState (hop) fra et Script ikke
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 yielder og kan kaste en fejl, så den ligger inde i 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 waypoint er der, hvor 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 når dette waypoint, og gå først derefter videre til det næste
		local reached = humanoid.MoveToFinished:Wait()
		if not reached then
			warn(`{npc.Name} got stuck on the way to the goal`)
			break
		end
	end
end

Parten Goal har CanCollide slået fra, fordi en sti ikke kan slutte inde i en fast part: stiens Status ville være NoPath.

Tabellen, som CreatePath får, beskriver NPC'en (Roblox kalder den en agent), så ruten undgår åbninger, den ikke kan komme igennem. Scriptet ovenfor sætter de første tre nøgler til standardværdierne, så du kan se, hvor de ændres.

Agentparametre til CreatePath
NøgleStandardHvad den bestemmer
AgentRadius2NPC'ens radius i studs. Hæv den for brede NPC'er, så stierne holder sig længere fra vægge.
AgentHeight5NPC'ens højde. Steder lavere end dette, for eksempel under en trappe, regnes som spærret.
AgentCanJumptrueTillader ruter, der kræver et hop. Sådanne waypoints har Action sat til Jump.
AgentCanClimbfalseTillader klatring på TrussPart. Sådanne waypoints har mærket Climb.
WaypointSpacing4Afstanden i studs mellem mellemliggende waypoints. math.huge fjerner dem.
CostsingenHvor dyrt det er at krydse materialer og mærkede områder. Se modifikatorer og links.

To detaljer i løkken er vigtige. Det første waypoint er NPC'ens egen position, så løkken springer det over. Og efter hver MoveTo kommer MoveToFinished:Wait(): en ny MoveTo erstatter det forrige mål, så en løkke uden ventetid sender NPC'en direkte mod det sidste waypoint, ind i netop den væg, den skulle gå uden om.

Til hop er waypointets Action Jump, og scriptet kalder ChangeState(Enum.HumanoidStateType.Jumping). I Roblox-referencen for Humanoid står der, at et server-script kun kan ændre tilstanden, når serveren ejer karakterens fysik. Det er en af grundene til, at scriptet først sætter ejeren.

På Robloxs side om pathfinding flyttes spillerens egen karakter med Humanoid:Move() og et tjek af ankomst hvert frame, og det kaldes den bedste måde at føre en Humanoid ad en sti på. MoveTo med MoveToFinished er kortere og mere overskueligt for en NPC på serveren, så guiden bruger det; hvis du senere får brug for mere præcis kontrol, så studér det officielle script.

Trin 3: det fulde jagtscript

Det er det script, de fleste leder efter. NPC'en jagter den nærmeste spiller inden for 80 studs, går uden om vægge, hopper, hvor ruten kræver det, finder en ny rute, når noget spærrer den, og går hjem, når der ikke er nogen i nærheden.

  1. Slet WalkToGoal fra Chaser, hvis du har tilføjet det.
  2. Hold musen over Chaser, klik på +, indsæt et Script med navnet ChaseAI, og indsæt koden nedenfor.
  3. Tryk på Play, gå om bag en væg, og løb så uden for rækkevidde. NPC'en går uden om væggen efter dig og vender derefter tilbage, hvor den startede.
Script i modellen Chaser 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

-- Indstillinger (afstande i studs, tid i sekunder)
local DETECTION_RANGE = 80 -- spillere længere væk end dette bemærker NPC'en ikke
local STOP_DISTANCE = 4 -- stop på denne afstand fra målet (0 = gå helt hen, til skade ved berøring)
local DIRECT_CHASE_RANGE = 30 -- tættere end dette springer vi pathfinding over, hvis intet er i vejen
local REPATH_DISTANCE = 4 -- hvor meget målet skal flytte sig, før stien beregnes igen
local MIN_REPATH_INTERVAL = 0.5 -- beregn aldrig stier oftere end dette
local WAYPOINT_TIMEOUT = 2 -- opgiv stien, hvis ét waypoint tager længere end dette
local CHASE_SPEED = 14 -- en spiller går som standard med hastighed 16, så den kan løbe fra denne NPC
local HOME_RADIUS = 4 -- så tæt på hjemmet regnes allerede som hjemme
local RAY_HEIGHTS = { 0, -2 } -- stråler for direkte udsyn i hoftehøjde og nær knæene

local HOME = rootPart.Position -- hvor NPC'en vender tilbage, når der ikke er nogen inden for rækkevidde

humanoid.WalkSpeed = CHASE_SPEED

-- Lad serveren simulere NPC'en. Ellers kan Roblox give dens fysik til en spillers enhed
-- i nærheden, og NPC'en hakker, når ejeren 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å kun gennem vand for at undgå en stor omvej
		DangerZone = math.huge, -- gå aldrig ind i områder med mærket DangerZone
	},
})

-- Den sti, NPC'en går ad lige nu
local waypoints: { PathWaypoint } = {}
local nextIndex = 0
local pathGoal: Vector3? = nil
local pathBlocked = false
local lastComputeTime = -math.huge

-- Blocked kan udløses for et waypoint, NPC'en allerede har passeret. Kun en forhindring forude betyder noget.
path.Blocked:Connect(function(blockedIndex: number)
	if blockedIndex >= nextIndex then
		pathBlocked = true
	end
end)

local rayParams = RaycastParams.new()
rayParams.RespectCanCollide = true -- parts, som intet kolliderer med, spærrer ikke udsynet

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

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

-- HumanoidRootPart for den nærmeste levende spiller inden for 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å cirka samme niveau, og der ikke er noget fast imellem.
-- En fri stråle beviser ikke, at man kan gå på jorden, så det bruges kun på kort afstand.
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)
	-- Nulstil efter beregningen, så Blocked fra den gamle rute ikke markerer den nye
	pathBlocked = false
	if ok and path.Status == Enum.PathStatus.Success then
		waypoints = path:GetWaypoints()
		nextIndex = 2 -- waypoint 1 er der, hvor NPC'en står
		pathGoal = goal
	else
		if not ok then
			warn(`{npc.Name}: path request failed: {err}`)
		end
		clearPath() -- ingen rute endnu; hovedløkken prøver snart igen
	end
end

local function needsNewPath(goal: Vector3): boolean
	if os.clock() - lastComputeTime < MIN_REPATH_INTERVAL then
		return false -- lige beregnet: gå ad den nuværende sti
	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 giver op efter timeout sekunder i stedet for de indbyggede 8,
-- så en NPC, der sidder fast, hurtigt får en ny sti
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() -- sidder fast eller blev skubbet ud af kurs: beregn en ny sti
	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() -- tæt nok på: stå ved siden af målet
			task.wait(0.2)
			continue
		end
		if distance <= DIRECT_CHASE_RANGE and canSeeDirectly(targetRoot) then
			clearPath()
			-- Hvis du også sender en part med, følger NPC'en efter den, mens den bevæger sig
			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ærheden, 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 brugbar sti endnu, for eksempel er målet uopnåeligt
	end
end

Alle indstillinger er øverst. Til flere NPC'er duplikerer du Chaser: hver kopi kører sin egen ChaseAI og husker sit eget hjem. Gamle scripts filtrerer stråler med FilterDescendantsInstances; Roblox-referencen anbefaler nu ExcludeInstances til nyt arbejde, og dette script bruger netop den.

Sådan virker jagtscriptet

Hver gennemgang af hovedløkken træffer én beslutning og laver én lille handling: stå stille, gå direkte hen mod spilleren eller gå til næste waypoint. Intet afgøres for mere end ét waypoint ad gangen, så NPC'en reagerer hele tiden.

Find den nærmeste spiller

findNearestTarget gennemgår Players:GetPlayers(), springer alle over uden karakter, levende Humanoid eller HumanoidRootPart (spillere, der respawner eller går) og returnerer den nærmeste root part inden for DETECTION_RANGE. Søgningen sker ved hver gennemgang, så NPC'en skifter selv til en spiller, der er tættere på, og en spiller, der er gået, bliver bare ikke fundet mere: der er ingen tilstand pr. spiller at rydde op i.

Ny sti, mens spilleren bevæger sig, men ikke hvert frame

At beregne en sti yielder og bruger servertid. needsNewPath beder kun om en ny sti, når der ingen sti er, den gamle er slut eller spærret, eller spilleren er gået mere end REPATH_DISTANCE studs fra slutningen af den nuværende sti, og aldrig tidligere end MIN_REPATH_INTERVAL sekunder efter den forrige. Mens stien beregnes, fortsætter NPC'en mod det nuværende waypoint, og den nye sti gås fra waypoint 2, så NPC'en ikke vender om mod det sted, hvor stien startede.

Spærrede stier

Døre lukker, parts falder ned. Path.Blocked udløses med indekset for det spærrede waypoint, som kan ligge bag NPC'en, så scriptet reagerer kun ved blockedIndex >= nextIndex: det sætter et flag, og løkken beregner en ny rute. Et waypoint, som NPC'en er længere end WAYPOINT_TIMEOUT sekunder om at nå, fordi den blev skubbet eller hang fast, starter også en ny rute.

Direkte hen til en synlig spiller

Pathfinding er ikke nødvendig, når spilleren er synlig på åben plads. Inden for DIRECT_CHASE_RANGE sender funktionen canSeeDirectly to stråler mod spilleren, i hoftehøjde og nær knæene, for at opdage lave vægge, og ignorerer begge karakterer. Hvis ingen af strålerne rammer noget, og spilleren er på cirka samme niveau, kalder NPC'en MoveTo(targetRoot.Position, targetRoot). Det andet argument får målet til at bevæge sig med spilleren, og når kaldet gentages hvert 0.15 sekund, nulstilles timeouten på 8 sekunder hele tiden.

En fri stråle beviser, at der ikke er noget fast i vejen, men ikke at der er et gulv. Hvis kortet har huller eller skrænter mellem NPC'en og spillerne, så sænk DIRECT_CHASE_RANGE, eller sæt den til 0 for altid at bruge pathfinding.

Stop på den rigtige afstand

Når spilleren er tættere på end STOP_DISTANCE, kalder NPC'en MoveTo på sin egen position, og det stopper den. 4 studs passer til en NPC, der skal stå ved siden af spilleren; til et kæledyr eller en ledsager, der holder afstand, så sæt 6 eller 8. Til en fjende, der slår ved berøring, sætter du 0, så den går helt hen, som i trin 4.

Hvorfor NPC'en hakker, og hvordan du retter det

Hvis NPC'en hakker, fryser ved hvert waypoint eller går baglæns, er årsagen som regel et af punkterne nedenfor. Jagtscriptet tager allerede højde for hvert af dem; tabellen er til at rette et script, du selv har skrevet.

Hakken ved pathfinding: årsager og løsninger
Hvad du serÅrsagLøsning
Glat, når den er alene, og rykvis, når en spiller er i nærhedenNetwork ownership. Roblox giver fysikken for ikke-ankrede parts til en nærliggende spillers enhed, så NPC'en kan simuleres på den spillers enhed, mens serveren giver kommandoerne, og hver overdragelse kan ligne et ryk.Kald SetNetworkOwner(nil) én gang på HumanoidRootPart fra serveren. Det gælder alle parts, der er samlet med den.
Går direkte mod det sidste waypoint og ind i væggeMoveTo kaldes for hvert waypoint i en løkke uden ventetid. Hvert kald erstatter det forrige mål.Vent på MoveToFinished, før du går videre til næste waypoint.
Stopper kortvarigt ved hvert waypoint eller skærer hjørnerEn fast task.wait() mellem waypoints i stedet for at vente på ankomst. For længe, og NPC'en står stille; for kort, og den springer frem.Vent på MoveToFinished med en timeout.
Hakker eller går baglæns flere gange i sekundetEn ny sti hvert frame. Hver starter fra NPC'ens egen position, så stien til waypoint 1 vender den om.Beregn kun stien igen, når målet har flyttet sig nogle studs, højst to gange i sekundet, og start fra waypoint 2.
Fryser i nogle sekunder og går så videreMoveToFinished:Wait() på et uopnåeligt waypoint venter på timeouten på 8 sekunder.Brug din egen, kortere timeout, og beregn en ny sti, når den er udløbet.

For at se, hvem der ejer NPC'en, åbner du Visualization Options under en playtest og slår Network owners til. Parts, som din klient simulerer, får en grøn kant; parts, der ejes af serveren eller en anden klient, har en hvid eller grå kant.

Trin 4: skade på spillere ved berøring (valgfrit)

Til en fjende tilføjer du et andet script i NPC'en, der giver spillere skade ved berøring. Det kører på serveren, så spillerens klient kan ikke ændre skaden eller komme uden om cooldown.

  1. Sæt i ChaseAI STOP_DISTANCE til 0, så NPC'en går helt ind i spillerne i stedet for at stoppe ved siden af.
  2. Indsæt et Script med navnet TouchDamage i Chaser, og indsæt koden nedenfor.
Script i modellen Chaser 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 besejret NPC giver ingen 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 udløses mange gange 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 tager højde for force fields, så spillere er sikre, så længe force fieldet efter spawn varer. For at ignorere force fields sænker du Humanoid.Health direkte.

Cooldown gemmes separat for hver spiller. Touched udløses mange gange i sekundet, mens parts gnider mod hinanden, og uden cooldown kunne én berøring tømme spillerens liv på et øjeblik. Posten slettes, når dens spiller går, så tabellen vokser ikke hele tiden, mens serveren kører.

For at spillerne kan slå igen, så giv dem et sværd eller en pistol med raycast. Begge giver skade på serveren til alt, der har en Humanoid, så de rammer også Chaser.

Modifikatorer og links til pathfinding

Som standard er stien den korteste rute, hvor der så vidt muligt ikke er hop. Det kan ændres på tre måder. Omkostninger og modifikatorer virker med jagtscriptet, som det er, fordi det allerede sender en Costs-tabel til CreatePath; links kræver nogle linjer, du selv skriver.

Omkostninger for materialer

Nøgler i Costs kan være materialenavne, for eksempel Water, Mud eller CrackedLava, både for terræn og for parts. Som standard koster hvert materiale 1. Et højere tal får NPC'en til at gå uden om materialet, hvis omvejen ikke er værre, og math.huge gør det ufremkommeligt. Jagtscriptet sætter Water = 20.

Områder, der skal undgås: PathfindingModifier

  1. Dæk området med en part med Anchored slået til og CanCollide slået fra.
  2. Indsæt en PathfindingModifier i den part, og sæt dens Label til DangerZone.
  3. Det er alt. Jagtscriptet giver allerede DangerZone omkostningen math.huge, så NPC'en går uden om området. Slå Pathfinding modifiers til i Visualization Options for at se mærket på navigationsnettet.

En modifikator med PassThrough slået til gør det modsatte: ruten går gennem en fast forhindring, for eksempel en lukket dør, som om den ikke var der. NPC'en kan stadig ikke gå gennem døren, men går hen til den, som om den havde hørt spilleren på den anden side.

PathfindingLink forbinder to punkter, som NPC'en normalt ikke kan gå mellem, for eksempel bredderne af en flod, den krydser i en båd. Sæt en Attachment i hver ende, sæt linkets Attachment0 og Attachment1, giv det et Label, for eksempel UseBoat, og tilføj UseBoat i Costs med en lavere omkostning end Water. Så dukker der et waypoint med det mærke op i stien: tjek waypoint.Label i walkToNextWaypoint, og kør din egen handling, for eksempel at sætte NPC'en i båden, i stedet for MoveTo. Links virker begge veje, medmindre du slår IsBidirectional fra.

Almindelige fejl og løsninger

Tjek først Output-vinduet. Det åbnes fra menuen Window eller på fanen Script. Scripts på denne side skriver en advarsel, når en sti-forespørgsel fejlede, eller en rig ikke kan bevæge sig.

NPC'en bevæger sig slet ikke

Hvis Output skriver, at NPC'en ikke kan bevæge sig (cannot move), er en del af riggen ankret: fjern Anchored fra HumanoidRootPart og de andre parts. Hvis ikke, så tjek, at koden er i et Script og ikke i et LocalScript, at det ligger inde i modellen i Workspace, og at Humanoid ikke er død.

Output skriver "Infinite yield possible" ved WaitForChild

Scriptet venter på et objekt, der ikke findes: en Humanoid eller HumanoidRootPart med et andet navn eller en manglende part Goal til scriptet fra trin 2. Omdøb objektet eller linjen i scriptet. Guiden til script-fejl forklarer denne advarsel.

Stien bliver ikke bygget, eller NPC'en ignorerer en spiller, den kunne nå

Path.Status efter ComputeAsync er NoPath, når start eller slut er inde i en fast part, når den eneste rute kræver et hop, og AgentCanJump er false, eller når AgentHeight eller AgentRadius er for stor til en åbning på vejen. Robloxs dokumentation har også hårde grænser: højst 3,000 studs i lige linje fra start til slut og et søgebudget på 20,000 knuder, som kæmpe åbne verdener eller labyrinter måske ikke har nok af. Slå Navigation mesh til for at tjekke ruten.

NPC'en glider og bevæger ikke benene

Det er et animationsproblem, ikke pathfinding. Spillerkarakterer får automatisk et Animate-script, men en NPC har brug for sit eget script for at afspille gåanimationer. Hver NPC i Robloxs NPC kit har et Script med navnet Animate, som du kan studere. Hvordan du indlæser og afspiller en animation på en NPC fra et server-Script, kan du se i afsnittet animation på en NPC.

NPC'en sidder fast i hjørner eller hopper, men kommer ikke over forhindringen

Hæv AgentRadius, så ruterne holder sig længere fra vægge, især for brede NPC'er. Hvis den hopper, men aldrig kommer over, er forhindringen højere, end Humanoid kan hoppe: hæv JumpHeight eller JumpPower på Humanoid, eller ændr banen.

Skade ved berøring udløses for ofte eller aldrig

For ofte: der er ingen cooldown, eller den gemmes pr. part og ikke pr. spiller. Aldrig: STOP_DISTANCE er større end 0, så NPC'en stopper som regel, før den rører nogen, eller spilleren har stadig force fieldet efter spawn.

Byg det med RoCode

Hvis det er nemmere for dig at beskrive NPC'en end at bygge den i hånden, kan RoCode skrive disse scripts i det place, du har åbent. Det er en uafhængig AI-agent til Roblox Studio: du skriver i webchatten, og dens Studio-plugin opretter og redigerer scripts i din Explorer.

Du skriver

Få modellen Chaser i Workspace til at jagte den nærmeste spiller inden for 80 studs med pathfinding, gå hjem, når der ikke er nogen i nærheden, og give 10 skade ved berøring med en cooldown på 1 sekund.

RoCode gør
  • Kan først gennemse modellen med Get Properties og læse nøgleværdier, for eksempel Anchored på dens parts og WalkSpeed på Humanoid. Skriv / i chatten for at vedhæfte den præcise sti til modellen
  • Skriver jagt- og skadescripts inde i modellen med Create Script og kan fjerne Anchored med Set Property, hvis riggen har brug for det
  • Tjekker kompileringen af begge scripts med Check Script direkte i Studio. Det fanger kompileringsfejl og ting som wait() i stedet for task.wait(), men ikke logiske fejl som en rute, der aldrig når spilleren
  • Sender ændringerne i pakker, og hver pakke er et fortrydelsespunkt i Studios historik

Med plugin 3.9 eller nyere kan RoCode køre en kort playtest og læse fejlene, og med plugin 3.9.11 eller nyere kan den styre en testfigur for at tjekke, at spillet virker, men under spillet tager den ingen skærmbilleder, så tryk på Play, og se selv på NPC'en. Hvis den opfører sig forkert, så fortæl RoCode, hvad du så: Check Output kan læse Server- og Client-linjerne fra din seneste playtest. En NPC er ét system blandt mange; se, hvordan du bygger et helt Roblox-spil med AI: først en spilbar kerne, derefter runder. Sådan forbinder RoCode til Studio.

Ofte stillede spørgsmål

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

På serveren, i et Script. Robloxs eget pathfinding-eksempel kører i et LocalScript, men der flytter det spillerens egen karakter. En NPC er fælles for alle, og den skade, den giver, skal afgøres af serveren. Se Script, LocalScript og ModuleScript.

Hvor mange jagende NPC'er kan én server klare?

Robloxs dokumentation giver intet præcist tal; det afhænger af kortet og af, hvor ofte stier beregnes. Det dyreste er at beregne stier, så jagtscriptet begrænser det til to gange i sekundet pr. NPC og springer det over, når spilleren er synlig. Til mange NPC'er anbefaler Robloxs råd om, hvor scripts skal ligge, at mærke dem med tags og håndtere dem via CollectionService fra ét ModuleScript i stedet for at lægge et script i hver model.

Hvordan får jeg en NPC til at respawne efter død?

Gem en kopi af NPC'en i ServerStorage, og lav respawn fra et script i ServerScriptService, fordi et script inde i NPC'en destrueres sammen med den. Når Died-eventet på Humanoid udløses, så vent nogle sekunder, destruér den gamle model, og læg en Clone() af kopien i Workspace. ChaseAI-scriptet inde i klonen starter af sig selv, fordi server-scripts kører, så snart de er i Workspace.

Kan man få NPC'er til kun at jagte spillere under en runde?

Ja. Lad dit rundescript klone NPC'er til Workspace, når runden starter, og destruere dem, når den slutter. Guiden til rundesystemer bygger den løkke med pause og runde, som det kobles på.

Kilder og videre læsning

Sådan blev koden tjekket: hvert script på denne side gennemgår streng Luau-typekontrol med Roblox API-definitionerne (luau-lsp, 20. november 2026). Typekontrollen fanger fejl i API-navne og forkerte typer, men ikke fejl i spillogikken, så test alt i Studio, før du udgiver.

Prøv RoCode i dit eget spil.

Gratis credits hver dag, intet kort. Installér pluginet, beskriv en funktion, og se hvad der dukker op i Studio.