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
ActionerJump, og beregn en ny sti, nårPath.Blockedudløses for et waypoint foran NPC'en. - Når spilleren kan ses direkte, så spring pathfinding over, og lav
MoveTodirekte hen til spilleren. Stop nogle studs væk, eller gå helt hen, hvis NPC'en giver skade ved berøring.
På denne side
Sådan virker NPC-pathfinding
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 | Hvad 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.Blocked | Udløses med waypointets indeks, når noget spærrer den beregnede rute. |
Humanoid:MoveTo(position) | Fører NPC'en hen til et punkt. |
Humanoid.MoveToFinished | Udlø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.
| Krav | Hvorfor det er vigtigt |
|---|---|
Humanoid med navnet Humanoid | MoveTo, WalkSpeed og hop hører til Humanoid. |
HumanoidRootPart | Den part, Humanoid styrer. Stier starter fra dens position. |
| Intet er ankret | En 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. |
- Å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.
- Omdøb riggen til
Chaser, og stil den et åbent sted. - 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.
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.
- 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. - I Explorer holder du musen over Chaser, klikker på knappen + og indsætter et Script. Kald det
WalkToGoal, og indsæt koden nedenfor. - Tryk på Play. NPC'en går uden om væggen og hen til parten Goal.
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.
| Nøgle | Standard | Hvad den bestemmer |
|---|---|---|
AgentRadius | 2 | NPC'ens radius i studs. Hæv den for brede NPC'er, så stierne holder sig længere fra vægge. |
AgentHeight | 5 | NPC'ens højde. Steder lavere end dette, for eksempel under en trappe, regnes som spærret. |
AgentCanJump | true | Tillader ruter, der kræver et hop. Sådanne waypoints har Action sat til Jump. |
AgentCanClimb | false | Tillader klatring på TrussPart. Sådanne waypoints har mærket Climb. |
WaypointSpacing | 4 | Afstanden i studs mellem mellemliggende waypoints. math.huge fjerner dem. |
Costs | ingen | Hvor 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.
- Slet
WalkToGoalfra Chaser, hvis du har tilføjet det. - Hold musen over Chaser, klik på +, indsæt et Script med navnet
ChaseAI, og indsæt koden nedenfor. - 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.
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.
| Hvad du ser | Årsag | Løsning |
|---|---|---|
| Glat, når den er alene, og rykvis, når en spiller er i nærheden | Network 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ægge | MoveTo 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ørner | En 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 sekundet | En 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å videre | MoveToFinished: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.
- Sæt i ChaseAI
STOP_DISTANCEtil0, så NPC'en går helt ind i spillerne i stedet for at stoppe ved siden af. - Indsæt et Script med navnet
TouchDamagei Chaser, og indsæt 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 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
- Dæk området med en part med Anchored slået til og CanCollide slået fra.
- Indsæt en PathfindingModifier i den part, og sæt dens
LabeltilDangerZone. - Det er alt. Jagtscriptet giver allerede
DangerZoneomkostningenmath.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.
Egne overgange: PathfindingLink
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.
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.
- 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
- Roblox Creator Docs: Pathfinding (på engelsk). agentparametre, waypoints, spærrede stier, modifikatorer, links og begrænsninger
- Roblox Creator Docs: PathfindingService (på engelsk). CreatePath og standardværdier
- Roblox Creator Docs: Path (på engelsk). ComputeAsync, GetWaypoints, Status og eventet Blocked
- Roblox Creator Docs: Humanoid (på engelsk). MoveTo, timeouten på 8 sekunder for MoveToFinished, ChangeState og TakeDamage
- Roblox Creator Docs: Network ownership (på engelsk). automatisk ejerskab, SetNetworkOwner og visningen Network owners
- Roblox Creator Docs: RaycastParams (på engelsk). ExcludeInstances og RespectCanCollide
- Roblox Creator Docs: NPC kit (på engelsk). NPC-eksempler med deres egne Animate-scripts
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.