Kısaca
NPC modelinin içine bir Script koy. PathfindingService:CreatePath() ile bir yol oluştur, onu bir pcall içinde path:ComputeAsync(start, goal) ile hesapla, sonra waypoint'leri Humanoid:MoveTo() ile tek tek geç ve bir sonrakinden önce MoveToFinished'ı bekle. NPC'nin oyuncuyu kovalaması için en yakın karakteri seç ve yolu her karede değil, oyuncu birkaç stud yer değiştirdiğinde yeniden hesapla.
- Bir Humanoid ve anchored olmayan bir HumanoidRootPart gerekir. Root part'ı sunucunun simüle etmesi için onda
SetNetworkOwner(nil)'ı çağır: oyuncuların yanında takılan bir NPC için olağan düzeltme bu. - Waypoint'in
Action'ıJumpolduğunda zıpla ve NPC'nin önündeki bir waypoint içinPath.Blockedtetiklendiğinde yeni bir yol hesapla. - Oyuncu doğrudan görünüyorsa pathfinding'i atla ve doğrudan ona
MoveToyap. Birkaç stud kala dur ya da NPC dokunarak hasar veriyorsa sonuna kadar git.
Bu sayfada
NPC pathfinding nasıl çalışır
Roblox, bir karakterin yürüyebileceği yüzeylerden bir navigasyon ağı (navigation mesh) kurar. PathfindingService bu ağda iki nokta arasında bir rota arar ve onu bir waypoint listesi olarak döndürür: her birinin bir konumu ve yürümek ya da zıplamak gibi bir eylemi vardır. Sonra NPC'nin Humanoid'i bir waypoint'ten diğerine yürür. Pathfinding sadece rotayı planlar: onu yürümek senin scriptinin işi.
| API | Ne yapar |
|---|---|
PathfindingService:CreatePath() | Agent parametreleriyle NPC'nin boyutuna göre, tekrar tekrar kullanabileceğin bir Path nesnesi oluşturur. |
Path:ComputeAsync(start, finish) | Rotayı hesaplar. Yield eder ve hata verebilir, bu yüzden onu bir pcall içinde çağır ve Path.Status'u kontrol et. |
Path:GetWaypoints() | Rotayı PathWaypoint değerlerinden oluşan bir dizi olarak döndürür; her birinin Position, Action ve Label'ı vardır. |
Path.Blocked | Hesaplanan rotayı bir şey kapattığında waypoint indeksiyle tetiklenir. |
Humanoid:MoveTo(position) | NPC'yi bir noktaya yürütür. |
Humanoid.MoveToFinished | NPC noktaya yaklaşık bir stud yaklaştığında true ile, 8 saniye içinde ulaşamazsa false ile tetiklenir. |
Hepsini bir sunucu Script'inde çalıştır: sunucu streaming açıkken bile bütün haritayı görür, tüm oyuncular aynı NPC'yi görür ve hasar, istemcinin sahteleyemeyeceği yerde belirlenir. Script, LocalScript ve ModuleScript bu ayrımı açıklıyor.
Adım 1: Hareket edebilen bir NPC
Aşağıdaki tablodaki üç şeye sahip olan her model bir yolu yürüyebilir. Toolbox'tan ya da eski place'lerden gelen rig'lerde bazen bir şey eksik olur ve bu genelde şöyle görünür: NPC yerinde duruyor ve hiç hata yok.
| Gereksinim | Neden önemli |
|---|---|
Adı Humanoid olan bir Humanoid | MoveTo, WalkSpeed ve zıplama Humanoid'e aittir. |
HumanoidRootPart | Humanoid'in yönettiği part. Yollar onun konumundan başlar. |
| Hiçbir şey anchored değil | Anchored bir part hareket edemez, ona bağlı part'lar da edemez. Anchored part'ların sahibi her zaman sunucudur, bu yüzden aşağıdaki takılma düzeltmesi onlara uygulanamaz. |
- Rig Generator'ı açmak için Avatar ya da Home sekmesini aç ve Character'a tıkla. R15'i, sonra Block Avatar'ı seç. Workspace'te bir rig belirir. R6 rig'leri aynı scriptlerle çalışır.
- Rig'in adını
Chaseryap ve onu açık bir alana koy. - Onun HumanoidRootPart'ını seç ve Properties penceresinde Anchored'ın kapalı olduğunu kontrol et. Modeldeki diğer anchored part'lar için de aynısını yap. Onları hızlıca bulmak için 3D viewport'un sağ üst köşesindeki Visualization Options widget'ında Anchored parts'ı aç.
Workspace
Chaser Model
Humanoid Humanoid
HumanoidRootPart Part
Head, UpperTorso, LowerTorso ... (vücut parçaları)
ChaseAI Script new
TouchDamage Script new
NPC'nin konuşması da gerekiyorsa NPC diyaloğu rehberi seçenekli bir Talk prompt'u ekliyor ve NPC yürürken neyin değiştiğini açıklıyor. Bir boss'u kovalamaya başlamadan önce kamerayla göstermek için cutscene rehberine bak.
Adım 2: NPC'yi bir noktaya göndermek
Çalışan en küçük scriptle başla: sabit bir part'a yürümek. Kovalama mantığı olmadan pathfinding'in her aşamasını gösteriyor.
- Workspace'e bir Part ekle, adını
Goalkoy, Anchored'ı aç, CanCollide'ı kapat ve onu NPC'nin bir duvarın etrafından dolaşması gerekecek şekilde zemine koy. - Explorer'da imleci Chaser'ın üstüne getir, + butonuna tıkla ve bir Script ekle. Adını
WalkToGoalkoy ve aşağıdaki kodu yapıştır. - Play'e bas. NPC duvarın etrafından dolaşır ve Goal part'ına yürür.
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
-- NPC'nin fiziğinin sahibi sunucu olmalı, yoksa Script'ten ChangeState (zıplama) çalışmaz
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 yield eder ve hata fırlatabilir, bu yüzden pcall içinde
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 -- ilk waypoint NPC'nin zaten durduğu yer
end
humanoid:MoveTo(waypoint.Position)
if waypoint.Action == Enum.PathWaypointAction.Jump then
humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
end
-- NPC bu waypoint'e ulaşana kadar bekliyoruz, ancak sonra bir sonrakine gidiyoruz
local reached = humanoid.MoveToFinished:Wait()
if not reached then
warn(`{npc.Name} got stuck on the way to the goal`)
break
end
end
end
Goal part'ında CanCollide kapalı, çünkü bir yol katı bir part'ın içinde bitemez: yolun Status'u NoPath olurdu.
CreatePath'e verilen tablo NPC'yi tanımlar (Roblox ona agent der), böylece rota onun sığmayacağı aralıklardan kaçınır. Yukarıdaki script ilk üç anahtarı varsayılan değerlere ayarlıyor, böylece onları nerede değiştireceğin görünüyor.
| Anahtar | Varsayılan | Ne ayarlar |
|---|---|---|
AgentRadius | 2 | NPC'nin stud cinsinden yarıçapı. Geniş NPC'lerde yolların duvarlardan uzak durması için artır. |
AgentHeight | 5 | NPC'nin yüksekliği. Bundan alçak yerler, örneğin bir merdivenin altı, kapalı sayılır. |
AgentCanJump | true | Zıplama gerektiren rotalara izin verir. Bu waypoint'lerin Action'ı Jump olur. |
AgentCanClimb | false | TrussPart'lara tırmanmaya izin verir. Bu waypoint'lerin etiketi Climb olur. |
WaypointSpacing | 4 | Ara waypoint'ler arasındaki stud cinsinden mesafe. math.huge onları kaldırır. |
Costs | yok | Malzemelerden ve etiketli alanlardan geçmenin ne kadar pahalı olduğu. Modifier'lar ve link'ler kısmına bak. |
Döngüde iki ayrıntı önemli. İlk waypoint NPC'nin kendi konumu, bu yüzden döngü onu atlıyor. Ve her MoveTo'dan sonra MoveToFinished:Wait() geliyor: yeni bir MoveTo önceki hedefin yerini alır, bu yüzden beklemeyen bir döngü NPC'yi doğrudan son waypoint'e, etrafından dolaşması gereken o duvarın içine gönderir.
Zıplamalarda waypoint'in Action'ı Jump olur ve script ChangeState(Enum.HumanoidStateType.Jumping)'i çağırır. Roblox'un Humanoid başvurusunda bir sunucu scriptinin durumu sadece karakterin fiziğinin sahibi sunucuysa değiştirebileceği yazıyor. Scriptin önce sahibi ayarlamasının sebeplerinden biri bu.
Roblox'un pathfinding sayfasında oyuncunun kendi karakteri her karede varış kontrolüyle Humanoid:Move() ile hareket ediyor ve bu, bir Humanoid'i bir yolda yürütmenin en iyi yolu olarak anılıyor. MoveToFinished ile MoveTo bir sunucu NPC'si için daha kısa ve anlaşılır, bu yüzden rehber onu kullanıyor; ileride daha hassas kontrol gerekirse resmi scripti incele.
Adım 3: Tam kovalama scripti
Çoğu kişinin aradığı script bu. NPC 80 stud içindeki en yakın oyuncuyu kovalar, duvarların etrafından dolaşır, rotanın gerektirdiği yerde zıplar, bir şey rotayı kapattığında yeni bir rota bulur ve yakında kimse yoksa evine döner.
- Eklediysen
WalkToGoal'ü Chaser'dan sil. - İmleci Chaser'ın üstüne getir, +'ya tıkla,
ChaseAIadlı bir Script ekle ve aşağıdaki kodu yapıştır. - Play'e bas, bir duvarın arkasına geç, sonra menzilin dışına koş. NPC duvarın etrafından senin peşinden gelir, sonra başladığı yere geri döner.
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
-- Ayarlar (mesafeler stud, süreler saniye cinsinden)
local DETECTION_RANGE = 80 -- NPC bundan uzaktaki oyuncuları fark etmez
local STOP_DISTANCE = 4 -- hedefe bu kadar mesafede dur (0 = dokunarak hasar için sonuna kadar git)
local DIRECT_CHASE_RANGE = 30 -- bundan yakında, arada bir şey yoksa pathfinding'i atlıyoruz
local REPATH_DISTANCE = 4 -- yolun yeniden hesaplanması için hedefin ne kadar yer değiştirmesi gerektiği
local MIN_REPATH_INTERVAL = 0.5 -- yolları asla bundan sık hesaplama
local WAYPOINT_TIMEOUT = 2 -- tek bir waypoint bundan uzun sürerse yolu bırak
local CHASE_SPEED = 14 -- varsayılan oyuncu 16 hızla yürür, yani bu NPC'den kaçabilir
local HOME_RADIUS = 4 -- eve bu kadar yakınlık zaten ev sayılır
local RAY_HEIGHTS = { 0, -2 } -- bel hizasında ve diz civarında görüş hattı ışınları
local HOME = rootPart.Position -- menzilde kimse yokken NPC'nin döndüğü yer
humanoid.WalkSpeed = CHASE_SPEED
-- NPC'yi sunucu simüle etsin. Yoksa Roblox fiziğini yakındaki bir oyuncunun
-- cihazına verebilir ve sahip değiştiğinde NPC takılır.
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, -- sudan sadece büyük bir dolambaçtan kaçınmak için geç
DangerZone = math.huge, -- DangerZone etiketli alanlara asla girme
},
})
-- NPC'nin şu anda yürüdüğü yol
local waypoints: { PathWaypoint } = {}
local nextIndex = 0
local pathGoal: Vector3? = nil
local pathBlocked = false
local lastComputeTime = -math.huge
-- Blocked, NPC'nin zaten geçtiği bir waypoint için tetiklenebilir. Sadece öndeki engel önemli.
path.Blocked:Connect(function(blockedIndex: number)
if blockedIndex >= nextIndex then
pathBlocked = true
end
end)
local rayParams = RaycastParams.new()
rayParams.RespectCanCollide = true -- hiçbir şeyin çarpışmadığı part'lar görüşü kapatmaz
local function clearPath()
waypoints = {}
nextIndex = 0
pathGoal = nil
end
local function stopMoving()
clearPath()
humanoid:MoveTo(rootPart.Position)
end
-- DETECTION_RANGE içindeki en yakın yaşayan oyuncunun HumanoidRootPart'ı ya da 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
-- Hedef yaklaşık aynı seviyedeyse ve arada katı bir şey yoksa true.
-- Temiz bir ışın zeminin yürünebilir olduğunu kanıtlamaz, bu yüzden bu sadece kısa mesafede.
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)
-- Hesaplamadan sonra sıfırlıyoruz, böylece eski rotadan gelen Blocked yenisini işaretlemez
pathBlocked = false
if ok and path.Status == Enum.PathStatus.Success then
waypoints = path:GetWaypoints()
nextIndex = 2 -- waypoint 1 NPC'nin durduğu yer
pathGoal = goal
else
if not ok then
warn(`{npc.Name}: path request failed: {err}`)
end
clearPath() -- henüz rota yok; ana döngü birazdan tekrar dener
end
end
local function needsNewPath(goal: Vector3): boolean
if os.clock() - lastComputeTime < MIN_REPATH_INTERVAL then
return false -- az önce hesapladık: mevcut yoldan gidiyoruz
end
local currentGoal = pathGoal
if currentGoal == nil or pathBlocked or nextIndex > #waypoints then
return true
end
return (goal - currentGoal).Magnitude > REPATH_DISTANCE
end
-- MoveToFinished'ı bekler ama yerleşik 8 yerine timeout saniye sonra pes eder,
-- böylece takılan bir NPC hızla yeni bir yol alır
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() -- takıldı ya da rotasından itildi: yeni yol hesaplıyoruz
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() -- yeterince yakın: hedefin yanında duruyoruz
task.wait(0.2)
continue
end
if distance <= DIRECT_CHASE_RANGE and canSeeDirectly(targetRoot) then
clearPath()
-- Part'ı da verirsen NPC o hareket ettikçe onu takip eder
humanoid:MoveTo(targetRoot.Position, targetRoot)
task.wait(0.15)
continue
end
goal = targetRoot.Position
else
if (HOME - rootPart.Position).Magnitude <= HOME_RADIUS then
stopMoving() -- yakında kimse yok ve NPC zaten evde
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) -- henüz çalışan bir yol yok, örneğin hedefe ulaşılamıyor
end
end
Tüm ayarlar en üstte. Birden fazla NPC için Chaser'ı çoğalt: her kopya kendi ChaseAI'ını çalıştırır ve kendi evini hatırlar. Eski scriptler ışınları FilterDescendantsInstances ile filtreler; Roblox başvurusu artık yeni işler için ExcludeInstances'ı öneriyor ve bu script onu kullanıyor.
Kovalama scripti nasıl çalışır
Ana döngünün her turu tek bir karar verir ve tek bir küçük eylem yapar: durmak, doğrudan oyuncuya bir adım atmak ya da bir sonraki waypoint'e yürümek. Hiçbir şey bir waypoint'ten uzun süreli kararlaştırılmaz, bu yüzden NPC sürekli tepki verir.
En yakın oyuncuyu bulmak
findNearestTarget, Players:GetPlayers()'ı dolaşır, karakteri, yaşayan Humanoid'i ya da HumanoidRootPart'ı olmayan herkesi (yeniden doğan ya da çıkan oyuncuları) atlar ve DETECTION_RANGE içindeki en yakın root part'ı döndürür. Arama her turda yapılır, bu yüzden NPC kendiliğinden daha yakın bir oyuncuya geçer ve çıkan bir oyuncu artık bulunmaz: temizlenmesi gereken oyuncu başına bir durum yok.
Oyuncu hareket ederken yolu yeniden hesaplamak, ama her karede değil
Yol hesaplamak yield eder ve sunucu zamanı harcar. needsNewPath yeni bir yolu sadece yol yokken, eskisi bittiğinde ya da kapandığında veya oyuncu mevcut yolun sonundan REPATH_DISTANCE studdan fazla uzaklaştığında ister, ve asla bir öncekinden sonraki MIN_REPATH_INTERVAL saniyeden önce istemez. Yol hesaplanırken NPC mevcut waypoint'e yürümeye devam eder, yeni yol da waypoint 2'den itibaren yürünür, bu yüzden NPC yolun başladığı yere doğru geri dönmez.
Kapanan yollar
Kapılar kapanır, part'lar düşer. Path.Blocked kapanan waypoint'in indeksiyle tetiklenir ve bu NPC'nin arkasında olabilir, bu yüzden script sadece blockedIndex >= nextIndex olduğunda tepki verir: bir bayrak koyar ve döngü yeni bir rota hesaplar. NPC itildiği ya da takıldığı için WAYPOINT_TIMEOUT saniyeden uzun süren bir waypoint de yeni bir rota başlatır.
Görünen oyuncuya doğrudan
Oyuncu açık bir alanda göz önündeyken pathfinding gerekmez. DIRECT_CHASE_RANGE içinde canSeeDirectly fonksiyonu alçak duvarları fark etmek için oyuncuya biri bel hizasında, biri diz civarında iki ışın gönderir ve iki karakteri de yok sayar. Hiçbir ışın bir şeye çarpmazsa ve oyuncu yaklaşık aynı seviyedeyse NPC MoveTo(targetRoot.Position, targetRoot)'u çağırır. İkinci argüman hedefin oyuncuyla birlikte hareket etmesini sağlar ve çağrıyı her 0.15 saniyede tekrarlamak 8 saniyelik zaman aşımını sürekli sıfırlar.
Temiz bir ışın yolda katı bir şey olmadığını kanıtlar, ama orada zemin olduğunu kanıtlamaz. Haritada NPC ile oyuncular arasında boşluklar ya da uçurumlar varsa DIRECT_CHASE_RANGE'i küçült ya da her zaman pathfinding kullanmak için 0 yap.
Doğru mesafede durmak
Oyuncu STOP_DISTANCE'tan yakınsa NPC kendi konumuna MoveTo çağırır ve bu onu durdurur. 4 stud, oyuncunun yanında durması gereken bir NPC için uygun; mesafe koruyan bir pet ya da eşlikçi için 6 ya da 8 yap. Dokunarak vuran bir düşman için, 4. adımdaki gibi sonuna kadar gitmesi için 0 yap.
NPC neden takılıyor ve nasıl düzeltilir
NPC takılıyorsa, her waypoint'te donuyorsa ya da geri adım atıyorsa sebep genelde aşağıdakilerden biri. Kovalama scripti zaten her birini hesaba katıyor; tablo kendi yazdığın bir scripti düzeltmek için.
| Ne görüyorsun | Sebep | Düzeltme |
|---|---|---|
| Tek başınayken akıcı, yakında bir oyuncu varken kesik kesik | Network ownership. Roblox anchored olmayan part'ların fiziğini yakındaki bir oyuncunun cihazına verir, yani komutları sunucu verirken NPC o oyuncunun cihazında simüle edilebilir ve her devir bir sarsıntı gibi görünebilir. | Sunucudan HumanoidRootPart üzerinde bir kez SetNetworkOwner(nil)'ı çağır. Bu ona bağlı tüm part'ları etkiler. |
| Doğrudan son waypoint'e ve duvarlara yürüyor | MoveTo bir döngüde her waypoint için beklemeden çağrılıyor. Her çağrı önceki hedefin yerini alır. | Bir sonraki waypoint'e geçmeden önce MoveToFinished'ı bekle. |
| Her waypoint'te kısa süre duruyor ya da köşeleri kesiyor | Varışı beklemek yerine waypoint'ler arasında sabit bir task.wait(). Çok uzunsa NPC durur; çok kısaysa ileri atlar. | MoveToFinished'ı bir zaman aşımıyla bekle. |
| Saniyede birkaç kez sarsılıyor ya da geri adım atıyor | Her karede yeni bir yol. Her biri NPC'nin kendi konumundan başlar, bu yüzden waypoint 1'e giden yol onu geri çevirir. | Yolu sadece hedef birkaç stud yer değiştirdiğinde, saniyede iki kezden sık olmamak üzere yeniden hesapla ve waypoint 2'den başla. |
| Birkaç saniye donuyor, sonra devam ediyor | Ulaşılamayan bir waypoint'teki MoveToFinished:Wait() 8 saniyelik zaman aşımını bekliyor. | Kendi, daha kısa zaman aşımını kullan ve süresi dolunca yeni bir yol hesapla. |
NPC'nin sahibinin kim olduğunu görmek için oyun testi sırasında Visualization Options'ı aç ve Network owners'ı aç. Senin istemcinin simüle ettiği part'lar yeşil bir çerçeve alır; sunucunun ya da başka bir istemcinin part'ları beyaz ya da gri çerçevelidir.
Adım 4: Dokununca oyunculara hasar (isteğe bağlı)
Bir düşman için NPC'ye, dokunduğunda oyunculara hasar veren ikinci bir script ekle. Sunucuda çalışır, bu yüzden oyuncunun istemcisi hasarı değiştiremez ya da bekleme süresini atlayamaz.
- ChaseAI'da
STOP_DISTANCE'ı0yap, böylece NPC oyuncuların yanında durmak yerine onlara kadar yürür. - Chaser'a
TouchDamageadlı bir Script ekle ve aşağıdaki kodu yapıştır.
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 -- yenilmiş bir NPC hasar vermez
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 -- part'lar iç içeyken Touched saniyede birçok kez tetiklenir
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 force field'ları hesaba katar, bu yüzden oyuncular doğduktan sonraki force field sürdükçe güvendedir. Force field'ları yok saymak için Humanoid.Health'i doğrudan azalt.
Bekleme süresi her oyuncu için ayrı tutulur. Part'lar birbirine sürtünürken Touched saniyede birçok kez tetiklenir ve bekleme süresi olmadan tek bir dokunuş bir anda oyuncunun canını sıfırlayabilirdi. Kayıt, oyuncusu çıktığında silinir, bu yüzden tablo sunucu açık kaldıkça sürekli büyümez.
Oyuncuların karşılık verebilmesi için onlara bir kılıç ya da raycast'li bir silah ver. İkisi de Humanoid'i olan her şeye sunucuda hasar verir, yani Chaser'a da isabet eder.
Pathfinding modifier'ları ve link'leri
Varsayılan olarak yol, mümkünse zıplama olmayan en kısa rotadır. Bunu üç şekilde değiştirebilirsin. Maliyetler ve modifier'lar kovalama scriptiyle olduğu gibi çalışır, çünkü script zaten CreatePath'e bir Costs tablosu veriyor; link'ler için birkaç kendi satırın gerekir.
Malzeme maliyetleri
Costs içindeki anahtarlar hem terrain hem part'lar için Water, Mud ya da CrackedLava gibi malzeme adları olabilir. Varsayılan olarak her malzemenin maliyeti 1. Daha büyük bir sayı, dolambaç daha kötü değilse NPC'nin o malzemeden kaçınmasını sağlar, math.huge ise onu geçilmez yapar. Kovalama scripti Water = 20 ayarlıyor.
Kaçınılacak alanlar: PathfindingModifier
- Alanı Anchored'ı açık ve CanCollide'ı kapalı bir part ile kapla.
- Bu part'a bir PathfindingModifier ekle ve
Label'ınıDangerZoneyap. - Bu kadar. Kovalama scripti
DangerZone'a zatenmath.hugemaliyetini veriyor, bu yüzden NPC bu alanın etrafından dolaşır. Etiketi navigasyon ağında görmek için Visualization Options'ta Pathfinding modifiers'ı aç.
PassThrough'u açık bir modifier tersini yapar: rota, kapalı bir kapı gibi katı bir engelin içinden, sanki orada yokmuş gibi geçer. NPC yine de kapının içinden geçemez, ama sanki oyuncuyu öbür taraftan duymuş gibi ona doğru yürür.
Kendi geçişlerin: PathfindingLink
PathfindingLink, NPC'nin normalde aralarında yürüyemediği iki noktayı bağlar, örneğin bir tekneyle geçtiği bir nehrin iki kıyısı. Her uca bir Attachment koy, link'in Attachment0 ve Attachment1'ini ayarla, ona UseBoat gibi bir Label ver ve Costs'a UseBoat'u Water'dan düşük bir maliyetle ekle. O zaman yolda bu etiketli bir waypoint belirir: walkToNextWaypoint'te waypoint.Label'ı kontrol et ve MoveTo yerine kendi eylemini çalıştır, örneğin NPC'yi tekneye bindir. IsBidirectional'ı kapatmazsan link'ler iki yönde de çalışır.
Sık yapılan hatalar ve çözümleri
Önce Output penceresini kontrol et. Window menüsünden ya da Script sekmesinden açılır. Bu sayfadaki scriptler bir yol isteği başarısız olduğunda ya da rig hareket edemediğinde bir uyarı yazdırır.
NPC hiç hareket etmiyor
Output NPC'nin hareket edemediğini (cannot move) yazıyorsa rig'in bir kısmı anchored: HumanoidRootPart'tan ve diğer part'lardan Anchored'ı kaldır. Yazmıyorsa kodun bir LocalScript'te değil Script'te olduğunu, Workspace'teki modelin içinde durduğunu ve Humanoid'in ölmediğini kontrol et.
Output WaitForChild'da "Infinite yield possible" yazıyor
Script var olmayan bir nesneyi bekliyor: farklı adlı bir Humanoid ya da HumanoidRootPart veya 2. adımdaki script için eksik Goal part'ı. Nesnenin ya da scriptteki satırın adını değiştir. Script hataları rehberi bu uyarıyı açıklıyor.
Yol oluşmuyor ya da NPC ulaşabileceği bir oyuncuyu yok sayıyor
ComputeAsync'ten sonra Path.Status, başlangıç ya da bitiş katı bir part'ın içindeyse, tek rota zıplama gerektiriyor ve AgentCanJump false ise ya da AgentHeight veya AgentRadius yoldaki bir aralık için fazla büyükse NoPath olur. Roblox dokümantasyonunda katı sınırlar da var: başlangıçtan bitişe düz çizgide en fazla 3,000 stud ve 20,000 düğümlük bir arama bütçesi; devasa açık dünyalara ya da labirentlere bu yetmeyebilir. Rotayı kontrol etmek için Navigation mesh'i aç.
NPC kayıyor ve bacaklarını oynatmıyor
Bu pathfinding değil, animasyon sorunu. Oyuncu karakterleri Animate scriptini otomatik alır, bir NPC'nin ise yürüme animasyonlarını oynatmak için kendi scripti olmalı. Roblox'un NPC kit'indeki her NPC'de inceleyebileceğin Animate adlı bir Script var. Bir sunucu Script'inden NPC'de animasyon yükleyip oynatmak için NPC'de animasyon kısmına bak.
NPC köşelerde takılıyor ya da zıplıyor ama engelin üstünden geçemiyor
Rotaların duvarlardan uzak durması için AgentRadius'u artır, özellikle geniş NPC'lerde. Zıplıyor ama bir türlü geçemiyorsa engel Humanoid'in zıplayabileceğinden yüksek: Humanoid'in JumpHeight ya da JumpPower'ını artır veya seviyeyi değiştir.
Dokunma hasarı çok sık ya da hiç tetiklenmiyor
Çok sık: bekleme süresi yok ya da oyuncu başına değil part başına tutuluyor. Hiç: STOP_DISTANCE 0'dan büyük, bu yüzden NPC genelde birine dokunmadan önce duruyor, ya da oyuncunun doğduktan sonraki force field'ı hâlâ sürüyor.
RoCode ile yap
NPC'yi elle kurmak yerine anlatmayı tercih ediyorsan RoCode bu scriptleri açık olan place'ine yazabilir. Roblox Studio için bağımsız bir yapay zeka ajanı: bir web sohbetine yazarsın ve Studio plugin'i scriptleri Explorer'ında oluşturur ve düzenler.
Workspace'teki Chaser modeli pathfinding ile 80 stud içindeki en yakın oyuncuyu kovalasın, yakında kimse yoksa evine dönsün ve 1 saniye bekleme süresiyle dokunarak 10 hasar versin.
- Önce modeli inceleyebilir; part'larındaki Anchored ve Humanoid'indeki WalkSpeed gibi önemli değerleri okumak için Get Properties kullanır. Modelin tam yolunu eklemek için sohbete / yaz
- Kovalama ve hasar scriptlerini modelin içine Create Script ile yazar ve rig gerektiriyorsa Set Property ile Anchored'ı kaldırabilir
- İki scriptin derlendiğini de doğrudan Studio'da Check Script ile kontrol eder. Bu, derleme hatalarını ve task.wait() yerine wait() gibi şeyleri yakalar, ama oyuncuya hiç ulaşmayan bir rota gibi mantık hatalarını yakalamaz
- Değişikliklerini gruplar halinde gönderir ve her grup Studio geçmişinde bir geri alma noktasıdır
Plugin 3.9 ya da üstüyle RoCode kısa bir oyun testi yapıp hataları okuyabilir, plugin 3.9.11 ya da üstüyle de oyunun çalıştığını kontrol etmek için bir test karakterini yönetebilir, ama oyun çalışırken ekran görüntüsü almaz; bu yüzden Play'e bas ve NPC'ye kendin bak. Beklendiği gibi davranmıyorsa RoCode'a ne gördüğünü söyle: Check Output son oyun testinin Server ve Client satırlarını okuyabilir. NPC birçok sistemden biri; yapay zeka ile bütün bir Roblox oyunu nasıl yapılır: önce oynanabilir çekirdek, sonra roundlar kısmına bak. RoCode Studio'ya nasıl bağlanır.
Sık sorulan sorular
NPC pathfinding nerede çalışmalı: sunucuda mı istemcide mi?
Sunucuda, bir Script'te. Roblox'un kendi pathfinding örneği bir LocalScript'te çalışıyor, ama orada hareket eden oyuncunun kendi karakteri. NPC herkes için ortak ve verdiği hasara sunucu karar vermeli. Script, LocalScript ve ModuleScript yazısına bak.
Bir sunucu kaç kovalayan NPC kaldırır?
Roblox dokümantasyonunda kesin bir sayı yok; haritaya ve yolların ne sıklıkla hesaplandığına bağlı. En pahalısı yol hesaplamak, bu yüzden kovalama scripti bunu NPC başına saniyede iki kezle sınırlıyor ve oyuncu görünürken atlıyor. Çok sayıda NPC için Roblox'un scriptlerin nerede tutulacağına dair önerileri, her modele bir script koymak yerine onları tag'lerle işaretlemeyi ve tek bir ModuleScript'ten CollectionService ile işlemeyi öneriyor.
NPC öldükten sonra yeniden nasıl doğar?
NPC'nin bir kopyasını ServerStorage'da tut ve yeniden doğuşu ServerScriptService'teki bir scriptten yap, çünkü NPC'nin içindeki script onunla birlikte yok edilir. Humanoid'in Died event'i tetiklendiğinde birkaç saniye bekle, eski modeli yok et ve kopyanın Clone()'unu Workspace'e koy. Klonun içindeki ChaseAI scripti kendiliğinden başlar, çünkü sunucu scriptleri Workspace'e girdikleri anda çalışır.
NPC'lerin oyuncuları sadece round sırasında kovalaması mümkün mü?
Evet. Round scriptin round başladığında NPC'leri Workspace'e klonlasın ve bittiğinde yok etsin. Round sistemi rehberi bunun bağlandığı intermission ve round döngüsünü kuruyor.
Kaynaklar ve ek okumalar
- Roblox Creator Docs: Pathfinding (İngilizce). agent parametreleri, waypoint'ler, kapanan yollar, modifier'lar, link'ler ve sınırlar
- Roblox Creator Docs: PathfindingService (İngilizce). CreatePath ve varsayılan değerler
- Roblox Creator Docs: Path (İngilizce). ComputeAsync, GetWaypoints, Status ve Blocked event'i
- Roblox Creator Docs: Humanoid (İngilizce). MoveTo, MoveToFinished'ın 8 saniyelik zaman aşımı, ChangeState ve TakeDamage
- Roblox Creator Docs: Network ownership (İngilizce). otomatik sahiplik, SetNetworkOwner ve Network owners modu
- Roblox Creator Docs: RaycastParams (İngilizce). ExcludeInstances ve RespectCanCollide
- Roblox Creator Docs: NPC kit (İngilizce). kendi Animate scriptleri olan NPC örnekleri
Kod nasıl kontrol edildi: bu sayfadaki her script, Roblox API tanımlarıyla Luau'nun katı tür denetleyicisinden geçiyor (luau-lsp, 20 Kasım 2026). Tür denetimi yanlış yazılmış API'leri ve hatalı türleri yakalar, oyun mantığını değil. Bu yüzden yayınlamadan önce Studio'da test et.