باختصار
لمنصة الانتقال ضع Script في ServerScriptService يستمع إلى حدث Touched في المنصة، ويجد اللاعب عبر Players:GetPlayerFromCharacter، وينقل الشخصية كلها عبر character:PivotTo() إلى نقطة أمام منصة الوجهة مباشرةً، وظهرها إليها، مع فترة انتظار لثانيتين تقريبًا لكل لاعب، كي لا تعيده منصة الوجهة فورًا. ولإرسال اللاعبين إلى مكان آخر في لعبتك، استدعِ TeleportService:TeleportAsync(placeId, { player }) من Script على الخادم داخل pcall، وهذا يعمل فقط في اللعبة المنشورة، لا في Studio.
- انقل الشخصية كلها عبر
PivotTo. تعيينHumanoidRootPart.Positionيفصل القطعة الجذرية عن بقية الجسم، لأن Roblox يحدّث الوصلات عند ضبط Position. - يجب أن ترسل قائمة الانتقال إلى الخادم اسم الوجهة لا موضعها. يفحص الخادم الاسم وفترة الانتظار وأي شرط فتح قبل أن ينقل أحدًا.
TeleportService:Teleport()قديم ومهجور ويعمل في العميل. استخدمTeleportAsyncعلى الخادم، ولفّه بـpcall، وأعد المحاولة، وعالجTeleportInitFailed.
في هذه الصفحة
نوعان من الانتقال
الانتقال في لعبة Roblox قد يعني ثلاثة أشياء: منصة تنقلك عبر الخريطة، أو قائمة نقاط يمكنك القفز إليها، أو بوابة إلى مستوى آخر. الأولان ينقلان الشخصية داخل الخادم الذي يوجد عليه اللاعب أصلًا. والثالث يرسل اللاعب إلى مكان آخر في لعبتك يعمل على خوادمه الخاصة. وهي تستخدم واجهات برمجية مختلفة، لذا يفيد أن تعرف أيها تحتاج.
| داخل الخادم نفسه | إلى مكان آخر في لعبتك | |
|---|---|---|
| الاستدعاء | character:PivotTo(cframe) | TeleportService:TeleportAsync(placeId, players) |
| لماذا | منصات الانتقال، وقوائم الانتقال، ونقل اللاعبين من الردهة إلى الحلبة | بوابات إلى مستوى آخر، وردهة ترسل اللاعبين إلى مكان منفصل فيه زنزانة أو مباراة |
| أين يعمل | Script على الخادم | Script على الخادم فقط. أما Teleport() في العميل فقديم ومهجور. |
| يعمل في اختبار اللعب في Studio | نعم | لا. لا يدعم TeleportService في Roblox اختبار اللعب في Studio، لذا يُختبر في اللعبة المنشورة. |
| ما يراه اللاعب | قفزة عبر الخريطة قد تستغرق حتى ثانيتين إذا كان يجب تحميل تلك المنطقة أولًا | شاشة تحميل Roblox، ثم المكان الآخر |
| العملات والعناصر والبيانات الأخرى | تبقى كما هي | يمسح Roblox البيانات المحلية للاعب، لذا يجب أن يأتي كل ما هو مهم من مخزن بيانات في المكان الآخر |
في هذا الدليل الأنواع الثلاثة مجموعة في Script واحد على الخادم، فتغطي مجموعة قواعد واحدة كل انتقال في لعبتك: الخادم يقرر، ولكل لاعب فترة انتظاره، وجهاز اللاعب يخبر فقط بالنقطة التي يريد الوصول إليها.
| العنصر | أين يوجد | ماذا يفعل |
|---|---|---|
Folder TeleportPads مع PadA وPadB | Workspace | منصتان. السمة Destination في كل منهما تسمّي المنصة التي ترسل إليها اللاعبين. |
Folder TeleportSpots | Workspace | قطعة واحدة لكل نقطة في قائمة الانتقال. السمة WinsNeeded تقفل النقطة. |
Folder PlacePortals | Workspace | قطع البوابات. السمة PlaceId في كل بوابة هي المكان الذي ترسل إليه اللاعبين. |
Script Teleporters | ServerScriptService | يدير أنواع الانتقال الثلاثة وينشئ حدثَي الاتصال (remotes). المكان الوحيد الذي يمكن أن يحدث فيه الانتقال. |
LocalScript TeleportMenu | StarterPlayer > StarterPlayerScripts | يرسم زر Teleport وقائمة النقاط، ويرسل اسم النقطة التي اختارها اللاعب. |
RemoteFunction GetTeleportSpots وRemoteEvent TeleportRequest | ReplicatedStorage (ينشئهما Teleporters) | الأول يُرجع إلى القائمة قائمة النقاط. والثاني يحمل الاسم المختار إلى الخادم. |
Workspace
TeleportPads Folder new
PadA Part new
PadB Part new
TeleportSpots Folder new
Spawn Part new
Lake Part new
Castle Part new
PlacePortals Folder new
DungeonPortal Part new
ServerScriptService
Teleporters Script new
StarterPlayer
StarterPlayerScripts
TeleportMenu LocalScript new
الخطوة 1: ابنِ منصتَي الانتقال
- في Explorer مرّر المؤشر فوق Workspace، واضغط الزر + وأدرج Folder. سمِّ المجلد
TeleportPads. السكربت يبحث عن هذا الاسم بالتحديد. - أدرج في المجلد قطعتَي Part وسمّهما
PadAوPadB. اجعل كلًّا منهما لوحًا مسطحًا، مثل 6 في 1 في 6 ستد، وضعهما على الأرض بمسافة بينهما. في نافذة Properties فعّل Anchored، واترك CanCollide وCanTouch مفعّلتين، واختر لونًا زاهيًا والمادة Neon ليلاحظهما اللاعبون. - حدّد PadA، ومرّر نافذة Properties إلى قسم Attributes واضغط +. أدخل الاسم
Destination، واختر النوع String واضغط Save، ثم اجعل القيمةPadB. افعل الشيء نفسه في PadB بالقيمةPadA. - أدر كل منصة بحيث يكون وجهها الأمامي متجهًا نحو أرض فارغة. يظهر اللاعبون على بعد 3 ستد أمام الوجه الأمامي لمنصة الوجهة، وظهرهم إليها، لذا اترك هناك بضعة ستد من الأرض الفارغة. لترى أي وجه هو الأمامي، انقر على المنصة بالزر الأيمن واختر Show Orientation Indicator: يحدد خط أزرق الوجه الأمامي. أدر المنصة بأداة Rotate حتى يشير هذا الخط إلى حيث يجب أن يمشي اللاعبون.
يصل اللاعبون إلى جوار المنصة لا فوقها، وهذا مقصود. في صفحة Roblox عن الـ debounce مذكور أن Touched يُطلق مرات كثيرة متتالية في لمسة واحدة، لذا فاللاعب الذي يظهر فوق المنصة الأخرى مباشرةً سيشغّلها من جديد فور انتهاء فترة انتظاره، ويطير عائدًا عبر الخريطة.
لست مقيدًا بمنصتين. يمكن أن تسمّي Destination في المنصة أي قطعة في TeleportPads، فتستطيع ثلاث منصات إرسال اللاعبين في دائرة. ولمنصة باتجاه واحد، وجّهها إلى قطعة في TeleportPads ليس لها Destination خاص بها: هذه القطعة تستقبل اللاعبين ولا ترسل أحدًا إلى أي مكان.
الخطوة 2: أضف سكربت الانتقال
مرّر المؤشر فوق ServerScriptService، وأدرج Script، وسمّه Teleporters، والصق فيه الكود أدناه. الآن يخدم المنصات، وبعد الخطوات التالية يخدم القائمة والبوابات أيضًا، لذا تضيفه مرة واحدة. الإعدادات في البداية هي الأسطر المخصصة لتغيّرها.
-- Script في ServerScriptService باسم Teleporters.
-- كل انتقال يُقرَّر هنا، على الخادم:
-- 1. المنصات: لمس قطعة في Workspace.TeleportPads ينقلك إلى القطعة المذكورة
-- في سمتها Destination.
-- 2. القائمة: يطلب LocalScript باسم TeleportMenu نقطة من Workspace.TeleportSpots
-- بالاسم. يفحص الخادم الاسم وفترة الانتظار وWins المطلوبة للنقطة.
-- 3. البوابات: لمس قطعة في Workspace.PlacePortals يرسلك إلى المكان
-- المذكور في سمتها PlaceId (مكان آخر في هذه اللعبة).
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local RunService = game:GetService("RunService")
local TeleportService = game:GetService("TeleportService")
local PAD_COOLDOWN_SECONDS = 2 -- مدة تجاهل المنصات للاعب بعد أي انتقال
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- عدد الستد أمام منصة الوجهة، ليصل اللاعبون إلى جوارها
local PLACE_ATTEMPTS = 3
local padFolder = workspace:FindFirstChild("TeleportPads")
local spotFolder = workspace:FindFirstChild("TeleportSpots")
local portalFolder = workspace:FindFirstChild("PlacePortals")
-- هذا السكربت ينشئ الـ remote بنفسه، فلا تضفهما يدويًا
local getSpots = Instance.new("RemoteFunction")
getSpots.Name = "GetTeleportSpots"
getSpots.Parent = ReplicatedStorage
local teleportRequest = Instance.new("RemoteEvent")
teleportRequest.Name = "TeleportRequest"
teleportRequest.Parent = ReplicatedStorage
local lastTeleport: { [Player]: number } = {}
local warnedPads: { [Instance]: boolean } = {}
local leavingForPlace: { [Player]: boolean } = {}
local function playerFromHit(otherPart: BasePart): Player?
local character = otherPart:FindFirstAncestorOfClass("Model")
return if character then Players:GetPlayerFromCharacter(character) else nil
end
local function onCooldown(player: Player, seconds: number): boolean
return os.clock() - (lastTeleport[player] or -math.huge) < seconds
end
-- على أي ارتفاع فوق الأرض توجد القطعة الجذرية لشخصية واقفة.
-- المعادلة من مرجع Roblox عن Humanoid.HipHeight (في هياكل R6 يُضاف طول الساق).
local function rootHeight(character: Model, humanoid: Humanoid, rootPart: BasePart): number
local height = rootPart.Size.Y / 2 + humanoid.HipHeight
if humanoid.RigType == Enum.HumanoidRigType.R6 then
local leg = character:FindFirstChild("Left Leg")
if leg and leg:IsA("BasePart") then
height += leg.Size.Y
end
end
return height
end
local function teleportTo(player: Player, destination: BasePart, besidePad: boolean)
local character = player.Character
local humanoid = character and character:FindFirstChildOfClass("Humanoid")
local rootPart = humanoid and humanoid.RootPart
if not (character and humanoid and rootPart) or humanoid.Health <= 0 then
return
end
lastTeleport[player] = os.clock() -- نضبطه قبل الانتظار، كي لا تشغّل لمسة ثانية انتقالًا ثانيًا
-- ننظر إلى حيث يتجه الوجه الأمامي للوجهة (مستويًا، دون ميل)
local facing = destination.CFrame.LookVector * Vector3.new(1, 0, 1)
if facing.Magnitude < 0.01 then
facing = Vector3.new(0, 0, -1)
end
facing = facing.Unit
-- نقف على وجهها العلوي: محور الشخصية هو قطعتها الجذرية، لذا نرفعه إلى ارتفاع الوقوف.
-- أما المنصة فتضع اللاعبين على بعد بضعة ستد أمامها، لأن اللاعب الواقف
-- على المنصة سيشغّلها من جديد في الخطوة التالية.
local lift = destination.Size.Y / 2 + rootHeight(character, humanoid, rootPart)
local top = destination.Position + destination.CFrame.UpVector * lift
if besidePad then
top += facing * (destination.Size.Z / 2 + PAD_ARRIVAL_GAP)
end
local target = CFrame.lookAlong(top, facing)
-- مع تفعيل instance streaming نحمّل أولًا المنطقة حول الوجهة (حتى ثانيتين)
pcall(function()
player:RequestStreamAroundAsync(target.Position, 2)
end)
if player.Parent == nil or player.Character ~= character or humanoid.Health <= 0 then
return -- خرج أو عاد للظهور أو مات أثناء تحميل المنطقة
end
-- الشخصية الجالسة ملحومة بالمقعد، ونقلها سيسحب المقعد معها.
-- تدمير SeatWeld يحرر الشخصية من المقعد أولًا.
local seat = humanoid.SeatPart
if seat then
local seatWeld = seat:FindFirstChild("SeatWeld")
if seatWeld then
seatWeld:Destroy()
end
end
character:PivotTo(target)
-- عند الوصول نبدأ فترة الانتظار من جديد: التحميل المسبق أعلاه قد يستغرق حتى ثانيتين،
-- ويجب ألا تعيد المنصة التي وصل اللاعب إلى جوارها إرساله فورًا
lastTeleport[player] = os.clock()
player:SetAttribute("MovementCheckSkip", true) -- لسكربت فحص السرعة، إن كان لديك واحد
end
-- 1. المنصات
if padFolder then
for _, pad in padFolder:GetChildren() do
if pad:IsA("BasePart") then
pad.Touched:Connect(function(otherPart: BasePart)
local player = playerFromHit(otherPart)
local destinationName = pad:GetAttribute("Destination")
if not player or typeof(destinationName) ~= "string" or onCooldown(player, PAD_COOLDOWN_SECONDS) then
return
end
local destination = padFolder:FindFirstChild(destinationName)
if destination and destination:IsA("BasePart") then
teleportTo(player, destination, true)
elseif not warnedPads[pad] then
warnedPads[pad] = true -- نحذّر مرة واحدة، لا عند كل لمسة
warn(`Teleporters: {pad.Name} points to {destinationName}, which is not a part in TeleportPads`)
end
end)
end
end
end
-- 2. القائمة: قائمة النقاط، ثم الطلب بالاسم
local function winsOf(player: Player): number
local leaderstats = player:FindFirstChild("leaderstats")
local wins = leaderstats and leaderstats:FindFirstChild("Wins")
return if wins and wins:IsA("IntValue") then wins.Value else 0
end
local function winsNeeded(spot: Instance): number
local value = spot:GetAttribute("WinsNeeded")
return if typeof(value) == "number" then value else 0
end
getSpots.OnServerInvoke = function(_player: Player)
local list = {}
if spotFolder then
for _, spot in spotFolder:GetChildren() do
if spot:IsA("BasePart") then
table.insert(list, { name = spot.Name, winsNeeded = winsNeeded(spot) })
end
end
end
table.sort(list, function(a, b)
if a.winsNeeded ~= b.winsNeeded then
return a.winsNeeded < b.winsNeeded
end
return a.name < b.name -- عند تساوي Wins: أبجديًا، كي لا يتغير الترتيب أبدًا
end)
return list
end
teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
-- العميل يرسل الاسم فقط. لا تقبل أبدًا من العميل موضعًا أو CFrame.
if typeof(spotName) ~= "string" or #spotName > 50 or not spotFolder then
return
end
if onCooldown(player, MENU_COOLDOWN_SECONDS) then
return
end
local spot = spotFolder:FindFirstChild(spotName)
if not (spot and spot:IsA("BasePart")) then
return
end
if winsOf(player) < winsNeeded(spot) then
return -- مقفلة لهذا اللاعب
end
teleportTo(player, spot, false)
end)
-- 3. البوابات إلى مكان آخر في هذه اللعبة
local function sendToPlace(player: Player, placeId: number)
if leavingForPlace[player] or onCooldown(player, PAD_COOLDOWN_SECONDS) then
return -- في الطريق أصلًا أو لمس انتقالًا قبل ثانية
end
lastTeleport[player] = os.clock()
if RunService:IsStudio() then
print(`Teleporters: would send {player.Name} to place {placeId}. Place teleports only work in the published game.`)
return
end
leavingForPlace[player] = true
for attempt = 1, PLACE_ATTEMPTS do
local ok, err = pcall(function()
TeleportService:TeleportAsync(placeId, { player })
end)
if ok then
return
end
warn(`Teleporters: teleport attempt {attempt} for {player.Name} failed: {err}`)
task.wait(2)
end
leavingForPlace[player] = nil -- نستسلم، ولمسة جديدة للبوابة تحاول من جديد
end
-- قد يفشل الانتقال حتى بعد بدئه. يبقى اللاعب هنا ويمكنه المحاولة من جديد.
TeleportService.TeleportInitFailed:Connect(function(player: Player, result: Enum.TeleportResult, message: string)
warn(`Teleporters: {player.Name} could not leave ({result.Name}): {message}`)
leavingForPlace[player] = nil
end)
if portalFolder then
for _, portal in portalFolder:GetChildren() do
if portal:IsA("BasePart") then
portal.Touched:Connect(function(otherPart: BasePart)
local player = playerFromHit(otherPart)
local placeId = portal:GetAttribute("PlaceId")
if player and typeof(placeId) == "number" and placeId > 0 then
sendToPlace(player, placeId)
end
end)
end
end
end
Players.PlayerRemoving:Connect(function(player: Player)
lastTeleport[player] = nil
leavingForPlace[player] = nil
end)
ينشئ Teleporters بنفسه RemoteFunction باسم GetTeleportSpots وRemoteEvent باسم TeleportRequest، فلا تحتاج إلى إدراج أي شيء يدويًا في ReplicatedStorage. يربط المنصات من TeleportPads والبوابات من PlacePortals مرة واحدة، عند بدء الخادم، لذا فالمنصات والبوابات المضافة أثناء اللعب لا تفعل شيئًا. وإذا غاب أحد المجلدات، فهذا النوع من الانتقال معطّل ببساطة.
| الجزء | ماذا يفعل | لماذا |
|---|---|---|
playerFromHit | يجد نموذج الشخصية الذي تنتمي إليه القطعة الملامسة، ويسأل Players:GetPlayerFromCharacter لمن هو. | تلمس المنصات أقدامًا وقبعات وقطعًا سائبة. كل ما ليس جزءًا من شخصية لاعب يعطي nil ويُتجاهل. |
onCooldown | يقارن os.clock() بوقت آخر انتقال للاعب. | فترة انتظار واحدة لكل لاعب، لذا لا يحجب لاعب واقف عند المنصة الآخرين أبدًا. لا شيء ينتظر أو ينام. |
rootHeight | يحسب ارتفاع القطعة الجذرية لشخصية واقفة فوق الأرض: نصف ارتفاع القطعة الجذرية زائد HipHeight في Humanoid، زائد طول الساق في هياكل R6. | هذه معادلة مرجع Roblox عن Humanoid.HipHeight. محور الشخصية هو قطعتها الجذرية، لذا فرفع المحور بهذا المقدار يضع القدمين على السطح للشخصيات الصغيرة والكبيرة ولـ R6. |
الفحوص في بداية teleportTo | يخرج إذا لم تكن للاعب شخصية حية بقطعة جذرية، ثم يسجّل الوقت فورًا. | طلب البث أدناه قد يجعل السكربت ينتظر. وتسجيل الوقت مسبقًا يمنع أحداث Touched الكثيرة في تلك اللحظة من تشغيل انتقال ثانٍ. |
| نقطة الوصول | الوجه العلوي للوجهة، مرفوعًا بمقدار rootHeight، مع اتجاه نظر نحو حيث يتجه وجهها الأمامي، دون ميل. وللمنصة تُزاح النقطة أيضًا 3 ستد عن وجهها الأمامي. | تظهر الشخصية واقفة، لا داخل قطعة الوجهة. وبجوار المنصة تبدأ قدماها على مستوى وجهها العلوي، فتنزل إلى الأرض بقدر سماكة المنصة. يبني CFrame.lookAlong قيمة CFrame في موضع باتجاه نظر محدد. |
RequestStreamAroundAsync | يطلب من Roblox إرسال المنطقة حول نقطة الوصول إلى هذا اللاعب أولًا، وينتظر ثانيتين على الأكثر. | الـ Instance streaming مفعّل افتراضيًا في الأماكن الجديدة، لذا قد لا يكون الجزء البعيد من الخريطة قد حُمّل بعد على جهاز اللاعب. توصي Roblox بهذا الاستدعاء من الخادم قبل نقل شخصية إلى مكان بعيد، مع أنها لا تضمن ما الذي سيصل بالضبط. |
| الفحص الثاني | إذا خرج اللاعب، أو عادت الشخصية للظهور أو ماتت أثناء الانتظار، فلا يتحرك شيء. | قد يكون اللاعب أجرى reset أو خرج من اللعبة أثناء تحميل المنطقة. ومثال التحميل المسبق الخاص بـ Roblox يتحقق أيضًا من أن الشخصية ما زالت في اللعبة قبل تحريكها. |
أسطر SeatWeld | إذا كانت الشخصية جالسة، يدمّر الـ Weld الذي يثبتها على المقعد. | يلحم Roblox الشخصية الجالسة بالمقعد. يحرّك PivotTo القطع بتغيير CFrame فيها، وفي مرجع Roblox أن ضبط CFrame لقطعة يحرّك القطع الموصولة بها أيضًا، لذا دون هذا سيصل المقعد وكل ما هو ملحوم به مع اللاعب. تدمير SeatWeld هو الطريقة التي يرفع بها مرجع Roblox عن Seat الشخصية عن المقعد من سكربت. |
character:PivotTo(target) | ينقل الشخصية كلها، بكل أطرافها وإكسسواراتها معًا، إلى نقطة الوصول. | تسمّي Roblox الدالة PivotTo الدالة الأساسية لتحريك النماذج من السكربتات. |
السطر الثاني مع lastTeleport | يبدأ فترة الانتظار من جديد عند الوصول. | قد يستغرق طلب البث حتى ثانيتين، وهي مدة فترة انتظار المنصة نفسها، لذا دون هذا السطر قد يصل اللاعب وفترة انتظاره منتهية أصلًا. |
MovementCheckSkip | يضبط سمة على Player بعد كل نقل. | فحص السرعة على الخادم سيظن القفزة غشًا. يقرأ MovementCheck من دليل الجري هذه السمة ويبدأ القياس من جديد من الموضع الجديد. ودون سكربت كهذا لا تفعل السمة شيئًا. |
| الإعداد | القيمة هنا | ماذا يغيّر |
|---|---|---|
PAD_COOLDOWN_SECONDS | 2 | مدة تجاهل المنصات والبوابات للاعب بعد أي انتقال. |
MENU_COOLDOWN_SECONDS | 3 | أقصر فاصل بين انتقالين عبر القائمة للاعب نفسه. للمنصات والقائمة ساعة مشتركة لكل لاعب، لذا يُتجاهل أيضًا طلب القائمة خلال 3 ثوانٍ بعد انتقال من منصة. |
PAD_ARRIVAL_GAP | 3 | على بعد كم ستد من الوجه الأمامي لمنصة الوجهة يظهر اللاعبون، ليصلوا إلى جوار المنصة لا فوقها. |
PLACE_ATTEMPTS | 3 | كم مرة تجرّب البوابة TeleportAsync بفاصل ثانيتين قبل أن تستسلم. |
اضغط Play الآن واخطُ على PadA: ستظهر أمام PadB. تحتاج القائمة والبوابات إلى الخطوتين التاليتين، لكن السكربت يعمل من دونهما.
الخطوة 4: الانتقال إلى مكان آخر
المكان (place) عالم منفصل داخل لعبتك، له خوادمه الخاصة: ردهة وزنزانة، أو مركز ومجموعة مستويات. ينتقل اللاعبون بين الأماكن عبر TeleportService، ولا يشغّله Roblox إلا في اللعبة المنشورة، لذا تنتهي هذه الخطوة في تطبيق Roblox لا في Studio.
- إذا لم تكن اللعبة منشورة بعد، فاختر File > Publish. الألعاب الجديدة، حتى تطلقها، مفتوحة فقط لك، وللأشخاص الذين منحتهم صلاحية Edit، ولأعضاء المجموعة ذوي الأدوار المناسبة، وهذا يكفي لاختبار الانتقال بنفسك.
- أنشئ مكانًا ثانيًا: افتح مكانًا جديدًا من أي قالب في Studio، وابنِ زنزانتك، ثم اختر File > Publish As، وانقر على مربع لعبتك، واختر Add as a new place واضغط Create.
- انسخ معرّف المكان الجديد. افتح Asset Manager من قائمة Window أو من تبويب Home، وانتقل إلى Places In Experience، وانقر على المكان بالزر الأيمن واختر Copy Asset ID، فيُنسخ معرّف المكان (place ID).
- بعد العودة إلى المكان الأول، أدرج في Workspace مجلد Folder باسم
PlacePortals، وداخله Part مثبتة باسمDungeonPortal. أضف سمة من النوع Number باسمPlaceIdوالصق المعرّف قيمةً لها. - اضغط Play والمس البوابة. يطبع Output سطرًا يبدأ بـ
Teleporters: would send: في Studio لا تفعل البوابة أكثر من ذلك. - انشر اللعبة من جديد عبر File > Publish، لتظهر البوابة في اللعبة المنشورة، واختبرها من تطبيق Roblox كما في الخطوة 5.
يستدعي Teleporters الدالة TeleportAsync داخل pcall، حتى 3 مرات مع توقف لثانيتين بين المحاولات، لأن صفحة Roblox عن الانتقال تقول إن الانتقالات قد تفشل وتعطي خطأ، وتوصي بإعادة المحاولة. وقد يبدأ الانتقال أيضًا ثم يفشل في اللحظة الأخيرة دون خطأ، تاركًا اللاعب حيث كان. لهذه الحالة يُطلق Roblox الحدث TeleportInitFailed، فيزيل السكربت عن اللاعب علامة «مغادر»، لذا تحاول لمسة جديدة للبوابة من جديد.
لإعادة اللاعبين، افعل الشيء نفسه في المكان الآخر: ضع نسخة من Teleporters في ServerScriptService فيه، وأضف بوابة قيمة PlaceId فيها هي معرّف مكانك الأول، منسوخًا من Asset Manager بالطريقة نفسها.
من يستطيع دخول أماكنك الأخرى
يحذّر توثيق Roblox عن الأمان: بمجرد وجود العميل في أحد أماكن لعبتك يستطيع الانتقال إلى أي مكان آخر فيها، أيًّا كان المسار الذي صممته، وتعطيل Direct Access في مكان ما يزيل فقط زر Join على الموقع. يغيّر هذا الإعداد Access Control for Places في قسم Audience > Access Settings في Creator Dashboard:
| الإعداد | من يستطيع دخول مكان ليس مكان البداية |
|---|---|
| Fully open | أي شخص، عبر الانتقال من أي لعبة، وروابط deep links، ودعوات اللعب، والانضمام إلى صديق. |
| Limited to same universe | فقط اللاعبون الذين ينتقلون من داخل ألعابك. الانتقال مسموح من العميل ومن الخادم. |
| Secure within universe only | فقط اللاعبون الذين تنقلهم سكربتات الخادم عندك من داخل هذه اللعبة. |
إذا كان يجب أن يصل اللاعبون إلى مكان ما عبر بوابتك فقط، مثل زنزانة، فاختر Secure within universe only. كل انتقال في هذا الدليل يبدأ على الخادم، لذا سيستمر في العمل. وتقول Roblox أيضًا إن كثيرًا من الألعاب لا تحتاج إلى انتقالات آمنة، لذا فاللعبة التي كل أماكنها مفتوحة للجميع يمكنها ترك الإعداد كما هو.
أين تخطئ دروس الانتقال القديمة
إذا كنت تقارن هذا الدليل بفيديو أو منشور في منتدى، فهذه هي الفروق المهمة، وسبب المشكلة في كل أسلوب.
| الدرس | المشكلة | هذا الدليل |
|---|---|---|
يضبط hit.Parent.HumanoidRootPart.Position = target.Position | في مرجع Roblox أن ضبط Position يحدّث وصلات القطعة، فتنزاح بالنسبة إلى القطع الموصولة بها: تبتعد القطعة الجذرية دون الجسم. | ينقل الشخصية كلها عبر PivotTo. |
يضبط HumanoidRootPart.CFrame = target.CFrame | يصير منتصف الشخصية في منتصف القطعة الهدف، فيدخل جزء منها فيها، وتأخذ ميل القطعة. | تظهر الشخصية على ارتفاع الوقوف فوق الوجه العلوي، بجوار المنصة، دون ميل. |
يستخدم متغير debounce واحدًا للمنصة كلها | أثناء انتقال لاعب واحد تتجاهل المنصة الجميع. ودون debounce إطلاقًا يُعاد اللاعب الذي يظهر على المنصة الأخرى فورًا. | فترة انتظار واحدة لكل لاعب، تُسجَّل قبل أي انتظار، ويظهر اللاعبون بجوار المنصة. |
يستدعي TeleportService:Teleport(placeId, player) من LocalScript | تصنّف Roblox الدالة Teleport() قديمة ومهجورة، وتنصح بعدم استخدامها في المشاريع الجديدة، ولا تسمح بـ TeleportAsync إلا من سكربتات الخادم. | يستدعي TeleportAsync في سكربت على الخادم. |
لا pcall ولا إعادة محاولة | صفحة Roblox عن الانتقال تقول إنها قد تفشل وتعطي خطأ، وقد تفشل أيضًا بعد البدء. | حتى 3 محاولات داخل pcall، ويتيح TeleportInitFailed للاعب المحاولة من جديد. |
| يستسلم لأنه «لا يعمل» في Studio | لا يدعم TeleportService اختبار اللعب في Studio. | بدلًا من ذلك يطبع RunService:IsStudio() ما كانت البوابة ستفعله. |
| واجهة انتقال ترسل أزرارها موضعًا | يستطيع الغشاش استدعاء الـ remote نفسه بأي موضع. | الأزرار ترسل اسم النقطة، والخادم يبحث عنه. |
| العملات تُنقل في teleport data | تقول Roblox إن teleport data مرئية للعميل وغير مشفرة. | ينصح بحفظ العملات وWins في مخزن بيانات وتحميلها في المكان الآخر (راجع كيف تنقل البيانات إلى مكان آخر). |
ما يستطيع اللاعبون تزويره وما لا يستطيعون
افترض أن الغشاش يتحكم في كل شيء على جهازه: يستطيع تعديل TeleportMenu، واستدعاء الـ remote كليهما أي عدد من المرات بأي وسائط، وتحريك شخصيته. هذا ما يمنحه إياه ذلك مع هذا الانتقال.
| الغشاش يحاول | النتيجة | لماذا |
|---|---|---|
| إرسال موضع أو CFrame عبر remote القائمة | يُتجاهل | يقرأ TeleportRequest نصًا واحدًا، هو اسم النقطة بطول 50 حرفًا على الأكثر. ويُهمل كل ما عدا ذلك. |
| طلب Castle دون 3 Wins | رفض | يقرأ الخادم Wins من نسخته من leaderstats. الزر الرمادي مجرد تلميح. |
| طلب نقطة غير موجودة | يُتجاهل | يبحث الخادم عن الاسم في TeleportSpots ولا يفعل شيئًا إذا لم توجد قطعة بهذا الاسم. |
| استدعاء remote القائمة مرارًا وتكرارًا | انتقال واحد عبر القائمة كل 3 ثوانٍ على الأكثر | فترة الانتظار محفوظة على الخادم، لكل لاعب. |
| تشغيل منصة دون الاقتراب منها | يصل إلى المنصة المقابلة، التي كان يستطيع المشي إليها أصلًا | تذكر Roblox الانتقال إلى أي نقطة والتلاعب بأحداث Touched ضمن ما يستطيع العميل فعله بشخصيته. |
| دخول مكان آخر في لعبتك مباشرةً | ممكن، إذا لم تكن قيمة Access Control for Places هي Secure within universe only | راجع من يستطيع دخول أماكنك الأخرى. |
| نقل شخصيته إلى أي مكان، بما فيه النقطة المقفلة | ممكن | كل جهاز يتحكم في حركة شخصيته. النقطة المقفلة وسيلة راحة لا خزنة، لذا افحص على الخادم قبل أن تعطي هناك أي شيء ثمين. |
الصف الأخير هو الحد الصادق لأي انتقال. للعبة تنافسية أضف فحصًا للحركة على الخادم، كما في دليل الجري. يضبط Teleporters أصلًا السمة MovementCheckSkip التي يقرؤها ذلك الفحص، لذا لا تُعلَّم انتقالاته هو كمخالفة: في توثيق Roblox عن الأمان أن الألعاب ذات الانتقالات المشروعة تحتاج تحديدًا إلى استثناء كهذا في فحوص الحركة.
الخطوة 5: اختبره
- اضغط Play. اخطُ على PadA: تظهر أمام PadB مباشرةً، وظهرك إليها. استدر واخطُ فورًا على PadB: لا يحدث شيء، لأن المنصات تتجاهلك لثانيتين بعد الوصول. ابتعد، وانتظر ثانيتين، واخطُ على PadB مجددًا: تظهر أمام PadA.
- انتظر بضع ثوانٍ، ثم اضغط Teleport في الجهة اليسرى من الشاشة. في القائمة تظهر Lake وSpawn والزر الرمادي "Castle (needs 3 wins)". اختر Lake: تظهر عليها. افتح القائمة مجددًا واختر Castle: لا يحدث شيء، وOutput صامت.
- امنح نفسك 3 Wins (لهذا تحتاج إلى سكربت leaderstats فيه IntValue باسم Wins، مثل الذي في دليل لوحة الصدارة). اضغط مفتاح التبديل Client/Server للانتقال إلى Server، وابحث في Explorer عن
Playersثم اسمك ثمleaderstatsثمWins، واجعل Value فيها 3 في نافذة Properties. عد إلى Client وافتح القائمة مجددًا: صار Castle بنفسجيًا وينقلك إلى هناك. - المس DungeonPortal. يطبع Output سطرًا يبدأ بـ
Teleporters: would send، مع اسمك ومعرّف المكان. في Studio هذا هو المتوقع، ولا يُطبع أكثر من مرة كل ثانيتين، مهما وقفت على البوابة. - اختر Server & Clients في القائمة المنسدلة لأوضاع الاختبار، واجعل عدد العملاء 2 واضغط Play. يستطيع اللاعبان استخدام المنصات في الوقت نفسه، ولا تحجب فترة انتظار أحدهما الآخر أبدًا.
- أوقف الاختبار، وانشر اللعبة وشغّلها من تطبيق Roblox. المس البوابة: تظهر شاشة تحميل Roblox، وتجد نفسك في المكان الآخر. وإذا بقيت في مكانك، فافتح Developer Console بالمفتاح F9، وبدّل السجل إلى عرض Server، الذي لا يراه إلا مالك اللعبة وأعضاء المجموعة ذوو صلاحية التعديل، وابحث عن تحذيرات
Teleporters:، ففيها السبب الذي ذكره Roblox.
أثناء الخطوات في Studio أبقِ نافذة Output مفتوحة (قائمة Window ثم Output). عندما يعمل Teleporters لا يطبع شيئًا سوى سطر البوابة من الخطوة 4، لذا فكل تحذير أو خطأ أحمر يستحق القراءة. راجع الأخطاء الشائعة.
كيف توسّعه
نقل فريق أو مجموعة أصدقاء معًا
يقبل TeleportAsync قائمة لاعبين، لذا تستطيع بوابة واحدة إرسال مجموعة كاملة إلى مكان واحد. تقترح صفحة Roblox عن الانتقال البدء من اللاعب الذي لمس البوابة: player.Team وTeam:GetPlayers() للفريق، أو SocialService:GetPlayersByPartyId() مع player.PartyId لمجموعة الأصدقاء (party). مرّر هذه القائمة بدل { player } واضبط علامة leavingForPlace لكل لاعب فيها.
إرسال مجموعة إلى خادم خاص بها
افتراضيًا يصل اللاعبون المنقولون إلى خادم عام في المكان الآخر. لإرسال مجموعة إلى خادم محجوز جديد، مثلًا لمباراة، أنشئ TeleportOptions، واجعل ShouldReserveServer فيه true، ومرّره وسيطًا ثالثًا: TeleportService:TeleportAsync(placeId, players, options). تذكر Roblox أن إعادة المحاولة مفيدة خصوصًا مع الأعطال المتعلقة بالخوادم المحجوزة، والسكربت يفعل ذلك أصلًا.
كيف تنقل البيانات إلى مكان آخر
الانتقال يمسح كل البيانات المحلية لهذا اللاعب. الـ Teleport data في Roblox، التي تُضبط عبر TeleportOptions:SetTeleportData() وتُقرأ في المكان الآخر عبر player:GetJoinData()، مرئية للعميل وغير مشفرة، لذا استخدمها فقط للاختيارات غير الحساسة، مثل الخريطة التي تُحمَّل. احفظ العملات وWins والعناصر في مخزن بيانات، كما في درس DataStore، وحمّلها من جديد عندما يصل اللاعب إلى المكان الآخر.
شاشة تحميل خاصة بك
أثناء تحميل الانتقال إلى مكان آخر يرى اللاعبون شاشة تحميل Roblox الافتراضية. لتعرض شاشتك، استدعِ في العميل TeleportService:SetTeleportGui() مع ScreenGui، مثل واحدة موجودة في ReplicatedStorage. الانتقالات في هذا الدليل تبدأ على الخادم، لذا يجب أن يستدعيها العميل مسبقًا، مثلًا بمجرد دخول اللاعب. تقول Roblox إن الشاشة يجب ضبطها من جديد قبل كل انتقال، وإنها لا تُستخدم مع مكان في لعبة أخرى. وتذكر أيضًا أن السكربتات داخل هذه الـ ScreenGui لا تعمل، لذا اجعلها ثابتة.
انتقالات الجولات ونقاط التفتيش
ينقل نظام الجولات في بداية كل جولة جميع اللاعبين إلى الحلبة باستدعاء PivotTo نفسه، ويقارن قسم PivotTo أم SpawnLocation في دليل الأوبي هذا الأسلوب بنقاط الظهور في Roblox. وإذا كان يجب أن تُفتح نقطة فقط بعد جولة، فنظام الجولات يمنح أصلًا Wins التي تقرؤها WinsNeeded.
الأخطاء الشائعة وحلولها
افتح نافذة Output (قائمة Window ثم Output) قبل الضغط على Play. يذكر Teleporters اسم المنصة عندما تشير Destination إلى لا شيء، لذا تظهر معظم المشكلات هناك.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("GetTeleportSpots")'
ينتظر TeleportMenu الـ remote الذي ينشئه Teleporters، إذن Teleporters لا يعمل. تأكد أنه Script لا LocalScript، وأنه موجود مباشرةً في ServerScriptService، وغير معطّل، وأنه لا يوجد منه خطأ أحمر في Output. دليل أخطاء السكربتات يشرح هذا التحذير بالتفصيل.
Teleporters: PadA points to PadC, which is not a part in TeleportPads
السمة Destination في المنصة تسمّي شيئًا ليس قطعة موجودة مباشرةً داخل المجلد TeleportPads. افحص الكتابة والأحرف الكبيرة في قيمة السمة وفي اسم منصة الوجهة. يظهر التحذير مرة واحدة لكل منصة، عندما يلمسها لاعب أول مرة.
أخطو على المنصة ولا يحدث شيء
تأكد أن اسم المجلد TeleportPads بالضبط، وأنه موجود مباشرةً في Workspace عند بدء اللعبة، وأن السمة Destination في المنصة من النوع String (السمة من النوع Number تُتجاهل)، وأن ثانيتين مرّتا منذ آخر انتقال لك. تأكد أيضًا أن CanTouch مفعّل في المنصة: تقول Roblox إن ربط Touched بقطعة معطّل فيها CanTouch يعطي خطأ، وهذا يوقف السكربت.
أظهر داخل جدار أو أسقط من الحافة
يظهر اللاعبون على بعد 3 ستد أمام الوجه الأمامي لمنصة الوجهة. انقر على المنصة بالزر الأيمن، واختر Show Orientation Indicator، وأدر المنصة حتى يشير الخط الأزرق إلى أرض فارغة. نقاط القائمة تضع اللاعبين فوق القطعة، لذا أبقِ كل نقطة على الأرض.
يبقى زر Castle رماديًا بعد أن كسبت 3 Wins
تُرسم القائمة عند فتحها، لذا أغلقها وافتحها مجددًا. وإذا بقي الزر رماديًا، فتأكد أن في leaderstats قيمة IntValue اسمها Wins بالضبط، وأن Wins تغيّرت على الخادم، لا في وضع Client فقط.
البوابة لا تفعل شيئًا في اللعبة المنشورة
افتح Developer Console بالمفتاح F9، وبدّل السجل إلى عرض Server (لا يراه إلا مالك اللعبة وأعضاء المجموعة ذوو صلاحية التعديل، لأن Teleporters سكربت Script على الخادم)، واقرأ تحذيرات Teleporters:، ففيها السبب الذي ذكره Roblox. تأكد أن السمة PlaceId في البوابة من النوع Number وتحتوي المعرّف من Asset Manager، وأنك نشرت المكان من جديد بعد إضافة البوابة.
اصنعه مع RoCode
إذا لم ترغب في بناء كل هذا يدويًا، يستطيع RoCode فعله في المكان المفتوح عندك. RoCode وكيل ذكاء اصطناعي مستقل لـ Roblox Studio ولا يتبع Roblox: تصف الميزة في دردشة الويب، وتنشئ إضافته لـ Studio القطع والسكربتات في Explorer عندك، فلا تحتاج إلى نسخ الكود من نافذة الدردشة.
أضف انتقالات: منصات في Workspace.TeleportPads ترسل اللاعبين إلى المنصة المذكورة في سمتها Destination مع فترة انتظار لثانيتين، وقائمة Teleport للنقاط في Workspace.TeleportSpots تحتاج فيها Castle إلى 3 Wins مع فحص على الخادم، وبوابات في Workspace.PlacePortals ترسل اللاعبين إلى المكان الذي معرّفه في سمتها PlaceId، مع إعادة المحاولة.
- يمكنه تصفح مكانك عندما تحتاج الخطوة إلى ذلك، عبر Search Game وSearch Scripts، ليعتمد على العناصر أو الـ remotes أو كود الحفظ الموجود أصلًا، بدل إضافة نظام ثانٍ
- ينشئ المجلدات وقطع المنصات عبر Create Instance، ويضبط خصائصها عبر Set Property، ويكتب Teleporters وTeleportMenu عبر Create Script
- أُمر بفحص ترجمة كل سكربت يكتبه عبر Check Script، الذي يترجمه في Studio دون تشغيله
- يرسل التغييرات على دفعات، وكل دفعة نقطة تراجع في سجل Studio
الانتقالات بين الأماكن تعمل فقط في اللعبة المنشورة، لذا اختبرها في تطبيق Roblox بنفسك. مع الإضافة 3.9 أو أحدث يستطيع RoCode تشغيل اختبار لعب قصير وقراءة الأخطاء، ومع الإضافة 3.9.15 أو أحدث تستطيع شخصيته الاختبارية الخطو على المنصات والضغط على أزرار القائمة، لكنه يتحقق فقط مما قرر اختباره بنفسه، لذا اخطُ على المنصات وافتح القائمة بنفسك. الانتقال نظام واحد من أنظمة كثيرة في اللعبة، وصنع لعبة كاملة مع RoCode يسير بالطريقة نفسها، نظامًا واحدًا في كل طلب. كيف يتصل RoCode بـ Studio.
الأسئلة الشائعة
كيف أصنع منصة انتقال في Roblox Studio؟
اضبط في قطعتين السمة Destination باسم كل منهما للأخرى، واجعل سكربتًا واحدًا على الخادم ينقل من يلمس المنصة عبر character:PivotTo إلى نقطة أمام المنصة الأخرى مباشرةً، مع فترة انتظار قصيرة لكل لاعب. الخطوة 1 والخطوة 2 تبنيان هذا بالضبط.
لماذا لا يعمل الانتقال عندي في Studio؟
المنصات والقائمة تعمل في Studio. أما الانتقال إلى مكان آخر فلا: لا يدعم TeleportService في Roblox اختبار اللعب في Studio، لذا انشر اللعبة واختبرها في تطبيق Roblox. السكربت في هذا الدليل يطبع بدل الانتقال ما كانت البوابة ستفعله، فتستطيع على الأقل التحقق من أنها تُطلق.
كيف أنقل اللاعبين إلى مكان آخر في لعبتي؟
أضف المكان عبر File > Publish As (Add as a new place)، وانسخ معرّفه من Asset Manager، واستدعِ TeleportService:TeleportAsync(placeId, { player }) من Script على الخادم داخل pcall، مع إعادة المحاولة عند الفشل. الخطوة 4 تأخذك عبر كل ذلك.
كيف أصنع واجهة انتقال (GUI)؟
ابنِ الأزرار في LocalScript وأرسل إلى الخادم اسم النقطة التي اختارها اللاعب فقط. يبحث الخادم عن الاسم في مجلد، ويفحص فترة الانتظار وأي شرط فتح، ثم ينقل الشخصية. لا ترسل أبدًا موضعًا من العميل: الغشاش يستطيع إرسال أي موضع.
لماذا تعلق شخصيتي أو تتفكك بعد الانتقال؟
تعيين Position للقطعة الجذرية يحرّك هذه القطعة وحدها، دون الجسم الموصول بها، ونسخ CFrame المنصة يضع منتصف الشخصية داخل المنصة. استخدم character:PivotTo مع نقطة على ارتفاع الوقوف فوق الأرض، محسوبة من HipHeight في Humanoid.
هل يمكن نقل العملات أو العناصر مع الانتقال؟
ليس بأمان. تقول Roblox إن teleport data مرئية للعميل وغير مشفرة، لذا تصلح لشيء مثل الخريطة المختارة، لا للعملات. احفظ العملات والعناصر في مخزن بيانات وحمّلها في المكان الآخر.
المصادر والقراءات
- Roblox Creator Docs: Teleport between places (بالإنجليزية). TeleportAsync، واختبارات اللعب في Studio، وAccess Control for Places، وشاشات الانتقال، وteleport data، والانتقالات الفاشلة
- Roblox Creator Docs: TeleportService (بالإنجليزية). Teleport المهجور، وTeleportAsync على الخادم فقط، وTeleportInitFailed
- Roblox Creator Docs: PVInstance:PivotTo (بالإنجليزية). الدالة الأساسية لتحريك النماذج من السكربتات
- Roblox Creator Docs: BasePart.Position (بالإنجليزية). لماذا يزيح ضبط Position لقطعة موصولة هذه القطعة عن البقية
- Roblox Creator Docs: Humanoid.HipHeight (بالإنجليزية). على أي ارتفاع توجد القطعة الجذرية لشخصية واقفة، لهياكل R15 وR6
- Roblox Creator Docs: Seat (بالإنجليزية). الـ SeatWeld الذي يثبت الشخصية الجالسة، وتدميره لرفعها
- Roblox Creator Docs: Player:RequestStreamAroundAsync (بالإنجليزية). طلب منطقة قبل أن تنتقل إليها الشخصية، دون ضمان ما سيصل
- Roblox Creator Docs: Streaming techniques and conversion (بالإنجليزية). البث الاستباقي قبل الانتقال
- Roblox Creator Docs: Access control and confidentiality (بالإنجليزية). لماذا يستطيع العملاء دخول أي مكان في اللعبة إذا لم تكن الانتقالات آمنة
- Roblox Creator Docs: Network ownership, movement validation, and physics (بالإنجليزية). ما يستطيع العميل فعله بشخصيته، واستثناءات الانتقال في فحوص الحركة
- Roblox Creator Docs: Create and publish games and places (بالإنجليزية). النشر، ومن يستطيع فتح لعبة جديدة، وإضافة مكان عبر Publish As
- Roblox Creator Docs: Asset Manager (بالإنجليزية). كيف تنسخ معرّف المكان
- Roblox Creator Docs: Developer Console (بالإنجليزية). عرض Server في السجل ومن يراه
- Roblox Creator Docs: Debounce patterns (بالإنجليزية). لماذا يُطلق Touched عدة مرات في لمسة واحدة
كيف فُحص الكود: كل سكربت في هذه الصفحة يجتاز الفاحص الصارم للأنواع في Luau مع تعريفات واجهة Roblox البرمجية (luau-lsp، ٢٠ نوفمبر ٢٠٢٦). فحص الأنواع يكشف الأخطاء في أسماء الواجهات البرمجية والأنواع الخاطئة، لا منطق اللعبة، فجرّب الكود في Studio قبل النشر.