Tutoriaali · Pelijärjestelmät

NPC:n pathfinding Roblox Studiossa: miten NPC saadaan seuraamaan pelaajaa

Jotta NPC kiertää seinät ja pääsee lähimmän pelaajan luo, tarvitaan kolme asiaa: rigi, joka pystyy liikkumaan, reitti PathfindingService-palvelulta ja silmukka, joka kulkee reittiä riitelemättä fysiikkamoottorin kanssa. Tässä oppaassa kokoamme kaikki kolme, ja lopuksi saamme yhden palvelinskriptin, jonka voi yksinkertaisesti laittaa NPC:n rigiin.

Päivitetty 20. marraskuuta 202612 min lukuaikaKirjoittaja:

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 Action on Jump, ja laske uusi reitti, kun Path.Blocked laukeaa NPC:n edessä olevalle reittipisteelle.
  • Kun pelaaja näkyy suoraan, ohita pathfinding ja tee MoveTo suoraan häntä kohti. Pysähdy muutaman studin päähän tai mene kiinni asti, jos NPC tekee vahinkoa kosketuksella.
Tällä sivulla
  1. Miten pathfinding toimii
  2. 1. NPC:n asetukset
  3. 2. Kävely pisteeseen
  4. 3. Jahtausskripti
  5. Miten jahti toimii
  6. Nykimisen poisto
  7. 4. Kosketusvahinko
  8. Modifikaattorit ja linkit
  9. Common errors
  10. With RoCode
  11. Usein kysytyt kysymykset
  12. Lähteet ja lisälukemista

Miten NPC:n pathfinding toimii

HavainnollistusChaser löytää reitin seinän ympäri, hyppää ulokkeelle ja pysähtyy 4 studin päähän sinusta.

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:t, joita tämä opas käyttää
APIMitä 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.BlockedLaukeaa reittipisteen indeksillä, kun jokin tukkii lasketun reitin.
Humanoid:MoveTo(position)Kuljettaa NPC:n pisteeseen.
Humanoid.MoveToFinishedLaukeaa 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.

Mitä NPC-malli tarvitsee
VaatimusMiksi se on tärkeää
Humanoid nimeltä HumanoidMoveTo, WalkSpeed ja hypyt kuuluvat Humanoidille.
HumanoidRootPartPart, jota Humanoid ohjaa. Reitit alkavat sen sijainnista.
Mitään ei ole ankkuroituAnkkuroitu 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.
  1. 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ä.
  2. Nimeä rigi uudelleen nimellä Chaser ja aseta se avoimelle paikalle.
  3. 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.
Explorer: NPC-malli tämän oppaan lopussa
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.

  1. 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ä.
  2. Vie Explorerissa osoitin Chaserin päälle, paina +-painiketta ja lisää Script. Nimeä se WalkToGoal ja liitä alla oleva koodi.
  3. Paina Play. NPC kiertää seinän ja kävelee Goal-partin luo.
Script kohteessa Chaser-mallissa nimeltä WalkToGoal
local PathfindingService = game:GetService("PathfindingService")

local npc = script.Parent :: Model
local humanoid = npc:WaitForChild("Humanoid") :: Humanoid
local rootPart = npc:WaitForChild("HumanoidRootPart") :: BasePart
local goalPart = workspace:WaitForChild("Goal") :: BasePart

-- 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.

Agentin parametrit CreatePathille
AvainOletusMitä se määrää
AgentRadius2NPC:n säde studeina. Suurenna sitä leveille NPC:ille, jotta reitit pysyvät kauempana seinistä.
AgentHeight5NPC:n korkeus. Tätä matalammat paikat, esimerkiksi portaiden alla, lasketaan tukituiksi.
AgentCanJumptrueSallii reitit, joilla tarvitaan hyppy. Tällaisten reittipisteiden Action on Jump.
AgentCanClimbfalseSallii kiipeämisen TrussPartteja pitkin. Tällaisten reittipisteiden tunniste on Climb.
WaypointSpacing4Välireittipisteiden etäisyys studeina. math.huge poistaa ne.
Costsei mitäänKuinka 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.

  1. Poista WalkToGoal Chaserista, jos lisäsit sen.
  2. Vie osoitin Chaserin päälle, paina +, lisää Script nimeltä ChaseAI ja liitä alla oleva koodi.
  3. 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.
Script kohteessa Chaser-mallissa nimeltä ChaseAI
local Players = game:GetService("Players")
local PathfindingService = game:GetService("PathfindingService")

local npc = script.Parent :: Model
local humanoid = npc:WaitForChild("Humanoid") :: Humanoid
local rootPart = npc:WaitForChild("HumanoidRootPart") :: BasePart

-- 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.

Nykiminen pathfindingissa: syyt ja korjaukset
Mitä näetSyyKorjaus
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 seiniinMoveTo kutsutaan jokaiselle reittipisteelle silmukassa odottamatta. Jokainen kutsu korvaa edellisen kohteen.Odota MoveToFinished-tapahtumaa ennen siirtymistä seuraavaan reittipisteeseen.
Pysähtyy hetkeksi jokaiseen reittipisteeseen tai oikaisee kulmiaKiinteä 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 sekunnissaUusi 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 sittenMoveToFinished: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.

  1. Aseta ChaseAI:ssa STOP_DISTANCE arvoon 0, jotta NPC kulkee pelaajiin kiinni asti eikä pysähdy viereen.
  2. Lisää Chaseriin Script nimeltä TouchDamage ja liitä alla oleva koodi.
Script kohteessa Chaser-mallissa nimeltä TouchDamage
local Players = game:GetService("Players")

local npc = script.Parent :: Model
local humanoid = npc:WaitForChild("Humanoid") :: Humanoid

local DAMAGE = 10
local COOLDOWN_SECONDS = 1

local lastHit: { [Player]: number } = {}

local function onTouched(hit: BasePart)
	if humanoid.Health <= 0 then
		return -- 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

  1. Peitä alue partilla, jossa Anchored on päällä ja CanCollide pois päältä.
  2. Lisää tähän parttiin PathfindingModifier ja aseta sen Label arvoon DangerZone.
  3. Siinä kaikki. Jahtausskripti antaa jo DangerZone-tunnisteelle kustannuksen math.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.

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.

Sinä kirjoitat

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.

RoCode tekee
  • 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

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.

Kokeile RoCodea omassa pelissäsi.

Ilmaisia krediittejä joka päivä, ei korttia. Asenna lisäosa, kuvaile ominaisuus ja katso, mitä Studioon ilmestyi.