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
Actionsebuah waypoint adalahJump, dan hitung path baru saatPath.Blockedterpicu untuk waypoint di depan NPC. - Saat pemain terlihat jelas, lewati pathfinding dan
MoveTolangsung ke pemain. Berhenti beberapa stud sebelumnya, atau terus maju kalau NPC memberi damage saat menyentuh.
Di halaman ini
Cara kerja NPC pathfinding
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 | Fungsinya |
|---|---|
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.Blocked | Terpicu dengan indeks waypoint saat sesuatu menghalangi rute yang sudah dihitung. |
Humanoid:MoveTo(position) | Menjalankan NPC ke arah sebuah titik. |
Humanoid.MoveToFinished | Terpicu 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.
| Syarat | Kenapa penting |
|---|---|
Humanoid bernama Humanoid | MoveTo, WalkSpeed dan melompat semuanya milik Humanoid. |
HumanoidRootPart | Part yang digerakkan Humanoid. Path dimulai dari posisinya. |
| Tidak ada yang di-anchor | Part 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. |
- 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.
- Ganti nama rig menjadi
Chaserdan pindahkan ke tanah yang lapang. - 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.
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.
- Sisipkan Part ke Workspace, beri nama
Goal, nyalakan Anchored dan matikan CanCollide, lalu taruh di lantai di tempat NPC harus memutari dinding untuk mencapainya. - Di Explorer, arahkan kursor ke Chaser, klik tombol + dan sisipkan Script. Beri nama
WalkToGoaldan tempel kode di bawah. - Tekan Play. NPC berjalan memutari dinding ke part Goal.
local PathfindingService = game:GetService("PathfindingService")
local npc = script.Parent :: Model
local humanoid = npc:WaitForChild("Humanoid") :: Humanoid
local rootPart = npc:WaitForChild("HumanoidRootPart") :: BasePart
local goalPart = workspace:WaitForChild("Goal") :: BasePart
-- 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.
| Key | Default | Yang diatur |
|---|---|---|
AgentRadius | 2 | Jari-jari NPC dalam stud. Naikkan untuk NPC yang lebar supaya path menjauh dari dinding. |
AgentHeight | 5 | Tinggi NPC. Ruang yang lebih rendah dari ini, seperti di bawah tangga, dihitung terhalang. |
AgentCanJump | true | Mengizinkan rute yang butuh lompatan. Waypoint itu punya Action bernilai Jump. |
AgentCanClimb | false | Mengizinkan memanjat TrussPart. Waypoint itu punya label Climb. |
WaypointSpacing | 4 | Jarak dalam stud di antara waypoint perantara. math.huge menghapusnya. |
Costs | tidak ada | Seberapa 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.
- Hapus
WalkToGoaldari Chaser kalau kamu sudah menambahkannya. - Arahkan kursor ke Chaser, klik +, sisipkan Script bernama
ChaseAIdan tempel kode di bawah. - Tekan Play, berjalan ke balik dinding, lalu lari keluar dari jangkauan. NPC mengikutimu memutari dinding, lalu kembali ke tempat awalnya.
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.
| Yang kamu lihat | Penyebab | Perbaikan |
|---|---|---|
| Mulus saat sendirian, tersentak begitu ada pemain yang dekat | Network 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 dinding | MoveTo 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 tikungan | task.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 detik | Path 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 lagi | MoveToFinished: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.
- Di ChaseAI, ubah
STOP_DISTANCEmenjadi0supaya NPC menabrak pemain, bukan berhenti di sampingnya. - Sisipkan Script bernama
TouchDamageke Chaser dan tempel kode di bawah.
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
- Tutupi area itu dengan sebuah part, dengan Anchored menyala dan CanCollide mati.
- Sisipkan PathfindingModifier ke part itu dan isi
Label-nya denganDangerZone. - Sudah. Script mengejar sudah memberi
DangerZonebiayamath.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.
Penyeberangan khusus: PathfindingLink
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.
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.
- 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
- Roblox Creator Docs: Pathfinding (dalam bahasa Inggris). agent parameters, waypoint, path terhalang, modifier, link dan batasnya
- Roblox Creator Docs: PathfindingService (dalam bahasa Inggris). CreatePath dan nilai default-nya
- Roblox Creator Docs: Path (dalam bahasa Inggris). ComputeAsync, GetWaypoints, Status dan event Blocked
- Roblox Creator Docs: Humanoid (dalam bahasa Inggris). MoveTo, timeout MoveToFinished 8 detik, ChangeState dan TakeDamage
- Roblox Creator Docs: Network ownership (dalam bahasa Inggris). kepemilikan otomatis, SetNetworkOwner dan tampilan Network owners
- Roblox Creator Docs: RaycastParams (dalam bahasa Inggris). ExcludeInstances dan RespectCanCollide
- Roblox Creator Docs: NPC kit (dalam bahasa Inggris). contoh NPC dengan script Animate masing-masing
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.