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
Actionpå waypointet erJump, og beregn en ny vei nårPath.Blockedutløses for et waypoint foran NPC-en. - Når spilleren er rett i synsfeltet, hopper du over pathfinding og gjør
MoveTorett mot spilleren. Stopp noen studs unna, eller gå helt inntil hvis NPC-en gjør skade ved berøring.
På denne siden
Slik fungerer NPC-pathfinding
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 | Hva 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.Blocked | Utløses med indeksen til et waypoint når noe sperrer den beregnede ruten. |
Humanoid:MoveTo(position) | Fører NPC-en mot et punkt. |
Humanoid.MoveToFinished | Utlø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.
| Krav | Hvorfor det er viktig |
|---|---|
En Humanoid med navnet Humanoid | MoveTo, WalkSpeed og hopping hører til Humanoid. |
HumanoidRootPart | Parten som Humanoid styrer. Veier starter fra posisjonen dens. |
| Ingenting er anchored | En 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. |
- Å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.
- Gi riggen navnet
Chaserog sett den på et åpent sted. - 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.
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.
- 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. - I Explorer holder du musepekeren over Chaser, trykker +-knappen og setter inn et Script. Gi det navnet
WalkToGoalog lim inn koden nedenfor. - Trykk Play. NPC-en går rundt veggen og frem til Goal-parten.
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.
| Nøkkel | Standard | Hva den bestemmer |
|---|---|---|
AgentRadius | 2 | NPC-ens radius i studs. Øk den for brede NPC-er slik at veiene holder seg lenger unna vegger. |
AgentHeight | 5 | NPC-ens høyde. Steder som er lavere enn dette, for eksempel under en trapp, regnes som sperret. |
AgentCanJump | true | Tillater ruter som krever et hopp. Slike waypoints har Action lik Jump. |
AgentCanClimb | false | Tillater klatring i TrussPart. Slike waypoints har merket Climb. |
WaypointSpacing | 4 | Avstanden i studs mellom mellomliggende waypoints. math.huge fjerner dem. |
Costs | ingen | Hvor 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.
- Slett
WalkToGoalfra Chaser hvis du la det til. - Hold musepekeren over Chaser, trykk +, sett inn et Script med navnet
ChaseAIog lim inn koden nedenfor. - 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.
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.
| Hva du ser | Årsak | Løsning |
|---|---|---|
| Jevnt når den er alene, og rykkvis når en spiller er i nærheten | Network 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 vegger | MoveTo 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ørner | En 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 sekundet | En 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å videre | MoveToFinished: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.
- I ChaseAI setter du
STOP_DISTANCEtil0, slik at NPC-en går helt inntil spillerne i stedet for å stoppe ved siden av dem. - Sett inn et Script med navnet
TouchDamagei Chaser og lim inn koden nedenfor.
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
- Dekk området med en part der Anchored er slått på og CanCollide er slått av.
- Sett inn en PathfindingModifier i den parten og sett
LabeltilDangerZone. - Det er alt. Jaktskriptet gir allerede
DangerZonekostnadenmath.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.
Egne overganger: PathfindingLink
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.
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.
- 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
- Roblox Creator Docs: Pathfinding (på engelsk). agentparametere, waypoints, sperrede veier, modifikatorer, lenker og begrensninger
- Roblox Creator Docs: PathfindingService (på engelsk). CreatePath og standardverdier
- Roblox Creator Docs: Path (på engelsk). ComputeAsync, GetWaypoints, Status og Blocked-hendelsen
- Roblox Creator Docs: Humanoid (på engelsk). MoveTo, tidsavbruddet på 8 sekunder for MoveToFinished, ChangeState og TakeDamage
- Roblox Creator Docs: Network ownership (på engelsk). automatisk eierskap, SetNetworkOwner og visningen Network owners
- Roblox Creator Docs: RaycastParams (på engelsk). ExcludeInstances og RespectCanCollide
- Roblox Creator Docs: NPC kit (på engelsk). NPC-eksempler med egne Animate-skript
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.