Lyhyesti
Laita Script NPC-mallin sisään. Luo reitti kutsulla PathfindingService:CreatePath(), laske se kutsulla path:ComputeAsync(start, goal) pcall-kutsun sisällä ja kulje sitten reittipisteet yksi kerrallaan kutsulla Humanoid:MoveTo() odottaen MoveToFinished-tapahtumaa ennen seuraavaa. Jotta NPC jahtaa pelaajaa, valitse lähin hahmo ja laske reitti uudelleen, kun hän on siirtynyt muutaman studin, eikä joka ruudunpäivityksellä.
- Tarvitaan Humanoid ja ankkuroimaton HumanoidRootPart. Kutsu root partille
SetNetworkOwner(nil), jotta palvelin simuloi sitä: se on tavallinen korjaus NPC:lle, joka nykii pelaajien lähellä. - Hyppää, kun reittipisteen
ActiononJump, ja laske uusi reitti, kunPath.Blockedlaukeaa NPC:n edessä olevalle reittipisteelle. - Kun pelaaja näkyy suoraan, ohita pathfinding ja tee
MoveTosuoraan häntä kohti. Pysähdy muutaman studin päähän tai mene kiinni asti, jos NPC tekee vahinkoa kosketuksella.
Tällä sivulla
Miten NPC:n pathfinding toimii
Roblox rakentaa navigointiverkon (navigation mesh) pinnoista, joilla hahmo voi kävellä. PathfindingService etsii tästä verkosta reitin kahden pisteen välille ja palauttaa sen luettelona reittipisteitä (waypoints): jokaisella on sijainti ja toiminto, esimerkiksi kävely tai hyppy. Sen jälkeen NPC:n Humanoid kävelee reittipisteestä seuraavaan. Pathfinding vain suunnittelee reitin: sitä pitkin liikuttaminen on skriptisi tehtävä.
| API | Mitä se tekee |
|---|---|
PathfindingService:CreatePath() | Luo uudelleenkäytettävän Path-objektin, joka mitoitetaan NPC:si kokoon agentin parametreilla. |
Path:ComputeAsync(start, finish) | Laskee reitin. Se luovuttaa suorituksen (yield) ja voi epäonnistua, joten kutsu sitä pcall-kutsun sisällä ja tarkista Path.Status. |
Path:GetWaypoints() | Palauttaa reitin PathWaypoint-arvojen taulukkona, ja jokaisella on Position, Action ja Label. |
Path.Blocked | Laukeaa reittipisteen indeksillä, kun jokin tukkii lasketun reitin. |
Humanoid:MoveTo(position) | Kuljettaa NPC:n pisteeseen. |
Humanoid.MoveToFinished | Laukeaa arvolla true, kun NPC tulee noin studin päähän pisteestä, tai arvolla false, jos se ei päässyt perille 8 sekunnissa. |
Aja kaikki tämä palvelimen Scriptissä: palvelin näkee koko kartan myös streamingin kanssa, kaikki pelaajat näkevät saman NPC:n, ja vahingosta päätetään paikassa, jossa asiakas ei voi väärentää sitä. Script, LocalScript ja ModuleScript selittää tämän jaon.
Vaihe 1: NPC, joka pystyy liikkumaan
Reittiä voi kulkea mikä tahansa malli, jos siinä on alla olevan taulukon kolme asiaa. Toolboxin tai vanhojen paikkojen rigeistä puuttuu joskus jotain, ja yleensä se näkyy näin: NPC seisoo paikallaan, eikä virhettä tule.
| Vaatimus | Miksi se on tärkeää |
|---|---|
Humanoid nimeltä Humanoid | MoveTo, WalkSpeed ja hypyt kuuluvat Humanoidille. |
HumanoidRootPart | Part, jota Humanoid ohjaa. Reitit alkavat sen sijainnista. |
| Mitään ei ole ankkuroitu | Ankkuroitu part ei voi liikkua, eivätkä sen kanssa yhdistetyt partit. Ankkuroidut partit ovat aina palvelimen omistamia, joten alla kuvattua nykimisen korjausta ei voi soveltaa niihin. |
- Avaa Avatar- tai Home-välilehti ja paina Character avataksesi Rig Generatorin. Valitse R15 ja sitten Block Avatar. Workspaceen ilmestyy rigi. R6-rigit toimivat samoilla skripteillä.
- Nimeä rigi uudelleen nimellä
Chaserja aseta se avoimelle paikalle. - Valitse sen HumanoidRootPart ja tarkista, että Anchored on Properties-ikkunassa pois päältä. Tee sama mallin kaikille muille ankkuroiduille parteille. Löytääksesi ne nopeasti ota käyttöön Anchored parts Visualization Options -widgetissä 3D-näkymän oikeassa yläkulmassa.
Workspace
Chaser Model
Humanoid Humanoid
HumanoidRootPart Part
Head, UpperTorso, LowerTorso ... (kehon osat)
ChaseAI Script new
TouchDamage Script new
Jotta NPC myös puhuu, NPC-dialogin opas lisää Talk-kehotteen vastausvaihtoehtoineen ja selittää, mikä muuttuu, kun NPC kävelee. Jos haluat näyttää pomon kameralla ennen kuin se aloittaa jahdin, katso välikohtausopas.
Vaihe 2: lähetetään NPC pisteeseen
Aloita pienimmästä toimivasta skriptistä: kävele paikallaan olevan partin luo. Se näyttää pathfindingin jokaisen vaiheen ilman jahtauslogiikkaa.
- Lisää Workspaceen Part, nimeä se
Goal, ota Anchored käyttöön, poista CanCollide käytöstä ja aseta se lattialle niin, että NPC:n on kierrettävä seinä. - Vie Explorerissa osoitin Chaserin päälle, paina +-painiketta ja lisää Script. Nimeä se
WalkToGoalja liitä alla oleva koodi. - Paina Play. NPC kiertää seinän ja kävelee Goal-partin luo.
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
-- Palvelimen on omistettava NPC:n fysiikka, muuten ChangeState (hyppy) ei toimi Scriptistä
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 luovuttaa suorituksen (yield) ja voi heittää virheen, joten se on pcallin sisällä
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 -- ensimmäinen reittipiste on paikka, jossa NPC jo seisoo
end
humanoid:MoveTo(waypoint.Position)
if waypoint.Action == Enum.PathWaypointAction.Jump then
humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
end
-- Odotetaan, että NPC saapuu tähän reittipisteeseen, ja vasta sitten mennään seuraavaan
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-partin CanCollide on pois päältä, koska reitti ei voi päättyä kiinteän partin sisään: reitin Status olisi NoPath.
Taulukko, jonka CreatePath saa, kuvaa NPC:n (Roblox kutsuu sitä agentiksi), jotta reitti välttää raot, joihin se ei mahdu. Yllä oleva skripti asettaa kolme ensimmäistä avainta oletusarvoihinsa, jotta näkyy, missä niitä muutetaan.
| Avain | Oletus | Mitä se määrää |
|---|---|---|
AgentRadius | 2 | NPC:n säde studeina. Suurenna sitä leveille NPC:ille, jotta reitit pysyvät kauempana seinistä. |
AgentHeight | 5 | NPC:n korkeus. Tätä matalammat paikat, esimerkiksi portaiden alla, lasketaan tukituiksi. |
AgentCanJump | true | Sallii reitit, joilla tarvitaan hyppy. Tällaisten reittipisteiden Action on Jump. |
AgentCanClimb | false | Sallii kiipeämisen TrussPartteja pitkin. Tällaisten reittipisteiden tunniste on Climb. |
WaypointSpacing | 4 | Välireittipisteiden etäisyys studeina. math.huge poistaa ne. |
Costs | ei mitään | Kuinka kallista materiaalien ja merkittyjen alueiden läpi kulkeminen on. Katso modifikaattorit ja linkit. |
Silmukassa kaksi yksityiskohtaa on tärkeitä. Ensimmäinen reittipiste on NPC:n oma sijainti, joten silmukka ohittaa sen. Ja jokaisen MoveTo-kutsun jälkeen tulee MoveToFinished:Wait(): uusi MoveTo korvaa edellisen kohteen, joten silmukka ilman odotusta lähettää NPC:n suoraan viimeiseen reittipisteeseen, juuri siihen seinään, joka sen pitäisi kiertää.
Hypyissä reittipisteen Action on Jump, ja skripti kutsuu ChangeState(Enum.HumanoidStateType.Jumping). Robloxin Humanoid-ohjeessa sanotaan, että palvelinskripti voi muuttaa tilaa vain, kun palvelin omistaa hahmon fysiikan. Tämä on yksi syy siihen, että skripti asettaa ensin omistajan.
Robloxin pathfinding-sivulla pelaajan omaa hahmoa liikutetaan kutsulla Humanoid:Move() ja perillepääsy tarkistetaan joka ruudunpäivityksellä, ja sitä kutsutaan parhaaksi tavaksi kuljettaa Humanoidia reittiä pitkin. MoveTo ja MoveToFinished ovat lyhyempiä ja selkeämpiä palvelimen NPC:lle, joten opas käyttää niitä; jos myöhemmin tarvitset tarkempaa ohjausta, tutki virallista skriptiä.
Vaihe 3: koko jahtausskripti
Tämä on skripti, jota useimmat etsivät. NPC jahtaa lähintä pelaajaa 80 studin säteellä, kiertää seinät, hyppää siellä, missä reitti sitä vaatii, löytää uuden reitin, kun jokin tukkii sen, ja palaa kotiin, kun lähellä ei ole ketään.
- Poista
WalkToGoalChaserista, jos lisäsit sen. - Vie osoitin Chaserin päälle, paina +, lisää Script nimeltä
ChaseAIja liitä alla oleva koodi. - Paina Play, mene seinän taakse ja juokse sitten kantaman ulkopuolelle. NPC kiertää seinän perässäsi ja palaa sitten sinne, mistä se lähti.
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
-- Asetukset (etäisyydet studeina, ajat sekunteina)
local DETECTION_RANGE = 80 -- tätä kauempana olevia pelaajia NPC ei huomaa
local STOP_DISTANCE = 4 -- pysähdy tälle etäisyydelle kohteesta (0 = mene kiinni, kosketusvahinkoa varten)
local DIRECT_CHASE_RANGE = 30 -- tätä lähempänä pathfinding ohitetaan, jos tiellä ei ole mitään
local REPATH_DISTANCE = 4 -- kuinka paljon kohteen on liikuttava, jotta reitti lasketaan uudelleen
local MIN_REPATH_INTERVAL = 0.5 -- älä koskaan laske reittejä tätä useammin
local WAYPOINT_TIMEOUT = 2 -- hylkää reitti, jos yksi reittipiste vie tätä kauemmin
local CHASE_SPEED = 14 -- pelaaja kävelee oletuksena nopeudella 16, joten hän pääsee tätä NPC:tä karkuun
local HOME_RADIUS = 4 -- näin lähellä kotia lasketaan jo kotona olemiseksi
local RAY_HEIGHTS = { 0, -2 } -- näköyhteyssäteet vyötärön korkeudella ja polvien tienoilla
local HOME = rootPart.Position -- minne NPC palaa, kun säteellä ei ole ketään
humanoid.WalkSpeed = CHASE_SPEED
-- Annetaan palvelimen simuloida NPC. Muuten Roblox voi antaa sen fysiikan lähellä olevan
-- pelaajan laitteelle, ja NPC nykii, kun omistaja vaihtuu.
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, -- kulje veden läpi vain välttääksesi ison kiertotien
DangerZone = math.huge, -- älä koskaan mene alueille, joilla on DangerZone-tunniste
},
})
-- Reitti, jota NPC kulkee juuri nyt
local waypoints: { PathWaypoint } = {}
local nextIndex = 0
local pathGoal: Vector3? = nil
local pathBlocked = false
local lastComputeTime = -math.huge
-- Blocked voi laueta reittipisteelle, jonka NPC on jo ohittanut. Vain edessä oleva este on tärkeä.
path.Blocked:Connect(function(blockedIndex: number)
if blockedIndex >= nextIndex then
pathBlocked = true
end
end)
local rayParams = RaycastParams.new()
rayParams.RespectCanCollide = true -- partit, joihin mikään ei törmää, eivät peitä näkyvyyttä
local function clearPath()
waypoints = {}
nextIndex = 0
pathGoal = nil
end
local function stopMoving()
clearPath()
humanoid:MoveTo(rootPart.Position)
end
-- Lähimmän elävän pelaajan HumanoidRootPart DETECTION_RANGE-etäisyyden sisällä tai 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, kun kohde on suunnilleen samalla tasolla eikä välissä ole mitään kiinteää.
-- Vapaa säde ei todista, että maata pitkin pääsee, joten tätä käytetään vain lyhyellä matkalla.
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)
-- Nollataan laskennan jälkeen, jotta vanhan reitin Blocked ei merkitse uutta
pathBlocked = false
if ok and path.Status == Enum.PathStatus.Success then
waypoints = path:GetWaypoints()
nextIndex = 2 -- reittipiste 1 on paikka, jossa NPC seisoo
pathGoal = goal
else
if not ok then
warn(`{npc.Name}: path request failed: {err}`)
end
clearPath() -- reittiä ei vielä ole; pääsilmukka yrittää pian uudelleen
end
end
local function needsNewPath(goal: Vector3): boolean
if os.clock() - lastComputeTime < MIN_REPATH_INTERVAL then
return false -- juuri laskettu: kuljetaan nykyistä reittiä
end
local currentGoal = pathGoal
if currentGoal == nil or pathBlocked or nextIndex > #waypoints then
return true
end
return (goal - currentGoal).Magnitude > REPATH_DISTANCE
end
-- Odottaa MoveToFinishediä, mutta luovuttaa timeout sekunnin jälkeen sisäänrakennetun 8:n sijaan,
-- jotta jumiin jäänyt NPC saa nopeasti uuden reitin
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() -- jäi jumiin tai tönäistiin pois reitiltä: lasketaan uusi reitti
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() -- tarpeeksi lähellä: seistään kohteen vieressä
task.wait(0.2)
continue
end
if distance <= DIRECT_CHASE_RANGE and canSeeDirectly(targetRoot) then
clearPath()
-- Kun annetaan myös part, NPC seuraa sitä sen liikkuessa
humanoid:MoveTo(targetRoot.Position, targetRoot)
task.wait(0.15)
continue
end
goal = targetRoot.Position
else
if (HOME - rootPart.Position).Magnitude <= HOME_RADIUS then
stopMoving() -- lähellä ei ole ketään, ja NPC on jo kotona
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) -- toimivaa reittiä ei vielä ole, esimerkiksi kohde on saavuttamattomissa
end
end
Kaikki asetukset ovat ylhäällä. Useampaa NPC:tä varten monista Chaser: jokainen kopio ajaa omaa ChaseAI:taan ja muistaa oman kotinsa. Vanhat skriptit suodattavat säteet FilterDescendantsInstances-ominaisuudella; Robloxin ohje suosittelee nyt uuteen työhön ExcludeInstances-ominaisuutta, ja tämä skripti käyttää juuri sitä.
Miten jahtausskripti toimii
Pääsilmukan jokainen kierros tekee yhden päätöksen ja yhden pienen toiminnon: seiso, astu suoraan pelaajaa kohti tai kulje seuraavaan reittipisteeseen. Mitään ei päätetä yhtä reittipistettä pidemmäksi ajaksi, joten NPC reagoi koko ajan.
Lähimmän pelaajan etsiminen
findNearestTarget käy läpi Players:GetPlayers()-listan, ohittaa kaikki, joilla ei ole hahmoa, elävää Humanoidia tai HumanoidRootPartia (pelaajat, jotka ovat syntymässä uudelleen tai poistumassa), ja palauttaa lähimmän root partin DETECTION_RANGE-etäisyyden sisällä. Haku tehdään joka kierroksella, joten NPC vaihtaa itse lähempään pelaajaan, ja poistunutta pelaajaa ei yksinkertaisesti enää löydy: pelaajakohtaista tilaa, joka pitäisi siivota, ei ole.
Reitin uudelleenlaskenta pelaajan liikkuessa, mutta ei joka ruudunpäivityksellä
Reitin laskenta luovuttaa suorituksen ja kuluttaa palvelimen aikaa. needsNewPath pyytää uutta reittiä vain, kun reittiä ei ole, vanha on päättynyt tai tukittu tai pelaaja on siirtynyt yli REPATH_DISTANCE studin päähän nykyisen reitin päästä, eikä koskaan aiemmin kuin MIN_REPATH_INTERVAL sekuntia edellisen jälkeen. Kun reittiä lasketaan, NPC jatkaa kulkua nykyiseen reittipisteeseen, ja uusi reitti kuljetaan reittipisteestä 2 alkaen, joten NPC ei käänny kohti paikkaa, josta reitti alkoi.
Tukitut reitit
Ovet sulkeutuvat, partit putoavat. Path.Blocked laukeaa tukitun reittipisteen indeksillä, joka voi olla NPC:n takana, joten skripti reagoi vain, kun blockedIndex >= nextIndex: se asettaa lipun, ja silmukka laskee uuden reitin. Myös reittipiste, jonne NPC kulkee pidempään kuin WAYPOINT_TIMEOUT sekuntia, koska sitä tönäistiin tai se tarttui johonkin, käynnistää uuden reitin.
Suoraan näkyvän pelaajan luo
Pathfindingia ei tarvita, kun pelaaja näkyy avoimella paikalla. DIRECT_CHASE_RANGE-etäisyyden sisällä funktio canSeeDirectly ampuu pelaajaa kohti kaksi sädettä, vyötärön korkeudella ja polvien tienoilla, jotta matalat seinät huomataan, ja ohittaa molemmat hahmot. Jos kumpikaan säde ei osu mihinkään ja pelaaja on suunnilleen samalla tasolla, NPC kutsuu MoveTo(targetRoot.Position, targetRoot). Toinen argumentti saa kohteen liikkumaan pelaajan mukana, ja kutsun toistaminen 0.15 sekunnin välein nollaa koko ajan 8 sekunnin aikakatkaisun.
Vapaa säde todistaa, ettei tiellä ole mitään kiinteää, mutta ei sitä, että siellä on lattia. Jos kartalla on NPC:n ja pelaajien välillä kuiluja tai jyrkänteitä, pienennä DIRECT_CHASE_RANGE-arvoa tai aseta se 0:ksi, jotta pathfindingia käytetään aina.
Pysähtyminen oikealle etäisyydelle
Kun pelaaja on lähempänä kuin STOP_DISTANCE, NPC kutsuu MoveTo-kutsua omaan sijaintiinsa, ja se pysäyttää sen. 4 studia sopii NPC:lle, jonka pitää seistä pelaajan vieressä; lemmikille tai saattajalle, joka pitää etäisyyttä, aseta 6 tai 8. Viholliselle, joka lyö kosketuksella, aseta 0, jotta se kulkee kiinni asti, kuten vaiheessa 4.
Miksi NPC nykii ja miten se korjataan
Jos NPC nykii, jähmettyy jokaiseen reittipisteeseen tai astuu taaksepäin, syy on yleensä jokin alla olevista. Jahtausskripti huomioi jo jokaisen niistä; taulukko on sitä varten, että voit korjata itse kirjoittamasi skriptin.
| Mitä näet | Syy | Korjaus |
|---|---|---|
| Sujuvaa yksin, nykivää, kun pelaaja on lähellä | Network ownership. Roblox antaa ankkuroimattomien parttien fysiikan lähellä olevan pelaajan laitteelle, joten NPC:tä voidaan simuloida tämän pelaajan laitteella samalla kun palvelin antaa käskyt, ja jokainen siirto voi näyttää nykäykseltä. | Kutsu kerran SetNetworkOwner(nil) HumanoidRootPartille palvelimelta. Se vaikuttaa kaikkiin siihen yhdistettyihin partteihin. |
| Kävelee suoraan viimeiseen reittipisteeseen ja seiniin | MoveTo kutsutaan jokaiselle reittipisteelle silmukassa odottamatta. Jokainen kutsu korvaa edellisen kohteen. | Odota MoveToFinished-tapahtumaa ennen siirtymistä seuraavaan reittipisteeseen. |
| Pysähtyy hetkeksi jokaiseen reittipisteeseen tai oikaisee kulmia | Kiinteä task.wait() reittipisteiden välillä perillepääsyn odottamisen sijaan. Liian pitkä, ja NPC seisoo; liian lyhyt, ja se hyppää eteenpäin. | Odota MoveToFinished-tapahtumaa aikakatkaisulla. |
| Nykii tai astuu taaksepäin useita kertoja sekunnissa | Uusi reitti joka ruudunpäivityksellä. Jokainen alkaa NPC:n omasta sijainnista, joten reitti reittipisteeseen 1 kääntää sen taaksepäin. | Laske reitti uudelleen vain, kun kohde on siirtynyt muutaman studin, enintään kahdesti sekunnissa, ja aloita reittipisteestä 2. |
| Jähmettyy muutamaksi sekunniksi ja jatkaa sitten | MoveToFinished:Wait() saavuttamattomassa reittipisteessä odottaa 8 sekunnin aikakatkaisun. | Käytä omaa, lyhyempää aikakatkaisua ja laske uusi reitti, kun se umpeutuu. |
Nähdäksesi, kuka NPC:n omistaa, avaa Visualization Options pelitestin aikana ja ota käyttöön Network owners. Partit, joita asiakkaasi simuloi, saavat vihreän ääriviivan; palvelimen tai toisen asiakkaan partit on ääriviivattu valkoisella tai harmaalla.
Vaihe 4: vahinko pelaajille kosketuksesta (valinnainen)
Viholliselle lisää NPC:hen toinen skripti, joka tekee vahinkoa pelaajille kosketuksesta. Se toimii palvelimella, joten pelaajan asiakas ei voi muuttaa vahinkoa tai ohittaa jäähdytysaikaa.
- Aseta ChaseAI:ssa
STOP_DISTANCEarvoon0, jotta NPC kulkee pelaajiin kiinni asti eikä pysähdy viereen. - Lisää Chaseriin Script nimeltä
TouchDamageja liitä alla oleva koodi.
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 -- kukistettu NPC ei tee vahinkoa
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 laukeaa monta kertaa sekunnissa, kun partit leikkaavat toisiaan
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 huomioi voimakentät, joten pelaajat ovat turvassa niin kauan kuin syntymisen jälkeinen voimakenttä on voimassa. Ohittaaksesi voimakentät pienennä Humanoid.Health-arvoa suoraan.
Jäähdytysaika tallennetaan erikseen jokaiselle pelaajalle. Touched laukeaa monta kertaa sekunnissa, kun partit hankaavat toisiaan, ja ilman jäähdytysaikaa yksi kosketus voisi nollata pelaajan terveyden hetkessä. Merkintä poistetaan, kun sen pelaaja poistuu, joten taulukko ei kasva koko palvelimen eliniän ajan.
Jotta pelaajat voivat puolustautua, anna heille miekka tai raycast-ase. Molemmat tekevät palvelimella vahinkoa kaikkeen, millä on Humanoid, joten ne osuvat myös Chaseriin.
Pathfindingin modifikaattorit ja linkit
Oletuksena reitti on lyhin reitti, jossa ei ole hyppyjä, jos mahdollista. Tätä voi muuttaa kolmella tavalla. Kustannukset ja modifikaattorit toimivat jahtausskriptin kanssa sellaisenaan, koska se antaa jo Costs-taulukon CreatePath-kutsulle; linkeille tarvitaan muutama oma rivi.
Materiaalien kustannukset
Costs-taulukon avaimina voivat olla materiaalien nimet, esimerkiksi Water, Mud tai CrackedLava, sekä terrainille että parteille. Oletuksena jokainen materiaali maksaa 1. Suurempi luku saa NPC:n kiertämään materiaalin, jos kiertotie ei ole huonompi, ja math.huge tekee siitä läpipääsemättömän. Jahtausskripti asettaa Water = 20.
Vältettävät alueet: PathfindingModifier
- Peitä alue partilla, jossa Anchored on päällä ja CanCollide pois päältä.
- Lisää tähän parttiin PathfindingModifier ja aseta sen
LabelarvoonDangerZone. - Siinä kaikki. Jahtausskripti antaa jo
DangerZone-tunnisteelle kustannuksenmath.huge, joten NPC kiertää tämän alueen. Ota Pathfinding modifiers käyttöön Visualization Optionsissa nähdäksesi tunnisteen navigointiverkossa.
Modifikaattori, jossa PassThrough on päällä, tekee päinvastoin: reitti kulkee kiinteän esteen, esimerkiksi suljetun oven, läpi kuin sitä ei olisi. NPC ei silti pääse oven läpi, mutta kulkee sitä kohti kuin olisi kuullut pelaajan toiselta puolelta.
Omat siirtymät: PathfindingLink
PathfindingLink yhdistää kaksi pistettä, joiden välillä NPC ei tavallisesti pääse kulkemaan, esimerkiksi joen rannat, jonka se ylittää veneellä. Aseta Attachment kumpaankin päähän, määritä linkille Attachment0 ja Attachment1, anna sille Label, esimerkiksi UseBoat, ja lisää UseBoat Costs-taulukkoon kustannuksella, joka on pienempi kuin Water-materiaalin. Silloin reitille ilmestyy reittipiste tällä tunnisteella: tarkista waypoint.Label funktiossa walkToNextWaypoint ja käynnistä oma toimintosi, esimerkiksi NPC:n nousu veneeseen, MoveTo-kutsun sijaan. Linkit toimivat molempiin suuntiin, ellei IsBidirectional ole pois päältä.
Yleiset virheet ja ratkaisut
Tarkista ensin Output-ikkuna. Se avataan Window-valikosta tai Script-välilehdeltä. Tämän sivun skriptit tulostavat varoituksen, kun reittipyyntö epäonnistui tai rigi ei pysty liikkumaan.
NPC ei liiku lainkaan
Jos Outputissa lukee, että NPC ei pysty liikkumaan (cannot move), osa rigistä on ankkuroitu: poista Anchored HumanoidRootPartista ja muista parteista. Jos ei, tarkista, että koodi on Scriptissä eikä LocalScriptissä, että se on Workspacessa olevan mallin sisällä ja että Humanoid ei ole kuollut.
Output kirjoittaa "Infinite yield possible" WaitForChildin kohdalla
Skripti odottaa objektia, jota ei ole: eri nimellä olevaa Humanoidia tai HumanoidRootPartia tai puuttuvaa Goal-partia vaiheen 2 skriptille. Nimeä objekti tai skriptin rivi uudelleen. Skriptivirheiden opas selittää tämän varoituksen.
Reittiä ei muodostu, tai NPC ei välitä pelaajasta, jonka luo se pääsisi
Path.Status on ComputeAsync-kutsun jälkeen NoPath, kun alku tai loppu on kiinteän partin sisällä, kun ainoa reitti vaatii hypyn ja AgentCanJump on false tai kun AgentHeight tai AgentRadius on liian suuri reitillä olevaan rakoon. Robloxin dokumentaatiossa on myös kovat rajat: enintään 3,000 studia linnuntietä alusta loppuun ja 20,000 solmun hakubudjetti, joka ei välttämättä riitä valtaville avoimille maailmoille tai labyrinteille. Ota Navigation mesh käyttöön tarkistaaksesi reitin.
NPC liukuu eikä liikuta jalkojaan
Tämä on animaatio-ongelma, ei pathfinding-ongelma. Pelaajien hahmot saavat Animate-skriptin automaattisesti, mutta NPC tarvitsee oman skriptin kävelyanimaatioiden toistamiseen. Robloxin NPC kitin jokaisessa NPC:ssä on Script nimeltä Animate, jota voi tutkia. Miten animaatio ladataan ja toistetaan NPC:llä palvelimen Scriptistä, katso osiosta animaatio NPC:llä.
NPC jää jumiin kulmiin tai hyppää mutta ei pääse esteen yli
Suurenna AgentRadius-arvoa, jotta reitit pysyvät kauempana seinistä, etenkin leveillä NPC:illä. Jos se hyppää mutta ei pääse yli, este on korkeampi kuin Humanoid pystyy hyppäämään: suurenna Humanoidin JumpHeight- tai JumpPower-arvoa tai muuta tasoa.
Kosketusvahinko laukeaa liian usein tai ei koskaan
Liian usein: jäähdytysaikaa ei ole, tai se tallennetaan partin eikä pelaajan mukaan. Ei koskaan: STOP_DISTANCE on suurempi kuin 0, joten NPC yleensä pysähtyy ennen kuin koskettaa ketään, tai pelaajalla on vielä syntymisen jälkeinen voimakenttä.
Rakenna tämä RoCodella
Jos sinun on helpompi kuvailla NPC kuin koota se käsin, RoCode voi kirjoittaa nämä skriptit paikkaan, joka sinulla on auki. Se on itsenäinen tekoälyagentti Roblox Studioon: kirjoitat verkkochatissa, ja sen Studio-lisäosa luo ja muokkaa skriptejä Explorerissasi.
Tee niin, että Workspacen Chaser-malli jahtaa lähintä pelaajaa 80 studin säteellä pathfindingin avulla, palaa kotiin, kun lähellä ei ole ketään, ja tekee kosketuksesta 10 vahinkoa 1 sekunnin jäähdytysajalla.
- Voi ensin tutkia mallin Get Properties -toiminnolla ja lukea tärkeät arvot, esimerkiksi sen parttien Anchored ja Humanoidin WalkSpeed. Kirjoita chattiin / liittääksesi tarkan polun malliin
- Kirjoittaa jahtaus- ja vahinkoskriptit mallin sisään Create Script -toiminnolla ja voi poistaa Anchoredin Set Property -toiminnolla, jos rigi sitä tarvitsee
- Tarkistaa molempien skriptien kääntymisen Check Script -toiminnolla suoraan Studiossa. Se löytää käännösvirheet ja asiat kuten wait() task.wait():n sijaan, mutta ei logiikkavirheitä, kuten reittiä, joka ei koskaan pääse pelaajan luo
- Lähettää muutokset erinä, ja jokainen erä on kumouspiste Studion historiassa
Lisäosalla 3.9 tai uudemmalla RoCode voi ajaa lyhyen pelitestin ja lukea virheet, ja lisäosalla 3.9.11 tai uudemmalla se voi ohjata testihahmoa tarkistaakseen, että peli toimii, mutta pelin aikana se ei ota kuvakaappauksia, joten paina Play ja katso NPC:tä itse. Jos se käyttäytyy väärin, kerro RoCodelle, mitä näit: Check Output voi lukea viimeisimmän pelitestisi Server- ja Client-rivit. NPC on yksi järjestelmä monista; katso, miten koko Roblox-peli rakennetaan tekoälyllä: ensin pelattava ydin, sitten kierrokset. Miten RoCode yhdistyy Studioon.
Usein kysytyt kysymykset
Missä NPC:n pathfinding ajetaan: palvelimella vai asiakkaalla?
Palvelimella, Scriptissä. Robloxin oma pathfinding-esimerkki toimii LocalScriptissä, mutta siinä liikkuu pelaajan oma hahmo. NPC on yhteinen kaikille, ja sen tekemästä vahingosta pitää päättää palvelimen. Katso Script, LocalScript ja ModuleScript.
Montako jahtaavaa NPC:tä yksi palvelin kestää?
Robloxin dokumentaatiossa ei ole tarkkaa lukua; se riippuu kartasta ja siitä, kuinka usein reittejä lasketaan. Kallein osa on reitin laskenta, joten jahtausskripti rajoittaa sen kahteen kertaan sekunnissa NPC:tä kohden ja ohittaa sen, kun pelaaja näkyy. Suurelle määrälle NPC:itä Robloxin suositukset skriptien sijoittamisesta neuvovat merkitsemään ne tageilla ja käsittelemään CollectionServicellä yhdestä ModuleScriptistä sen sijaan, että jokaiseen malliin laitettaisiin skripti.
Miten NPC saadaan syntymään uudelleen kuoltuaan?
Säilytä NPC:n kopio ServerStoragessa ja tee uudelleensyntyminen ServerScriptServicen skriptistä, koska NPC:n sisällä oleva skripti tuhoutuu sen mukana. Kun Humanoidin Died-tapahtuma laukeaa, odota muutama sekunti, tuhoa vanha malli ja laita kopion Clone() Workspaceen. Kloonin sisällä oleva ChaseAI-skripti käynnistyy itse, koska palvelinskriptit toimivat heti, kun ne ovat Workspacessa.
Voiko NPC:t saada jahtaamaan pelaajia vain kierroksen aikana?
Kyllä. Anna kierrosskriptisi kloonata NPC:t Workspaceen kierroksen alkaessa ja tuhota ne sen päättyessä. Kierrosjärjestelmän opas kokoaa tauon ja kierroksen silmukan, johon tämä kytketään.
Lähteet ja lisälukemista
- Roblox Creator Docs: Pathfinding (englanniksi). agentin parametrit, reittipisteet, tukitut reitit, modifikaattorit, linkit ja rajoitukset
- Roblox Creator Docs: PathfindingService (englanniksi). CreatePath ja oletusarvot
- Roblox Creator Docs: Path (englanniksi). ComputeAsync, GetWaypoints, Status ja Blocked-tapahtuma
- Roblox Creator Docs: Humanoid (englanniksi). MoveTo, MoveToFinishedin 8 sekunnin aikakatkaisu, ChangeState ja TakeDamage
- Roblox Creator Docs: Network ownership (englanniksi). automaattinen omistajuus, SetNetworkOwner ja Network owners -tila
- Roblox Creator Docs: RaycastParams (englanniksi). ExcludeInstances ja RespectCanCollide
- Roblox Creator Docs: NPC kit (englanniksi). NPC-esimerkit omine Animate-skripteineen
Miten koodi tarkistettiin: jokainen tämän sivun skripti läpäisee Luaun tiukan tyyppitarkistuksen Roblox API:n määrittelyillä (luau-lsp, 20. marraskuuta 2026). Tyyppitarkistus löytää virheet API-nimissä ja väärät tyypit, mutta ei pelilogiikan virheitä, joten testaa kaikki Studiossa ennen julkaisua.