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

كيف تصنع نظام جولات في Roblox Studio

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

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

باختصار

اكتب Script واحدًا على الخادم في ServerScriptService يمرّ في دائرة على مجموعة ثابتة من الحالات: الاستراحة (انتظار العدد المطلوب من اللاعبين، ثم العد التنازلي)، وتحميل الخريطة (استنساخ خريطة عشوائية من ServerStorage إلى Workspace)، والانتقال (نقل كل شخصية حية إلى قطعة الظهور عبر PivotTo)، والجولة (تشغيل المؤقت حتى ينتهي الوقت أو يبقى لاعب واحد أو فريق واحد)، والتنظيف (منح Wins، وإعادة إظهار الناجين، وحذف الخريطة).

  • شغّل الحلقة على الخادم فقط. انشر الحالة والثواني المتبقية سماتٍ (Attributes) على Folder في ReplicatedStorage، ودع LocalScript يعرضها.
  • احتفظ بجدول لمن ما زالوا في الجولة. أزل اللاعب عندما يموت الـ Humanoid الخاص به، أو تُحذف شخصيته، أو يغادر.
  • لا تنقل إلا اللاعبين الذين تكون شخصياتهم حية لحظة بدء الجولة. ومن يدخل لاحقًا ينتظر الجولة التالية في الردهة.
في هذه الصفحة
  1. طريقة العمل
  2. 1. الردهة والخرائط
  3. 2. سكربت الجولات
  4. كيف تعمل الحالات
  5. 3. واجهة المؤقت
  6. لاعبون في منتصف الجولة
  7. كيف توسّعه
  8. Common errors
  9. مع RoCode
  10. الأسئلة الشائعة
  11. المصادر والقراءات

كيف يعمل نظام الجولات

توضيحسكربتات الجولات الجاهزة في لعبة قيد التشغيل، بسرعة مضاعفة.

نظام الجولات آلة حالات. في أي لحظة يكون الخادم في حالة واحدة بالضبط، ولكل حالة مهمة واحدة، وشرط واحد ينقلها إلى الحالة التالية. إذا كتبته بهذه الطريقة فكل المنطق في مكان واحد، ولا يظهر الخطأ الكلاسيكي الذي تحاول فيه حلقة المؤقت وحلقة الجولة كلتاهما إنهاء الجولة نفسها.

حالات حلقة الجولات في هذا الدليل
الحالةماذا يفعل الخادممتى ينتقل إلى التالية
Waitingيُظهر "Waiting for players (1/2)"عندما يكون على الخادم عدد كافٍ من اللاعبين
Intermissionيعدّ الوقت تنازليًا بينما الجميع في الردهةانتهى العد (أو العودة إلى Waiting إذا غادر لاعبون)
Startingينسخ خريطة عشوائية إلى Workspace، ويُظهر اسمها، ويطلب من العملاء تحميلهاانتهى عد قصير "استعدّوا"
InRoundينقل اللاعبين الأحياء، ويشغّل المؤقت، ويُخرج من مات أو غادرانتهى الوقت، أو بقي لاعب واحد أو فريق واحد
Resultsيمنح Win لكل من ما زال حيًا، ويُظهر من فازمرّت بضع ثوانٍ
Cleanupيعيد إظهار الناجين في الردهة ويحذف الخريطةفورًا، ثم تبدأ الحلقة من جديد

الخادم يملك كل حالة. والعملاء لا يفعلون إلا عرض ما يخبرهم به الخادم. فالعد التنازلي في LocalScript يبتعد عن العد الحقيقي، ويكون خاطئًا عند من دخل لاحقًا، ويمكن للمستغل (Exploiter) تغييره. إذا كان الفصل بين الخادم والعميل جديدًا عليك فاقرأ أولًا Script vs LocalScript vs ModuleScript.

الخطوة 1: جهّز الردهة والخرائط وإحصائية Wins

  1. ابنِ ردهة في Workspace فيها SpawnLocation. تأكد من تفعيل خاصيته Neutral، كي يظهر كل لاعب هنا، وينتظر هنا، ويعود إلى هنا بعد خروجه من الجولة.
  2. في ServerStorage أدرج Folder باسم Maps. الكائنات في ServerStorage لا تُرسل إلى اللاعبين أبدًا، فالخرائط غير المستخدمة لا تكلّفهم شيئًا.
  3. ابنِ كل خريطة على شكل Model داخل Maps، بقطع مثبّتة (Anchored). ابنِها بعيدًا عن الردهة (بضع مئات من الستاد تكفي)، لأن النسخة تظهر في المكان الذي بنيتها فيه بالضبط، ويجب ألا يستطيع اللاعبون الخارجون من الجولة العودة إليها مشيًا.
  4. داخل كل خريطة أضف Folder باسم Spawns، وفيه Part مثبّت واحد لكل لاعب متوقع. اضبط Transparency على 1 وأطفئ CanCollide، كي لا يراها أحد ولا يتعثر بها.
نافذة Explorer بعد هذا الدليل
Workspace
  Lobby Model
    SpawnLocation SpawnLocation
ServerStorage
  Maps Folder new
    Desert Model new
      Spawns Folder new
        Spawn1 Part new
        Spawn2 Part new
    Castle Model new
      Spawns Folder new
ServerScriptService
  Leaderstats Script new
  RoundSystem Script new
StarterGui
  RoundHud ScreenGui new
    RoundHudClient LocalScript new

يضيف سكربت الجولات 1 إلى IntValue باسم Wins داخل مجلد leaderstats الخاص باللاعب. إذا لم يكن في لعبتك leaderstats بعد فأضف هذا السكربت القصير. وإذا كان موجودًا، كنسخة الحفظ من دليل لوحة الصدارة، فتجاوزه: سكربتان ينشئان leaderstats يعطيان كل لاعب مجلدين.

Script في ServerScriptService باسم Leaderstats
local Players = game:GetService("Players")

local function setupLeaderstats(player: Player)
	local leaderstats = Instance.new("Folder")
	leaderstats.Name = "leaderstats" -- يجب أن يكون الاسم هكذا بالضبط، بأحرف صغيرة

	local wins = Instance.new("IntValue")
	wins.Name = "Wins"
	wins.Value = 0
	wins.Parent = leaderstats

	leaderstats.Parent = player
end

Players.PlayerAdded:Connect(setupLeaderstats)

-- في Studio قد تدخل قبل أن يعمل هذا السكربت، لذلك نجهّز كل من هو هنا أصلًا
for _, player in Players:GetPlayers() do
	setupLeaderstats(player)
end

تُعاد Wins هذه إلى الصفر عندما يغادر اللاعب. لتبقى محفوظة بين الجلسات خذ نسخة DataStore من دليل لوحة الصدارة.

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

أدرج Script في ServerScriptService، وسمّه RoundSystem، والصق الكود أدناه. الإعدادات في الأعلى هي على الأرجح الأسطر الوحيدة التي ستحتاج إلى تغييرها. كل حالة دالة منفصلة، والحلقة في الأسفل تشغّلها بالترتيب، بلا نهاية.

Script في ServerScriptService باسم RoundSystem
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")

-- الإعدادات
local MIN_PLAYERS = 2 -- اجعلها 1 ما دمت تختبر وحدك
local INTERMISSION_SECONDS = 20
local GET_READY_SECONDS = 5
local ROUND_SECONDS = 120
local RESULTS_SECONDS = 5
local USE_TEAMS = false -- true: تنتهي الجولة عندما يبقى لاعبون في فريق واحد فقط

local mapsFolder = ServerStorage:WaitForChild("Maps")
local random = Random.new()

-- ما تعرضه شاشة كل لاعب محفوظ في سمات على هذا المجلد.
-- السمات التي يضبطها الخادم تُنسخ إلى كل العملاء، ومنهم من يدخل لاحقًا.
local roundInfo = Instance.new("Folder")
roundInfo.Name = "RoundInfo"
roundInfo.Parent = ReplicatedStorage

local function setState(state: string, status: string)
	roundInfo:SetAttribute("State", state)
	roundInfo:SetAttribute("Status", status)
	roundInfo:SetAttribute("TimeLeft", 0)
end

local function setTimeLeft(seconds: number)
	roundInfo:SetAttribute("TimeLeft", seconds)
end

-- من ما زال في الجولة الحالية، والاتصالات التي تراقب كلًا منهم
local alive: { [Player]: boolean } = {}
local watchers: { [Player]: { RBXScriptConnection } } = {}

local function eliminate(player: Player)
	if not alive[player] then
		return
	end
	alive[player] = nil
	player:SetAttribute("InRound", false)
	local connections = watchers[player]
	if connections then
		for _, connection in connections do
			connection:Disconnect()
		end
		watchers[player] = nil
	end
end

Players.PlayerRemoving:Connect(eliminate)

-- يعيد الشخصية والـ Humanoid فقط إذا كان اللاعب حيًا الآن
local function getLivingCharacter(player: Player): (Model?, Humanoid?)
	local character = player.Character
	if not character or not character.Parent then
		return nil, nil
	end
	local humanoid = character:FindFirstChildOfClass("Humanoid")
	if not humanoid or humanoid.Health <= 0 or not humanoid.RootPart then
		return nil, nil
	end
	return character, humanoid
end

-- يعدّ الأطراف الباقية في الجولة (اللاعبين، أو الفرق إذا كان USE_TEAMS مفعّلًا)
local function countSides(): (number, number)
	local sides: { [Instance]: boolean } = {}
	local sideCount = 0
	local playerCount = 0
	for player in alive do
		playerCount += 1
		local team = player.Team
		local side: Instance = if USE_TEAMS and team then team else player
		if not sides[side] then
			sides[side] = true
			sideCount += 1
		end
	end
	return sideCount, playerCount
end

-- الحالة: Waiting وIntermission. تعيد false إذا غادر لاعبون أثناء العد.
local function runIntermission(): boolean
	while #Players:GetPlayers() < MIN_PLAYERS do
		setState("Waiting", `Waiting for players ({#Players:GetPlayers()}/{MIN_PLAYERS})`)
		task.wait(1)
	end
	setState("Intermission", "Intermission")
	for secondsLeft = INTERMISSION_SECONDS, 1, -1 do
		if #Players:GetPlayers() < MIN_PLAYERS then
			return false
		end
		setTimeLeft(secondsLeft)
		task.wait(1)
	end
	return true
end

-- الحالة: Starting، الجزء 1. ننسخ خريطة عشوائية (غير السابقة، إن وُجد خيار).
local lastMapName = ""

local function loadMap(): Model?
	local allMaps: { Model } = {}
	local freshMaps: { Model } = {}
	for _, child in mapsFolder:GetChildren() do
		if child:IsA("Model") then
			table.insert(allMaps, child)
			if child.Name ~= lastMapName then
				table.insert(freshMaps, child)
			end
		end
	end
	local choices = if #freshMaps > 0 then freshMaps else allMaps
	if #choices == 0 then
		warn("RoundSystem: add at least one map Model to ServerStorage > Maps")
		return nil
	end
	local chosen = choices[random:NextInteger(1, #choices)]
	lastMapName = chosen.Name
	local map = chosen:Clone()
	map.Parent = workspace
	return map
end

local function getSpawnPoints(map: Model): { BasePart }
	local points: { BasePart } = {}
	local folder = map:FindFirstChild("Spawns")
	if folder then
		for _, child in folder:GetChildren() do
			if child:IsA("BasePart") then
				table.insert(points, child)
			end
		end
	end
	-- نخلطها كي لا يقع اللاعبون على نقطة الظهور نفسها في كل جولة
	for i = #points, 2, -1 do
		local j = random:NextInteger(1, i)
		points[i], points[j] = points[j], points[i]
	end
	return points
end

-- على أي ارتفاع فوق الأرض تكون الـ root part للشخصية الواقفة.
-- المعادلة من مرجع 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

-- الحالة: Starting، الجزء 2. الاستعداد، ثم نقل كل الأحياء.
local function startRound(map: Model): boolean
	local spawnPoints = getSpawnPoints(map)
	if #spawnPoints == 0 then
		warn(`RoundSystem: {map.Name} needs a Spawns folder with at least one part in it`)
		return false
	end

	-- عند تفعيل البث (Streaming) نطلب من كل عميل تحميل الخريطة قبل وصول الشخصية
	if workspace.StreamingEnabled then
		local mapPosition = map:GetPivot().Position
		for _, player in Players:GetPlayers() do
			task.spawn(function()
				pcall(function()
					player:RequestStreamAroundAsync(mapPosition, GET_READY_SECONDS)
				end)
			end)
		end
	end

	setState("Starting", `Map: {map.Name}`)
	for secondsLeft = GET_READY_SECONDS, 1, -1 do
		setTimeLeft(secondsLeft)
		task.wait(1)
	end

	-- لا يشارك إلا من هو حي الآن. والباقون ينتظرون الجولة التالية.
	local participants: { Player } = {}
	for _, player in Players:GetPlayers() do
		if getLivingCharacter(player) then
			table.insert(participants, player)
		end
	end
	if #participants < MIN_PLAYERS then
		setState("Waiting", "Not enough players, starting over")
		task.wait(2)
		return false
	end

	for index, player in participants do
		local character, humanoid = getLivingCharacter(player)
		local rootPart = if humanoid then humanoid.RootPart else nil
		if character and humanoid and rootPart then
			local spawnPart = spawnPoints[(index - 1) % #spawnPoints + 1]
			-- محور (Pivot) الشخصية هو الـ root part، لذلك نرفعه إلى ارتفاع الوقوف فوق القطعة
			local height = spawnPart.Size.Y / 2 + rootHeight(character, humanoid, rootPart)
			character:PivotTo(spawnPart.CFrame + Vector3.new(0, height, 0))
			alive[player] = true
			player:SetAttribute("InRound", true)
			watchers[player] = {
				humanoid.Died:Connect(function()
					eliminate(player)
				end),
				player.CharacterRemoving:Connect(function()
					eliminate(player)
				end),
			}
		end
	end
	return true
end

-- الحالة: InRound. تنتهي عندما ينتهي الوقت أو يبقى طرف واحد.
local function runRound()
	setState("InRound", "Round in progress")
	local startingSides = countSides()
	for secondsLeft = ROUND_SECONDS, 1, -1 do
		local _, playersLeft = countSides()
		roundInfo:SetAttribute("Status", `{playersLeft} left`)
		setTimeLeft(secondsLeft)
		task.wait(1)
		local sidesLeft = countSides()
		-- الجولة التي بدأها طرف واحد (اختبار فردي) لا تنتهي إلا بانتهاء الوقت أو بالموت
		if sidesLeft == 0 or (startingSides > 1 and sidesLeft == 1) then
			break
		end
	end
end

-- الحالة: Results. يفوز كل من ما زال حيًا.
local function awardWin(player: Player)
	local leaderstats = player:FindFirstChild("leaderstats")
	local wins = leaderstats and leaderstats:FindFirstChild("Wins")
	if wins and wins:IsA("IntValue") then
		wins.Value += 1
	end
end

local function finishRound(): { Player }
	local sidesLeft = countSides()
	local winners: { Player } = {}
	for player in alive do
		table.insert(winners, player)
	end

	local message = `{#winners} players survived!`
	local firstTeam = if #winners > 0 then winners[1].Team else nil
	if #winners == 0 then
		message = "Nobody survived"
	elseif USE_TEAMS and sidesLeft == 1 and firstTeam then
		message = `{firstTeam.Name} wins!`
	elseif #winners == 1 then
		message = `{winners[1].DisplayName} wins!`
	end

	for _, player in winners do
		awardWin(player)
		eliminate(player) -- نتوقف عن مراقبتهم؛ ويبقون على الخريطة حتى التنظيف
	end
	setState("Results", message)
	task.wait(RESULTS_SECONDS)
	return winners
end

-- الحالة: Cleanup. نعيد الناجين إلى الردهة، ثم نحذف الخريطة.
local function cleanup(map: Model, survivors: { Player })
	for _, player in survivors do
		if player.Parent then -- ما زال على الخادم
			task.spawn(function()
				local ok, err = pcall(function()
					player:LoadCharacterAsync()
				end)
				if not ok then
					warn(`RoundSystem: could not respawn {player.Name}: {err}`)
				end
			end)
		end
	end
	map:Destroy()
end

-- الحلقة: كل دورة جولة واحدة
while true do
	if runIntermission() then
		local map = loadMap()
		if map then
			local survivors: { Player } = {}
			if startRound(map) then
				runRound()
				survivors = finishRound()
			end
			cleanup(map, survivors)
		else
			task.wait(5) -- لا خرائط بعد: سنحاول مجددًا بعد قليل
		end
	end
end

كل ما هو مهم يحدث هنا، على الخادم: من في الجولة، والمؤقت، والفائز، وWins. أما العملاء فلا يتلقون إلا ثلاث سمات على ReplicatedStorage.RoundInfo (State وStatus وTimeLeft) والسمة InRound على كل لاعب.

كيف تعمل كل حالة

الانتظار والاستراحة

تُبقي runIntermission الحلقة أولًا إلى أن يبلغ #Players:GetPlayers() القيمة MIN_PLAYERS. ثم تعدّ تنازليًا ثانية بثانية عبر task.wait(1) وتفحص عدد اللاعبين في كل نبضة. إذا غادر أحد وصار على الخادم أقل من الحد الأدنى أعادت false، فتبدأ الحلقة الرئيسية من جديد من Waiting، فلا تبدأ الجولة أبدًا بشخص واحد.

اختيار الخريطة وتحميلها

تجمع loadMap كل Model في ServerStorage.Maps، وتستبعد خريطة الجولة السابقة إن كان هناك ما يُختار منه، وتأخذ واحدة عبر Random:NextInteger. ثم تستنسخ الخريطة إلى Workspace. يبقى الأصل سليمًا في ServerStorage، فتبدأ كل جولة بنسخة جديدة: كل ما كسره اللاعبون أو حرّكوه في الجولة السابقة يختفي.

في الأماكن الجديدة يكون بث النسخ (Instance Streaming) مفعّلًا: لا يملك العميل إلا القطع القريبة من شخصيته. قبل الانتقال يستدعي السكربت Player:RequestStreamAroundAsync لكل لاعب، وهذا يطلب من المحرك أن يرسل إلى العميل المنطقة المحيطة بالخريطة أثناء عد "استعدّوا". ودون ذلك قد يصل اللاعبون قبل تحميل الأرض ويتجمدون لحظة.

نقل اللاعبين عبر PivotTo

بعد العد يجمع السكربت قائمة المشاركين من اللاعبين الذين توجد شخصياتهم، وما زالت في العالم، ولها Humanoid صحته أكبر من 0 وroot part. هذا الفحص يأتي بعد العد، فمن مات أو غادر أثناءه لا يدخل القائمة.

يُنقل كل مشارك عبر character:PivotTo(cframe). يصف مرجع Roblox الدالة PivotTo بأنها الطريقة الأساسية لتحريك النماذج من السكربت، وهي تحرّك كل أجزاء الشخصية معًا. أما ضبط HumanoidRootPart.Position فليس الشيء نفسه: يعدّل Roblox الوصلات بحيث يتحرك ذلك الجزء وحده، وقد يبقى باقي الجسم خلفه. محور الشخصية هو الـ root part، لذلك يكون الهدف هو CFrame قطعة الظهور مرفوعًا بنصف ارتفاع القطعة مضافًا إليه الارتفاع الذي تقف عليه الـ root part فوق الأرض. تحسبه rootHeight بالمعادلة من مرجع Roblox لـ Humanoid.HipHeight: نصف ارتفاع الـ root part زائد HipHeight، زائد طول الساق في هياكل R6. هكذا لا تعلق الأفاتارات المكبّرة والمخصصة داخل القطعة ولا تسقط عليها من أعلى. يتضمن الـ CFrame الدوران، فينظر اللاعبون إلى حيث تنظر قطعة الظهور: أدر القطع بحيث ينظر الجميع إلى مركز الخريطة.

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

إذا كنت تستخدم أيضًا فحص السرعة من دليل الركض، فأضف player:SetAttribute("MovementCheckSkip", true) مباشرة بعد character:PivotTo(...) في startRound، كي لا يُحسب الانتقال تجاوزًا للسرعة.

مؤقت الجولة وشروط النهاية

تنبض runRound مرة كل ثانية. في كل نبضة تحدّث الحالة (كم لاعبًا بقي) والثواني المتبقية، ثم تعدّ الأطراف الحية. تنتهي الجولة بإحدى ثلاث طرق:

  • انتهى الوقت. تصل حلقة for إلى 1 وتنتهي.
  • بقي طرف واحد. الطرف لاعب، أو فريق إذا كان USE_TEAMS مفعّلًا. لا يعمل هذا الفحص إلا إذا بدأت الجولة بطرفين أو أكثر، فلا ينتهي الاختبار الفردي في اللحظة التي يبدأ فيها.
  • لم يبقَ أحد. مات الجميع أو غادروا، فتنتهي الجولة دون فائز.

الفحص مرة كل ثانية يعني أن الجولة قد تستمر حتى ثانية بعد آخر خروج، وهذا لا يكاد يُلاحظ في مؤقت الجولة.

منح Wins وعرض النتيجة

القاعدة في هذا السكربت بسيطة: يفوز كل من هو حي لحظة انتهاء الجولة. وهذا يغطي آخر لاعب ناجٍ، وآخر فريق ناجٍ، ووضع "اصمد حتى ينتهي المؤقت" بسطر منطق واحد. تضيف finishRound 1 إلى Wins لكل فائز، وتتوقف عن مراقبتهم، وتعرض رسالة مثل "Alex wins!" لمدة RESULTS_SECONDS. إذا أردت ألا يكون هناك فائز عند انتهاء الوقت فتجاوز awardWin وغيّر الرسالة عندما تكون sidesLeft أكبر من 1. وفي كل الأحوال واصل إرجاع القائمة، لأن التنظيف يعيد الناجين إلى الردهة بناءً عليها.

التنظيف

ما زال الناجون واقفين على الخريطة، لذلك تعيد cleanup إظهارهم في الردهة عبر Player:LoadCharacterAsync()، التي تحل محل LoadCharacter القديمة، ثم تحذف نسخة الخريطة. كل إعادة إظهار تجري في task.spawn خاص بها داخل pcall، لأن الاستدعاء ينتظر تحميل الشخصية وقد يفشل إذا كان اللاعب يغادر في تلك اللحظة بالذات. أما اللاعبون الخارجون فلا يحتاجون إلى شيء: لقد عادوا إلى الحياة في الردهة من تلقاء أنفسهم.

الخطوة 3: اعرض المؤقت والحالة لكل لاعب

ينشر الخادم ثلاث سمات على ReplicatedStorage.RoundInfo: State (كلمة ثابتة مثل InRound، للسكربتات)، وStatus (نص للبشر)، وTimeLeft (الثواني). السمات التي يضبطها سكربت على الخادم في كائن يُنسخ إلى العملاء تصل تلقائيًا إلى كل عميل، واللاعب الذي يدخل في منتصف الجولة يحصل على القيم الحالية فورًا. لذلك تناسب المؤقت أكثر من الـ Remote: فالـ RemoteEvent الذي أُرسل قبل دخول أحدهم لن يصل إليه أبدًا.

  1. في Explorer أدرج ScreenGui داخل StarterGui وسمّه RoundHud. اترك ResetOnSpawn مفعّلًا (الإعداد الافتراضي).
  2. أدرج LocalScript داخل RoundHud، وسمّه RoundHudClient، والصق الكود أدناه. إنه ينشئ النص بنفسه، فلا حاجة إلى رسم أي شيء آخر.
  3. اضغط Play. يُظهر النص في أعلى الشاشة الحالة والعد التنازلي بصيغة m:ss.
LocalScript في ScreenGui RoundHud داخل StarterGui باسم RoundHudClient
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local roundInfo = ReplicatedStorage:WaitForChild("RoundInfo")
local screenGui = script.Parent :: ScreenGui

-- النص. إذا رسمت TextLabel خاصًا بك داخل RoundHud فاحذف هذه الكتلة واستخدم:
-- local label = screenGui:WaitForChild("StatusLabel") :: TextLabel
local label = Instance.new("TextLabel")
label.Name = "StatusLabel"
label.AnchorPoint = Vector2.new(0.5, 0)
label.Position = UDim2.new(0.5, 0, 0, 12)
label.Size = UDim2.fromOffset(320, 44)
label.BackgroundColor3 = Color3.fromRGB(20, 14, 32)
label.BackgroundTransparency = 0.2
label.TextColor3 = Color3.new(1, 1, 1)
label.Font = Enum.Font.BuilderSansBold
label.TextSize = 22
label.TextWrapped = true -- الرسائل الطويلة تنتقل إلى سطر ثانٍ
label.Text = ""
label.Parent = screenGui

local corner = Instance.new("UICorner")
corner.CornerRadius = UDim.new(0, 10)
corner.Parent = label

local function formatTime(seconds: number): string
	return string.format("%d:%02d", seconds // 60, seconds % 60)
end

local function update()
	local status = roundInfo:GetAttribute("Status")
	local timeLeft = roundInfo:GetAttribute("TimeLeft")
	local text = if type(status) == "string" then status else ""
	if type(timeLeft) == "number" and timeLeft > 0 then
		text ..= "   " .. formatTime(timeLeft)
	end
	label.Text = text
end

roundInfo:GetAttributeChangedSignal("Status"):Connect(update)
roundInfo:GetAttributeChangedSignal("TimeLeft"):Connect(update)
update()

بما أن ResetOnSpawn مفعّل، يعطي Roblox اللاعب نسخة جديدة من RoundHud عند كل ظهور للشخصية، ومنها إعادة الإظهار عند التنظيف. فيقرأ السكربت السمات الحالية من جديد، ولا يتقادم النص أبدًا.

العميل يقرأ فقط. لا شيء يغيّره اللاعب على شاشته يؤثر في المؤقت الحقيقي، لأن تغييرات السمات من LocalScript تبقى على ذلك العميل وحده. ولعدّ تنازلي بأعشار الثانية يستطيع الخادم بدلًا من ذلك أن يحفظ في سمة وقت الانتهاء من workspace:GetServerTimeNow()، ويطرح كل عميل منه في كل إطار قيمة workspace:GetServerTimeNow() الخاصة به.

إذا كانت لعبتك تبدأ بـ قائمة رئيسية فإن RoundHud يظهر عندما يضغط اللاعب Play، لأن StarterGui لا يُنسخ إلى اللاعب إلا بعد ظهور شخصيته. واللاعبون الذين ما زالوا في القائمة ليست لهم شخصية، فلا يُنقلون أبدًا إلى الجولة.

لاعبون يموتون أو يغادرون أو يدخلون في منتصف الجولة

من السهل إغفال هذه الحالات عند كتابة سكربت جولات لأول مرة. إذا لم تُعالَج إحداها فعادة ترى خطأ في Output أو جولة لا تنتهي أبدًا. إليك ما يفعله السكربت أعلاه مع كل منها.

الحالات الحدّية وكيف يتعامل معها سكربت الجولات
الموقفماذا يحدثأين في السكربت
لاعب يموت في الجولة (قُتل، أو أعاد ضبط شخصيته، أو سقط)يُخرَج من الجولة، ويعود إلى الحياة في الردهة بعد Players.RespawnTime (5 ثوانٍ افتراضيًا).humanoid.Died يستدعي eliminate
حُذفت الشخصية دون موتكما في الموت: خرج اللاعب.player.CharacterRemoving يستدعي eliminate
لاعب يغادر الخادميُخرَج، وتُقطع اتصالاته، وتعيد النبضة التالية عدّ الأطراف.Players.PlayerRemoving يستدعي eliminate
لاعب يدخل في منتصف الجولةيظهر في الردهة، ويرى الحالة والمؤقت مباشرة، ويدخل الجولة التالية.لا يُختار المشاركون إلا في startRound
كان اللاعب ميتًا لحظة بدء الجولةلا يُنقل، وينتظر في الردهة.getLivingCharacter
غادر الجميع أو ماتواتنتهي الجولة بـ "Nobody survived"، وتبدأ الحلقة من جديد: Intermission إذا بقي على الخادم عدد كافٍ من اللاعبين، وإلا Waiting.sidesLeft == 0 في runRound

كُتبت eliminate بحيث يكون استدعاؤها عدة مرات للاعب نفسه آمنًا. فاللاعب الذي مات وعاد إلى الحياة يطلق Died وCharacterRemoving كليهما، ومن يغادر قد يطلق الأحداث الثلاثة كلها؛ والاستدعاء الأول وحده هو الذي يفعل شيئًا.

كيف توسّعه: الفرق، والتصويت على الخريطة، وأحداث الجولة

آخر فريق ناجٍ

اجعل USE_TEAMS = true، ثم أضف كائنات Team إلى خدمة Teams في Explorer، لكل منها اسم وTeamColor خاصان. افتراضيًا يضع Roblox كل لاعب يدخل في الفريق القابل للتعيين التلقائي الذي فيه أقل عدد من الأعضاء. وعندما يغادر لاعبون لا يعيد موازنة الفرق، فقد تصبح الفرق غير متكافئة في الجلسات الطويلة. اترك SpawnLocation في الردهة على Neutral كي تظهر كل الفرق هناك. عندها تنتهي الجولة عندما يبقى اللاعبون الأحياء في فريق واحد فقط، وتبدو النتيجة مثل "Red wins!".

لنمط "واحد ضد الجميع" (صياد واحد والباقون ينجون) اختر في startRound مشاركًا عشوائيًا واحدًا، واضبط Team الخاص به على فريق الصياد قبل الانتقال. أزل AutoAssignable من فريق الصياد كي لا يدخله لاعبون جدد أبدًا، وفي cleanup أعد الصياد إلى فريق الناجين. عندها تعمل شروط النهاية نفسها: يفوز الصياد إذا خرج كل الناجين، ويفوز الناجون إذا صمدوا حتى نهاية المؤقت، بشرط أن تتجاوز awardWin للصياد عندما ينتهي الوقت.

تصويت اللاعبين على الخريطة

في التصويت يجب أن يتواصل العميل مع الخادم، أي أنك تحتاج إلى RemoteEvent. أثناء الاستراحة ينشر الخادم اسمين أو ثلاثة لخرائط على شكل سمات، ويرسل كل عميل عبر RemoteEvent الاسم الذي ضغط عليه، ويعدّ الخادم الأصوات قبل تشغيل loadMap. ويجب على الخادم أن يتحقق من كل صوت: أن المعامل نص، وأنه أحد الخيارات الحالية، وأن الحالة Intermission، وأن كل لاعب يُحسب مرة واحدة (احفظ الأصوات في جدول مفتاحه Player كي يحل الصوت الثاني محل الأول، وامسحه في PlayerRemoving). يشرح دليل RemoteEvent نمط التحقق هذا بالتفصيل.

منح أداة في بداية الجولة

تستطيع سكربتات أخرى التفاعل مع الجولة دون لمس RoundSystem. يضبط سكربت الجولات السمة InRound لكل لاعب عندما ينقله، ويزيلها عندما يخرج اللاعب. هذا السكربت يستمع إليها ويعطي كل لاعب نسخة من Tool باسم RoundTool موجودة في ServerStorage.

Script في ServerScriptService باسم GiveRoundTool
local Players = game:GetService("Players")
local ServerStorage = game:GetService("ServerStorage")

local toolTemplate = ServerStorage:WaitForChild("RoundTool") :: Tool

local function watchPlayer(player: Player)
	player:GetAttributeChangedSignal("InRound"):Connect(function()
		if player:GetAttribute("InRound") ~= true then
			return
		end
		local backpack = player:FindFirstChildOfClass("Backpack")
		if backpack then
			toolTemplate:Clone().Parent = backpack
		end
	end)
end

Players.PlayerAdded:Connect(watchPlayer)
for _, player in Players:GetPlayers() do
	watchPlayer(player)
end

لا يوجد كود يسحب الأداة. عندما تموت الشخصية يستبدل Roblox الـ Backpack بآخر جديد يملؤه من StarterPack، وLoadCharacterAsync عند التنظيف يفرغه عند الناجين، فلا تبقى الأداة بعد الجولة.

إذا احتجت إلى سلاح لتمنحه، فابنِ سيفًا أو مسدسًا يعمل بالأشعة (Raycast)، واحفظه في ServerStorage بدل StarterPack، وغيّر "RoundTool" في هذا السكربت إلى اسمه.

شخصيات NPC وكائنات أخرى لمدة الجولة فقط

كل ما يجب أن يوجد أثناء الجولة فقط يمكن أن يعيش داخل نموذج الخريطة: الأعداء، والأغراض القابلة للالتقاط، والمنصات المتحركة. السكربتات داخل نموذج في ServerStorage لا تعمل؛ وبمجرد أن تصبح النسخة في Workspace تبدأ بالعمل، وmap:Destroy() عند التنظيف يحذفها مع كل شيء آخر. لإضافة أعداء يطاردون اللاعبين ابنِ واحدًا وفق دليل إيجاد المسار للـ NPC وضعه في الخريطة. ولجولة كاميرا فوق الخريطة في بداية كل جولة يشرح دليل المشاهد السينمائية كيف يستطيع هذا السكربت تشغيل مشهد سينمائي لكل لاعب عبر BindableEvent.

كيف تحوّله إلى وحدة (Module)

في البداية لا تحتاج إلى ModuleScript. فالـ Script الواحد أسهل قراءة ما دمت تبني اللعبة. قسّمه عندما تحتاج سكربتات أخرى إلى استدعاء دوال الجولة، أو عندما تريد نقل الإعدادات إلى ModuleScript مشترك واحد يستطيع الخادم وواجهتك كلاهما تحميله عبر require. وحتى ذلك الحين تعمل السمة State على RoundInfo والسمة InRound على كل لاعب واجهةً عامة لنظام الجولات: أي سكربت يستطيع الاستماع إليهما.

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

افتح نافذة Output (من قائمة Window في Studio أو من تبويب Script) قبل الضغط على Play. معظم مشكلات نظام الجولات تطبع هناك تحذيرًا أو خطأ مع اسم السكربت ورقم السطر.

عالق عند "Waiting for players (1/2)"

أنت تختبر وحدك وMIN_PLAYERS تساوي 2. اجعلها 1 للاختبارات الفردية أو اختبر في وضع Server & Clients بعميلين.

Infinite yield possible on 'ServerStorage:WaitForChild("Maps")'

المجلد غير موجود، أو في اسمه خطأ إملائي، أو هو في الخدمة الخطأ. يجب أن يكون Folder اسمه Maps بالضبط ومباشرة داخل ServerStorage. والتحذير نفسه لـ RoundInfo في LocalScript يعني أن سكربت RoundSystem لم يصل إلى إنشائها: إما أنه معطّل، أو توقف بخطأ، أو ما زال ينتظر مجلد Maps.

بعد الانتقال يسقط اللاعبون عبر الخريطة

قطع الخريطة غير مثبّتة، فتتفكك النسخة بمجرد أن تصبح في Workspace. حدّد الخريطة، وثبّت قطعها، وتأكد أن قطع الظهور فوق الأرض لا داخلها.

اللاعبون الخارجون يعودون إلى الحياة في الحلبة

داخل الخريطة SpawnLocation. استبدله بـ Part عادي في مجلد Spawns الخاص بتلك الخريطة.

الجولة لا تنتهي عندما يموت الجميع

تأكد أن الضرر عندك يقتل الـ Humanoid فعلًا (تصل الصحة إلى 0)، لا أنه يحرّك اللاعبين أو يثبّتهم. وإذا عطّلت حالة Dead للـ Humanoid فإن Died لا ينطلق أبدًا، وتضطر الجولة إلى الاستمرار حتى نهاية المؤقت.

حلقة الجولات تتوقف نهائيًا بعد خطأ واحد

الحلقة تعمل في خيط واحد، فأي خطأ في أي حالة ينهيها. اقرأ الخطأ في Output، وأصلح السطر، واختبر مجددًا. سبب شائع: عُدّل السكربت بحيث يستخدم player.Character.Humanoid دون التحقق من وجود الشخصية.

اصنعه مع RoCode

إذا لم ترغب في بناء كل هذا يدويًا، فيمكن لـ RoCode أن يفعله في المكان المفتوح عندك. إنه وكيل ذكاء اصطناعي يعمل عبر إضافة لـ Roblox Studio، فتظهر السكربتات والقطع في Explorer عندك، لا في نافذة دردشة تضطر إلى النسخ منها.

ما تكتبه

أضف نظام جولات: استراحة 20 ثانية تحتاج إلى لاعبين اثنين، وخريطة عشوائية من ServerStorage.Maps، ونقل الجميع إلى قطع الظهور في الخريطة، وجولات مدتها دقيقتان يفوز فيها آخر لاعب حي، وأضف Win إلى leaderstats، واعرض الحالة والمؤقت في أعلى الشاشة.

ما يفعله RoCode
  • يستطيع أن يتصفح مكانك أولًا عبر List Children وSearch Game وSearch Scripts، ليستخدم مجلد Maps وسكربت leaderstats عندك بدل إضافة مجموعة ثانية
  • ينشئ Script الجولات في ServerScriptService وLocalScript المؤقت عبر Create Script، ويستطيع وضع حلبة من مبانيه الجاهزة عبر Place Prefab إذا لم تكن عندك خرائط بعد
  • يفحص ترجمة كل سكربت داخل Studio عبر Check Script قبل الانتهاء. وهذا يكشف الأخطاء النحوية، لا أخطاء منطق الجولة
  • بعد تجربة اللعب التي تجريها، يقرأ Check Output أسطر Server وClient من آخر تجربة لعب ليصلح خطأ وقت التشغيل

مع الإضافة 3.9 أو أحدث يستطيع RoCode تشغيل تجربة لعب قصيرة وقراءة الأخطاء، ومع الإضافة 3.9.11 أو أحدث يستطيع التحكم بشخصية اختبار واحدة، لكنه لا يختبر بعدة لاعبين، لذا شغّل الجولات بنفسك في وضع Server & Clients. كل دفعة تغييرات نقطة تراجع في Studio. حلقة الجولات أساس كثير من الألعاب، وصنع لعبة Roblox كاملة بالذكاء الاصطناعي، نظامًا بعد نظام يبدأ غالبًا بحلقة كهذه. كيف يتصل RoCode بـ Studio.

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

كيف أصنع نظام جولات بالفرق في Roblox؟

أضف كائنات Team إلى خدمة Teams واجعل USE_TEAMS = true في سكربت الجولات. يوزّع Roblox اللاعبين الداخلين على الفريق القابل للتعيين التلقائي الذي فيه أقل عدد من الأعضاء، وتنتهي الجولة عندما يبقى اللاعبون الأحياء في فريق واحد فقط.

كيف أعرض العد التنازلي لكل اللاعبين؟

اضبط من الخادم الثواني المتبقية سمةً على كائن في ReplicatedStorage، واستمع إليها عبر GetAttributeChangedSignal في LocalScript يحدّث TextLabel، كما في الخطوة 3. واللاعبون الذين يدخلون لاحقًا يحصلون على القيمة الحالية فورًا.

ماذا أستخدم في حلقة الجولات: wait() أم task.wait()؟

استخدم task.wait(). يصنّف Roblox الدالة العامة wait() بأنها قديمة ومستبدلة بـ task.wait().

كيف أنقل اللاعبين إلى مكان آخر في كل جولة؟

هذه أداة أخرى. هذا الدليل ينقل الشخصيات داخل خادم واحد عبر PivotTo. أما إرسال اللاعبين إلى مكان آخر في تجربتك (Experience) فيتم عبر TeleportService، الذي ينقلهم إلى خادم آخر. يبني دليل الانتقال بوابات تفعل ذلك، مع إعادة المحاولة إذا فشل الانتقال.

لماذا يتجمد اللاعبون لحظة بعد الانتقال؟

عند تفعيل بث النسخ لم يكن العميل قد تلقى الخريطة بعد. استدعاء RequestStreamAroundAsync في السكربت أثناء عد "استعدّوا" يطلب من المحرك إرسالها مسبقًا؛ وقيمة أطول لـ GET_READY_SECONDS تمنح الاتصالات البطيئة وقتًا أطول.

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

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

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

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