Tutorial · Sistem permainan

Pathfinding NPC dalam Roblox Studio: cara buat NPC mengejar pemain

Supaya NPC boleh mengelak dinding dan sampai kepada pemain terdekat, anda perlukan tiga perkara: rig yang boleh bergerak, laluan daripada PathfindingService dan gelung yang mengikut laluan itu tanpa bertelagah dengan enjin fizik. Dalam panduan ini kita bina ketiga-tiganya dan di penghujungnya mendapat satu skrip pelayan yang boleh terus diletakkan dalam rig NPC.

Dikemas kini 20 November 202614 minit bacaanDitulis oleh

Ringkasnya

Letakkan Script di dalam model NPC. Cipta laluan melalui PathfindingService:CreatePath(), kira laluan dengan path:ComputeAsync(start, goal) di dalam pcall, kemudian lalui waypoint satu demi satu dengan Humanoid:MoveTo(), menunggu MoveToFinished sebelum waypoint seterusnya. Supaya NPC mengejar pemain, pilih watak yang paling dekat dan kira semula laluan apabila watak itu bergerak beberapa stud, bukan pada setiap bingkai.

  • Anda perlukan Humanoid dan HumanoidRootPart yang tidak di-anchor. Panggil SetNetworkOwner(nil) pada root part supaya pelayan yang mensimulasinya: ini pembaikan biasa untuk NPC yang tersentak berhampiran pemain.
  • Lompat apabila Action waypoint ialah Jump, dan kira laluan baharu apabila Path.Blocked tercetus untuk waypoint di hadapan NPC.
  • Apabila pemain kelihatan secara langsung, langkau pathfinding dan buat MoveTo terus kepadanya. Berhenti beberapa stud jauhnya, atau datang rapat jika NPC menyebabkan kerosakan melalui sentuhan.
Di halaman ini
  1. Cara pathfinding berfungsi
  2. 1. Sediakan NPC
  3. 2. Berjalan ke titik
  4. 3. Skrip mengejar
  5. Cara mengejar berfungsi
  6. Hentikan tersentak
  7. 4. Kerosakan sentuhan
  8. Modifier dan link
  9. Common errors
  10. With RoCode
  11. Soalan lazim
  12. Sumber dan bacaan lanjut

Cara pathfinding NPC berfungsi

IlustrasiChaser mencari laluan mengelilingi dinding, melompat naik ke tebing dan berhenti 4 stud daripada anda.

Roblox membina jaringan navigasi (navigation mesh) daripada permukaan yang boleh dipijak oleh watak. PathfindingService mencari laluan antara dua titik pada jaringan ini dan memulangkannya sebagai senarai waypoint: setiap satu ada kedudukan dan tindakan, contohnya berjalan atau melompat. Kemudian Humanoid NPC berjalan dari satu waypoint ke waypoint seterusnya. Pathfinding hanya merancang laluan: skrip anda yang perlu menggerakkan NPC mengikutinya.

API yang digunakan dalam panduan ini
APIApa yang dilakukan
PathfindingService:CreatePath()Mencipta objek Path yang boleh digunakan berkali-kali, mengikut saiz NPC anda melalui parameter agen.
Path:ComputeAsync(start, finish)Mengira laluan. Ia menangguhkan pelaksanaan (yield) dan boleh gagal, jadi panggil di dalam pcall dan semak Path.Status.
Path:GetWaypoints()Memulangkan laluan sebagai tatasusunan nilai PathWaypoint, setiap satu ada Position, Action dan Label.
Path.BlockedTercetus dengan indeks waypoint apabila sesuatu menghalang laluan yang telah dikira.
Humanoid:MoveTo(position)Menggerakkan NPC ke satu titik.
Humanoid.MoveToFinishedTercetus dengan true apabila NPC sampai dalam lingkungan kira-kira satu stud daripada titik, atau dengan false jika ia tidak sampai dalam 8 saat.

Jalankan semua ini dalam Script pelayan: pelayan nampak seluruh peta walaupun dengan streaming, semua pemain nampak NPC yang sama, dan kerosakan diputuskan di tempat yang klien tidak boleh palsukan. Script, LocalScript dan ModuleScript menerangkan pembahagian ini.

Langkah 1: NPC yang boleh bergerak

Mana-mana model boleh berjalan mengikut laluan jika ia ada tiga perkara dalam jadual di bawah. Rig daripada Toolbox atau place lama kadang-kadang kekurangan sesuatu, dan biasanya ia kelihatan begini: NPC berdiri diam, tetapi tiada ralat.

Apa yang diperlukan oleh model NPC
KeperluanKenapa ia penting
Humanoid bernama HumanoidMoveTo, WalkSpeed dan lompatan milik Humanoid.
HumanoidRootPartPart yang dikawal oleh Humanoid. Laluan bermula dari kedudukannya.
Tiada apa-apa di-anchorPart yang di-anchor tidak boleh bergerak, begitu juga part yang disambungkan kepadanya. Part yang di-anchor sentiasa dimiliki pelayan, jadi pembaikan tersentak yang diterangkan di bawah tidak boleh digunakan padanya.
  1. Buka tab Avatar atau Home dan klik Character untuk membuka Rig Generator. Pilih R15, kemudian Block Avatar. Rig akan muncul dalam Workspace. Rig R6 berfungsi dengan skrip yang sama.
  2. Tukar nama rig kepada Chaser dan letakkan di kawasan lapang.
  3. Pilih HumanoidRootPartnya dan pastikan Anchored dalam tetingkap Properties dimatikan. Lakukan perkara yang sama untuk mana-mana part lain yang di-anchor dalam model. Untuk mencarinya dengan cepat, hidupkan Anchored parts dalam widget Visualization Options di penjuru kanan atas viewport 3D.
Explorer: model NPC di penghujung panduan ini
Workspace
  Chaser Model
    Humanoid Humanoid
    HumanoidRootPart Part
    Head, UpperTorso, LowerTorso ... (bahagian badan)
    ChaseAI Script new
    TouchDamage Script new

Supaya NPC juga boleh bercakap, panduan dialog NPC menambah gesaan Talk dengan pilihan jawapan dan menerangkan apa yang berubah apabila NPC berjalan. Untuk menunjukkan bos dengan kamera sebelum ia mula mengejar, lihat panduan cutscene.

Langkah 2: Hantar NPC ke satu titik

Mulakan dengan skrip berfungsi yang paling kecil: berjalan ke part yang tidak bergerak. Ia menunjukkan setiap peringkat pathfinding tanpa logik mengejar.

  1. Masukkan Part ke dalam Workspace, namakan Goal, hidupkan Anchored, matikan CanCollide dan letakkan di atas lantai supaya NPC terpaksa mengelilingi dinding.
  2. Dalam Explorer, halakan kursor pada Chaser, klik butang + dan masukkan Script. Namakan WalkToGoal dan tampal kod di bawah.
  3. Klik Play. NPC mengelilingi dinding dan berjalan ke part Goal.
Script dalam model Chaser bernama 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

-- Pelayan mesti memiliki fizik NPC, jika tidak ChangeState (lompat) daripada Script tidak akan berfungsi
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 menangguhkan pelaksanaan dan boleh melontar ralat, jadi ia di dalam 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 -- waypoint pertama ialah tempat NPC sudah berdiri
		end
		humanoid:MoveTo(waypoint.Position)
		if waypoint.Action == Enum.PathWaypointAction.Jump then
			humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
		end
		-- Tunggu sehingga NPC sampai ke waypoint ini, baru pergi ke yang seterusnya
		local reached = humanoid.MoveToFinished:Wait()
		if not reached then
			warn(`{npc.Name} got stuck on the way to the goal`)
			break
		end
	end
end

Part Goal mempunyai CanCollide dimatikan kerana laluan tidak boleh berakhir di dalam part pepejal: Status laluan akan menjadi NoPath.

Jadual yang diterima oleh CreatePath menerangkan NPC (Roblox memanggilnya agen), supaya laluan mengelak celah yang tidak muat untuknya. Skrip di atas menetapkan tiga kunci pertama kepada nilai lalai supaya anda nampak di mana hendak mengubahnya.

Parameter agen untuk CreatePath
KunciLalaiApa yang ditetapkan
AgentRadius2Jejari NPC dalam stud. Besarkan untuk NPC yang lebar supaya laluan menjauhi dinding.
AgentHeight5Ketinggian NPC. Tempat yang lebih rendah daripada ini, contohnya di bawah tangga, dianggap terhalang.
AgentCanJumptrueMembenarkan laluan yang memerlukan lompatan. Waypoint sebegini mempunyai Action bernilai Jump.
AgentCanClimbfalseMembenarkan memanjat TrussPart. Waypoint sebegini mempunyai label Climb.
WaypointSpacing4Jarak dalam stud antara waypoint perantaraan. math.huge membuangnya.
CoststiadaBetapa mahalnya melalui bahan dan kawasan yang dilabel. Lihat modifier dan link.

Dua butiran penting dalam gelung ini. Waypoint pertama ialah kedudukan NPC sendiri, jadi gelung melangkaunya. Dan selepas setiap MoveTo ada MoveToFinished:Wait(): MoveTo baharu menggantikan sasaran sebelumnya, jadi gelung tanpa menunggu menghantar NPC terus ke waypoint terakhir, ke dalam dinding yang sepatutnya dielakkannya.

Untuk lompatan, Action waypoint ialah Jump, dan skrip memanggil ChangeState(Enum.HumanoidStateType.Jumping). Rujukan Roblox untuk Humanoid menyatakan skrip pelayan hanya boleh mengubah keadaan apabila pelayan memiliki fizik watak. Ini salah satu sebab skrip menetapkan pemilik dahulu.

Pada halaman Roblox tentang pathfinding, watak pemain sendiri digerakkan melalui Humanoid:Move() dengan semakan ketibaan pada setiap bingkai, dan ini disebut sebagai cara terbaik menggerakkan Humanoid mengikut laluan. MoveTo dengan MoveToFinished lebih pendek dan lebih mudah difahami untuk NPC pelayan, jadi panduan ini menggunakannya; jika kemudian anda perlukan kawalan yang lebih tepat, kaji skrip rasmi itu.

Langkah 3: Skrip mengejar penuh

Inilah skrip yang dicari oleh kebanyakan orang. NPC mengejar pemain terdekat dalam lingkungan 80 stud, mengelak dinding, melompat di tempat yang diperlukan laluan, mencari laluan baharu apabila sesuatu menghalangnya, dan pulang ke rumah apabila tiada sesiapa berhampiran.

  1. Padam WalkToGoal daripada Chaser jika anda telah menambahnya.
  2. Halakan kursor pada Chaser, klik +, masukkan Script bernama ChaseAI dan tampal kod di bawah.
  3. Klik Play, pergi ke belakang dinding, kemudian lari keluar dari jarak pengesanan. NPC mengelilingi dinding mengejar anda, kemudian kembali ke tempat ia bermula.
Script dalam model Chaser bernama 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

-- Tetapan (jarak dalam stud, masa dalam saat)
local DETECTION_RANGE = 80 -- NPC tidak perasan pemain yang lebih jauh daripada ini
local STOP_DISTANCE = 4 -- berhenti pada jarak ini daripada sasaran (0 = datang rapat, untuk kerosakan sentuhan)
local DIRECT_CHASE_RANGE = 30 -- lebih dekat daripada ini, langkau pathfinding jika tiada halangan
local REPATH_DISTANCE = 4 -- sejauh mana sasaran mesti bergerak supaya laluan dikira semula
local MIN_REPATH_INTERVAL = 0.5 -- jangan sekali-kali kira laluan lebih kerap daripada ini
local WAYPOINT_TIMEOUT = 2 -- tinggalkan laluan jika satu waypoint mengambil masa lebih lama daripada ini
local CHASE_SPEED = 14 -- pemain lalai berjalan pada kelajuan 16, jadi boleh melarikan diri daripada NPC ini
local HOME_RADIUS = 4 -- sedekat ini dengan rumah sudah dikira di rumah
local RAY_HEIGHTS = { 0, -2 } -- sinar garis penglihatan pada paras pinggang dan dekat lutut

local HOME = rootPart.Position -- tempat NPC kembali apabila tiada sesiapa dalam jarak

humanoid.WalkSpeed = CHASE_SPEED

-- Biarkan pelayan mensimulasi NPC. Jika tidak, Roblox mungkin memberikan fiziknya kepada peranti
-- pemain berdekatan, dan NPC tersentak apabila pemiliknya bertukar.
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, -- melalui air hanya untuk mengelak lencongan yang jauh
		DangerZone = math.huge, -- jangan sekali-kali masuk kawasan berlabel DangerZone
	},
})

-- Laluan yang sedang diikuti NPC sekarang
local waypoints: { PathWaypoint } = {}
local nextIndex = 0
local pathGoal: Vector3? = nil
local pathBlocked = false
local lastComputeTime = -math.huge

-- Blocked boleh tercetus untuk waypoint yang sudah dilalui NPC. Hanya halangan di hadapan yang penting.
path.Blocked:Connect(function(blockedIndex: number)
	if blockedIndex >= nextIndex then
		pathBlocked = true
	end
end)

local rayParams = RaycastParams.new()
rayParams.RespectCanCollide = true -- part yang tidak berlanggar dengan apa-apa tidak menghalang penglihatan

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

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

-- HumanoidRootPart pemain hidup yang terdekat dalam DETECTION_RANGE, atau 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 apabila sasaran lebih kurang pada paras yang sama dan tiada apa-apa pepejal di antaranya.
-- Sinar yang bersih tidak membuktikan tanah boleh dilalui, jadi ini hanya untuk jarak dekat.
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)
	-- Set semula selepas pengiraan, supaya Blocked daripada laluan lama tidak menandakan laluan baharu
	pathBlocked = false
	if ok and path.Status == Enum.PathStatus.Success then
		waypoints = path:GetWaypoints()
		nextIndex = 2 -- waypoint 1 ialah tempat NPC berdiri
		pathGoal = goal
	else
		if not ok then
			warn(`{npc.Name}: path request failed: {err}`)
		end
		clearPath() -- belum ada laluan; gelung utama akan cuba lagi tidak lama lagi
	end
end

local function needsNewPath(goal: Vector3): boolean
	if os.clock() - lastComputeTime < MIN_REPATH_INTERVAL then
		return false -- baru sahaja dikira: teruskan mengikut laluan semasa
	end
	local currentGoal = pathGoal
	if currentGoal == nil or pathBlocked or nextIndex > #waypoints then
		return true
	end
	return (goal - currentGoal).Magnitude > REPATH_DISTANCE
end

-- Menunggu MoveToFinished, tetapi berputus asa selepas timeout saat dan bukan 8 saat terbina dalam,
-- supaya NPC yang tersekat cepat mendapat laluan baharu
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() -- tersekat atau ditolak keluar dari laluan: kira laluan baharu
	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() -- cukup dekat: berdiri di sebelah sasaran
			task.wait(0.2)
			continue
		end
		if distance <= DIRECT_CHASE_RANGE and canSeeDirectly(targetRoot) then
			clearPath()
			-- Jika part juga diberikan, NPC mengikutinya selagi ia bergerak
			humanoid:MoveTo(targetRoot.Position, targetRoot)
			task.wait(0.15)
			continue
		end
		goal = targetRoot.Position
	else
		if (HOME - rootPart.Position).Magnitude <= HOME_RADIUS then
			stopMoving() -- tiada sesiapa berhampiran, dan NPC sudah di rumah
			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) -- belum ada laluan yang berfungsi, contohnya sasaran tidak boleh dicapai
	end
end

Semua tetapan ada di bahagian atas. Untuk beberapa NPC, duplikasi Chaser: setiap salinan menjalankan ChaseAI sendiri dan mengingati rumah sendiri. Skrip lama menapis sinar melalui FilterDescendantsInstances; rujukan Roblox kini mengesyorkan ExcludeInstances untuk kerja baharu, dan skrip ini menggunakannya.

Cara skrip mengejar berfungsi

Setiap pusingan gelung utama membuat satu keputusan dan satu tindakan kecil: berdiri, melangkah terus ke arah pemain, atau berjalan ke waypoint seterusnya. Tiada keputusan yang melangkaui satu waypoint, jadi NPC sentiasa bertindak balas.

Mencari pemain terdekat

findNearestTarget melalui Players:GetPlayers(), melangkau sesiapa yang tiada watak, Humanoid yang hidup atau HumanoidRootPart (pemain yang sedang respawn atau keluar), dan memulangkan root part terdekat dalam DETECTION_RANGE. Carian berlaku pada setiap pusingan, jadi NPC bertukar sendiri kepada pemain yang lebih dekat, dan pemain yang keluar tidak lagi ditemui: tiada keadaan bagi setiap pemain yang perlu dibersihkan.

Mengira semula laluan semasa pemain bergerak, tetapi bukan setiap bingkai

Pengiraan laluan menangguhkan pelaksanaan dan menggunakan masa pelayan. needsNewPath meminta laluan baharu hanya apabila tiada laluan, laluan lama sudah habis atau terhalang, atau pemain telah bergerak lebih daripada REPATH_DISTANCE stud dari hujung laluan semasa, dan tidak sekali-kali lebih awal daripada MIN_REPATH_INTERVAL saat selepas yang sebelumnya. Semasa laluan dikira, NPC terus berjalan ke waypoint semasa, dan laluan baharu diikuti bermula dari waypoint 2, jadi NPC tidak berpusing ke tempat laluan itu bermula.

Laluan yang terhalang

Pintu tertutup, part jatuh. Path.Blocked tercetus dengan indeks waypoint yang terhalang, yang mungkin berada di belakang NPC, jadi skrip hanya bertindak balas apabila blockedIndex >= nextIndex: ia menetapkan bendera, dan gelung mengira laluan baharu. Waypoint yang mengambil masa lebih daripada WAYPOINT_TIMEOUT saat untuk dicapai, kerana NPC ditolak atau tersangkut, juga mencetuskan laluan baharu.

Terus ke arah pemain yang kelihatan

Pathfinding tidak diperlukan apabila pemain kelihatan di kawasan lapang. Dalam DIRECT_CHASE_RANGE, fungsi canSeeDirectly memancarkan dua sinar ke arah pemain, pada paras pinggang dan dekat lutut untuk mengesan dinding rendah, dan mengabaikan kedua-dua watak. Jika tiada sinar terkena apa-apa dan pemain lebih kurang pada paras yang sama, NPC memanggil MoveTo(targetRoot.Position, targetRoot). Argumen kedua membuatkan sasaran bergerak bersama pemain, dan memanggilnya semula setiap 0.15 saat sentiasa menetapkan semula had masa 8 saat.

Sinar yang bersih membuktikan tiada apa-apa pepejal di laluan, tetapi bukan bahawa ada lantai di situ. Jika peta anda ada jurang atau tebing curam antara NPC dan pemain, kecilkan DIRECT_CHASE_RANGE atau tetapkan 0 supaya sentiasa menggunakan pathfinding.

Berhenti pada jarak yang betul

Apabila pemain lebih dekat daripada STOP_DISTANCE, NPC memanggil MoveTo pada kedudukannya sendiri, dan ini menghentikannya. 4 stud sesuai untuk NPC yang perlu berdiri di sebelah pemain; untuk haiwan peliharaan atau pengiring yang menjaga jarak, tetapkan 6 atau 8. Untuk musuh yang menyerang melalui sentuhan, tetapkan 0 supaya ia datang rapat, seperti dalam langkah 4.

Kenapa NPC tersentak dan cara membaikinya

Jika NPC tersentak, terhenti pada setiap waypoint atau melangkah ke belakang, biasanya puncanya salah satu perkara di bawah. Skrip mengejar sudah mengambil kira setiap satunya; jadual ini untuk membaiki skrip yang anda tulis sendiri.

Tersentak semasa pathfinding: punca dan pembaikan
Apa yang anda nampakPuncaPembaikan
Lancar apabila bersendirian, tersentak-sentak apabila ada pemain berdekatanNetwork ownership. Roblox memberikan fizik part yang tidak di-anchor kepada peranti pemain berdekatan, jadi NPC mungkin disimulasi pada peranti pemain itu sementara arahan diberi oleh pelayan, dan setiap pertukaran boleh kelihatan seperti sentakan.Panggil SetNetworkOwner(nil) sekali pada HumanoidRootPart dari pelayan. Ini terpakai pada semua part yang disambungkan kepadanya.
Berjalan terus ke waypoint terakhir dan ke dalam dindingMoveTo dipanggil untuk setiap waypoint dalam gelung tanpa menunggu. Setiap panggilan menggantikan sasaran sebelumnya.Tunggu MoveToFinished sebelum beralih ke waypoint seterusnya.
Berhenti sekejap pada setiap waypoint atau memotong suduttask.wait() tetap antara waypoint dan bukannya menunggu ketibaan. Terlalu lama, NPC berdiri; terlalu singkat, ia melompat ke hadapan.Tunggu MoveToFinished dengan had masa.
Tersentak atau melangkah ke belakang beberapa kali sesaatLaluan baharu pada setiap bingkai. Setiap satu bermula dari kedudukan NPC sendiri, jadi laluan ke waypoint 1 memusingkannya ke belakang.Kira semula laluan hanya apabila sasaran bergerak beberapa stud, tidak lebih daripada dua kali sesaat, dan mulakan dari waypoint 2.
Terhenti beberapa saat, kemudian berjalan semulaMoveToFinished:Wait() pada waypoint yang tidak boleh dicapai menunggu had masa 8 saat.Gunakan had masa sendiri yang lebih pendek dan kira laluan baharu apabila ia tamat.

Untuk melihat siapa yang memiliki NPC, buka Visualization Options semasa playtest dan hidupkan Network owners. Part yang disimulasi oleh klien anda mendapat garis luar hijau; part pelayan atau klien lain bergaris luar putih atau kelabu.

Langkah 4: Kerosakan kepada pemain apabila disentuh (pilihan)

Untuk musuh, tambah skrip kedua pada NPC yang menyebabkan kerosakan kepada pemain apabila disentuh. Ia berjalan pada pelayan, jadi klien pemain tidak boleh mengubah kerosakan atau memintas cooldown.

  1. Dalam ChaseAI, tetapkan STOP_DISTANCE kepada 0 supaya NPC datang rapat kepada pemain dan bukannya berhenti di sebelah.
  2. Masukkan Script bernama TouchDamage ke dalam Chaser dan tampal kod di bawah.
Script dalam model Chaser bernama 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 -- NPC yang sudah tewas tidak menyebabkan kerosakan
	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 tercetus banyak kali sesaat selagi part bertindih
	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 mengambil kira medan daya (force field), jadi pemain selamat selagi medan daya selepas spawn masih aktif. Untuk mengabaikan medan daya, kurangkan Humanoid.Health secara terus.

Cooldown disimpan berasingan untuk setiap pemain. Touched tercetus banyak kali sesaat selagi part bergesel antara satu sama lain, dan tanpa cooldown satu sentuhan boleh menghabiskan nyawa pemain dalam sekelip mata. Rekod dipadam apabila pemiliknya keluar, jadi jadual tidak terus membesar sepanjang hayat pelayan.

Supaya pemain boleh melawan, beri mereka pedang atau senapang raycast. Kedua-duanya menyebabkan kerosakan pada pelayan kepada apa sahaja yang ada Humanoid, jadi Chaser juga akan terkena.

Modifier dan link pathfinding

Secara lalai, laluan ialah jalan terpendek yang sedapat mungkin tiada lompatan. Anda boleh mengubahnya dengan tiga cara. Kos dan modifier berfungsi dengan skrip mengejar seperti sedia ada, kerana ia sudah menghantar jadual Costs kepada CreatePath; link memerlukan beberapa baris anda sendiri.

Kos bahan

Kunci dalam Costs boleh berupa nama bahan, contohnya Water, Mud atau CrackedLava, untuk Terrain dan juga part. Secara lalai setiap bahan berkos 1. Nombor yang lebih besar membuatkan NPC mengelak bahan itu jika lencongan tidak lebih teruk, dan math.huge menjadikannya tidak boleh dilalui. Skrip mengejar menetapkan Water = 20.

Kawasan yang perlu dielak: PathfindingModifier

  1. Tutup kawasan itu dengan part yang Anchored dihidupkan dan CanCollide dimatikan.
  2. Masukkan PathfindingModifier ke dalam part itu dan tetapkan Labelnya kepada DangerZone.
  3. Itu sahaja. Skrip mengejar sudah memberi DangerZone kos math.huge, jadi NPC mengelak kawasan itu. Hidupkan Pathfinding modifiers dalam Visualization Options untuk melihat label pada jaringan navigasi.

Modifier dengan PassThrough dihidupkan melakukan sebaliknya: laluan menembusi halangan pepejal, contohnya pintu tertutup, seolah-olah ia tiada. NPC tetap tidak boleh melalui pintu, tetapi berjalan ke arahnya seolah-olah terdengar pemain di sebelah sana.

PathfindingLink menyambungkan dua titik yang biasanya tidak boleh dilalui NPC, contohnya tebing sungai yang diseberanginya dengan bot. Letakkan Attachment pada setiap hujung, tetapkan Attachment0 dan Attachment1 link, beri ia Label, contohnya UseBoat, dan tambah UseBoat ke dalam Costs dengan kos lebih rendah daripada Water. Kemudian laluan akan ada waypoint dengan label itu: semak waypoint.Label dalam walkToNextWaypoint dan jalankan tindakan anda sendiri, contohnya naikkan NPC ke dalam bot, dan bukannya MoveTo. Link berfungsi dua hala melainkan IsBidirectional dimatikan.

Ralat biasa dan cara membaikinya

Semak tetingkap Output dahulu. Ia dibuka daripada menu Window atau dalam tab Script. Skrip dalam halaman ini mencetak amaran apabila permintaan laluan gagal atau rig tidak boleh bergerak.

NPC langsung tidak bergerak

Jika Output menyatakan NPC tidak boleh bergerak (cannot move), sebahagian rig di-anchor: matikan Anchored pada HumanoidRootPart dan part lain. Jika tidak, semak bahawa kod berada dalam Script, bukan LocalScript, bahawa ia di dalam model dalam Workspace dan bahawa Humanoid belum mati.

Output menulis "Infinite yield possible" pada WaitForChild

Skrip sedang menunggu objek yang tiada: Humanoid atau HumanoidRootPart dengan nama lain, atau part Goal yang tiada untuk skrip langkah 2. Tukar nama objek atau baris dalam skrip. Panduan ralat skrip menerangkan amaran ini.

Laluan tidak dibina, atau NPC mengabaikan pemain yang sepatutnya boleh dicapai

Path.Status selepas ComputeAsync ialah NoPath apabila permulaan atau penghujung berada di dalam part pepejal, apabila satu-satunya laluan memerlukan lompatan tetapi AgentCanJump ialah false, atau apabila AgentHeight atau AgentRadius terlalu besar untuk celah di laluan. Dokumentasi Roblox juga ada had tetap: tidak lebih daripada 3,000 stud dalam garis lurus dari permulaan ke penghujung dan bajet carian 20,000 nod, yang mungkin tidak mencukupi untuk dunia terbuka yang sangat besar atau labirin. Hidupkan Navigation mesh untuk menyemak laluan.

NPC meluncur dan tidak menggerakkan kaki

Ini masalah animasi, bukan pathfinding. Watak pemain mendapat skrip Animate secara automatik, tetapi NPC perlukan skrip sendiri untuk memainkan animasi berjalan. Setiap NPC dalam NPC kit daripada Roblox ada Script bernama Animate yang boleh anda kaji. Cara memuatkan dan memainkan animasi pada NPC daripada Script pelayan, lihat bahagian animasi pada NPC.

NPC tersangkut di sudut atau melompat tetapi tidak dapat melepasi halangan

Besarkan AgentRadius supaya laluan menjauhi dinding, terutamanya untuk NPC yang lebar. Jika ia melompat tetapi tidak pernah berjaya melepasi, halangan itu lebih tinggi daripada lompatan Humanoid: besarkan JumpHeight atau JumpPower Humanoid atau ubah peringkat itu.

Kerosakan sentuhan berlaku terlalu kerap atau tidak pernah

Terlalu kerap: tiada cooldown, atau ia disimpan untuk setiap part dan bukan untuk setiap pemain. Tidak pernah: STOP_DISTANCE lebih besar daripada 0, jadi NPC biasanya berhenti sebelum menyentuh sesiapa, atau pemain masih ada medan daya selepas spawn.

Bina ini dengan RoCode

Jika lebih mudah bagi anda menerangkan NPC daripada membinanya dengan tangan, RoCode boleh menulis skrip ini dalam place yang sedang anda buka. Ia ejen AI bebas untuk Roblox Studio: anda menulis dalam chat web, dan plugin Studionya mencipta dan mengedit skrip dalam Explorer anda.

Anda tulis

Buat model Chaser dalam Workspace mengejar pemain terdekat dalam lingkungan 80 stud melalui pathfinding, pulang ke rumah apabila tiada sesiapa berhampiran, dan menyebabkan 10 kerosakan melalui sentuhan dengan cooldown 1 saat.

RoCode buat
  • Boleh meneliti model dahulu melalui Get Properties dan membaca nilai utama, contohnya Anchored pada part-partnya dan WalkSpeed Humanoid. Taip / dalam chat untuk melampirkan laluan tepat kepada model
  • Menulis skrip mengejar dan kerosakan di dalam model melalui Create Script, dan boleh mematikan Anchored melalui Set Property jika rig memerlukannya
  • Menyemak kompilasi kedua-dua skrip melalui Check Script terus dalam Studio. Ini menangkap ralat kompilasi dan perkara seperti wait() dan bukan task.wait(), tetapi bukan pepijat logik seperti laluan yang tidak pernah sampai kepada pemain
  • Menghantar perubahan secara berkelompok, dan setiap kelompok ialah satu titik undo dalam sejarah Studio

Dengan plugin 3.9 atau lebih baharu, RoCode boleh menjalankan playtest pendek dan membaca ralat, dan dengan plugin 3.9.11 atau lebih baharu ia boleh mengawal watak ujian untuk menyemak bahawa game berfungsi, tetapi ia tidak mengambil tangkapan skrin semasa permainan, jadi klik Play dan perhatikan NPC sendiri. Jika ia berkelakuan salah, beritahu RoCode apa yang anda nampak: Check Output boleh membaca baris Server dan Client daripada playtest terakhir anda. NPC ialah satu sistem antara banyak; lihat cara membina seluruh game Roblox dengan AI: teras yang boleh dimainkan dahulu, kemudian pusingan. Cara RoCode bersambung dengan Studio.

Soalan lazim

Di mana pathfinding NPC perlu dijalankan: pada pelayan atau klien?

Pada pelayan, dalam Script. Contoh pathfinding Roblox sendiri berjalan dalam LocalScript, tetapi di situ yang bergerak ialah watak pemain sendiri. NPC dikongsi oleh semua orang, dan kerosakan yang disebabkannya mesti diputuskan oleh pelayan. Lihat Script, LocalScript dan ModuleScript.

Berapa banyak NPC pengejar yang boleh ditampung satu pelayan?

Dokumentasi Roblox tidak memberi angka tepat; ia bergantung pada peta dan berapa kerap laluan dikira. Yang paling mahal ialah pengiraan laluan, jadi skrip mengejar mengehadkannya kepada dua kali sesaat bagi setiap NPC dan melangkaunya apabila pemain kelihatan. Untuk banyak NPC, cadangan Roblox tentang tempat menyimpan skrip menasihatkan supaya menandakannya dengan tag dan mengendalikannya melalui CollectionService daripada satu ModuleScript, bukan meletakkan skrip dalam setiap model.

Bagaimana buat NPC respawn selepas mati?

Simpan salinan NPC dalam ServerStorage, dan lakukan respawn daripada skrip dalam ServerScriptService, kerana skrip di dalam NPC dimusnahkan bersamanya. Apabila event Died Humanoid tercetus, tunggu beberapa saat, musnahkan model lama dan letakkan Clone() salinan itu ke dalam Workspace. Skrip ChaseAI di dalam klon akan bermula sendiri, kerana skrip pelayan berjalan sebaik sahaja ia berada dalam Workspace.

Bolehkah NPC mengejar pemain hanya semasa pusingan?

Boleh. Biarkan skrip pusingan anda mengklon NPC ke dalam Workspace apabila pusingan bermula dan memusnahkannya apabila pusingan tamat. Panduan sistem pusingan membina kitaran rehat dan pusingan yang boleh disambungkan dengan ini.

Sumber dan bacaan lanjut

Cara kod disemak: setiap skrip di halaman ini lulus semakan jenis Luau yang ketat dengan definisi API Roblox (luau-lsp, 20 November 2026). Semakan jenis mengesan kesilapan nama API dan jenis yang salah, tetapi bukan kesilapan logik permainan, jadi uji semuanya dalam Studio sebelum anda menerbitkannya.

Cuba RoCode dalam permainan anda.

Kredit percuma setiap hari, tanpa kad. Pasang plugin, terangkan ciri yang anda mahu dan semak hasilnya dalam Studio.