باختصار
ابنِ الباب كـ Part أو Model، وفعّل Anchored، وانقل pivot الخاص به إلى الحافة التي فيها المفصلات (تبويب Model، ثم Pivot)، وأضف الوسم Door في نافذة Properties. يجد Script واحد في ServerScriptService كل الأبواب الموسومة عبر CollectionService، ويضيف ProximityPrompt ("Open"، مع الضغط المطوّل على E)، وعند الحدث Triggered يحرّك بـ Tween قيمة NumberValue من 0 إلى 1، فيتحرك الباب عبر door:PivotTo(closedPivot:Lerp(openPivot, alpha)). والسمات (attributes) على كل باب تحدد هل هو دوّار أم منزلق، والزاوية، والمدة، والإغلاق التلقائي، والمفتاح.
- لا يمكن تحريك موضع Model بـ Tween مباشرة: ليس لدى Model خاصية CFrame أو Position، و
WorldPivotالخاص بها يحدد مكان الـ pivot فقط. حرّك NumberValue بـ Tween وحرّك الباب عبرPivotTo: تسميه Roblox الطريقة الأساسية لتحريك النماذج من سكربت. - افتح الأبواب على الخادم. الباب الذي يُفتح من LocalScript يتحرك على شاشة ذلك اللاعب فقط.
- تحقّق من المفتاح والمسافة على الخادم. يقول دليل الأمان في Roblox إن ProximityPrompt يمكن إساءة استخدامه تمامًا مثل RemoteEvent، ويذكر هناك أيضًا مثالًا على فحص يجب أن يجريه الخادم: هل يملك اللاعب المفتاح اللازم لفتح الباب.
في هذه الصفحة
كيف يعمل الباب المبرمج بسكربت
الباب الذي يعمل في لعبة حقيقية يجب أن يحرّكه الخادم. إذا حرّكه LocalScript، فسيُفتح الباب على شاشة لاعب واحد ويبقى مغلقًا لكل الآخرين، لأن التغيير الذي يجريه العميل يبقى على ذلك الجهاز (راجع ما الذي يتكرر عبر الشبكة وما الذي لا يتكرر). لذلك في هذا الدليل يكتفي جهاز اللاعب بعرض التلميح والإبلاغ عن ضغط المفتاح، ويتولى Script واحد على الخادم كل ما عدا ذلك. استخدام الباب مرة واحدة يبدو هكذا:
- يقترب اللاعب من الباب لأقل من 8 ستاد، فيظهر تلميح فيه الإجراء Open واسم الكائن Door والمفتاح E على لوحة المفاتيح. على يد التحكم أو الشاشة اللمسية تعرض Roblox الزر المناسب.
- يضغط اللاعب مطوّلًا على E لمدة 0.2 ثانية. ينطلق الحدث
Triggeredالخاص بالتلميح على الخادم مع هذا اللاعب. - يتحقق DoorService من اللاعب: حي، وقريب بما يكفي، ولا يكرر استخدام التلميح بسرعة مزعجة، ويحمل المفتاح إذا كان الباب يتطلبه.
- يحرّك السكربت بـ Tween رقمًا من 0 (مغلق) إلى 1 (مفتوح). ومع كل تغيّر في الرقم ينقل الباب عبر
PivotToبهذا الجزء من الطريق بين الوضع المغلق والوضع المفتوح. - بعد أربع ثوانٍ من الفتح الكامل يُغلق الباب بالطريقة نفسها. والضغط أثناء الحركة يعيد الباب إلى الاتجاه المعاكس من حيث هو.
| العنصر | مكانه | ماذا يفعل |
|---|---|---|
Script DoorService | ServerScriptService | يجد كل الأبواب، ويضيف تلميحًا لكل منها، ويتحقق من كل استخدام، ويحرّك الباب. السكربت الوحيد في هذا الدليل. |
الوسم Door | على كل Part أو Model لباب | يحدد ما هو باب. تُضاف الوسوم في نافذة Properties وتُحفظ مع المكان. |
سمات، مثل Style وKeyName | على كل باب (اختياري) | إعدادات باب واحد: دوّار أم منزلق، والزاوية، والسرعة، والإغلاق التلقائي، والمفتاح. |
ProximityPrompt DoorPrompt | داخل الباب (يضيفه DoorService) | يعرض "Open" أو "Close" ويطلق Triggered عندما يضغط اللاعب مطوّلًا على E. |
NumberValue DoorProgress | داخل الباب (يضيفه DoorService) | الرقم الذي يحرّكه الـ Tween بين 0 و1. كل تغيير يحرّك الباب. |
Tool RedKey (اختياري) | StarterPack، للاختبار | مفتاح الباب المقفل. يصلح أي Tool إذا كان اسمه مطابقًا لـ KeyName الخاص بالباب. |
Workspace
FrontDoor Part new
VaultDoor Model new
Panel Part new
Knob Part new
ServerScriptService
DoorService Script new
StarterPack
RedKey Tool new
Handle Part new
الخطوة 1: ابنِ الباب وحدّد المفصلة
- في Explorer مرّر المؤشر فوق Workspace، واضغط الزر + وأدرج Part. سمِّه
FrontDoor، واضبطSizeعلى نحو4, 7, 0.5(عرض 4 ستاد، وارتفاع 7، وسماكة نصف ستاد)، وضعه في فتحة الباب. يصلح أيضًا باب من عدة قطع: حدّدها واضغط Ctrl+G لتجميعها في Model. - فعّل Anchored لكل قطعة في الباب واترك CanCollide مفعّلًا. القطع المثبّتة لا تتحرك أبدًا بسبب الجاذبية أو التصادمات، لكن السكربت يستطيع تحريكها رغم ذلك، وهذا بالضبط ما يفعله DoorService.
- حدّد المفصلة. حدّد الباب، وافتح تبويب Model وفعّل Pivot. اضغط مطوّلًا على السهم الصغير في زاوية زر Pivot وفعّل Snap، حتى يلتصق الـ pivot بنقاط الارتكاز في الزوايا والحواف والمراكز. اسحب الـ pivot إلى حافة الباب التي ستكون فيها المفصلات. في الباب المنزلق يمكن أن يبقى الـ pivot في المركز.
- أضف الوسم. دون إلغاء تحديد الباب، مرّر نافذة Properties حتى Tags، واضغط + واكتب
Doorبحرف D كبير. إذا كان الباب Model، فضع الوسم على الـ Model نفسها، لا على القطع التي بداخلها. - ابنِ بابًا ثانيًا، ستحتاج إليه في القسمين الخاصين بالأبواب المنزلقة والمفتاح. أدرج في Workspace قطعتي Part أخريين:
Panelبحجم نحو4, 7, 0.5، وKnobبحجم نحو0.5, 0.5, 0.5ملاصقة لأحد وجهي Panel. حدّد الاثنتين، واضغط Ctrl+G وأعد تسمية الـ Model الجديدة إلىVaultDoor. ثبّت القطعتين، وضع النموذج في الفتحة الثانية، وأضف الوسمDoorإلى الـ Model. يمكن أن يبقى الـ pivot الخاص بها في المركز، لأن هذا الباب سيكون منزلقًا.
الـ pivot مهم لأن الباب الدوّار يدور حوله. إذا تركته في المركز، فسيدور الباب في مكانه مثل الباب الدوّار في المتاجر. في القطعة يُحفظ الـ pivot الذي حددته كـ PivotOffset، وGetPivot يأخذه في الحسبان، لذا يدير السكربت الباب حول النقطة التي اخترتها تمامًا. إذا كان لدى الـ Model قطعة PrimaryPart، فإن pivot النموذج هو pivot تلك القطعة، ويعلّق DoorService التلميح عليها أيضًا. ومن دون PrimaryPart يذهب التلميح إلى أول قطعة يُعثر عليها داخل النموذج. إذا كنت ستحدد PrimaryPart، فافعل ذلك قبل تحريك الـ pivot: تعيين PrimaryPart ينقل pivot النموذج إلى pivot تلك القطعة، كما تشير صفحة Roblox عن Pivot tools.
إعدادات الباب (السمات)
يعمل أي باب بالقيم الافتراضية في الجدول أدناه. لتغيير باب واحد، حدّده، ومرّر نافذة Properties حتى Attributes، واضغط +، واكتب الاسم، واختر النوع واضغط Save، ثم اضبط القيمة. يقرأ DoorService السمات مرة واحدة عندما يُعدّ الباب، لذا غيّرها واللعبة متوقفة.
| السمة | النوع | الافتراضي | ماذا تفعل |
|---|---|---|---|
Style | string | Swing | Swing يدير الباب حول الـ pivot الخاص به. وSlide يزيحه جانبًا على امتداد عرضه. |
OpenAngle | number | 90 | كم درجة يدور الباب الدوّار. الرقم السالب يفتحه في الاتجاه الآخر. أبقِ القيمة بين -179 و179: الباب يسلك دائمًا القوس الأقصر، لذا يحصر DoorService الزاوية ضمن هذين الحدين. |
SlideDistance | number | عرضه | كم ستاد ينزلق الباب المنزلق على امتداد عرضه. الرقم السالب يزيحه في الاتجاه الآخر. |
OpenSeconds | number | 0.6 | كم يستغرق الفتح أو الإغلاق الكامل، بين 0.05 و10. |
AutoCloseSeconds | number | 4 | كم يبقى الباب مفتوحًا بالكامل قبل أن يُغلق نفسه. القيمة 0 تبقيه مفتوحًا إلى أن يغلقه أحد. |
KeyName | string | لا يوجد | اسم الـ Tool الذي يجب أن يملكه اللاعب لفتح الباب، مثل RedKey. لا تضبطه للباب الذي يمكن لأي أحد فتحه. |
الخطوة 2: أضف سكربت الباب
مرّر المؤشر فوق ServerScriptService، وأدرج Script باسم DoorService والصق فيه الكود أدناه. إنه يدير كل الأبواب في المكان، مهما كان عدد الأبواب التي وسمتها. الإعدادات الثلاثة في البداية تسري على كل الأبواب؛ وسمات الخطوة 1 تغيّر بابًا واحدًا.
-- Script في ServerScriptService باسم DoorService.
-- يفتح ويغلق كل Part أو Model يحمل الوسم "Door" عبر تلميح بالضغط المطوّل على E.
-- الخادم يحرّك الباب، لذا يرى كل اللاعبين الباب نفسه، والخادم أيضًا
-- يتحقق من المسافة والمفتاح، لذا لن يفتح أحد بابًا مقفلًا من بعيد.
--
-- سمات اختيارية على كل باب (تُضبط في نافذة Properties):
-- Style string "Swing" (الافتراضي) أو "Slide"
-- OpenAngle number كم درجة يدور الباب الدوّار حول الـ pivot (الافتراضي 90، من -179 إلى 179)
-- SlideDistance number كم ستاد ينزلق الباب المنزلق على امتداد عرضه (الافتراضي: عرضه)
-- OpenSeconds number كم يستغرق الفتح (الافتراضي 0.6)
-- AutoCloseSeconds number يُغلق من جديد بعد هذا العدد من الثواني؛ 0 يبقيه مفتوحًا (الافتراضي 4)
-- KeyName string اسم الـ Tool الذي يجب أن يملكه اللاعب، مثل "RedKey"
local CollectionService = game:GetService("CollectionService")
local TweenService = game:GetService("TweenService")
local DOOR_TAG = "Door"
local PROMPT_DISTANCE = 8 -- ستاد
local MIN_SECONDS_BETWEEN_USES = 0.3 -- لكل باب، ضد تكرار استخدام التلميح
local doorsSetUp: { [Instance]: boolean } = {}
local function attribute(door: Instance, name: string, default: any): any
local value = door:GetAttribute(name)
if value == nil or typeof(value) ~= typeof(default) then
return default
end
if typeof(value) == "number" and (value ~= value or math.abs(value) == math.huge) then
return default -- NaN أو ما لا نهاية، أُدخلا في نافذة Properties
end
return value
end
local function hasKey(player: Player, keyName: string): boolean
local backpack = player:FindFirstChildOfClass("Backpack")
local character = player.Character
local inBackpack = backpack and backpack:FindFirstChild(keyName)
local held = character and character:FindFirstChild(keyName)
return (inBackpack ~= nil and inBackpack:IsA("Tool")) or (held ~= nil and held:IsA("Tool"))
end
local function setUpDoor(door: Instance)
if doorsSetUp[door] or not (door:IsA("BasePart") or door:IsA("Model")) then
return -- باب يعمل بالفعل، أو ليس قطعة ولا نموذجًا
end
local promptPart = if door:IsA("Model") then (door.PrimaryPart or door:FindFirstChildWhichIsA("BasePart", true)) else door
if not (promptPart and promptPart:IsA("BasePart")) then
warn(`DoorService: {door:GetFullName()} has no part to put the prompt on`)
return
end
doorsSetUp[door] = true
door.Destroying:Connect(function()
doorsSetUp[door] = nil
end)
-- نسخة الباب العامل تجلب معها التلميح والقيمة القديمين: نحذفهما
for _, leftover in door:GetDescendants() do
if leftover.Name == "DoorPrompt" or leftover.Name == "DoorProgress" then
leftover:Destroy()
end
end
-- نحسب الوضعين المغلق والمفتوح مرة واحدة، من المكان الذي يقف فيه الباب الآن
local closedPivot = door:GetPivot()
local openPivot: CFrame
if attribute(door, "Style", "Swing") == "Slide" then
-- ننزلق على امتداد الضلع الأفقي الأطول للباب، أي عرضه. يُقاس الـ Model على امتداد
-- أضلاع الـ pivot الخاص به، والـ Part حسب Size الخاص به، لذا لا تُدِر pivot القطعة المنزلقة
local size = if door:IsA("Model") then door:GetExtentsSize() else (door :: BasePart).Size
local alongX = size.X >= size.Z
local width = if alongX then size.X else size.Z
local direction = if alongX then Vector3.xAxis else Vector3.zAxis
openPivot = closedPivot * CFrame.new(direction * attribute(door, "SlideDistance", width))
else
-- الـ Lerp يدور دائمًا على القوس الأقصر، لذا فالزاوية الأكبر ستفتح الباب في الاتجاه الخطأ
local angle = math.clamp(attribute(door, "OpenAngle", 90), -179, 179)
openPivot = closedPivot * CFrame.Angles(0, math.rad(angle), 0)
end
local openSeconds = math.clamp(attribute(door, "OpenSeconds", 0.6), 0.05, 10)
local autoClose = math.max(attribute(door, "AutoCloseSeconds", 4), 0)
local keyName = attribute(door, "KeyName", "")
-- نحرّك بـ Tween رقمًا من 0 (مغلق) إلى 1 (مفتوح) ونحرّك الباب معه.
-- PivotTo يحرّك قطعة واحدة أو نموذجًا كاملًا حول الـ pivot الخاص به.
local progress = Instance.new("NumberValue")
progress.Name = "DoorProgress"
progress.Parent = door
progress.Changed:Connect(function(alpha: number)
door:PivotTo(closedPivot:Lerp(openPivot, alpha))
end)
local prompt = Instance.new("ProximityPrompt")
prompt.Name = "DoorPrompt"
prompt.ActionText = "Open"
prompt.ObjectText = if keyName ~= "" then `Needs {keyName}` else "Door"
prompt.HoldDuration = 0.2
prompt.MaxActivationDistance = PROMPT_DISTANCE
prompt.RequiresLineOfSight = false
prompt.Parent = promptPart
local isOpen = false
local lastUse = 0
local moveCount = 0
local function move(open: boolean)
isOpen = open
moveCount += 1
door:SetAttribute("Open", open) -- تستطيع السكربتات الأخرى قراءة هذا
prompt.ActionText = if open then "Close" else "Open"
-- الـ Tween الجديد على القيمة نفسها يلغي القديم، لذا يستطيع الباب الانعكاس في منتصف الطريق.
-- نضبط المدة حسب ما تبقى له من مسافة.
local target = if open then 1 else 0
local seconds = openSeconds * math.abs(target - progress.Value)
TweenService:Create(progress, TweenInfo.new(seconds, Enum.EasingStyle.Quad, Enum.EasingDirection.Out), { Value = target }):Play()
if open and autoClose > 0 then
local thisMove = moveCount
task.delay(openSeconds + autoClose, function()
if moveCount == thisMove and isOpen then
move(false)
end
end)
end
end
prompt.Triggered:Connect(function(player: Player)
local now = os.clock()
if now - lastUse < MIN_SECONDS_BETWEEN_USES then
return
end
-- يقول دليل الأمان في Roblox إن التلميحات يمكن إساءة استخدامها مثل الـ Remotes، لذا نتحقق هنا مرة أخرى
local character = player.Character
local humanoid = character and character:FindFirstChildOfClass("Humanoid")
local rootPart = humanoid and humanoid.RootPart
if not (humanoid and rootPart) or humanoid.Health <= 0 then
return
end
if (rootPart.Position - promptPart.Position).Magnitude > PROMPT_DISTANCE + 6 then
return -- بعيد جدًا عن الاستخدام الصادق للتلميح
end
if keyName ~= "" and not isOpen and not hasKey(player, keyName) then
return -- مقفل، وهذا اللاعب لا يملك المفتاح
end
lastUse = now
move(not isOpen)
end)
end
-- كل الأبواب الموسومة الآن وكل ما سيُوسم لاحقًا (بما في ذلك الأبواب التي تستنسخها السكربتات)
for _, door in CollectionService:GetTagged(DOOR_TAG) do
setUpDoor(door)
end
CollectionService:GetInstanceAddedSignal(DOOR_TAG):Connect(setUpDoor)
يضيف DoorService بنفسه DoorPrompt وDoorProgress إلى كل باب عند تشغيل اللعبة، لذا لا حاجة إلى إدراج أي شيء يدويًا. احتفظ بنسخة واحدة من السكربت: إنها تخدم كل الأبواب الموسومة بالفعل.
| جزء السكربت | ماذا يفعل | لماذا |
|---|---|---|
attribute() | يقرأ سمة واحدة ويعيد القيمة الافتراضية إذا لم تكن السمة موجودة، أو كان نوعها خاطئًا، أو لم تكن رقمًا حقيقيًا (NaN أو ما لا نهاية). | الخطأ المطبعي في نافذة Properties ينتج بابًا بالإعدادات الافتراضية، لا بابًا معطّلًا. |
doorsSetUp وحلقة الـ leftover | يُعدّ كل باب مرة واحدة، ويحذف أولًا DoorPrompt أو DoorProgress المنسوخين من باب آخر. | وإلا لكان لنسخة الباب العامل تلميحان، أحدهما لا يعمل. |
closedPivot وopenPivot | يُحسبان مرة واحدة، من المكان الذي يقف فيه الباب لحظة الإعداد. الباب الدوّار يدير الـ pivot حول محوره الرأسي نفسه؛ والمنزلق يزيحه على امتداد الضلع الأطول للباب. | الـ Lerp من الـ pivot المغلق إلى المفتوح يُبقي الـ pivot في مكانه بينما يدور الباب، لذا لا تتحرك حافة المفصلات طوال الدوران. |
DoorProgress وPivotTo | الـ Tween يغيّر الرقم؛ وكل تغيير يضع الباب عند closedPivot:Lerp(openPivot, alpha). | يستطيع TweenService تحريك NumberValue، وPivotTo يحرّك قطعة أو نموذجًا بكل قطعه بحيث يصبح الـ pivot عند هذا الـ CFrame. |
| التلميح | HoldDuration 0.2، وMaxActivationDistance 8، وRequiresLineOfSight معطّل. الباب المقفل يعرض "Needs RedKey". | مع تفعيل خط الرؤية يختفي التلميح عندما يحجب شيء قطعته؛ ومن دونه لا يُخفي الإطار أو بقية أجزاء الباب النموذج التلميحَ. |
move() | يشغّل الـ Tween نحو 1 أو نحو 0، ويضبط المدة حسب ما تبقى للباب من مسافة. | الـ Tween الجديد على القيمة نفسها يلغي القديم، لذا فالباب الذي يُعكس في منتصف الطريق يعود بسلاسة ويستغرق نصف المدة. |
| الإغلاق التلقائي | ينتظر مدة الفتح زائد AutoCloseSeconds، ثم يغلق الباب فقط إذا لم يتغير moveCount. | المؤقت القديم لن يغلق أبدًا بابًا أغلقه أحد وفتحه من جديد في هذه الأثناء. |
الفحوص في Triggered | استخدام واحد للباب كل 0.3 ثانية، وشخصية حية، وعلى بعد لا يزيد عن 14 ستاد من قطعة التلميح، والمفتاح، لكن للفتح فقط. | كل ما يستطيع العميل إطلاقه يمكن إساءة استخدامه، لذا يعيد الخادم الفحوص. الـ 14 ستاد هي 8 ستاد للتلميح زائد 6 هامشًا للاعب الذي تحرك أثناء ضغطه المطوّل على E. |
السمة Open | تُضبط على الباب مع كل حركة. | السمات التي تُضبط على الخادم تتكرر لكل اللاعبين، لذا تستطيع السكربتات الأخرى، ومنها LocalScript، الاستماع إليها عبر GetAttributeChangedSignal("Open"). |
وسم كل الأبواب وإدارتها من سكربت واحد هو النهج الذي توصي به Roblox نفسها: يقول مرجع CollectionService إنك إذا كنت تضيف السكربت نفسه إلى كائنات كثيرة، فقد يكون سكربت يعتمد على CollectionService أفضل. يعيد GetTagged الأبواب الموجودة عند تشغيل السكربت، ويلتقط GetInstanceAddedSignal الأبواب التي تُوسم أو تُضاف لاحقًا. هذه الطريقة في تنظيم المكان مشروحة في دليل سكربتات العميل والخادم.
كيف تصنع بابًا منزلقًا
حدّد VaultDoor، وأضف سمة من نوع string باسم Style واضبط قيمتها على Slide. الآن لا يدور الباب، بل ينزلق جانبًا: بمقدار عرضه، أو بمقدار SlideDistance ستاد إذا ضبطتها. لكي ينزلق في الاتجاه الآخر، اضبط مسافة سالبة، مثل -4 لباب عرضه 4 ستاد. وأي باب آخر، بما فيه FrontDoor، يصبح منزلقًا بالطريقة نفسها بمجرد أن يحصل على هذه السمة.
يقيس DoorService البعدين الأفقيين للباب، العرض والسماكة، ويحرّكه على امتداد الأكبر منهما. يقيس الـ Model عبر GetExtentsSize، الذي يتبع صندوقه اتجاه pivot النموذج، لذا فالباب الذي أُدير 90 درجة بعد التجميع ينزلق مع ذلك على امتداد عرضه لا سماكته. ويقيس الـ Part من خلال Size الخاص بالقطعة نفسها، لذا لا تُدِر pivot القطعة المنزلقة. أما تحريك هذا الـ pivot فمسموح.
- الأبواب المزدوجة: نصفان موسومان متجاوران، لكل منهما
Styleيساوي Slide، ولأحدهماSlideDistanceسالبة، حتى يتباعدا من المنتصف. وللأبواب المزدوجة الدوّارة ضع pivot كل نصف على حافته الخارجية، وأعطِ أحد النصفينOpenAngleسالبة. لكل نصف تلميحه الخاص، ويُفتح وحده. إذا كان النصفان ينزلقان أحدهما نحو الآخر، فانقل إشارة السالب إلى النصف الآخر. - بوابات ترتفع إلى الأعلى: هذا السكربت يحرّك الباب على امتداد عرضه فقط. لكي ترتفع الأبواب، اضبط
directionفي السكربت علىVector3.yAxis(عندها سترتفع كل الأبواب المنزلقة) وأعطِ كل بابSlideDistanceتساوي ارتفاعه. - باب يعمل بالفيزياء: درس Roblox عن الأجسام المتحركة يحرّك القطع على محور واحد عبر PrismaticConstraint. ومثل الباب ذي المفصلة، هذه فيزياء، دون تلميح ولا قفل إلى أن تكتبهما بنفسك.
كيف تقفل الباب بمفتاح
الباب المقفل لا يُفتح إلا للاعب الذي يملك Tool بالاسم المطلوب. اصنع المفتاح، ثم أخبر الباب باسمه:
- مرّر المؤشر فوق StarterPack، واضغط + وأدرج Tool باسم
RedKey. أدرج فيه Part واحدة باسمHandle، وهي القطعة التي تمسكها الشخصية بيدها، وتأكد أنها غير مثبّتة: القطعة المثبّتة في أداة تسمّر الشخصية في مكانها. ألغِ تحديدCanBeDroppedفي الـ Tool إذا كان يجب ألا يرمي اللاعبون المفتاح لغيرهم: ما دام مفعّلًا، يرمي Backspace الأداة المجهّزة في Workspace. - حدّد VaultDoor، وأضف سمة من نوع string باسم
KeyNameواضبط قيمتها علىRedKey. الآن يظهر في اسم الكائن على التلميح Needs RedKey.
يبحث DoorService عن المفتاح في مكانين. الـ Tool يكون في Backpack اللاعب إلى أن يُجهَّز، والتجهيز ينقله إلى الشخصية، لذا يُفتح الباب سواء كان المفتاح في شريط الأدوات أو في اليد. يجري الفحص على الخادم، لأن دليل الأمان في Roblox يذكر هذه الحالة بالتحديد، أي هل يملك اللاعب مفتاح الباب، كحق يجب على الخادم التحقق منه. المفتاح مطلوب للفتح فقط: يستطيع أي أحد إغلاق الباب المفتوح، وهو يُغلق نفسه بعد AutoCloseSeconds.
يعطي StarterPack المفتاح للجميع عند كل ظهور (spawn)، وهذا ما تحتاجه للاختبار. في لعبة حقيقية أعطه بطريقة أخرى:
- من متجر: دليل واجهة المتجر يعطي Tool من ServerStorage إلى Backpack وStarterGear الخاصين بالمشتري.
- من شخصية: دليل حوار NPC يعطي Tool من
ServerStorage.DialogueItemsعندما يختار اللاعب خيارًا فيه الإجراءGiveItem. ضع في هذا المجلد Tool باسم RedKey، واضبط للخيار في DialogueDataaction = "GiveItem"وitem = "RedKey"، فيُعطى المفتاح أثناء الحوار. - كعنصر في المخزون: مع نظام المخزون يعمل عنصر المفتاح بمجرد أن يجهّزه اللاعب، لأن التجهيز يضع نسخة من الـ Tool الخاص به في Backpack وفي اليد.
المفتاح الموجود في Backpack يضيع عندما تموت الشخصية، لأن Roblox تعيد ملء Backpack عند كل ظهور من StarterPack وStarterGear. لكي تحتفظ به، ضع نسخة منه في StarterGear الخاص باللاعب أيضًا، كما يفعل دليل المتجر. وإذا أردت العكس، أي أن يُستهلك المفتاح، فابحث عن Tool المفتاح في Backpack اللاعب أو في شخصيته ودمّره داخل معالج Triggered، مباشرة بعد نجاح فحص المفتاح.
أين تخطئ دروس الأبواب القديمة
إذا كنت تقارن هذا الدليل بفيديو أو منشور في منتدى، فهذه هي الأساليب التي تسبب معظم مواضيع «الباب لا يعمل عندي»، وما يفعله هذا الدليل بدلًا منها.
| الدرس | المشكلة | هذا الدليل |
|---|---|---|
يحرّك CFrame الخاص بباب من نوع Model بـ Tween | لا توجد في مرجع Model خاصية CFrame أو Position. وWorldPivot الخاص بها يحدد مكان pivot النموذج فقط، لذا فتحريكه بـ Tween ينقل نقطة الـ pivot بينما تبقى القطع في مكانها. | يحرّك NumberValue بـ Tween وينقل النموذج كله عبر PivotTo. |
ينقل النموذج عبر SetPrimaryPartCFrame | قديمة: تنصح Roblox باستخدام PivotTo في المشاريع الجديدة. | يستخدم PivotTo، الذي تسميه Roblox الدالة الأساسية لتحريك Model من السكربتات. |
| يلحم كل القطع بقطعة مفصلة واحدة ويحرّك المفصلة وحدها بـ Tween | يعمل عندما تكون كل وصلات Weld في مكانها، لكن أي قطعة غير ملحومة تبقى خلفها عندما تتحرك المفصلة. | يبقي كل القطع مثبّتة، دون Weld. وPivotTo يحرّك الباب وكل ما بداخله. |
| ينسخ السكربت نفسه في كل باب | كل إصلاح يجب تكراره في كل نسخة. تقترح Roblox وسم الكائنات ومعالجتها بسكربت واحد عبر CollectionService. | DoorService واحد والوسم Door. |
| يفتح الباب في LocalScript | يُفتح الباب على شاشة ذلك اللاعب فقط، بينما يراه الجميع مغلقًا. | الخادم يحرّك الباب، لذا يرى كل اللاعبين الباب نفسه. |
يفتح الباب عبر Touched | ينطلق Touched عدة مرات متتالية عند لمسة واحدة (صفحة Roblox عن الـ debounce)، ويستطيع جهاز اللاعب التحكم في توقيت انطلاق Touched لشخصيته (توثيق Roblox عن الأمان). | تلميح يتحقق منه الخادم. |
يحرّك الباب خطوة خطوة في حلقة بـ wait() | تصنّف Roblox الدالة wait() على أنها استُبدلت بـ task.wait()، والحلقة لا تستطيع الانعكاس في منتصف الطريق عندما يضغط أحد مرة أخرى. | Tween واحد لكل حركة. الـ Tween الجديد على القيمة نفسها يلغي القديم، لذا ينعكس الباب من مكانه الحالي. |
| يتحقق من المفتاح في LocalScript أو لا يتحقق أصلًا | الغشاش يتحكم في كل شيء على جهازه، لذا فالفحص على العميل لا يوقف أحدًا. | الخادم يبحث عن الـ Tool في Backpack اللاعب وفي شخصيته. |
| لا يوجد كولداون على التلميح | يقول دليل الأمان في Roblox إن التلميحات معرّضة لإساءة الاستخدام تمامًا مثل الـ Remotes، لذا لا شيء يمنع إطلاقه مرة بعد مرة. | استخدام واحد للباب كل 0.3 ثانية. |
ما الذي يستطيعه الغشاش وما الذي لا يستطيعه
افترض أن الغشاش يتحكم في كل شيء على جهازه، بما في ذلك شخصيته. هذا ما يعنيه ذلك لهذه الأبواب.
| الغشاش يحاول | النتيجة | لماذا |
|---|---|---|
| إطلاق التلميح من الطرف الآخر للخريطة | يُتجاهل إذا لم تكن شخصيته عند الباب | يقيس DoorService المسافة من القطعة الجذرية للشخصية إلى قطعة التلميح، ويتجاهل كل ما هو أبعد من 14 ستاد. يستطيع الغشاش أولًا نقل شخصيته إلى الباب (انظر السطر الأخير)، لذا فإن فحص المسافة يحمي من الاستخدام عن بُعد، لا من الانتقال الفوري. |
| إطلاقه مرات كثيرة في الثانية | لا أكثر من استخدام واحد للباب كل 0.3 ثانية | يحفظ الخادم وقت آخر استخدام لكل باب. |
| فتح باب بمفتاح دون مفتاح | رفض | يبحث الخادم عن الـ Tool في Backpack الخاص به وفي شخصيته حيث يراهما هو، لا على شاشة الغشاش. |
| استخدام الباب بينما الشخصية ميتة | يُتجاهل | يتحقق DoorService من وجود Humanoid صحته أكبر من 0 ومن وجود القطعة الجذرية. |
| المرور عبر الباب المغلق رغم ذلك | ممكن | يذكر توثيق Roblox عن الأمان تجاوز العوائق الفيزيائية وتغيير التصادمات الخاصة ضمن ما يستطيع العميل فعله بشخصيته. |
| الانتقال الفوري إلى ما خلف الباب | ممكن | يذكر التوثيق نفسه نقل الشخصية فوريًا إلى أي نقطة. |
الخطوة 3: اختبر
- اضغط Play (F5). اقترب من FrontDoor: ضمن 8 ستاد يظهر تلميح فيه الإجراء Open واسم الكائن Door. اضغط مطوّلًا على E. بعد 0.2 ثانية يُفتح الباب بزاوية 90 درجة حول حافة المفصلات خلال 0.6 ثانية، ويصبح مكتوبًا على التلميح Close.
- مرّ عبر الباب وانتظر. بعد أربع ثوانٍ من الفتح الكامل يُغلق الباب نفسه. اضغط مطوّلًا على E أثناء إغلاقه: ينعكس ويُفتح من حيث كان.
- اختبر القفل. إذا كان RedKey في StarterPack، فانقله مؤقتًا إلى ServerStorage، واضغط Play واضغط مطوّلًا على E عند VaultDoor: مكتوب على التلميح Needs RedKey، ولا يتحرك شيء. أوقف اللعبة، وأعد RedKey إلى StarterPack وشغّل من جديد: يُفتح VaultDoor سواء كان المفتاح في شريط الأدوات أو في اليد.
- اختبر الباب المنزلق. ينزلق VaultDoor، وهو Model قيمة
Styleفيه Slide، جانبًا بمقدار عرضه عند الفتح. أوقف اللعبة، وحدّد VaultDoor، وأدره 90 درجة بأداة Rotate وشغّل من جديد: يجب أن ينزلق على امتداد عرضه لا سماكته. عندما تنتهي، أعده كما كان. - اختر Server & Clients من القائمة المنسدلة لأوضاع الاختبار، واضبط عميلين واضغط Play. افتح الباب في نافذة أحد العميلين: سيكون مفتوحًا في النافذة الأخرى أيضًا ويُغلق في كلتيهما.
- أوقف اللعبة، وحدّد بابًا واضغط Ctrl+D لتكراره، ثم انقل النسخة إلى فتحة أخرى. تأكد أن Tags في النسخة ما زالت تحتوي على Door، واضغط Play: النسخة تعمل دون سكربت إضافي.
أبقِ نافذة Output مفتوحة (قائمة Window، ثم Output). عندما يعمل كل شيء لا يطبع DoorService أي شيء. التحذير الذي يقول إن الباب "has no part to put the prompt on" يعني أنه لا توجد قطع داخل الـ Model الموسومة. ولبقية المشكلات راجع قسم الأخطاء الشائعة.
كيف توسّعه
الأبواب التلقائية
لكي يُفتح الباب عندما يقترب أحد، استدعِ move(true) من داخل setUpDoor دون انتظار التلميح. في نهاية setUpDoor شغّل حلقة عبر task.spawn، لأن الحلقة العادية هناك لن تنتهي أبدًا، ولن يتقدم DoorService إلى ما بعد الباب الأول. اجعلها تعمل فقط ما دام الباب موجودًا في اللعبة: task.spawn(function() while door.Parent do ... task.wait(0.5) end end). داخل الحلقة تحقّق عبر workspace:GetPartBoundsInBox هل توجد شخصية داخل صندوق حول الفتحة، واستدعِ move(true) عندما تكون هناك والباب مغلق. بعد ذلك يغلقه الإغلاق التلقائي كما من قبل. اضبط Enabled للتلميح على false إذا كان يجب أن يُفتح الباب تلقائيًا فقط.
أبواب VIP
دليل الـ gamepass يبني بالفعل باب VIP يمر عبره مالكو الـ pass مباشرة، باستخدام مجموعات التصادم. ولباب VIP يُفتح بزر E، أضف فحصًا آخر في معالج Triggered بجانب فحص المفتاح: نفّذ return إذا لم يتحقق player:GetAttribute("OwnsPass_VIP") == true، وهي السمة التي يضبطها سكربت الخادم في دليل الـ gamepass. اقرأها على الخادم فقط.
لوحة الكود
للباب الذي يُفتح بإدخال كود، احفظ الكود في Script على الخادم أو في ServerStorage، اللذين لا يصلان إلى اللاعبين أبدًا، ولا تضعه بأي حال في LocalScript حيث يستطيع الغشاش قراءته. يرسل LocalScript الخاص باللوحة الأرقام المدخلة فقط عبر RemoteEvent. على الخادم تحقّق من أن اللاعب قرب الباب، وحدّ من تكرار المحاولات، وقارن الأرقام، وبعدها فقط استدعِ move(true). يبيّن دليل RemoteEvent كيف تتحقق مما يستقبله الـ Remote.
الأصوات
ضع Sound داخل قطعة الباب حتى يصدر من موضع تلك القطعة، واستدعِ دالته Play في بداية move. أو شغّله من LocalScript يستمع إلى السمة Open الخاصة بالباب عبر GetAttributeChangedSignal("Open")، فالخادم يضبط هذه السمة مع كل حركة.
أبواب تُضاف أثناء اللعب
استنسخ الأبواب الجديدة من قالب مغلق في ServerStorage. يقرأ DoorService الوضع المغلق للباب لحظة ظهوره، لذا فنسخة من باب كان مفتوحًا في تلك اللحظة ستعتبر وضعها المفتوح هو المغلق. ضع النسخة في الفتحة عبر PivotTo قبل أن تضبط Parent الخاص بها على Workspace، حتى يحفظ DoorService هذا المكان كوضع مغلق. التلميحات والقيم القديمة التي جاءت مع النسخة تُحذف تلقائيًا. وعن الباب الذي ينقل اللاعبين إلى منطقة أخرى أو مكان آخر، اقرأ دليل الانتقال (teleport).
الأخطاء الشائعة وحلولها
افتح نافذة Output (قائمة Window، ثم Output) قبل الضغط على Play. معظم مشكلات الأبواب سببها وسم أو pivot أو سمة تختلف قليلًا عما يتوقعه السكربت.
لا يظهر التلميح عند الباب
تحقّق بالترتيب: DoorService هو Script وليس LocalScript، وموجود مباشرة في ServerScriptService؛ والباب يحمل الوسم Door بحرف D كبير، وفي الباب النموذج يكون على الـ Model نفسها؛ والباب قطعة (Part أو MeshPart أو أي BasePart آخر) أو Model؛ وأنت تقف على بعد لا يزيد عن 8 ستاد من القطعة التي يُعلَّق عليها التلميح. التحذير في Output الذي يقول إن الباب "has no part to put the prompt on" يعني أنه لا توجد قطع داخل الـ Model الموسومة.
الباب يسقط أو ينجرف أو يُدفع عند تشغيل اللعبة
إحدى قطعه غير مثبّتة. حدّد كل قطع الباب وفعّل Anchored. القطع المثبّتة لا تتحرك أبدًا بفعل الفيزياء، لكن DoorService يستطيع تحريكها رغم ذلك.
غيّرت سمة لكن الباب يتجاهلها
تحقّق من ثلاثة أمور. النوع: يجب أن تكون OpenAngle وSlideDistance وOpenSeconds وAutoCloseSeconds سمات من نوع number، وStyle وKeyName من نوع string؛ وعند النوع الخاطئ يأخذ DoorService القيمة الافتراضية. الكتابة: الأسماء تُقارن حرفيًا، لذا فإن openAngle سمة مختلفة. والقيم تُقارن حرفيًا أيضًا: يجب أن تكون Style هي Slide بحرف S كبير ودون مسافات. التوقيت: يقرأ DoorService السمات مرة واحدة عندما يُعدّ الباب، لذا فالتغيير أثناء اختبار اللعب لا يفعل شيئًا إلى أن تشغّل اللعبة من جديد.
الباب يُفتح في الاتجاه الخطأ أو يميل على جانبه
لكي يُفتح في الاتجاه الآخر، اجعل OpenAngle سالبة، مثل -90. إذا كان يدور حول محور أفقي بدلًا من المفصلة الرأسية، فإن الـ pivot نفسه مُدار: فعّل Pivot في تبويب Model وأدِر الـ pivot حتى يعود رأسيًا.
الباب المنزلق يدخل في الجدار أو يتحرك قليلًا جدًا
أعطه SlideDistance سالبة حتى ينزلق في الاتجاه الآخر. وإذا كان يتحرك قليلًا جدًا أو بعيدًا جدًا، فاضبط في SlideDistance عدد الستاد المطلوب ولا تعتمد على العرض المقاس.
معي المفتاح لكن الباب لا يُفتح
يجب أن يكون المفتاح Tool، لا Part ولا Model، ويجب أن يطابق اسمه KeyName حرفيًا، بما في ذلك الأحرف الكبيرة. ويجب أن يكون في Backpack الخاص بك أو في يدك. وتأكد أيضًا أن KeyName على الباب سمة من نوع string.
اصنعه مع RoCode
إذا لم تكن ترغب في إعداد كل هذا يدويًا، فيستطيع RoCode بناءه في المكان المفتوح عندك. RoCode وكيل ذكاء اصطناعي مستقل لـ Roblox Studio، وليس من Roblox: تصف التغيير في دردشة الويب، فتنشئ إضافته لـ Studio السكربتات والكائنات في Explorer عندك، لذا لا تحتاج إلى لصق أي كود.
اجعل الأبواب التي تحمل الوسم Door تُفتح بتلميح مع الضغط المطوّل على E: دوران 90 درجة حول الـ pivot خلال 0.6 ثانية، وإغلاق بعد 4 ثوانٍ، وانزلاق بدل الدوران عندما تكون السمة Style تساوي Slide، ويبقى الباب مغلقًا إذا لم يكن لدى اللاعب Tool بالاسم الموجود في KeyName. كل شيء على الخادم، مع فحص المسافة.
- قد يستعرض مكانك عندما تحتاج الخطوة إلى ذلك، عبر Search Game وSearch Scripts، ليبني على العناصر أو الـ Remotes أو كود الحفظ الموجود لديك بدلًا من إضافة نظام ثانٍ
- يكتب Script في ServerScriptService عبر Create Script، وقد ينشئ قطعة الباب عبر Create Instance ويضبط عليها سمات مثل Style وKeyName
- لديه تعليمات بفحص ترجمة كل سكربت يكتبه عبر Check Script، الذي يترجمه في Studio دون تشغيله
- يضع نقطة تراجع قبل كل دفعة تغييرات وبعدها، لذا يتراجع Ctrl+Z عن دفعة واحدة في كل مرة
قبل الاختبار تحقّق من pivot كل باب بأداة Pivot في Studio: الباب يدور حوله. مع الإضافة 3.9 أو أحدث يستطيع RoCode تشغيل اختبار لعب قصير وقراءة الأخطاء، ومع الإضافة 3.9.15 أو أحدث يستطيع التحكم في شخصية اختبار تمشي وتضغط المفاتيح، لكنه يفحص فقط ما قرر اختباره بنفسه، لذا اقترب من كل باب واضغط مطوّلًا على E بنفسك. كيف يتصل RoCode بـ Studio.
الأسئلة الشائعة
كيف أجعل الباب يُفتح بزر E في Roblox Studio؟
ضع ProximityPrompt في الباب واربط الحدث Triggered الخاص به في Script على الخادم يحرّك الباب. يفعل DoorService الأمرين لكل باب يحمل الوسم Door. المفتاح E هو مفتاح التلميح الافتراضي، وتعرض Roblox الإدخال المناسب للوحات المفاتيح وأيادي التحكم والشاشات اللمسية.
لماذا يدور بابي حول منتصفه؟
الـ pivot الخاص به ما زال في المركز. فعّل Pivot في تبويب Model واسحب الـ pivot إلى حافة المفصلات؛ السكربت يدير الباب حول الـ pivot.
كيف أصنع بابًا منزلقًا؟
اضبط السمة Style للباب على القيمة Slide. سينزلق جانبًا بمقدار عرضه أو بمقدار SlideDistance ستاد؛ والمسافة السالبة تزيحه في الاتجاه الآخر.
هل يمكن صنع باب دون سكربتات؟
نعم. درس Roblox عن الباب ذي المفصلة يثبّت بابًا غير مثبّت على إطار عبر HingeConstraint بحدود، ويفتحه اللاعبون بدفعه بأجسامهم. ليس في هذا الباب تلميح ولا قفل ولا إغلاق تلقائي.
كيف أصنع بابًا لا يفتحه إلا الـ VIP؟
استخدم باب VIP من دليل الـ gamepass، الذي يمر عبره مالكو الـ pass، أو أضف إلى معالج Triggered في DoorService فحصًا يقرأ على الخادم قبل الفتح هل يملك اللاعب الـ pass، مثل السمة OwnsPass_VIP التي يضبطها ذلك الدليل.
لماذا يُفتح الباب عندي لكن ليس عند اللاعبين الآخرين؟
الذي يفتحه LocalScript، والتغيير الذي يجريه LocalScript يبقى على جهاز ذلك اللاعب. انقل كود الفتح إلى Script على الخادم، كما في DoorService، حتى يصل التغيير إلى الجميع.
المصادر والقراءات
- Roblox Creator Docs: PVInstance:PivotTo (بالإنجليزية). تحريك قطعة أو نموذج كامل من خلال الـ pivot الخاص به
- Roblox Creator Docs: Pivot tools (بالإنجليزية). نقل الـ pivot، وSnap ونقاط الارتكاز، والـ pivot عند وجود PrimaryPart
- Roblox Creator Docs: Model (بالإنجليزية). WorldPivot، وGetExtentsSize يتبع الـ pivot، وSetPrimaryPartCFrame قديمة
- Roblox Creator Docs: CFrame:Lerp (بالإنجليزية). الدوران يُستكمل على أقصر قوس
- Roblox Creator Docs: TweenService (بالإنجليزية). ما الذي يمكن تحريكه بـ Tween، وكيف يلغي Tween ثانٍ على الخاصية نفسها الأول
- Roblox Creator Docs: Proximity prompts (بالإنجليزية). إنشاء التلميحات وإعدادها، والإدخال على أي جهاز، وخط الرؤية
- Roblox Creator Docs: ProximityPrompt (بالإنجليزية). المفتاح والزر الافتراضيان، وHoldDuration، وMaxActivationDistance، وTriggered
- Roblox Creator Docs: CollectionService (بالإنجليزية). الوسوم، وGetTagged، وGetInstanceAddedSignal
- Roblox Creator Docs: Properties window (بالإنجليزية). إضافة الوسوم والسمات في Studio
- Roblox Creator Docs: Securing the client-server boundary (بالإنجليزية). ProximityPrompt كسطح هجوم، وفحص حق «المفتاح والباب»
- Roblox Creator Docs: Network ownership, movement validation, and physics (بالإنجليزية). ما الذي يستطيع العميل فعله بشخصيته
- Roblox Creator Docs: Build a hinged door (بالإنجليزية). باب بـ HingeConstraint دون كود
- Roblox Creator Docs: In-game tools (بالإنجليزية). Handle، والتثبيت، وStarterPack
- Roblox Creator Docs: Tool.CanBeDropped (بالإنجليزية). ما يفعله Backspace بالأداة المجهّزة
كيف فُحص الكود: كل سكربت في هذه الصفحة يجتاز الفاحص الصارم للأنواع في Luau مع تعريفات واجهة Roblox البرمجية (luau-lsp، ٢٠ نوفمبر ٢٠٢٦). فحص الأنواع يكشف الأخطاء في أسماء الواجهات البرمجية والأنواع الخاطئة، لا منطق اللعبة، فجرّب الكود في Studio قبل النشر.