باختصار
اكتب Script واحدًا على الخادم في ServerScriptService يمرّ في دائرة على مجموعة ثابتة من الحالات: الاستراحة (انتظار العدد المطلوب من اللاعبين، ثم العد التنازلي)، وتحميل الخريطة (استنساخ خريطة عشوائية من ServerStorage إلى Workspace)، والانتقال (نقل كل شخصية حية إلى قطعة الظهور عبر PivotTo)، والجولة (تشغيل المؤقت حتى ينتهي الوقت أو يبقى لاعب واحد أو فريق واحد)، والتنظيف (منح Wins، وإعادة إظهار الناجين، وحذف الخريطة).
- شغّل الحلقة على الخادم فقط. انشر الحالة والثواني المتبقية سماتٍ (Attributes) على Folder في ReplicatedStorage، ودع LocalScript يعرضها.
- احتفظ بجدول لمن ما زالوا في الجولة. أزل اللاعب عندما يموت الـ Humanoid الخاص به، أو تُحذف شخصيته، أو يغادر.
- لا تنقل إلا اللاعبين الذين تكون شخصياتهم حية لحظة بدء الجولة. ومن يدخل لاحقًا ينتظر الجولة التالية في الردهة.
في هذه الصفحة
كيف يعمل نظام الجولات
نظام الجولات آلة حالات. في أي لحظة يكون الخادم في حالة واحدة بالضبط، ولكل حالة مهمة واحدة، وشرط واحد ينقلها إلى الحالة التالية. إذا كتبته بهذه الطريقة فكل المنطق في مكان واحد، ولا يظهر الخطأ الكلاسيكي الذي تحاول فيه حلقة المؤقت وحلقة الجولة كلتاهما إنهاء الجولة نفسها.
| الحالة | ماذا يفعل الخادم | متى ينتقل إلى التالية |
|---|---|---|
| Waiting | يُظهر "Waiting for players (1/2)" | عندما يكون على الخادم عدد كافٍ من اللاعبين |
| Intermission | يعدّ الوقت تنازليًا بينما الجميع في الردهة | انتهى العد (أو العودة إلى Waiting إذا غادر لاعبون) |
| Starting | ينسخ خريطة عشوائية إلى Workspace، ويُظهر اسمها، ويطلب من العملاء تحميلها | انتهى عد قصير "استعدّوا" |
| InRound | ينقل اللاعبين الأحياء، ويشغّل المؤقت، ويُخرج من مات أو غادر | انتهى الوقت، أو بقي لاعب واحد أو فريق واحد |
| Results | يمنح Win لكل من ما زال حيًا، ويُظهر من فاز | مرّت بضع ثوانٍ |
| Cleanup | يعيد إظهار الناجين في الردهة ويحذف الخريطة | فورًا، ثم تبدأ الحلقة من جديد |
الخادم يملك كل حالة. والعملاء لا يفعلون إلا عرض ما يخبرهم به الخادم. فالعد التنازلي في LocalScript يبتعد عن العد الحقيقي، ويكون خاطئًا عند من دخل لاحقًا، ويمكن للمستغل (Exploiter) تغييره. إذا كان الفصل بين الخادم والعميل جديدًا عليك فاقرأ أولًا Script vs LocalScript vs ModuleScript.
الخطوة 1: جهّز الردهة والخرائط وإحصائية Wins
- ابنِ ردهة في Workspace فيها
SpawnLocation. تأكد من تفعيل خاصيته Neutral، كي يظهر كل لاعب هنا، وينتظر هنا، ويعود إلى هنا بعد خروجه من الجولة. - في ServerStorage أدرج
FolderباسمMaps. الكائنات في ServerStorage لا تُرسل إلى اللاعبين أبدًا، فالخرائط غير المستخدمة لا تكلّفهم شيئًا. - ابنِ كل خريطة على شكل
ModelداخلMaps، بقطع مثبّتة (Anchored). ابنِها بعيدًا عن الردهة (بضع مئات من الستاد تكفي)، لأن النسخة تظهر في المكان الذي بنيتها فيه بالضبط، ويجب ألا يستطيع اللاعبون الخارجون من الجولة العودة إليها مشيًا. - داخل كل خريطة أضف
FolderباسمSpawns، وفيهPartمثبّت واحد لكل لاعب متوقع. اضبط Transparency على 1 وأطفئ CanCollide، كي لا يراها أحد ولا يتعثر بها.
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 يعطيان كل لاعب مجلدين.
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، والصق الكود أدناه. الإعدادات في الأعلى هي على الأرجح الأسطر الوحيدة التي ستحتاج إلى تغييرها. كل حالة دالة منفصلة، والحلقة في الأسفل تشغّلها بالترتيب، بلا نهاية.
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 الذي أُرسل قبل دخول أحدهم لن يصل إليه أبدًا.
- في Explorer أدرج ScreenGui داخل StarterGui وسمّه
RoundHud. اترك ResetOnSpawn مفعّلًا (الإعداد الافتراضي). - أدرج LocalScript داخل
RoundHud، وسمّهRoundHudClient، والصق الكود أدناه. إنه ينشئ النص بنفسه، فلا حاجة إلى رسم أي شيء آخر. - اضغط Play. يُظهر النص في أعلى الشاشة الحالة والعد التنازلي بصيغة
m:ss.
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.
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، واعرض الحالة والمؤقت في أعلى الشاشة.
- يستطيع أن يتصفح مكانك أولًا عبر 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 تمنح الاتصالات البطيئة وقتًا أطول.
المصادر والقراءات
- Roblox Creator Docs: Add rounds (بالإنجليزية). حلقة جولات الفرق الخاصة بـ Roblox في مثال لعبة Laser Tag
- Roblox Creator Docs: PVInstance:PivotTo (بالإنجليزية). تحريك النماذج والشخصيات من السكربت
- Roblox Creator Docs: Player (بالإنجليزية). LoadCharacterAsync وCharacterRemoving وRequestStreamAroundAsync
- Roblox Creator Docs: Properties and attributes (بالإنجليزية). ضبط السمات ومتابعة تغييراتها
- Roblox Creator Docs: Implement teams (بالإنجليزية). إضافة الفرق والتعيين التلقائي
- Roblox Creator Docs: Studio testing modes (بالإنجليزية). الاختبار بعدة عملاء في Server & Clients
كيف فُحص الكود: كل سكربت في هذه الصفحة يجتاز الفاحص الصارم للأنواع في Luau مع تعريفات واجهة Roblox البرمجية (luau-lsp، ٢٠ نوفمبر ٢٠٢٦). فحص الأنواع يكشف الأخطاء في أسماء الواجهات البرمجية والأنواع الخاطئة، لا منطق اللعبة، فجرّب الكود في Studio قبل النشر.