Tutorial · Sistem game

Cara membuat NPC pathfinding di Roblox: NPC yang mengikuti dan mengejar pemain

NPC yang berjalan memutari dinding untuk mencapai pemain terdekat butuh tiga hal: rig yang bisa bergerak, rute dari PathfindingService, dan loop yang mengikuti rute itu tanpa melawan physics engine. Panduan ini membuat ketiganya dan diakhiri dengan satu script server yang bisa langsung kamu taruh di rig NPC.

Diperbarui 14 November 202614 menit bacaDitulis oleh

Singkatnya

Taruh Script di dalam model NPC. Buat path dengan PathfindingService:CreatePath(), hitung dengan path:ComputeAsync(start, goal) di dalam pcall, lalu jalankan waypoint satu per satu dengan Humanoid:MoveTo(), sambil menunggu MoveToFinished sebelum waypoint berikutnya. Untuk mengejar pemain, pilih karakter terdekat dan hitung ulang path saat pemain sudah berpindah beberapa stud, bukan setiap frame.

  • NPC butuh Humanoid dan HumanoidRootPart yang tidak di-anchor. Panggil SetNetworkOwner(nil) di root part supaya server yang mensimulasikannya: itu perbaikan biasa untuk NPC yang tersendat saat dekat pemain.
  • Lompat saat Action sebuah waypoint adalah Jump, dan hitung path baru saat Path.Blocked terpicu untuk waypoint di depan NPC.
  • Saat pemain terlihat jelas, lewati pathfinding dan MoveTo langsung ke pemain. Berhenti beberapa stud sebelumnya, atau terus maju kalau NPC memberi damage saat menyentuh.
Di halaman ini
  1. Cara kerja pathfinding
  2. 1. Siapkan NPC
  3. 2. Jalan ke titik
  4. 3. Script mengejar
  5. Cara kerja pengejaran
  6. Perbaiki NPC tersendat
  7. 4. Damage sentuh
  8. Modifier dan link
  9. Error umum
  10. Dengan RoCode
  11. Pertanyaan umum
  12. Sumber dan bacaan lanjutan

Cara kerja NPC pathfinding

IlustrasiChaser menemukan jalan memutari dinding, melompat naik ke pijakan dan berhenti 4 stud darimu.

Roblox membuat navigation mesh dari permukaan yang bisa diinjak karakter. PathfindingService mencari rute di mesh itu di antara dua titik dan mengembalikannya sebagai daftar waypoint, masing-masing berupa posisi plus aksi seperti berjalan atau melompat. Humanoid milik NPC lalu berjalan dari satu waypoint ke waypoint berikutnya. Pathfinding hanya merencanakan rutenya: bergerak di sepanjang rute itu adalah tugas script kamu.

API yang dipakai panduan ini
APIFungsinya
PathfindingService:CreatePath()Membuat objek Path yang bisa dipakai ulang, disesuaikan dengan ukuran NPC kamu lewat agent parameters.
Path:ComputeAsync(start, finish)Menghitung rutenya. Fungsi ini yield dan bisa gagal, jadi panggil di dalam pcall dan cek Path.Status.
Path:GetWaypoints()Mengembalikan rute sebagai array berisi nilai PathWaypoint, masing-masing dengan Position, Action dan Label.
Path.BlockedTerpicu dengan indeks waypoint saat sesuatu menghalangi rute yang sudah dihitung.
Humanoid:MoveTo(position)Menjalankan NPC ke arah sebuah titik.
Humanoid.MoveToFinishedTerpicu dengan true saat NPC sudah sekitar satu stud dari titik itu, atau false kalau NPC belum sampai setelah 8 detik.

Jalankan semua ini di Script server: server melihat seluruh map bahkan saat streaming menyala, setiap pemain melihat NPC yang sama, dan damage diputuskan di tempat yang tidak bisa dipalsukan client. Script vs LocalScript vs ModuleScript (dalam bahasa Inggris) menjelaskan pembagiannya.

Langkah 1: Siapkan NPC yang bisa bergerak

Model apa pun bisa mengikuti path asal punya tiga hal di bawah ini. Rig dari Toolbox atau dari place lama kadang tidak punya salah satunya, dan gejala biasanya adalah NPC yang diam saja tanpa error.

Yang dibutuhkan model NPC
SyaratKenapa penting
Humanoid bernama HumanoidMoveTo, WalkSpeed dan melompat semuanya milik Humanoid.
HumanoidRootPartPart yang digerakkan Humanoid. Path dimulai dari posisinya.
Tidak ada yang di-anchorPart yang di-anchor tidak bisa bergerak, begitu juga part yang tersambung ke part itu. Server selalu memiliki part yang di-anchor, jadi perbaikan tersendat di bawah tidak bisa dipakai untuk part itu.
  1. Buka tab Avatar atau Home dan klik Character untuk membuka Rig Generator. Pilih R15, lalu Block Avatar. Sebuah rig muncul di Workspace. Rig R6 juga jalan dengan script yang sama.
  2. Ganti nama rig menjadi Chaser dan pindahkan ke tanah yang lapang.
  3. Pilih HumanoidRootPart-nya dan cek bahwa Anchored mati di jendela Properties. Lakukan hal yang sama untuk part lain di model yang di-anchor. Untuk menemukannya dengan cepat, nyalakan Anchored parts di widget Visualization Options di kanan atas viewport 3D.
Explorer: model NPC di akhir panduan ini
Workspace
  Chaser Model
    Humanoid Humanoid
    HumanoidRootPart Part
    Head, UpperTorso, LowerTorso ... (the body parts)
    ChaseAI Script new
    TouchDamage Script new

Supaya NPC juga bisa bicara, panduan dialog NPC menambahkan prompt Talk dengan jawaban yang bisa dipilih, dan menjelaskan apa yang berubah saat NPC berjalan. Untuk memperlihatkan boss dengan kamera sebelum mulai mengejar, lihat panduan cutscene.

Langkah 2: Jalankan NPC ke sebuah titik

Mulai dengan script paling kecil yang berfungsi: berjalan ke sebuah part yang diam. Script ini memperlihatkan setiap tahap pathfinding tanpa logika mengejar.

  1. Sisipkan Part ke Workspace, beri nama Goal, nyalakan Anchored dan matikan CanCollide, lalu taruh di lantai di tempat NPC harus memutari dinding untuk mencapainya.
  2. Di Explorer, arahkan kursor ke Chaser, klik tombol + dan sisipkan Script. Beri nama WalkToGoal dan tempel kode di bawah.
  3. Tekan Play. NPC berjalan memutari dinding ke part Goal.
Script di 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

-- Server harus memiliki physics NPC supaya ChangeState (melompat) bisa jalan dari Script
local canSetOwner, ownerProblem = rootPart:CanSetNetworkOwnership()
if not canSetOwner then
	warn(`{npc.Name} cannot move: {ownerProblem}. Untick Anchored on every part of the rig.`)
	return
end
rootPart:SetNetworkOwner(nil)

local path = PathfindingService:CreatePath({
	AgentRadius = 2,
	AgentHeight = 5,
	AgentCanJump = true,
})

-- ComputeAsync melakukan yield dan bisa melempar error, jadi ditaruh 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 adalah tempat NPC sudah berdiri
		end
		humanoid:MoveTo(waypoint.Position)
		if waypoint.Action == Enum.PathWaypointAction.Jump then
			humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
		end
		-- Tunggu sampai waypoint ini tercapai sebelum pindah ke waypoint berikutnya
		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 punya CanCollide mati karena path tidak bisa berakhir di dalam part yang padat: Status path-nya akan menjadi NoPath.

Table yang diberikan ke CreatePath menggambarkan NPC, yang oleh Roblox disebut agent, supaya rutenya menghindari celah yang tidak muat untuknya. Script di atas mengisi tiga key pertama dengan nilai default-nya supaya kamu tahu di mana mengubahnya.

Agent parameters untuk CreatePath
KeyDefaultYang diatur
AgentRadius2Jari-jari NPC dalam stud. Naikkan untuk NPC yang lebar supaya path menjauh dari dinding.
AgentHeight5Tinggi NPC. Ruang yang lebih rendah dari ini, seperti di bawah tangga, dihitung terhalang.
AgentCanJumptrueMengizinkan rute yang butuh lompatan. Waypoint itu punya Action bernilai Jump.
AgentCanClimbfalseMengizinkan memanjat TrussPart. Waypoint itu punya label Climb.
WaypointSpacing4Jarak dalam stud di antara waypoint perantara. math.huge menghapusnya.
Coststidak adaSeberapa mahal material dan region berlabel untuk dilewati. Lihat modifier dan link.

Ada dua detail penting di loop itu. Waypoint pertama adalah posisi NPC sendiri, jadi loop melewatinya. Dan setiap MoveTo diikuti MoveToFinished:Wait(): MoveTo baru menggantikan tujuan sebelumnya, jadi loop yang tidak menunggu akan mengirim NPC lurus ke waypoint terakhir, menabrak dinding yang seharusnya diputarinya.

Untuk lompatan, Action waypoint-nya adalah Jump dan script memanggil ChangeState(Enum.HumanoidStateType.Jumping). Referensi Humanoid dari Roblox mencatat bahwa script server hanya bisa mengubah state saat server memiliki physics karakter itu, salah satu alasan script mengatur network owner lebih dulu.

Halaman pathfinding Roblox menggerakkan karakter milik pemain sendiri dengan Humanoid:Move() dan pengecekan sampai-tidaknya di setiap frame, dan menyebutnya cara terbaik untuk menggerakkan Humanoid di sepanjang path. MoveTo dengan MoveToFinished lebih pendek dan lebih mudah diikuti untuk NPC server, jadi panduan ini memakainya; pelajari script resminya kalau nanti kamu butuh kontrol yang lebih halus.

Langkah 3: Script mengejar lengkap

Ini script yang dicari kebanyakan orang. NPC mengejar pemain terdekat dalam jarak 80 stud, berjalan memutari dinding, melompat di tempat yang dibutuhkan rute, mencari rute baru saat ada yang menghalangi, dan berjalan pulang saat tidak ada siapa pun di dekatnya.

  1. Hapus WalkToGoal dari Chaser kalau kamu sudah menambahkannya.
  2. Arahkan kursor ke Chaser, klik +, sisipkan Script bernama ChaseAI dan tempel kode di bawah.
  3. Tekan Play, berjalan ke balik dinding, lalu lari keluar dari jangkauan. NPC mengikutimu memutari dinding, lalu kembali ke tempat awalnya.
Script di 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

-- Pengaturan (jarak dalam stud, waktu dalam detik)
local DETECTION_RANGE = 80 -- pemain yang lebih jauh dari ini diabaikan
local STOP_DISTANCE = 4 -- berhenti sedekat ini dari target (0 = menabrak target, untuk damage sentuh)
local DIRECT_CHASE_RANGE = 30 -- di dalam jarak ini, lewati pathfinding kalau tidak ada yang menghalangi
local REPATH_DISTANCE = 4 -- seberapa jauh target harus berpindah sebelum path dihitung ulang
local MIN_REPATH_INTERVAL = 0.5 -- jangan pernah menghitung path lebih sering dari ini
local WAYPOINT_TIMEOUT = 2 -- tinggalkan path kalau satu waypoint butuh waktu lebih lama dari ini
local CHASE_SPEED = 14 -- pemain berjalan dengan kecepatan 16 secara default, jadi mereka bisa kabur dari NPC ini
local HOME_RADIUS = 4 -- sedekat ini dari rumah dihitung sudah di rumah
local RAY_HEIGHTS = { 0, -2 } -- ray line of sight setinggi pinggang dan dekat lutut

local HOME = rootPart.Position -- tempat NPC kembali saat tidak ada siapa pun dalam jangkauan

humanoid.WalkSpeed = CHASE_SPEED

-- Biarkan server yang mensimulasikan NPC. Kalau tidak, Roblox bisa memberikan physics-nya ke
-- perangkat pemain di dekatnya, dan NPC tersendat setiap kali itu berpindah.
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, -- melewati air hanya untuk menghindari jalan memutar yang jauh
		DangerZone = math.huge, -- jangan pernah masuk ke region berlabel DangerZone
	},
})

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

-- Blocked bisa terpicu untuk waypoint yang sudah dilewati NPC. Hanya halangan di depan 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 bisa ditabrak apa pun tidak menghalangi pandangan

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

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

-- HumanoidRootPart milik pemain hidup 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 kalau target kira-kira di ketinggian yang sama dan tidak ada benda padat di antaranya.
-- Ray yang bersih tidak membuktikan tanahnya bisa diinjak, jadi ini hanya dipakai di 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)
	-- Reset setelah menghitung, supaya event Blocked dari rute lama tidak menandai rute baru
	pathBlocked = false
	if ok and path.Status == Enum.PathStatus.Success then
		waypoints = path:GetWaypoints()
		nextIndex = 2 -- waypoint 1 adalah tempat NPC berdiri
		pathGoal = goal
	else
		if not ok then
			warn(`{npc.Name}: path request failed: {err}`)
		end
		clearPath() -- belum ada rute; loop utama mencoba lagi sebentar lagi
	end
end

local function needsNewPath(goal: Vector3): boolean
	if os.clock() - lastComputeTime < MIN_REPATH_INTERVAL then
		return false -- baru saja dihitung: terus jalani path yang sekarang
	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, tapi menyerah setelah `timeout` detik, bukan 8 detik
-- bawaan, supaya NPC yang tersangkut cepat dapat path baru
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() -- tersangkut atau terdorong keluar jalur: hitung path baru
	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() -- sudah cukup dekat: tetap di samping target
			task.wait(0.2)
			continue
		end
		if distance <= DIRECT_CHASE_RANGE and canSeeDirectly(targetRoot) then
			clearPath()
			-- Memberikan part-nya juga membuat NPC mengikuti part itu saat 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() -- tidak ada siapa pun dan 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 path yang bisa dipakai, misalnya target tidak bisa dijangkau
	end
end

Semua pengaturan ada di bagian atas. Untuk NPC yang lebih banyak, duplikat Chaser: setiap salinan menjalankan ChaseAI-nya sendiri dan mengingat rumahnya sendiri. Script lama memfilter ray dengan FilterDescendantsInstances; referensi Roblox sekarang menyarankan ExcludeInstances untuk pekerjaan baru, dan itulah yang dipakai script ini.

Cara kerja script mengejar

Setiap putaran loop utama mengambil satu keputusan, lalu melakukan satu hal kecil: diam, melangkah lurus ke pemain, atau berjalan ke waypoint berikutnya. Tidak ada yang dijalankan lebih lama dari satu waypoint, jadi NPC terus bereaksi.

Mencari pemain terdekat

findNearestTarget memeriksa Players:GetPlayers() satu per satu, melewati siapa pun yang tidak punya karakter, Humanoid yang masih hidup atau HumanoidRootPart (pemain yang sedang respawn atau keluar), dan mengembalikan root part terdekat dalam DETECTION_RANGE. Pencarian berjalan di setiap putaran, jadi NPC berpindah sendiri ke pemain yang lebih dekat, dan pemain yang keluar tidak akan ditemukan lagi: tidak ada data per pemain yang perlu dibersihkan.

Menghitung ulang saat pemain bergerak, tanpa melakukannya setiap frame

Menghitung path melakukan yield dan memakan waktu server. needsNewPath hanya meminta path baru saat belum ada path, path lama sudah selesai atau terhalang, atau pemain sudah berpindah lebih dari REPATH_DISTANCE stud dari ujung path yang sekarang, dan tidak pernah dalam MIN_REPATH_INTERVAL detik setelah path terakhir. Selama menghitung, NPC tetap berjalan ke waypoint-nya yang sekarang, dan path baru diikuti mulai dari waypoint 2, jadi NPC tidak berbalik ke titik awal path.

Path yang terhalang

Pintu tertutup dan part jatuh. Path.Blocked terpicu dengan indeks waypoint yang terhalang, yang mungkin ada di belakang NPC, jadi script hanya bereaksi saat blockedIndex >= nextIndex: script memasang flag dan loop menghitung rute baru. Waypoint yang butuh lebih dari WAYPOINT_TIMEOUT detik untuk dicapai, karena NPC terdorong atau tersangkut, juga memicu rute baru.

Langsung ke pemain yang terlihat

Pathfinding sia-sia saat pemain terlihat jelas di tanah lapang. Di dalam DIRECT_CHASE_RANGE, canSeeDirectly menembakkan dua ray ke pemain, setinggi pinggang dan dekat lutut untuk menangkap dinding rendah, dengan mengabaikan kedua karakter. Kalau tidak ada yang kena dan pemain kira-kira di ketinggian yang sama, NPC memanggil MoveTo(targetRoot.Position, targetRoot). Argumen kedua membuat tujuannya ikut bergerak bersama pemain, dan mengulang panggilan setiap 0,15 detik terus mereset timeout 8 detik.

Ray yang bersih membuktikan tidak ada benda padat yang menghalangi, bukan bahwa ada lantai untuk diinjak. Kalau map kamu punya celah atau jurang di antara NPC dan pemain, turunkan DIRECT_CHASE_RANGE, atau isi 0 supaya selalu memakai pathfinding.

Berhenti di jarak yang tepat

Saat pemain berada dalam STOP_DISTANCE, NPC memanggil MoveTo ke posisinya sendiri, yang membuatnya berhenti. 4 stud cocok untuk NPC yang harus berdiri di samping pemain; naikkan ke 6 atau 8 untuk pet atau pengawal yang menjaga jarak. Untuk musuh yang melukai saat menyentuh, isi 0 supaya NPC menabrak pemain, seperti di Langkah 4.

Kenapa NPC tersendat, dan cara memperbaikinya

NPC yang tersentak, berhenti di setiap waypoint atau berkedut mundur biasanya punya salah satu penyebab di bawah. Script mengejar sudah menangani semuanya; tabel ini untuk memperbaiki script yang kamu tulis sendiri.

Pathfinding tersendat: penyebab dan perbaikannya
Yang kamu lihatPenyebabPerbaikan
Mulus saat sendirian, tersentak begitu ada pemain yang dekatNetwork ownership. Roblox memberikan physics part yang tidak di-anchor ke perangkat pemain di dekatnya, jadi NPC bisa jadi disimulasikan di perangkat pemain itu sementara server yang memberi perintah, dan setiap perpindahan bisa terlihat sebagai sendatan.Panggil SetNetworkOwner(nil) di HumanoidRootPart sekali, dari server. Ini berlaku untuk setiap part yang tersambung dengannya.
Berjalan lurus ke waypoint terakhir dan menabrak dindingMoveTo dipanggil untuk setiap waypoint di dalam loop tanpa menunggu. Setiap panggilan menggantikan tujuan sebelumnya.Tunggu MoveToFinished sebelum pindah ke waypoint berikutnya.
Berhenti sebentar di setiap waypoint, atau memotong tikungantask.wait() dengan waktu tetap di antara waypoint, bukan menunggu sampai tiba. Terlalu lama dan NPC diam; terlalu singkat dan NPC melompati waypoint.Tunggu MoveToFinished, dengan timeout.
Berkedut atau melangkah mundur beberapa kali per detikPath baru setiap frame. Setiap path dimulai di posisi NPC sendiri, jadi berjalan ke waypoint 1 membuatnya berbalik.Hitung ulang hanya saat target sudah berpindah beberapa stud, paling banyak dua kali per detik, dan mulai dari waypoint 2.
Membeku beberapa detik, lalu jalan lagiMoveToFinished:Wait() di waypoint yang tidak bisa dicapai menunggu sampai timeout 8 detik.Pakai timeout sendiri yang lebih singkat dan hitung path baru saat waktunya habis.

Untuk melihat siapa pemilik NPC, buka Visualization Options saat playtest dan nyalakan Network owners. Part yang disimulasikan client kamu mendapat garis tepi hijau; part milik server atau client lain diberi garis tepi putih atau abu-abu.

Langkah 4: Beri damage ke pemain saat bersentuhan (opsional)

Untuk musuh, tambahkan script kedua ke NPC yang memberi damage ke pemain yang disentuhnya. Script ini berjalan di server, jadi client pemain tidak bisa mengubah jumlah damage atau melewati cooldown.

  1. Di ChaseAI, ubah STOP_DISTANCE menjadi 0 supaya NPC menabrak pemain, bukan berhenti di sampingnya.
  2. Sisipkan Script bernama TouchDamage ke Chaser dan tempel kode di bawah.
Script di 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 kalah tidak memberi damage
	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 terpicu berkali-kali per detik selama part saling bertumpuk
	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 menghormati force field, jadi pemain aman selama force field spawn mereka masih ada. Untuk mengabaikan force field, kurangi Humanoid.Health secara langsung.

Cooldown-nya disimpan per pemain. Touched terpicu berkali-kali per detik selama part saling bergesekan, dan tanpa cooldown satu senggolan bisa menghabiskan health pemain dalam sekejap. Setiap entri dihapus saat pemainnya keluar, jadi table-nya tidak terus membesar selama server hidup.

Supaya pemain bisa melawan, beri mereka pedang atau raycast gun (dalam bahasa Inggris). Keduanya memberi damage di server ke apa pun yang punya Humanoid, jadi keduanya juga mengenai Chaser.

Modifier dan link pathfinding

Secara default path adalah rute terpendek, yang menghindari lompatan kalau bisa. Ada tiga alat yang mengubahnya. Costs dan modifier langsung jalan dengan script mengejar apa adanya, karena script itu sudah memberikan table Costs ke CreatePath; link butuh beberapa baris tambahan buatanmu sendiri.

Biaya material

Key di Costs bisa berupa nama material seperti Water, Mud atau CrackedLava, untuk terrain maupun part. Setiap material punya biaya 1 secara default. Angka yang lebih tinggi membuat NPC menghindari material itu kecuali jalan memutarnya lebih buruk, dan math.huge membuatnya tidak bisa dilewati. Script mengejar mengisi Water = 20.

Region yang dihindari: PathfindingModifier

  1. Tutupi area itu dengan sebuah part, dengan Anchored menyala dan CanCollide mati.
  2. Sisipkan PathfindingModifier ke part itu dan isi Label-nya dengan DangerZone.
  3. Sudah. Script mengejar sudah memberi DangerZone biaya math.huge, jadi NPC mengambil rute memutari area itu. Nyalakan Pathfinding modifiers di Visualization Options untuk melihat label-nya di navigation mesh.

Modifier dengan PassThrough menyala melakukan kebalikannya: rute melewati rintangan padat, seperti pintu yang tertutup, seolah rintangan itu tidak ada. NPC tetap tidak bisa berjalan menembus pintu, tapi NPC menuju ke sana, seolah mendengar pemain di baliknya.

PathfindingLink menghubungkan dua titik yang biasanya tidak bisa dilalui NPC, seperti dua tepi sungai yang diseberangi dengan perahu. Taruh Attachment di setiap ujung, atur Attachment0 dan Attachment1 milik link, beri Label seperti UseBoat, dan tambahkan UseBoat ke Costs dengan biaya lebih rendah dari Water. Path lalu berisi waypoint dengan label itu: cek waypoint.Label di walkToNextWaypoint dan jalankan aksi buatanmu sendiri, seperti mendudukkan NPC di perahu, alih-alih MoveTo. Link berlaku dua arah kecuali kamu mematikan IsBidirectional.

Error umum dan cara memperbaikinya

Cek jendela Output dulu. Buka dari menu Window atau tab Script. Script di halaman ini mencetak peringatan saat permintaan path gagal atau rig tidak bisa bergerak.

NPC tidak bergerak sama sekali

Kalau Output bilang NPC tidak bisa bergerak, ada bagian rig yang di-anchor: hilangkan centang Anchored di HumanoidRootPart dan part lainnya. Kalau bukan itu, cek bahwa kodenya ada di Script, bukan LocalScript, bahwa script ada di dalam model di Workspace, dan bahwa Humanoid-nya belum mati.

Output menampilkan "Infinite yield possible" di WaitForChild

Script sedang menunggu objek yang tidak ada: Humanoid atau HumanoidRootPart dengan nama lain, atau tidak ada part bernama Goal untuk script Langkah 2. Ganti nama objeknya atau string di script. Panduan error script menjelaskan peringatan ini.

Path gagal, atau NPC mengabaikan pemain yang sebenarnya bisa dicapai

Path.Status bernilai NoPath setelah ComputeAsync saat titik awal atau akhir ada di dalam part padat, saat satu-satunya rute butuh lompatan dan AgentCanJump bernilai false, atau saat AgentHeight atau AgentRadius terlalu besar untuk celah di jalannya. Roblox juga mendokumentasikan batas tetap: paling jauh 3.000 stud dalam garis lurus dari awal sampai akhir, dan batas pencarian 20.000 node yang bisa habis di open world yang sangat luas atau labirin. Nyalakan Navigation mesh untuk mengecek rutenya.

NPC meluncur tanpa menggerakkan kakinya

Itu masalah animasi, bukan masalah pathfinding. Karakter pemain otomatis mendapat script Animate, tapi NPC butuh script sendiri untuk memutar animasi berjalan. Setiap NPC di NPC kit dari Roblox punya Script bernama Animate yang bisa kamu pelajari. Untuk memuat dan memutar animasi di NPC dari Script server, lihat memutar animasi di NPC.

NPC tersangkut di sudut atau melompat tanpa berhasil melewati rintangan

Naikkan AgentRadius supaya rute lebih jauh dari dinding, terutama untuk NPC yang lebar. Kalau NPC melompat tapi tidak pernah berhasil lewat, rintangannya lebih tinggi dari lompatan Humanoid: naikkan JumpHeight atau JumpPower Humanoid, atau ubah level-nya.

Damage sentuh kena terlalu sering, atau tidak pernah kena

Terlalu sering: cooldown-nya tidak ada, atau disimpan per part, bukan per pemain. Tidak pernah: STOP_DISTANCE di atas 0, jadi NPC biasanya berhenti sebelum menyentuh siapa pun, atau pemain masih punya force field spawn.

Buat dengan RoCode

Kalau kamu lebih suka menjelaskan NPC-nya daripada menyusunnya secara manual, RoCode bisa menulis script ini ke place yang sedang kamu buka. RoCode adalah agen AI independen untuk Roblox Studio: kamu mengetik di web chat, dan plugin Studio-nya membuat dan mengedit script di Explorer kamu.

Kamu ketik

Buat model Chaser di Workspace mengejar pemain terdekat dalam jarak 80 stud dengan pathfinding, berjalan pulang saat tidak ada siapa pun di dekatnya, dan memberi 10 damage saat bersentuhan dengan cooldown 1 detik.

RoCode mengerjakan
  • Bisa memeriksa model itu dulu, memakai Get Properties untuk membaca nilai penting seperti Anchored di part-nya dan WalkSpeed di Humanoid-nya. Ketik / di chat untuk melampirkan path persis model itu
  • Menulis script mengejar dan script damage di dalam model dengan Create Script, dan bisa menghilangkan centang Anchored dengan Set Property kalau rig-nya membutuhkannya
  • Mengecek compile kedua script dengan Check Script di dalam Studio. Itu menangkap error compile dan pola seperti wait() yang seharusnya task.wait(), bukan bug logika seperti rute yang tidak pernah sampai ke pemain
  • Mengirim perubahannya dalam batch, dan setiap batch adalah titik undo di riwayat Studio

Dengan plugin 3.9 atau lebih baru RoCode bisa menjalankan playtest singkat dan membaca error-nya, dan dengan plugin 3.9.11 atau lebih baru RoCode bisa mengendalikan karakter tes untuk mengecek game-nya berfungsi, tapi RoCode tidak mengambil screenshot saat game berjalan, jadi tekan Play dan perhatikan NPC-nya sendiri. Kalau NPC-nya berperilaku aneh, ceritakan ke RoCode apa yang kamu lihat: Check Output bisa membaca baris Server dan Client dari playtest terakhirmu. NPC adalah satu sistem di antara banyak sistem; lihat cara membuat game Roblox lengkap dengan AI, inti yang bisa dimainkan dulu lalu ronde berikutnya. Cara RoCode terhubung ke Studio.

Pertanyaan umum

NPC pathfinding sebaiknya jalan di server atau di client?

Di server, di dalam Script. Contoh pathfinding milik Roblox sendiri berjalan di LocalScript, tapi contoh itu menggerakkan karakter milik pemain sendiri. NPC dipakai bersama semua orang, dan damage yang diberikannya harus diputuskan oleh server. Lihat Script vs LocalScript vs ModuleScript (dalam bahasa Inggris).

Berapa banyak NPC pengejar yang bisa ditangani satu server?

Dokumentasi Roblox tidak memberi angka pasti; itu tergantung map kamu dan seberapa sering path dihitung. Menghitung path adalah bagian yang berat, karena itu script mengejar membatasinya dua kali per detik per NPC dan melewatinya saat pemain terlihat. Untuk banyak NPC, panduan Roblox tentang lokasi script menyarankan memberi tag ke NPC dan menanganinya dengan CollectionService dari satu ModuleScript, bukan satu script di setiap model.

Bagaimana cara membuat NPC respawn setelah mati?

Simpan salinan NPC di ServerStorage, dan tangani respawn dari script di ServerScriptService, karena script di dalam NPC ikut hancur bersama NPC itu. Saat event Died milik Humanoid terpicu, tunggu beberapa detik, hancurkan model lama dan taruh Clone() dari salinan itu ke Workspace. Script ChaseAI di dalam clone itu mulai sendiri, karena script server berjalan begitu berada di Workspace.

Bisakah NPC mengejar pemain hanya selama ronde berlangsung?

Bisa. Buat script ronde kamu meng-clone NPC ke Workspace saat ronde dimulai dan menghancurkannya saat ronde selesai. Panduan sistem ronde membuat loop intermission dan ronde yang bisa kamu sambungkan dengan ini.

Sumber dan bacaan lanjutan

Cara kode ini dicek: setiap skrip di halaman ini lolos pemeriksa tipe strict Luau dengan definisi API Roblox (luau-lsp, 14 November 2026). Pemeriksaan tipe menangkap nama API yang salah ketik dan tipe yang keliru, bukan logika game, jadi uji dulu di Studio sebelum dipublikasikan.

Coba RoCode di game kamu sendiri.

Kredit gratis setiap hari, tanpa kartu. Pasang plugin-nya, jelaskan fiturnya, lalu cek hasilnya di Studio.