باختصار
ضع 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 يُحدث ضررًا باللمس.
في هذه الصفحة
كيف يعمل pathfinding الـ NPC
يبني Roblox شبكة ملاحة (navigation mesh) من الأسطح التي يمكن للشخصية المشي عليها. يبحث PathfindingService في هذه الشبكة عن طريق بين نقطتين ويعيده كقائمة من نقاط المسار (waypoints): لكل واحدة موقع وإجراء، مثل المشي أو القفز. ثم يمشي Humanoid الخاص بالـ NPC من نقطة إلى التالية. الـ pathfinding يخطط للطريق فقط: أما التحرك عليه فمهمة سكربتك.
| 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 واقف في مكانه، ولا يوجد خطأ.
| المتطلب | لماذا هو مهم |
|---|---|
Humanoid باسم Humanoid | MoveTo وWalkSpeed والقفز كلها تابعة للـ Humanoid. |
HumanoidRootPart | القطعة التي يتحكم بها الـ Humanoid. المسارات تبدأ من موقعها. |
| لا شيء مثبّت (Anchored) | القطعة المثبتة لا تستطيع الحركة، ولا القطع المتصلة بها. القطع المثبتة يملكها الخادم دائمًا، لذلك لا يمكن تطبيق إصلاح الارتجاف المذكور أدناه عليها. |
- افتح تبويب Avatar أو Home واضغط Character لفتح Rig Generator. اختر R15، ثم Block Avatar. سيظهر rig في Workspace. الـ rigs من نوع R6 تعمل مع السكربتات نفسها.
- أعد تسمية الـ rig إلى
Chaserوضعه في مكان مفتوح. - حدّد HumanoidRootPart الخاص به وتأكّد أن Anchored في نافذة Properties غير مفعّل. افعل الشيء نفسه مع أي قطعة مثبتة أخرى في النموذج. لتجدها بسرعة، فعّل Anchored parts في أداة Visualization Options في الزاوية العلوية اليمنى من نافذة العرض ثلاثية الأبعاد.
Workspace
Chaser Model
Humanoid Humanoid
HumanoidRootPart Part
Head, UpperTorso, LowerTorso ... (أجزاء الجسم)
ChaseAI Script new
TouchDamage Script new
لكي يتكلم الـ NPC أيضًا، يضيف دليل الحوار مع الـ NPC تلميح Talk مع خيارات للرد ويشرح ما الذي يتغير عندما يمشي الـ NPC. ولعرض الزعيم بالكاميرا قبل أن يبدأ المطاردة، انظر دليل المشاهد السينمائية (cutscenes).
الخطوة 2: نرسل الـ NPC إلى نقطة
ابدأ بأصغر سكربت يعمل: المشي إلى قطعة ثابتة. فهو يبيّن كل مرحلة من مراحل الـ pathfinding دون منطق المطاردة.
- أدرج Part في Workspace، وسمّه
Goal، وفعّل Anchored، وألغِ CanCollide، وضعه على الأرض بحيث يضطر الـ NPC إلى الالتفاف حول جدار. - في Explorer مرّر المؤشر فوق Chaser، واضغط الزر + وأدرج Script. سمّه
WalkToGoalوالصق الكود أدناه. - اضغط Play. يلتف الـ NPC حول الجدار ويمشي إلى القطعة 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
-- يجب أن يملك الخادم فيزياء الـ 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)، كي يتجنب الطريق الفتحات التي لا يمر منها. السكربت أعلاه يضبط المفاتيح الثلاثة الأولى على قيمها الافتراضية، كي يتضح أين تغيّرها.
| المفتاح | الافتراضي | ماذا يحدد |
|---|---|---|
AgentRadius | 2 | نصف قطر الـ NPC بالستد. زِده للـ NPC العريضة كي تبقى المسارات بعيدة عن الجدران. |
AgentHeight | 5 | ارتفاع الـ NPC. الأماكن الأخفض من هذا، مثل ما تحت الدرج، تُعدّ مسدودة. |
AgentCanJump | true | يسمح بطرق تحتاج إلى قفزة. نقاط المسار هذه تكون Action فيها Jump. |
AgentCanClimb | false | يسمح بالتسلق على TrussPart. نقاط المسار هذه تحمل الوسم Climb. |
WaypointSpacing | 4 | المسافة بالستد بين نقاط المسار الوسيطة. 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 ستد، ويلتف حول الجدران، ويقفز حيث يحتاج الطريق، ويجد طريقًا جديدًا عندما يسدّه شيء، ويعود إلى البيت عندما لا يكون أحد قريبًا.
- احذف
WalkToGoalمن Chaser إن كنت أضفته. - مرّر المؤشر فوق Chaser، واضغط +، وأدرج Script باسم
ChaseAIوالصق الكود أدناه. - اضغط Play، وادخل خلف الجدار، ثم اهرب خارج المدى. يلتف الـ NPC حول الجدار خلفك، ثم يعود إلى حيث بدأ.
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 يرتجف، أو يتجمد عند كل نقطة مسار، أو يخطو إلى الخلف، فالسبب عادةً واحد من البنود أدناه. سكربت المطاردة يعالج كلًا منها بالفعل؛ الجدول موجود لإصلاح سكربت كتبته بنفسك.
| ما تراه | السبب | الإصلاح |
|---|---|---|
| سلس حين يكون وحده، ومتقطع حين يقترب لاعب | ملكية الشبكة (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 سكربتًا ثانيًا يُحدث ضررًا للاعبين عند اللمس. هو يعمل على الخادم، لذلك لا يستطيع عميل اللاعب تغيير الضرر أو تجاوز فترة التهدئة.
- في ChaseAI اضبط
STOP_DISTANCEعلى0، كي يقترب الـ NPC من اللاعبين حتى الالتصاق بدل التوقف بجانبهم. - أدرج في Chaser سكربت Script باسم
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
- غطِّ المنطقة بقطعة فيها Anchored مفعّل وCanCollide ملغى.
- أدرج في هذه القطعة PathfindingModifier واضبط
Labelالخاص به علىDangerZone. - هذا كل شيء. سكربت المطاردة يعطي
DangerZoneبالفعل التكلفةmath.huge، لذلك يتجنب الـ NPC هذه المنطقة. فعّل Pathfinding modifiers في Visualization Options لترى الوسم على شبكة الملاحة.
المعدِّل الذي فيه PassThrough مفعّل يفعل العكس: يمر الطريق عبر عائق صلب، مثل باب مغلق، كأنه غير موجود. لا يزال الـ NPC عاجزًا عن المرور عبر الباب، لكنه يمشي نحوه كأنه سمع اللاعب من الجهة الأخرى.
انتقالات خاصة بك: PathfindingLink
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 من الضرر باللمس مع فترة تهدئة قدرها ثانية واحدة.
- يمكنه أولًا فحص النموذج عبر 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 عندما تبدأ الجولة، ويدمّرها عندما تنتهي. دليل نظام الجولات يبني دورة الاستراحة والجولة التي يرتبط بها هذا.
المصادر والقراءات
- Roblox Creator Docs: Pathfinding (بالإنجليزية). معاملات الوكيل، ونقاط المسار، والمسارات المسدودة، والمعدِّلات، والروابط، والحدود
- Roblox Creator Docs: PathfindingService (بالإنجليزية). CreatePath والقيم الافتراضية
- Roblox Creator Docs: Path (بالإنجليزية). ComputeAsync وGetWaypoints وStatus والحدث Blocked
- Roblox Creator Docs: Humanoid (بالإنجليزية). MoveTo، ومهلة MoveToFinished ذات الثماني ثوانٍ، وChangeState، وTakeDamage
- Roblox Creator Docs: Network ownership (بالإنجليزية). الملكية التلقائية، وSetNetworkOwner، ووضع Network owners
- Roblox Creator Docs: RaycastParams (بالإنجليزية). ExcludeInstances وRespectCanCollide
- Roblox Creator Docs: NPC kit (بالإنجليزية). أمثلة NPC مع سكربتات Animate خاصة بها
كيف فُحص الكود: كل سكربت في هذه الصفحة يجتاز الفاحص الصارم للأنواع في Luau مع تعريفات واجهة Roblox البرمجية (luau-lsp، ٢٠ نوفمبر ٢٠٢٦). فحص الأنواع يكشف الأخطاء في أسماء الواجهات البرمجية والأنواع الخاطئة، لا منطق اللعبة، فجرّب الكود في Studio قبل النشر.