درس · أنظمة اللعب

Pathfinding للـ NPC في Roblox Studio: كيف تجعل الـ NPC يلاحق اللاعب

لكي يلتف الـ NPC حول الجدران ويصل إلى أقرب لاعب، تحتاج إلى ثلاثة أشياء: rig يستطيع الحركة، ومسار من PathfindingService، وحلقة تمشي على المسار دون أن تتصارع مع محرك الفيزياء. في هذا الدليل نجمع الثلاثة، ونحصل في النهاية على سكربت خادم واحد يمكنك وضعه مباشرة في rig الـ NPC.

آخر تحديث ٢٠ نوفمبر ٢٠٢٦القراءة في 13 دبقلم

باختصار

ضع Script داخل نموذج الـ NPC. أنشئ مسارًا عبر PathfindingService:CreatePath()، واحسبه عبر path:ComputeAsync(start, goal) داخل pcall، ثم امشِ على نقاط المسار (waypoints) واحدة تلو الأخرى عبر Humanoid:MoveTo()، منتظرًا MoveToFinished قبل التالية. لكي يلاحق الـ NPC اللاعب، اختر أقرب شخصية وأعد حساب المسار عندما تتحرك بضعة ستدات، وليس في كل إطار.

  • تحتاج إلى Humanoid وإلى HumanoidRootPart غير مثبّت (غير Anchored). استدعِ SetNetworkOwner(nil) على الـ root part كي يحاكيه الخادم: هذا هو الإصلاح المعتاد للـ NPC الذي يرتجف قرب اللاعبين.
  • اقفز عندما تكون Action لنقطة المسار تساوي Jump، واحسب مسارًا جديدًا عندما ينطلق Path.Blocked لنقطة مسار أمام الـ NPC.
  • عندما يكون اللاعب مرئيًا مباشرة، تخطَّ الـ pathfinding ونفّذ MoveTo نحوه مباشرة. توقف على بعد بضعة ستدات، أو اقترب حتى الالتصاق إذا كان الـ NPC يُحدث ضررًا باللمس.
في هذه الصفحة
  1. كيف يعمل الـ pathfinding
  2. 1. إعداد الـ NPC
  3. 2. المشي إلى نقطة
  4. 3. سكربت المطاردة
  5. كيف تعمل المطاردة
  6. إزالة الارتجاف
  7. 4. الضرر باللمس
  8. المعدِّلات والروابط
  9. Common errors
  10. With RoCode
  11. الأسئلة الشائعة
  12. المصادر والقراءات

كيف يعمل pathfinding الـ NPC

توضيحChaser يجد مسارًا حول الجدار، ويقفز إلى الحافة، ويتوقف على بعد 4 ستدات منك.

يبني Roblox شبكة ملاحة (navigation mesh) من الأسطح التي يمكن للشخصية المشي عليها. يبحث PathfindingService في هذه الشبكة عن طريق بين نقطتين ويعيده كقائمة من نقاط المسار (waypoints): لكل واحدة موقع وإجراء، مثل المشي أو القفز. ثم يمشي Humanoid الخاص بالـ NPC من نقطة إلى التالية. الـ pathfinding يخطط للطريق فقط: أما التحرك عليه فمهمة سكربتك.

الواجهات البرمجية (API) التي يستخدمها هذا الدليل
APIماذا يفعل
PathfindingService:CreatePath()ينشئ كائن Path يمكن استخدامه مرات كثيرة، مضبوطًا على حجم الـ NPC عبر معاملات الوكيل (agent).
Path:ComputeAsync(start, finish)يحسب الطريق. هو يوقف التنفيذ مؤقتًا (yield) وقد يفشل، لذلك استدعِه داخل pcall وافحص Path.Status.
Path:GetWaypoints()يعيد الطريق كمصفوفة من قيم PathWaypoint، لكل منها Position وAction وLabel.
Path.Blockedينطلق مع رقم نقطة المسار عندما يسدّ شيء ما الطريق المحسوب.
Humanoid:MoveTo(position)يقود الـ NPC إلى نقطة.
Humanoid.MoveToFinishedينطلق بـ true عندما يقترب الـ NPC من النقطة بنحو ستد واحد، أو بـ false إذا لم يصل خلال 8 ثوانٍ.

شغّل كل هذا في Script على الخادم: الخادم يرى الخريطة كلها حتى مع البث (streaming)، وكل اللاعبين يرون الـ NPC نفسه، والضرر يُقرَّر حيث لا يستطيع العميل تزويره. Script وLocalScript وModuleScript يشرح هذا التقسيم.

الخطوة 1: NPC يستطيع الحركة

يمكن لأي نموذج أن يمشي على مسار إذا كانت فيه الأشياء الثلاثة من الجدول أدناه. الـ rigs من Toolbox أو من الأماكن القديمة ينقصها أحيانًا شيء ما، وعادةً يبدو ذلك هكذا: الـ NPC واقف في مكانه، ولا يوجد خطأ.

ما يحتاجه نموذج الـ NPC
المتطلبلماذا هو مهم
Humanoid باسم HumanoidMoveTo وWalkSpeed والقفز كلها تابعة للـ Humanoid.
HumanoidRootPartالقطعة التي يتحكم بها الـ Humanoid. المسارات تبدأ من موقعها.
لا شيء مثبّت (Anchored)القطعة المثبتة لا تستطيع الحركة، ولا القطع المتصلة بها. القطع المثبتة يملكها الخادم دائمًا، لذلك لا يمكن تطبيق إصلاح الارتجاف المذكور أدناه عليها.
  1. افتح تبويب Avatar أو Home واضغط Character لفتح Rig Generator. اختر R15، ثم Block Avatar. سيظهر rig في Workspace. الـ rigs من نوع R6 تعمل مع السكربتات نفسها.
  2. أعد تسمية الـ rig إلى Chaser وضعه في مكان مفتوح.
  3. حدّد HumanoidRootPart الخاص به وتأكّد أن Anchored في نافذة Properties غير مفعّل. افعل الشيء نفسه مع أي قطعة مثبتة أخرى في النموذج. لتجدها بسرعة، فعّل Anchored parts في أداة Visualization Options في الزاوية العلوية اليمنى من نافذة العرض ثلاثية الأبعاد.
Explorer: نموذج الـ NPC في نهاية هذا الدليل
Workspace
  Chaser Model
    Humanoid Humanoid
    HumanoidRootPart Part
    Head, UpperTorso, LowerTorso ... (أجزاء الجسم)
    ChaseAI Script new
    TouchDamage Script new

لكي يتكلم الـ NPC أيضًا، يضيف دليل الحوار مع الـ NPC تلميح Talk مع خيارات للرد ويشرح ما الذي يتغير عندما يمشي الـ NPC. ولعرض الزعيم بالكاميرا قبل أن يبدأ المطاردة، انظر دليل المشاهد السينمائية (cutscenes).

الخطوة 2: نرسل الـ NPC إلى نقطة

ابدأ بأصغر سكربت يعمل: المشي إلى قطعة ثابتة. فهو يبيّن كل مرحلة من مراحل الـ pathfinding دون منطق المطاردة.

  1. أدرج Part في Workspace، وسمّه Goal، وفعّل Anchored، وألغِ CanCollide، وضعه على الأرض بحيث يضطر الـ NPC إلى الالتفاف حول جدار.
  2. في Explorer مرّر المؤشر فوق Chaser، واضغط الزر + وأدرج Script. سمّه WalkToGoal والصق الكود أدناه.
  3. اضغط Play. يلتف الـ NPC حول الجدار ويمشي إلى القطعة Goal.
Script في النموذج Chaser باسم 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، وإلا فلن يعمل ChangeState (القفز) من 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 يوقف التنفيذ مؤقتًا وقد يرمي خطأ، لذلك هو داخل 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 -- نقطة المسار الأولى هي المكان الذي يقف فيه الـ NPC بالفعل
		end
		humanoid:MoveTo(waypoint.Position)
		if waypoint.Action == Enum.PathWaypointAction.Jump then
			humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
		end
		-- ننتظر حتى يصل الـ NPC إلى نقطة المسار هذه، وبعدها فقط نمشي إلى التالية
		local reached = humanoid.MoveToFinished:Wait()
		if not reached then
			warn(`{npc.Name} got stuck on the way to the goal`)
			break
		end
	end
end

خاصية CanCollide في القطعة Goal ملغاة، لأن المسار لا يمكن أن ينتهي داخل قطعة صلبة: كانت Status المسار ستساوي NoPath.

الجدول الذي يستقبله CreatePath يصف الـ NPC (يسميه Roblox الوكيل أو agent)، كي يتجنب الطريق الفتحات التي لا يمر منها. السكربت أعلاه يضبط المفاتيح الثلاثة الأولى على قيمها الافتراضية، كي يتضح أين تغيّرها.

معاملات الوكيل في CreatePath
المفتاحالافتراضيماذا يحدد
AgentRadius2نصف قطر الـ NPC بالستد. زِده للـ NPC العريضة كي تبقى المسارات بعيدة عن الجدران.
AgentHeight5ارتفاع الـ NPC. الأماكن الأخفض من هذا، مثل ما تحت الدرج، تُعدّ مسدودة.
AgentCanJumptrueيسمح بطرق تحتاج إلى قفزة. نقاط المسار هذه تكون Action فيها Jump.
AgentCanClimbfalseيسمح بالتسلق على TrussPart. نقاط المسار هذه تحمل الوسم Climb.
WaypointSpacing4المسافة بالستد بين نقاط المسار الوسيطة. math.huge يزيلها.
Costsلا شيءكم يكلّف المرور عبر الخامات والمناطق الموسومة. انظر المعدِّلات والروابط.

في الحلقة تفصيلتان مهمتان. نقطة المسار الأولى هي موقع الـ NPC نفسه، لذلك تتخطاها الحلقة. وبعد كل MoveTo يأتي MoveToFinished:Wait(): لأن MoveTo الجديد يستبدل الهدف السابق، فالحلقة بلا انتظار ترسل الـ NPC مباشرة إلى آخر نقطة مسار، نحو الجدار نفسه الذي يجب أن يلتف حوله.

للقفز تكون Action لنقطة المسار Jump، ويستدعي السكربت ChangeState(Enum.HumanoidStateType.Jumping). في مرجع Roblox عن Humanoid مذكور أن سكربت الخادم يستطيع تغيير الحالة فقط عندما يملك الخادم فيزياء الشخصية. هذا أحد أسباب أن السكربت يحدد المالك أولًا.

في صفحة Roblox عن الـ pathfinding، تتحرك شخصية اللاعب نفسه عبر Humanoid:Move() مع فحص للوصول في كل إطار، وتوصف هذه بأنها أفضل طريقة لقيادة Humanoid على مسار. MoveTo مع MoveToFinished أقصر وأوضح لـ NPC على الخادم، لذلك يستخدمه الدليل؛ وإذا احتجت لاحقًا إلى تحكم أدق، فادرس السكربت الرسمي.

الخطوة 3: سكربت المطاردة الكامل

هذا هو السكربت الذي يبحث عنه معظم الناس. يلاحق الـ NPC أقرب لاعب ضمن 80 ستد، ويلتف حول الجدران، ويقفز حيث يحتاج الطريق، ويجد طريقًا جديدًا عندما يسدّه شيء، ويعود إلى البيت عندما لا يكون أحد قريبًا.

  1. احذف WalkToGoal من Chaser إن كنت أضفته.
  2. مرّر المؤشر فوق Chaser، واضغط +، وأدرج Script باسم ChaseAI والصق الكود أدناه.
  3. اضغط Play، وادخل خلف الجدار، ثم اهرب خارج المدى. يلتف الـ NPC حول الجدار خلفك، ثم يعود إلى حيث بدأ.
Script في النموذج Chaser باسم 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

-- الإعدادات (المسافات بالستد، والوقت بالثواني)
local DETECTION_RANGE = 80 -- اللاعبون أبعد من هذا لا يلاحظهم الـ NPC
local STOP_DISTANCE = 4 -- التوقف على هذه المسافة من الهدف (0 = الاقتراب حتى الالتصاق، للضرر باللمس)
local DIRECT_CHASE_RANGE = 30 -- أقرب من هذا نتخطى الـ pathfinding إذا لم يكن في الطريق شيء
local REPATH_DISTANCE = 4 -- كم يجب أن يتحرك الهدف كي يُعاد حساب المسار
local MIN_REPATH_INTERVAL = 0.5 -- لا تحسب المسارات أبدًا أسرع من هذا
local WAYPOINT_TIMEOUT = 2 -- اترك المسار إذا استغرقت نقطة مسار واحدة أطول من هذا
local CHASE_SPEED = 14 -- اللاعب يمشي افتراضيًا بسرعة 16، لذلك يستطيع الهرب من هذا الـ NPC
local HOME_RADIUS = 4 -- هذا القرب من البيت يُعدّ بيتًا بالفعل
local RAY_HEIGHTS = { 0, -2 } -- أشعة خط الرؤية على مستوى الخصر وقرب الركبتين

local HOME = rootPart.Position -- حيث يعود الـ NPC عندما لا يكون أحد ضمن المدى

humanoid.WalkSpeed = CHASE_SPEED

-- دع الخادم يحاكي الـ NPC. وإلا فقد يعطي Roblox فيزياءه لجهاز
-- لاعب قريب، فيرتجف الـ NPC عندما يتغير المالك.
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, -- المرور عبر الماء فقط لتجنب التفاف كبير
		DangerZone = math.huge, -- لا تدخل أبدًا المناطق الموسومة بـ DangerZone
	},
})

-- المسار الذي يمشي عليه الـ NPC الآن
local waypoints: { PathWaypoint } = {}
local nextIndex = 0
local pathGoal: Vector3? = nil
local pathBlocked = false
local lastComputeTime = -math.huge

-- قد ينطلق Blocked لنقطة مسار تجاوزها الـ NPC بالفعل. المهم فقط هو العائق في الأمام.
path.Blocked:Connect(function(blockedIndex: number)
	if blockedIndex >= nextIndex then
		pathBlocked = true
	end
end)

local rayParams = RaycastParams.new()
rayParams.RespectCanCollide = true -- القطع التي لا يصطدم بها شيء لا تحجب الرؤية

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

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

-- HumanoidRootPart لأقرب لاعب حي ضمن DETECTION_RANGE أو 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 عندما يكون الهدف تقريبًا على المستوى نفسه ولا يوجد بينهما شيء صلب.
-- الشعاع الخالي لا يثبت أن الأرض قابلة للمشي، لذلك هذا على المسافة القصيرة فقط.
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)
	-- نعيد الضبط بعد الحساب، كي لا يعلّم Blocked من الطريق القديم الطريق الجديد
	pathBlocked = false
	if ok and path.Status == Enum.PathStatus.Success then
		waypoints = path:GetWaypoints()
		nextIndex = 2 -- نقطة المسار 1 هي المكان الذي يقف فيه الـ NPC
		pathGoal = goal
	else
		if not ok then
			warn(`{npc.Name}: path request failed: {err}`)
		end
		clearPath() -- لا يوجد طريق بعد؛ ستحاول الحلقة الرئيسية مرة أخرى قريبًا
	end
end

local function needsNewPath(goal: Vector3): boolean
	if os.clock() - lastComputeTime < MIN_REPATH_INTERVAL then
		return false -- حسبناه للتو: نمشي على المسار الحالي
	end
	local currentGoal = pathGoal
	if currentGoal == nil or pathBlocked or nextIndex > #waypoints then
		return true
	end
	return (goal - currentGoal).Magnitude > REPATH_DISTANCE
end

-- ينتظر MoveToFinished، لكنه يستسلم بعد timeout ثانية بدل الثماني المدمجة،
-- كي يحصل الـ NPC العالق بسرعة على مسار جديد
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() -- علق أو دُفع عن مساره: نحسب مسارًا جديدًا
	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() -- قريب بما يكفي: نقف بجانب الهدف
			task.wait(0.2)
			continue
		end
		if distance <= DIRECT_CHASE_RANGE and canSeeDirectly(targetRoot) then
			clearPath()
			-- إذا مرّرنا القطعة أيضًا، يتبعها الـ NPC ما دامت تتحرك
			humanoid:MoveTo(targetRoot.Position, targetRoot)
			task.wait(0.15)
			continue
		end
		goal = targetRoot.Position
	else
		if (HOME - rootPart.Position).Magnitude <= HOME_RADIUS then
			stopMoving() -- لا أحد قريب، والـ NPC في البيت بالفعل
			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) -- لا يوجد مسار صالح بعد، مثلًا الهدف لا يمكن الوصول إليه
	end
end

كل الإعدادات في الأعلى. لعدة NPC، كرّر Chaser: كل نسخة تشغّل ChaseAI الخاص بها وتتذكر بيتها. السكربتات القديمة تصفّي الأشعة عبر FilterDescendantsInstances؛ أما مرجع Roblox فيوصي الآن للعمل الجديد بـ ExcludeInstances، وهذا ما يستخدمه هذا السكربت.

كيف يعمل سكربت المطاردة

كل دورة في الحلقة الرئيسية تتخذ قرارًا واحدًا وتنفذ إجراءً صغيرًا واحدًا: الوقوف، أو خطوة مباشرة نحو اللاعب، أو المشي إلى نقطة المسار التالية. لا شيء يُقرَّر لأكثر من نقطة مسار واحدة، لذلك يتفاعل الـ NPC طوال الوقت.

البحث عن أقرب لاعب

findNearestTarget يمر على Players:GetPlayers()، ويتخطى كل من ليس لديه شخصية أو Humanoid حي أو HumanoidRootPart (اللاعبين الذين يعاودون الظهور أو يغادرون)، ويعيد أقرب root part ضمن DETECTION_RANGE. البحث يجري في كل دورة، لذلك ينتقل الـ NPC بنفسه إلى لاعب أقرب، واللاعب الذي غادر ببساطة لا يُعثر عليه بعد ذلك: لا توجد حالة لكل لاعب تحتاج إلى تنظيف.

إعادة حساب المسار أثناء حركة اللاعب، لكن ليس في كل إطار

حساب المسار يوقف التنفيذ مؤقتًا ويستهلك وقت الخادم. needsNewPath يطلب مسارًا جديدًا فقط عندما لا يوجد مسار، أو انتهى القديم أو انسدّ، أو ابتعد اللاعب أكثر من REPATH_DISTANCE ستد عن نهاية المسار الحالي، وأبدًا ليس قبل مرور MIN_REPATH_INTERVAL ثانية على الحساب السابق. أثناء حساب المسار يواصل الـ NPC المشي إلى نقطة المسار الحالية، والمسار الجديد يُمشى من نقطة المسار 2، لذلك لا يستدير الـ NPC نحو المكان الذي بدأ منه المسار.

المسارات المسدودة

الأبواب تُغلق، والقطع تسقط. Path.Blocked ينطلق مع رقم نقطة المسار المسدودة، وقد تكون خلف الـ NPC، لذلك يتفاعل السكربت فقط عند blockedIndex >= nextIndex: يرفع علامة، وتحسب الحلقة طريقًا جديدًا. ونقطة المسار التي يستغرق الـ NPC للوصول إليها أكثر من WAYPOINT_TIMEOUT ثانية، لأنه دُفع أو علق، تطلق هي أيضًا طريقًا جديدًا.

مباشرة إلى اللاعب المرئي

لا حاجة إلى الـ pathfinding عندما يكون اللاعب مرئيًا في مكان مفتوح. ضمن DIRECT_CHASE_RANGE تطلق الدالة canSeeDirectly شعاعين نحو اللاعب، على مستوى الخصر وقرب الركبتين، لتلاحظ الجدران المنخفضة، وتتجاهل الشخصيتين كلتيهما. إذا لم يصطدم أي شعاع بشيء وكان اللاعب تقريبًا على المستوى نفسه، يستدعي الـ NPC MoveTo(targetRoot.Position, targetRoot). المعامل الثاني يجعل الهدف يتحرك مع اللاعب، وتكرار الاستدعاء كل 0.15 ثانية يعيد ضبط المهلة ذات الثماني ثوانٍ باستمرار.

الشعاع الخالي يثبت أنه لا يوجد شيء صلب في الطريق، لكنه لا يثبت أن هناك أرضية. إذا كانت في الخريطة هاويات أو منحدرات بين الـ NPC واللاعبين، فقلّل DIRECT_CHASE_RANGE أو اجعله 0 لاستخدام الـ pathfinding دائمًا.

التوقف على المسافة المطلوبة

عندما يكون اللاعب أقرب من STOP_DISTANCE، يستدعي الـ NPC MoveTo إلى موقعه هو، وهذا يوقفه. 4 ستدات تناسب NPC يجب أن يقف بجانب اللاعب؛ ولحيوان أليف أو مرافق يحافظ على مسافة، اجعلها 6 أو 8. ولعدو يضرب باللمس، اجعلها 0 كي يقترب حتى الالتصاق، كما في الخطوة 4.

لماذا يرتجف الـ NPC وكيف تصلح ذلك

إذا كان الـ NPC يرتجف، أو يتجمد عند كل نقطة مسار، أو يخطو إلى الخلف، فالسبب عادةً واحد من البنود أدناه. سكربت المطاردة يعالج كلًا منها بالفعل؛ الجدول موجود لإصلاح سكربت كتبته بنفسك.

الارتجاف في الـ pathfinding: الأسباب والإصلاحات
ما تراهالسببالإصلاح
سلس حين يكون وحده، ومتقطع حين يقترب لاعبملكية الشبكة (Network ownership). يعطي Roblox فيزياء القطع غير المثبتة لجهاز لاعب قريب، لذلك قد يُحاكى الـ NPC على جهاز ذلك اللاعب بينما يصدر الخادم الأوامر، وكل عملية تسليم قد تبدو كهزة.استدعِ SetNetworkOwner(nil) مرة واحدة على HumanoidRootPart من الخادم. هذا يسري على كل القطع المتصلة به.
يمشي مباشرة إلى آخر نقطة مسار ونحو الجدرانيُستدعى MoveTo لكل نقطة مسار في الحلقة دون انتظار. كل استدعاء يستبدل الهدف السابق.انتظر MoveToFinished قبل الانتقال إلى نقطة المسار التالية.
يتوقف قليلًا عند كل نقطة مسار أو يقطع الزواياtask.wait() ثابت بين نقاط المسار بدل انتظار الوصول. إذا طال، يقف الـ NPC؛ وإذا قصر، يقفز إلى الأمام.انتظر MoveToFinished مع مهلة.
يرتجف أو يخطو إلى الخلف عدة مرات في الثانيةمسار جديد في كل إطار. كل مسار يبدأ من موقع الـ NPC نفسه، لذلك يعيده المسار إلى نقطة المسار 1 إلى الخلف.أعد حساب المسار فقط عندما يتحرك الهدف بضعة ستدات، وليس أكثر من مرتين في الثانية، وابدأ من نقطة المسار 2.
يتجمد بضع ثوانٍ، ثم يواصلMoveToFinished:Wait() على نقطة مسار لا يمكن الوصول إليها ينتظر المهلة ذات الثماني ثوانٍ.استخدم مهلة خاصة بك أقصر، واحسب مسارًا جديدًا عندما تنتهي.

لترى من يملك الـ NPC، افتح Visualization Options أثناء اختبار اللعب وفعّل Network owners. القطع التي يحاكيها عميلك تحصل على إطار أخضر؛ وقطع الخادم أو عميل آخر لها إطار أبيض أو رمادي.

الخطوة 4: ضرر للاعبين عند اللمس (اختياري)

للعدو، أضف إلى الـ NPC سكربتًا ثانيًا يُحدث ضررًا للاعبين عند اللمس. هو يعمل على الخادم، لذلك لا يستطيع عميل اللاعب تغيير الضرر أو تجاوز فترة التهدئة.

  1. في ChaseAI اضبط STOP_DISTANCE على 0، كي يقترب الـ NPC من اللاعبين حتى الالتصاق بدل التوقف بجانبهم.
  2. أدرج في Chaser سكربت Script باسم TouchDamage والصق الكود أدناه.
Script في النموذج Chaser باسم TouchDamage
local Players = game:GetService("Players")

local npc = script.Parent :: Model
local humanoid = npc:WaitForChild("Humanoid") :: Humanoid

local DAMAGE = 10
local COOLDOWN_SECONDS = 1

local lastHit: { [Player]: number } = {}

local function onTouched(hit: BasePart)
	if humanoid.Health <= 0 then
		return -- الـ NPC المهزوم لا يُحدث ضررًا
	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 ينطلق مرات كثيرة في الثانية ما دامت القطع متداخلة
	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 fields)، لذلك يبقى اللاعبون آمنين ما دام حقل القوة بعد الظهور ساريًا. لتجاهل حقول القوة، أنقص Humanoid.Health مباشرة.

فترة التهدئة تُحفظ لكل لاعب على حدة. Touched ينطلق مرات كثيرة في الثانية ما دامت القطع تحتك ببعضها، وبدون فترة تهدئة قد تُفرغ لمسة واحدة صحة اللاعب في لحظة. يُحذف الإدخال عندما يغادر لاعبه، لذلك لا يكبر الجدول طوال عمر الخادم.

كي يستطيع اللاعبون الدفاع عن أنفسهم، أعطهم سيفًا أو سلاحًا ناريًا بالـ raycast. كلاهما يُحدث ضررًا على الخادم لكل ما فيه Humanoid، لذلك سيصيبان Chaser أيضًا.

المعدِّلات والروابط في الـ pathfinding

افتراضيًا، المسار هو أقصر طريق يخلو من القفزات قدر الإمكان. يمكن تغيير ذلك بثلاث طرق. التكاليف والمعدِّلات تعمل مع سكربت المطاردة كما هو، لأنه يمرّر بالفعل جدول Costs إلى CreatePath؛ أما الروابط فتحتاج إلى بضعة أسطر خاصة بك.

تكلفة الخامات

يمكن أن تكون مفاتيح Costs أسماء خامات، مثل Water أو Mud أو CrackedLava، للتضاريس (terrain) وللقطع معًا. افتراضيًا تكلفة كل خامة 1. الرقم الأكبر يجعل الـ NPC يتجنب هذه الخامة إذا لم يكن الالتفاف أسوأ، وmath.huge يجعلها غير قابلة للعبور. سكربت المطاردة يضبط Water = 20.

مناطق يجب تجنبها: PathfindingModifier

  1. غطِّ المنطقة بقطعة فيها Anchored مفعّل وCanCollide ملغى.
  2. أدرج في هذه القطعة PathfindingModifier واضبط Label الخاص به على DangerZone.
  3. هذا كل شيء. سكربت المطاردة يعطي DangerZone بالفعل التكلفة math.huge، لذلك يتجنب الـ NPC هذه المنطقة. فعّل Pathfinding modifiers في Visualization Options لترى الوسم على شبكة الملاحة.

المعدِّل الذي فيه PassThrough مفعّل يفعل العكس: يمر الطريق عبر عائق صلب، مثل باب مغلق، كأنه غير موجود. لا يزال الـ NPC عاجزًا عن المرور عبر الباب، لكنه يمشي نحوه كأنه سمع اللاعب من الجهة الأخرى.

PathfindingLink يصل بين نقطتين لا يستطيع الـ NPC عادةً المرور بينهما، مثل ضفتي نهر يعبره بقارب. ضع Attachment عند كل طرف، واضبط في الرابط Attachment0 وAttachment1، وأعطه Label، مثل UseBoat، وأضف UseBoat إلى Costs بتكلفة أقل من Water. عندها ستظهر في المسار نقطة مسار تحمل هذا الوسم: افحص waypoint.Label في walkToNextWaypoint وشغّل إجراءك الخاص، مثل إركاب الـ NPC في القارب، بدل MoveTo. الروابط تعمل في الاتجاهين، ما لم تلغِ IsBidirectional.

الأخطاء الشائعة وحلولها

افحص أولًا نافذة Output. تُفتح من قائمة Window أو من تبويب Script. السكربتات في هذه الصفحة تطبع تحذيرًا عندما يفشل طلب المسار أو لا يستطيع الـ rig الحركة.

الـ NPC لا يتحرك إطلاقًا

إذا كُتب في Output أن الـ NPC لا يستطيع الحركة (cannot move)، فجزء من الـ rig مثبّت: ألغِ Anchored من HumanoidRootPart وبقية القطع. وإن لم يكن كذلك، فتأكّد أن الكود في Script وليس في LocalScript، وأنه داخل النموذج في Workspace، وأن الـ Humanoid لم يمت.

Output يكتب "Infinite yield possible" عند WaitForChild

السكربت ينتظر كائنًا غير موجود: Humanoid أو HumanoidRootPart باسم مختلف، أو القطعة Goal غائبة في سكربت الخطوة 2. أعد تسمية الكائن أو السطر في السكربت. دليل أخطاء السكربتات يشرح هذا التحذير.

المسار لا يُبنى، أو يتجاهل الـ NPC لاعبًا كان يمكنه الوصول إليه

Path.Status بعد ComputeAsync يساوي NoPath عندما تكون البداية أو النهاية داخل قطعة صلبة، أو عندما يتطلب الطريق الوحيد قفزة وAgentCanJump يساوي false، أو عندما يكون AgentHeight أو AgentRadius كبيرًا جدًا على فتحة في الطريق. في توثيق Roblox توجد أيضًا حدود صارمة: لا أكثر من 3,000 ستد في خط مستقيم من البداية إلى النهاية، وميزانية بحث قدرها 20,000 عقدة، وقد لا تكفي للعوالم المفتوحة الضخمة أو المتاهات. فعّل Navigation mesh لتفحص الطريق.

الـ NPC ينزلق ولا يحرك ساقيه

هذه مشكلة رسوم متحركة (animation)، وليست مشكلة pathfinding. شخصيات اللاعبين تحصل على سكربت Animate تلقائيًا، أما الـ NPC فيحتاج إلى سكربت خاص لتشغيل رسوم المشي. في كل NPC من NPC kit الخاصة بـ Roblox يوجد Script باسم Animate يمكنك دراسته. لكيفية تحميل رسوم متحركة وتشغيلها على NPC من Script على الخادم، انظر قسم الرسوم المتحركة على الـ NPC.

الـ NPC يعلق عند الزوايا أو يقفز لكنه لا يتخطى العائق

زِد AgentRadius كي تبقى الطرق أبعد عن الجدران، خصوصًا للـ NPC العريضة. وإذا كان يقفز لكنه لا يعبر أبدًا، فالعائق أعلى مما يستطيع الـ Humanoid القفز: زِد JumpHeight أو JumpPower في الـ Humanoid أو غيّر المستوى.

الضرر باللمس يحدث كثيرًا جدًا أو لا يحدث أبدًا

كثيرًا جدًا: لا توجد فترة تهدئة، أو أنها تُحفظ لكل قطعة وليس لكل لاعب. أبدًا: STOP_DISTANCE أكبر من 0، لذلك يتوقف الـ NPC عادةً قبل أن يلمس أحدًا، أو أن حقل القوة بعد الظهور ما زال ساريًا عند اللاعب.

ابنِه باستخدام RoCode

إذا كان وصف الـ NPC أسهل عليك من تجميعه يدويًا، يستطيع RoCode كتابة هذه السكربتات في المكان المفتوح عندك. إنه وكيل ذكاء اصطناعي مستقل لـ Roblox Studio: تكتب في دردشة الويب، وإضافته لـ Studio تنشئ السكربتات وتعدّلها في Explorer عندك.

ما تكتبه

اجعل النموذج Chaser في Workspace يلاحق أقرب لاعب ضمن 80 ستد عبر الـ pathfinding، ويعود إلى البيت عندما لا يكون أحد قريبًا، ويُحدث 10 من الضرر باللمس مع فترة تهدئة قدرها ثانية واحدة.

ما يفعله RoCode
  • يمكنه أولًا فحص النموذج عبر Get Properties وقراءة القيم الأساسية، مثل Anchored في قطعه وWalkSpeed في الـ Humanoid. اكتب / في الدردشة لترفق المسار الدقيق للنموذج
  • يكتب سكربتي المطاردة والضرر داخل النموذج عبر Create Script، ويمكنه إلغاء Anchored عبر Set Property إذا احتاج الـ rig ذلك
  • يتحقق من تجميع السكربتين عبر Check Script داخل Studio مباشرة. هذا يلتقط أخطاء التجميع وأشياء مثل wait() بدل task.wait()، لكنه لا يلتقط الأخطاء المنطقية مثل طريق لا يصل إلى اللاعب أبدًا
  • يرسل التغييرات على دفعات، وكل دفعة هي نقطة تراجع في سجل Studio

مع الإضافة 3.9 أو أحدث يستطيع RoCode تشغيل اختبار لعب قصير وقراءة الأخطاء، ومع الإضافة 3.9.11 أو أحدث يستطيع التحكم في شخصية اختبار ليتأكد أن اللعبة تعمل، لكنه لا يلتقط لقطات شاشة أثناء اللعب، لذلك اضغط Play وانظر إلى الـ NPC بنفسك. إذا تصرّف بشكل غير متوقع، فأخبر RoCode بما رأيته: يستطيع Check Output قراءة أسطر Server وClient من آخر اختبار لعب لك. الـ NPC نظام واحد من أنظمة كثيرة؛ انظر كيف تبني لعبة Roblox كاملة بالذكاء الاصطناعي: النواة القابلة للعب أولًا، ثم الجولات. كيف يتصل RoCode بـ Studio.

الأسئلة الشائعة

أين أشغّل pathfinding الـ NPC: على الخادم أم على العميل؟

على الخادم، في Script. مثال الـ pathfinding الخاص بـ Roblox يعمل في LocalScript، لكن هناك تتحرك شخصية اللاعب نفسه. الـ NPC مشترك بين الجميع، والضرر الذي يُحدثه يجب أن يقرره الخادم. انظر Script وLocalScript وModuleScript.

كم NPC مطارِد يتحمله خادم واحد؟

لا يوجد رقم دقيق في توثيق Roblox؛ الأمر يعتمد على الخريطة وعلى عدد مرات حساب المسارات. أغلى شيء هو حساب المسار، لذلك يحدّه سكربت المطاردة بمرتين في الثانية لكل NPC ويتخطاه عندما يكون اللاعب مرئيًا. لعدد كبير من الـ NPC، تنصح توصيات Roblox حول مكان حفظ السكربتات بوسمها ومعالجتها عبر CollectionService من ModuleScript واحد، بدل وضع سكربت في كل نموذج.

كيف أجعل الـ NPC يعاود الظهور بعد موته؟

احتفظ بنسخة من الـ NPC في ServerStorage، ونفّذ إعادة الظهور من سكربت في ServerScriptService، لأن السكربت داخل الـ NPC يُدمَّر معه. عندما ينطلق الحدث Died في الـ Humanoid، انتظر بضع ثوانٍ، ودمّر النموذج القديم وضع Clone() للنسخة في Workspace. سكربت ChaseAI داخل النسخة سيبدأ بنفسه، لأن سكربتات الخادم تعمل بمجرد أن تصبح في Workspace.

هل يمكن جعل الـ NPC يطاردون اللاعبين أثناء الجولة فقط؟

نعم. اجعل سكربت الجولات عندك يستنسخ الـ NPC في Workspace عندما تبدأ الجولة، ويدمّرها عندما تنتهي. دليل نظام الجولات يبني دورة الاستراحة والجولة التي يرتبط بها هذا.

المصادر والقراءات

كيف فُحص الكود: كل سكربت في هذه الصفحة يجتاز الفاحص الصارم للأنواع في Luau مع تعريفات واجهة Roblox البرمجية (luau-lsp، ٢٠ نوفمبر ٢٠٢٦). فحص الأنواع يكشف الأخطاء في أسماء الواجهات البرمجية والأنواع الخاطئة، لا منطق اللعبة، فجرّب الكود في Studio قبل النشر.

جرّب RoCode على لعبتك أنت.

رصيد مجاني كل يوم ودون بطاقة. ثبّت الإضافة، وصف الميزة، وراجع ما يظهر في Studio.