دليل · أنظمة اللعب

كيف تصنع Teleport في Roblox Studio

الـ Teleport في Roblox أحد أمرين: نقل الشخصية إلى موضع آخر على الخادم نفسه، أو إرسال اللاعب إلى مكان آخر في لعبتك. في هذا الدليل نبني الاثنين من سكربت خادم واحد: منصات ترسلك إلى المنصة المقابلة، وقائمة Teleport تُفتح فيها النقاط المقفلة مقابل Wins، وبوابات إلى مكان آخر تعيد المحاولة عندما يفشل انتقال Roblox.

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

باختصار

لمنصة الانتقال ضع Script في ServerScriptService يستمع إلى حدث Touched في المنصة، ويجد اللاعب عبر Players:GetPlayerFromCharacter، وينقل الشخصية كلها عبر character:PivotTo() إلى نقطة أمام منصة الوجهة مباشرةً، وظهرها إليها، مع فترة انتظار لثانيتين تقريبًا لكل لاعب، كي لا تعيده منصة الوجهة فورًا. ولإرسال اللاعبين إلى مكان آخر في لعبتك، استدعِ TeleportService:TeleportAsync(placeId, { player }) من Script على الخادم داخل pcall، وهذا يعمل فقط في اللعبة المنشورة، لا في Studio.

  • انقل الشخصية كلها عبر PivotTo. تعيين HumanoidRootPart.Position يفصل القطعة الجذرية عن بقية الجسم، لأن Roblox يحدّث الوصلات عند ضبط Position.
  • يجب أن ترسل قائمة الانتقال إلى الخادم اسم الوجهة لا موضعها. يفحص الخادم الاسم وفترة الانتظار وأي شرط فتح قبل أن ينقل أحدًا.
  • TeleportService:Teleport() قديم ومهجور ويعمل في العميل. استخدم TeleportAsync على الخادم، ولفّه بـ pcall، وأعد المحاولة، وعالج TeleportInitFailed.
في هذه الصفحة
  1. طريقة العمل
  2. 1. المنصات
  3. 2. سكربت الانتقال
  4. 3. قائمة الانتقال
  5. 4. أماكن أخرى
  6. الدروس القديمة
  7. حدود الحماية
  8. 5. الاختبار
  9. التوسعات
  10. Common errors
  11. مع RoCode
  12. الأسئلة الشائعة
  13. المصادر والقراءات

نوعان من الانتقال

رسم توضيحيلمس PadA يضعك أمام PadB مباشرةً، فلا تعيدك PadB فورًا، ويرفض الخادم نقطة Castle المقفلة لكنه ينقلك إلى Lake.

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

نوعان من الانتقال
داخل الخادم نفسهإلى مكان آخر في لعبتك
الاستدعاءcharacter:PivotTo(cframe)TeleportService:TeleportAsync(placeId, players)
لماذامنصات الانتقال، وقوائم الانتقال، ونقل اللاعبين من الردهة إلى الحلبةبوابات إلى مستوى آخر، وردهة ترسل اللاعبين إلى مكان منفصل فيه زنزانة أو مباراة
أين يعملScript على الخادمScript على الخادم فقط. أما Teleport() في العميل فقديم ومهجور.
يعمل في اختبار اللعب في Studioنعملا. لا يدعم TeleportService في Roblox اختبار اللعب في Studio، لذا يُختبر في اللعبة المنشورة.
ما يراه اللاعبقفزة عبر الخريطة قد تستغرق حتى ثانيتين إذا كان يجب تحميل تلك المنطقة أولًاشاشة تحميل Roblox، ثم المكان الآخر
العملات والعناصر والبيانات الأخرىتبقى كما هييمسح Roblox البيانات المحلية للاعب، لذا يجب أن يأتي كل ما هو مهم من مخزن بيانات في المكان الآخر

في هذا الدليل الأنواع الثلاثة مجموعة في Script واحد على الخادم، فتغطي مجموعة قواعد واحدة كل انتقال في لعبتك: الخادم يقرر، ولكل لاعب فترة انتظاره، وجهاز اللاعب يخبر فقط بالنقطة التي يريد الوصول إليها.

مما يتكون الانتقال
العنصرأين يوجدماذا يفعل
Folder TeleportPads مع PadA وPadBWorkspaceمنصتان. السمة Destination في كل منهما تسمّي المنصة التي ترسل إليها اللاعبين.
Folder TeleportSpotsWorkspaceقطعة واحدة لكل نقطة في قائمة الانتقال. السمة WinsNeeded تقفل النقطة.
Folder PlacePortalsWorkspaceقطع البوابات. السمة PlaceId في كل بوابة هي المكان الذي ترسل إليه اللاعبين.
Script TeleportersServerScriptServiceيدير أنواع الانتقال الثلاثة وينشئ حدثَي الاتصال (remotes). المكان الوحيد الذي يمكن أن يحدث فيه الانتقال.
LocalScript TeleportMenuStarterPlayer > StarterPlayerScriptsيرسم زر Teleport وقائمة النقاط، ويرسل اسم النقطة التي اختارها اللاعب.
RemoteFunction GetTeleportSpots وRemoteEvent TeleportRequestReplicatedStorage (ينشئهما Teleporters)الأول يُرجع إلى القائمة قائمة النقاط. والثاني يحمل الاسم المختار إلى الخادم.
Explorer عندما يكتمل الانتقال. يضيف Teleporters الكائنين GetTeleportSpots وTeleportRequest إلى ReplicatedStorage عند تشغيل اللعبة.
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: ابنِ منصتَي الانتقال

  1. في Explorer مرّر المؤشر فوق Workspace، واضغط الزر + وأدرج Folder. سمِّ المجلد TeleportPads. السكربت يبحث عن هذا الاسم بالتحديد.
  2. أدرج في المجلد قطعتَي Part وسمّهما PadA وPadB. اجعل كلًّا منهما لوحًا مسطحًا، مثل 6 في 1 في 6 ستد، وضعهما على الأرض بمسافة بينهما. في نافذة Properties فعّل Anchored، واترك CanCollide وCanTouch مفعّلتين، واختر لونًا زاهيًا والمادة Neon ليلاحظهما اللاعبون.
  3. حدّد PadA، ومرّر نافذة Properties إلى قسم Attributes واضغط +. أدخل الاسم Destination، واختر النوع String واضغط Save، ثم اجعل القيمة PadB. افعل الشيء نفسه في PadB بالقيمة PadA.
  4. أدر كل منصة بحيث يكون وجهها الأمامي متجهًا نحو أرض فارغة. يظهر اللاعبون على بعد 3 ستد أمام الوجه الأمامي لمنصة الوجهة، وظهرهم إليها، لذا اترك هناك بضعة ستد من الأرض الفارغة. لترى أي وجه هو الأمامي، انقر على المنصة بالزر الأيمن واختر Show Orientation Indicator: يحدد خط أزرق الوجه الأمامي. أدر المنصة بأداة Rotate حتى يشير هذا الخط إلى حيث يجب أن يمشي اللاعبون.

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

لست مقيدًا بمنصتين. يمكن أن تسمّي Destination في المنصة أي قطعة في TeleportPads، فتستطيع ثلاث منصات إرسال اللاعبين في دائرة. ولمنصة باتجاه واحد، وجّهها إلى قطعة في TeleportPads ليس لها Destination خاص بها: هذه القطعة تستقبل اللاعبين ولا ترسل أحدًا إلى أي مكان.

الخطوة 2: أضف سكربت الانتقال

مرّر المؤشر فوق ServerScriptService، وأدرج Script، وسمّه Teleporters، والصق فيه الكود أدناه. الآن يخدم المنصات، وبعد الخطوات التالية يخدم القائمة والبوابات أيضًا، لذا تضيفه مرة واحدة. الإعدادات في البداية هي الأسطر المخصصة لتغيّرها.

Script في ServerScriptService باسم 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 مرة واحدة، عند بدء الخادم، لذا فالمنصات والبوابات المضافة أثناء اللعب لا تفعل شيئًا. وإذا غاب أحد المجلدات، فهذا النوع من الانتقال معطّل ببساطة.

ماذا يفعل كل جزء في Teleporters
الجزءماذا يفعللماذا
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 من دليل الجري هذه السمة ويبدأ القياس من جديد من الموضع الجديد. ودون سكربت كهذا لا تفعل السمة شيئًا.
الإعدادات في بداية Teleporters
الإعدادالقيمة هناماذا يغيّر
PAD_COOLDOWN_SECONDS2مدة تجاهل المنصات والبوابات للاعب بعد أي انتقال.
MENU_COOLDOWN_SECONDS3أقصر فاصل بين انتقالين عبر القائمة للاعب نفسه. للمنصات والقائمة ساعة مشتركة لكل لاعب، لذا يُتجاهل أيضًا طلب القائمة خلال 3 ثوانٍ بعد انتقال من منصة.
PAD_ARRIVAL_GAP3على بعد كم ستد من الوجه الأمامي لمنصة الوجهة يظهر اللاعبون، ليصلوا إلى جوار المنصة لا فوقها.
PLACE_ATTEMPTS3كم مرة تجرّب البوابة TeleportAsync بفاصل ثانيتين قبل أن تستسلم.

اضغط Play الآن واخطُ على PadA: ستظهر أمام PadB. تحتاج القائمة والبوابات إلى الخطوتين التاليتين، لكن السكربت يعمل من دونهما.

الخطوة 4: الانتقال إلى مكان آخر

المكان (place) عالم منفصل داخل لعبتك، له خوادمه الخاصة: ردهة وزنزانة، أو مركز ومجموعة مستويات. ينتقل اللاعبون بين الأماكن عبر TeleportService، ولا يشغّله Roblox إلا في اللعبة المنشورة، لذا تنتهي هذه الخطوة في تطبيق Roblox لا في Studio.

  1. إذا لم تكن اللعبة منشورة بعد، فاختر File > Publish. الألعاب الجديدة، حتى تطلقها، مفتوحة فقط لك، وللأشخاص الذين منحتهم صلاحية Edit، ولأعضاء المجموعة ذوي الأدوار المناسبة، وهذا يكفي لاختبار الانتقال بنفسك.
  2. أنشئ مكانًا ثانيًا: افتح مكانًا جديدًا من أي قالب في Studio، وابنِ زنزانتك، ثم اختر File > Publish As، وانقر على مربع لعبتك، واختر Add as a new place واضغط Create.
  3. انسخ معرّف المكان الجديد. افتح Asset Manager من قائمة Window أو من تبويب Home، وانتقل إلى Places In Experience، وانقر على المكان بالزر الأيمن واختر Copy Asset ID، فيُنسخ معرّف المكان (place ID).
  4. بعد العودة إلى المكان الأول، أدرج في Workspace مجلد Folder باسم PlacePortals، وداخله Part مثبتة باسم DungeonPortal. أضف سمة من النوع Number باسم PlaceId والصق المعرّف قيمةً لها.
  5. اضغط Play والمس البوابة. يطبع Output سطرًا يبدأ بـ Teleporters: would send: في Studio لا تفعل البوابة أكثر من ذلك.
  6. انشر اللعبة من جديد عبر 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:

القيم الثلاث لـ Access Control for Places
الإعدادمن يستطيع دخول مكان ليس مكان البداية
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 كليهما أي عدد من المرات بأي وسائط، وتحريك شخصيته. هذا ما يمنحه إياه ذلك مع هذا الانتقال.

ما قد يجربه الغشاش وما يفعله Teleporters حياله
الغشاش يحاولالنتيجةلماذا
إرسال موضع أو 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: اختبره

  1. اضغط Play. اخطُ على PadA: تظهر أمام PadB مباشرةً، وظهرك إليها. استدر واخطُ فورًا على PadB: لا يحدث شيء، لأن المنصات تتجاهلك لثانيتين بعد الوصول. ابتعد، وانتظر ثانيتين، واخطُ على PadB مجددًا: تظهر أمام PadA.
  2. انتظر بضع ثوانٍ، ثم اضغط Teleport في الجهة اليسرى من الشاشة. في القائمة تظهر Lake وSpawn والزر الرمادي "Castle (needs 3 wins)". اختر Lake: تظهر عليها. افتح القائمة مجددًا واختر Castle: لا يحدث شيء، وOutput صامت.
  3. امنح نفسك 3 Wins (لهذا تحتاج إلى سكربت leaderstats فيه IntValue باسم Wins، مثل الذي في دليل لوحة الصدارة). اضغط مفتاح التبديل Client/Server للانتقال إلى Server، وابحث في Explorer عن Players ثم اسمك ثم leaderstats ثم Wins، واجعل Value فيها 3 في نافذة Properties. عد إلى Client وافتح القائمة مجددًا: صار Castle بنفسجيًا وينقلك إلى هناك.
  4. المس DungeonPortal. يطبع Output سطرًا يبدأ بـ Teleporters: would send، مع اسمك ومعرّف المكان. في Studio هذا هو المتوقع، ولا يُطبع أكثر من مرة كل ثانيتين، مهما وقفت على البوابة.
  5. اختر Server & Clients في القائمة المنسدلة لأوضاع الاختبار، واجعل عدد العملاء 2 واضغط Play. يستطيع اللاعبان استخدام المنصات في الوقت نفسه، ولا تحجب فترة انتظار أحدهما الآخر أبدًا.
  6. أوقف الاختبار، وانشر اللعبة وشغّلها من تطبيق 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، مع إعادة المحاولة.

ما يفعله RoCode
  • يمكنه تصفح مكانك عندما تحتاج الخطوة إلى ذلك، عبر 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 مرئية للعميل وغير مشفرة، لذا تصلح لشيء مثل الخريطة المختارة، لا للعملات. احفظ العملات والعناصر في مخزن بيانات وحمّلها في المكان الآخر.

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

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

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

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