Eğitim · Oyun sistemleri

Roblox Studio'da NPC pathfinding: oyuncuyu takip eden NPC nasıl yapılır

Bir NPC'nin duvarların etrafından dolaşıp en yakın oyuncuya ulaşması için üç şey gerekir: hareket edebilen bir rig, PathfindingService'ten bir rota ve rotayı takip eden ama fizik motoruyla çekişmeyen bir döngü. Bu rehberde üçünü de kuruyoruz ve sonunda NPC'nin rig'ine öylece koyabileceğin tek bir sunucu scripti elde ediyoruz.

Güncellendi: 20 Kasım 202612 dk okumaYazan:

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'ı Jump olduğunda zıpla ve NPC'nin önündeki bir waypoint için Path.Blocked tetiklendiğinde yeni bir yol hesapla.
  • Oyuncu doğrudan görünüyorsa pathfinding'i atla ve doğrudan ona MoveTo yap. Birkaç stud kala dur ya da NPC dokunarak hasar veriyorsa sonuna kadar git.
Bu sayfada
  1. Pathfinding nasıl çalışır
  2. 1. NPC'yi kurmak
  3. 2. Bir noktaya yürümek
  4. 3. Kovalama scripti
  5. Kovalama nasıl çalışır
  6. Takılmayı gidermek
  7. 4. Dokunma hasarı
  8. Modifier'lar ve link'ler
  9. Common errors
  10. With RoCode
  11. Sık sorulan sorular
  12. Kaynaklar ve ek okumalar

NPC pathfinding nasıl çalışır

ÇizimChaser duvarın etrafından bir yol buluyor, çıkıntıya zıplıyor ve senden 4 stud uzakta duruyor.

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.

Bu rehberin kullandığı API'ler
APINe 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.BlockedHesaplanan rotayı bir şey kapattığında waypoint indeksiyle tetiklenir.
Humanoid:MoveTo(position)NPC'yi bir noktaya yürütür.
Humanoid.MoveToFinishedNPC 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.

NPC modelinin ihtiyaç duyduğu şeyler
GereksinimNeden önemli
Adı Humanoid olan bir HumanoidMoveTo, WalkSpeed ve zıplama Humanoid'e aittir.
HumanoidRootPartHumanoid'in yönettiği part. Yollar onun konumundan başlar.
Hiçbir şey anchored değilAnchored 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.
  1. 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.
  2. Rig'in adını Chaser yap ve onu açık bir alana koy.
  3. 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ç.
Explorer: bu rehberin sonunda NPC modeli
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.

  1. Workspace'e bir Part ekle, adını Goal koy, Anchored'ı aç, CanCollide'ı kapat ve onu NPC'nin bir duvarın etrafından dolaşması gerekecek şekilde zemine koy.
  2. Explorer'da imleci Chaser'ın üstüne getir, + butonuna tıkla ve bir Script ekle. Adını WalkToGoal koy ve aşağıdaki kodu yapıştır.
  3. Play'e bas. NPC duvarın etrafından dolaşır ve Goal part'ına yürür.
Script konum: Chaser modeli adı: 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

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

CreatePath için agent parametreleri
AnahtarVarsayılanNe ayarlar
AgentRadius2NPC'nin stud cinsinden yarıçapı. Geniş NPC'lerde yolların duvarlardan uzak durması için artır.
AgentHeight5NPC'nin yüksekliği. Bundan alçak yerler, örneğin bir merdivenin altı, kapalı sayılır.
AgentCanJumptrueZıplama gerektiren rotalara izin verir. Bu waypoint'lerin Action'ı Jump olur.
AgentCanClimbfalseTrussPart'lara tırmanmaya izin verir. Bu waypoint'lerin etiketi Climb olur.
WaypointSpacing4Ara waypoint'ler arasındaki stud cinsinden mesafe. math.huge onları kaldırır.
CostsyokMalzemelerden 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.

  1. Eklediysen WalkToGoal'ü Chaser'dan sil.
  2. İmleci Chaser'ın üstüne getir, +'ya tıkla, ChaseAI adlı bir Script ekle ve aşağıdaki kodu yapıştır.
  3. 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.
Script konum: Chaser modeli adı: 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

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

Pathfinding'de takılma: sebepler ve düzeltmeler
Ne görüyorsunSebepDüzeltme
Tek başınayken akıcı, yakında bir oyuncu varken kesik kesikNetwork 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üyorMoveTo 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 kesiyorVarışı 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ıyorHer 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 ediyorUlaşı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.

  1. ChaseAI'da STOP_DISTANCE'ı 0 yap, böylece NPC oyuncuların yanında durmak yerine onlara kadar yürür.
  2. Chaser'a TouchDamage adlı bir Script ekle ve aşağıdaki kodu yapıştır.
Script konum: Chaser modeli adı: 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 -- 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

  1. Alanı Anchored'ı açık ve CanCollide'ı kapalı bir part ile kapla.
  2. Bu part'a bir PathfindingModifier ekle ve Label'ını DangerZone yap.
  3. Bu kadar. Kovalama scripti DangerZone'a zaten math.huge maliyetini 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.

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.

Sen yazarsın

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.

RoCode yapar
  • Ö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

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.

RoCode'u kendi oyununda dene.

Her gün ücretsiz kredi, kart gerekmez. Plugin'i kur, özelliği anlat ve Studio'da ne oluştuğunu kontrol et.