מדריך · נתוני שחקן

איך ליצור טבלת מובילים ב-Roblox Studio

את רשימת השחקנים בפינה הימנית העליונה של משחק Roblox מנהלת תיקייה אחת בשם leaderstats. המדריך הזה בונה אותה מאפס: סקריפט שרת, דרך בטוחה לתת נקודות, שמירה בין סשנים וטופ 10 עולמי.

עודכן 20 בנובמבר 20266 דק׳ קריאהמאת:

בקצרה

צרו Script ב-ServerScriptService שמאזין ל-Players.PlayerAdded, יוצר Folder בשם בדיוק leaderstats (הכול באותיות קטנות) והופך אותו לילד של השחקן. כל IntValue, NumberValue או StringValue בתוך התיקייה הזו הופך לעמודה ברשימת השחקנים.

  • צרו ושנו סטטיסטיקה רק בשרת. שינוי ש-LocalScript עשה רואה רק השחקן הזה, ואף אחד אחר.
  • leaderstats לא נשמר. טענו ושמרו ערכים דרך data store אם הם צריכים לשרוד עד הסשן הבא.
  • לדירוג של כל השחקנים כתבו כל ניקוד ל-ordered data store והציגו אותו על לוח בעולם שלכם או במצב Global של רשימת השחקנים.
בעמוד הזה
  1. איך leaderstats עובד
  2. 1. ליצור leaderstats
  3. 2. מתן נקודות
  4. 3. שמירה
  5. 4. טופ 10 עולמי
  6. Common errors
  7. עם RoCode
  8. שאלות נפוצות
  9. מקורות וקריאה נוספת

איך leaderstats עובד

איורהסקריפטים המוכנים של leaderstats ושל משטח המטבעות במשחק שרץ.

Roblox מציגה רשימת שחקנים בכל משחק. כשלשחקן יש Folder ילד בשם leaderstats, הרשימה מוסיפה עמודה לכל אובייקט ערך שבתוכו ומציגה את הערך של השחקן בשורה שלו. כותרת העמודה היא ה-Name של אובייקט הערך.

אובייקטי ערך שאפשר לשים ב-leaderstats
אובייקטשומרמתאים ל
IntValueמספרים שלמיםמטבעות, הריגות, ניצחונות, רמה
NumberValueמספרים עשרונייםזמן ההקפה הכי טוב, מרחק
StringValueטקסטדרגה או תואר של קבוצה

שני כללים שוברים כמעט כל טבלת מובילים שלא עובדת. שם התיקייה חייב להיות בדיוק leaderstats: Leaderstats או leaderStats לא נלקחים בחשבון. ואת התיקייה חייב ליצור Script של שרת, כי רק שינויים בשרת משוכפלים לכל השחקנים. אם אתם לא בטוחים איפה הקוד רץ, קראו קודם את Script vs LocalScript vs ModuleScript (באנגלית).

שלב 1: צרו את סקריפט ה-leaderstats

  1. ב-Explorer רחפו מעל ServerScriptService, לחצו על כפתור ה-+ והכניסו Script.
  2. שנו את השם שלו ל-Leaderstats, כדי שיהיה קל למצוא אותו אחר כך.
  3. החליפו את התוכן שלו בקוד שלמטה ולחצו על Play. השם שלכם יופיע ברשימת השחקנים עם Coins ו-Wins ששווים 0.
Script בתוך ServerScriptService בשם Leaderstats
local Players = game:GetService("Players")

local function setupLeaderstats(player: Player)
	local leaderstats = Instance.new("Folder")
	leaderstats.Name = "leaderstats" -- השם חייב להיות בדיוק כזה, הכול באותיות קטנות

	local coins = Instance.new("IntValue")
	coins.Name = "Coins"
	coins.Value = 0
	coins.Parent = 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

הלולאה בסוף חשובה בבדיקות ב-Studio: השחקן הראשון לפעמים נכנס לפני ש-PlayerAdded מחובר, ובלי הלולאה היה נשאר בלי סטטיסטיקה.

שלב 2: תנו נקודות בצורה בטוחה

כדי לשנות מאפיין, קבעו את ה-Value שלו מסקריפט שרת. משטח המטבעות הזה נותן 10 מטבעות כששחקן נוגע בו. Touched נורה הרבה פעמים בשנייה בזמן שהדמות עומדת על ה-Part, ולכן הסקריפט מחזיק זמן המתנה קצר לכל שחקן.

Script בתוך Part ב-Workspace בשם CoinPad
local Players = game:GetService("Players")

local part = script.Parent :: BasePart
local REWARD = 10
local COOLDOWN_SECONDS = 1

local lastReward: { [Player]: number } = {}

part.Touched:Connect(function(hit: BasePart)
	local character = hit:FindFirstAncestorOfClass("Model")
	local player = character and Players:GetPlayerFromCharacter(character)
	if not player then
		return
	end

	local now = os.clock()
	local last = lastReward[player]
	if last and now - last < COOLDOWN_SECONDS then
		return -- Touched נורה הרבה פעמים בצעד אחד; זה מונע מנגיעה אחת לשלם עשר פעמים
	end
	lastReward[player] = now

	local leaderstats = player:FindFirstChild("leaderstats")
	local coins = leaderstats and leaderstats:FindFirstChild("Coins")
	if coins and coins:IsA("IntValue") then
		coins.Value += REWARD
	end
end)

Players.PlayerRemoving:Connect(function(player: Player)
	lastReward[player] = nil
end)

FindFirstAncestorOfClass("Model") מוצא את הדמות גם כשה-Part שנגע נמצא בתוך אביזר, ובדיקה פשוטה של hit.Parent מפספסת את זה.

אם נקודות ניתנות על משהו שהשחקן עושה במסך שלו, למשל לחיצה על כפתור, ה-LocalScript צריך לבקש מהשרת דרך RemoteEvent, והשרת צריך להחליט אם לשלם. אף פעם אל תתנו ללקוח לשלוח את הסכום. המדריך ל-RemoteEvents מראה את התבנית הזו עם בדיקה.

ארבע דוגמאות מוכנות: המדריך למשחק הראשון נותן Coin אחד על כל מטבע שהשחקן נוגע בו במסלול, ו-Win על משטח הסיום אחרי 3 מטבעות, המדריך לסימולטור קליקים נותן Coins על לחיצות כפתור עם מגבלת קליקים בשרת, המדריך לחרב מוסיף 1 ל-Kills למי שנתן את המכה האחרונה לפני שהשחקן מת, והמדריך לנשק מראה איך לספור הריגה כשיריה מורידה את ה-Health של המטרה ל-0.

שלב 3: שמרו סטטיסטיקה בין סשנים

leaderstats חי רק כל עוד השרת חי. כדי לשמור מטבעות וניצחונות, טענו אותם מ-data store כשהשחקן נכנס, ושמרו כשהוא יוצא. הגרסה הזו מחליפה את הסקריפט משלב 1. היא אף פעם לא שומרת שחקן שהנתונים שלו לא נטענו: בדיוק הטעות הזו מוחקת התקדמות ברוב סקריפטי השמירה שמועתקים.

Script בתוך ServerScriptService בשם Leaderstats
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")

-- נקרא בתוך כל pcall שלמטה, ולכן פלייס שעוד לא פורסם
-- (בלי גישה ל-data store) עדיין מקבל טבלת מובילים
local function statsStore(): DataStore
	return DataStoreService:GetDataStore("PlayerStats_v1")
end

-- שחקנים שהסטטיסטיקה השמורה שלהם נטענה. את מי שלא כאן אף פעם לא שומרים,
-- ולכן טעינה שנכשלה לא תדרוס התקדמות אמיתית באפסים.
local loaded: { [Player]: boolean } = {}

local function keyFor(player: Player): string
	return "player_" .. player.UserId
end

local function onPlayerAdded(player: Player)
	local leaderstats = Instance.new("Folder")
	leaderstats.Name = "leaderstats"

	local coins = Instance.new("IntValue")
	coins.Name = "Coins"
	coins.Parent = leaderstats

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

	local ok, data = pcall(function()
		return statsStore():GetAsync(keyFor(player))
	end)
	if ok then
		if type(data) == "table" then
			coins.Value = tonumber(data.Coins) or 0
			wins.Value = tonumber(data.Wins) or 0
		end
		loaded[player] = true
	else
		warn(`Could not load stats for {player.Name}: {data}`)
	end

	leaderstats.Parent = player
end

local function save(player: Player)
	if not loaded[player] then
		return
	end
	local leaderstats = player:FindFirstChild("leaderstats")
	local coins = leaderstats and leaderstats:FindFirstChild("Coins")
	local wins = leaderstats and leaderstats:FindFirstChild("Wins")
	if not (coins and coins:IsA("IntValue") and wins and wins:IsA("IntValue")) then
		return
	end
	local ok, err = pcall(function()
		statsStore():SetAsync(keyFor(player), { Coins = coins.Value, Wins = wins.Value })
	end)
	if not ok then
		warn(`Could not save stats for {player.Name}: {err}`)
	end
end

Players.PlayerAdded:Connect(onPlayerAdded)
for _, player in Players:GetPlayers() do
	task.spawn(onPlayerAdded, player)
end

Players.PlayerRemoving:Connect(function(player: Player)
	save(player)
	loaded[player] = nil
end)

-- כשהשרת נכבה, שומרים את כולם לפני הסגירה
game:BindToClose(function()
	local pending = 0
	for _, player in Players:GetPlayers() do
		pending += 1
		task.spawn(function()
			save(player)
			pending -= 1
		end)
	end
	while pending > 0 do
		task.wait()
	end
end)

למשחק קטן זה מספיק. על ניסיונות חוזרים, UpdateAsync, מגבלות בקשות והגנה מפני שני שרתים שכותבים את אותו שחקן, קראו הלאה במדריך ל-DataStore.

שלב 4: טופ 10 עולמי

leaderstats משווה רק שחקנים באותו שרת. לדירוג עולמי צריך ordered data store: data store ששומר מספר אחד לכל מפתח ויודע להחזיר מפתחות ממוינים לפי ערך. כתבו אליו את הניקוד של כל שחקן מהשרת, ואז קראו בחזרה את הרשומות העליונות.

אפשר להציג אותו בשתי דרכים. ברשימת השחקנים של Roblox יש מצבי Friends ו-Global, שקוראים ordered data store שנרשם ב-Creator Hub (נכון לזמן הכתיבה זה פיצ׳ר בטא, טבלת מובילים פעילה אחת למשחק). או שאפשר לצייר את הדירוג בעצמכם על לוח בעולם שלכם: זה עובד בכל משחק ומאפשר לעצב אותו איך שרוצים. הסקריפט שלמטה עושה את הדבר השני, ואת הניקוד הוא כותב עם ה-user ID של השחקן כמפתח, וזה אותו פורמט שטבלת המובילים ב-Creator Hub מצפה לו.

  1. הוסיפו ל-Workspace Part מעוגן, קראו לו WinsBoard ותנו לו גודל של שלט (למשל 12 על 8 על 1 studs), עם הפאה הקדמית לכיוון נקודת ההופעה.
  2. הכניסו ל-ServerScriptService Script בשם GlobalWinsBoard עם הקוד שלמטה.
  3. לחצו על Play. הלוח יתמלא אחרי העדכון הראשון ויתעדכן כל דקה.
Script בתוך ServerScriptService בשם GlobalWinsBoard
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")

local winsBoard = DataStoreService:GetOrderedDataStore("GlobalWins_v1")

local TOP_N = 10
local REFRESH_SECONDS = 60

-- הלוח: Part מעוגן בשם WinsBoard ב-Workspace. הסקריפט מוסיף בעצמו
-- SurfaceGui ושורות, ולכן צריך לבנות רק את ה-Part.
local boardPart = workspace:WaitForChild("WinsBoard") :: BasePart

local gui = Instance.new("SurfaceGui")
gui.Face = Enum.NormalId.Front
gui.SizingMode = Enum.SurfaceGuiSizingMode.PixelsPerStud
gui.PixelsPerStud = 50
gui.Parent = boardPart

local list = Instance.new("Frame")
list.Size = UDim2.fromScale(1, 1)
list.BackgroundColor3 = Color3.fromRGB(18, 11, 31)
list.Parent = gui

local layout = Instance.new("UIListLayout")
layout.SortOrder = Enum.SortOrder.LayoutOrder
layout.Parent = list

local nameCache: { [number]: string } = {}

local function nameFor(userId: number): string
	local cached = nameCache[userId]
	if cached then
		return cached
	end
	local ok, name = pcall(function()
		return Players:GetNameFromUserIdAsync(userId)
	end)
	local result = if ok then name else "Unknown player"
	nameCache[userId] = result
	return result
end

local function recordWins(player: Player)
	local leaderstats = player:FindFirstChild("leaderstats")
	local wins = leaderstats and leaderstats:FindFirstChild("Wins")
	if wins and wins:IsA("IntValue") then
		local ok, err = pcall(function()
			winsBoard:SetAsync(tostring(player.UserId), wins.Value)
		end)
		if not ok then
			warn(`Could not record wins for {player.Name}: {err}`)
		end
	end
end

local function refresh()
	local ok, pages = pcall(function()
		return winsBoard:GetSortedAsync(false, TOP_N)
	end)
	if not ok then
		warn(`Could not read the wins board: {pages}`)
		return
	end

	for _, child in list:GetChildren() do
		if child:IsA("TextLabel") then
			child:Destroy()
		end
	end

	for rank, entry in pages:GetCurrentPage() do
		local label = Instance.new("TextLabel")
		label.Size = UDim2.new(1, 0, 1 / TOP_N, 0)
		label.BackgroundTransparency = 1
		label.TextColor3 = Color3.new(1, 1, 1)
		label.TextScaled = true
		label.Text = `{rank}. {nameFor(tonumber(entry.key) or 0)}   {entry.value}`
		label.LayoutOrder = rank
		label.Parent = list
	end
end

while true do
	for _, player in Players:GetPlayers() do
		recordWins(player)
	end
	refresh()
	task.wait(REFRESH_SECONDS)
end

GetSortedAsync(false, 10) מחזיר קודם את 10 הערכים הגדולים ביותר. Ordered data store שומר רק מספרים שלמים, ולכן שמרו את הניקוד כמספרים שלמים. הסקריפט כותב כל שחקן פעם בדקה וקורא את הטופ 10 פעם בדקה, עם מרווח גדול בתוך המגבלות הסטנדרטיות לשרת (30 ועוד 5 לשחקן בדקה לכתיבות ל-ordered data store, ו-5 ועוד 2 לשחקן לקריאות ממוינות, לפי התיעוד נכון ל-30 בספטמבר 2026).

שגיאות נפוצות ופתרונות

הבעיות שלמטה מכסות את רוב התלונות "טבלת המובילים שלי לא עובדת". קודם בדקו את חלון ה-Output (פתחו אותו מתפריט Window ב-Studio או בלשונית Script): אם הסקריפט נפל עם שגיאה, יהיה שם מספר שורה.

טבלת המובילים בכלל לא מוצגת

בדקו שהתיקייה נקראת leaderstats באותיות קטנות, שההורה שלה הוא ה-Player (ולא הדמות) ושהקוד הוא Script ב-ServerScriptService, ולא LocalScript.

שחקנים אחרים לא רואים את השינוי במאפיין שלי

הערך שונה בלקוח. העבירו את השינוי ל-Script של שרת, ואם כפתור או מקש מפעילים אותו, שלחו RemoteEvent ותנו לשרת לשנות את הערך.

attempt to index nil with 'Coins'

הקוד ניסה לקרוא את player.leaderstats.Coins לפני שהתיקייה הופיעה, או שהשם כתוב אחרת. בשרת השתמשו ב-FindFirstChild ובדקו את התוצאה; ב-LocalScript השתמשו ב-player:WaitForChild("leaderstats"). המדריך לשגיאות בסקריפטים מפרט את השגיאה הזו.

מטבעות נוספים ב-10, 20 או 50 מנגיעה אחת

Touched נורה שוב ושוב בזמן שה-Parts חותכים זה את זה. הוסיפו זמן המתנה לכל שחקן, כמו בשלב 2, או מחקו את הפריט אחרי האיסוף.

הסטטיסטיקה מתאפסת בכל כניסה מחדש

Roblox לא שומרת leaderstats. הוסיפו את הסקריפט משלב 3. כדי לבדוק שמירה ב-Studio, פרסמו את הפלייס והפעילו את Studio Access to API Services ב-Experience Settings.

לעשות עם RoCode

אם לא בא לכם לבנות את זה ביד, RoCode יכול לבנות הכול בתוך הפלייס שפתוח אצלכם. זה סוכן AI שעובד דרך פלאגין ל-Roblox Studio, ולכן הוא יוצר סקריפטים ו-Parts ב-Explorer שלכם, ולא נותן קוד להדבקה.

אתם כותבים

תוסיף טבלת מובילים עם Coins ו-Wins שנשמרת בין סשנים, ולוח טופ 10 לפי ניצחונות על Part ליד נקודת ההופעה.

RoCode עושה
  • יכול קודם לחפש בפלייס קוד leaderstats או DataStore קיים, כדי להשלים את מה שיש ולא להוסיף טבלת מובילים שנייה
  • יוצר סקריפט שרת ב-ServerScriptService ו-Part ללוח ב-Workspace
  • בודק את הקומפילציה של הסקריפטים שכתב בתוך Studio לפני הסיום
  • שולח את השינויים בקבוצות, וכל קבוצה מסומנת כנקודת ביטול בהיסטוריה של Studio

את התוצאה עדיין אתם בודקים, ואתם בודקים במשחק את הסטטיסטיקה ואת השמירה: עם פלאגין 3.9 ומעלה RoCode יכול להריץ בדיקת משחק קצרה ולקרוא את השגיאות, ועם פלאגין 3.9.11 ומעלה לשלוט בדמות בדיקה ולבדוק ערכים כמו Coins ו-Wins, אבל הוא בודק רק את מה שהוא עצמו בחר לבדוק. Leaderstats הוא בדרך כלל הראשון מבין הרבה מערכות במשחק: בנו את שאר המשחק מערכת אחת לכל בקשה באותה דרך. איך RoCode מתחבר ל-Studio.

שאלות נפוצות

מה זה leaderstats ב-Roblox?

Folder בשם בדיוק leaderstats, הכול באותיות קטנות, בתוך ה-Player. Roblox מציגה כל IntValue, NumberValue או StringValue שבו כעמודה ברשימת השחקנים. צרו אותו מ-Script של שרת, כמו בשלב 1.

איך יוצרים טבלת מובילים עולמית ב-Roblox?

כתבו את הניקוד של כל שחקן ל-ordered data store מהשרת, ואז קראו בחזרה את הרשומות העליונות והציגו אותן על לוח בעולם שלכם. בשלב 4 יש סקריפט מלא לטופ 10.

Roblox שומרת leaderstats אוטומטית?

לא. leaderstats קיים רק כל עוד השחקן בשרת. שמרו את הערכים דרך data store כשהשחקן יוצא, וטענו כשהוא נכנס, כמו בשלב 3.

אפשר להסתיר ערך מטבלת המובילים?

כן. מוצגים רק ערכים בתוך התיקייה leaderstats. שמרו נתונים פרטיים בתיקייה אחרת אצל השחקן או בטבלה בסקריפט שרת.

איך מסתירים את כל רשימת השחקנים?

מ-LocalScript קראו ל-StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, false). העבירו true כדי להציג אותה שוב.

אפשר להשתמש ב-NumberValue למטבעות?

אפשר, אבל למטבע של מספרים שלמים IntValue מתאים יותר, ו-ordered data store מקבל רק מספרים שלמים, אם אחר כך תרצו לבנות לפיהם דירוג.

מקורות וקריאה נוספת

איך הקוד נבדק: כל סקריפט בעמוד הזה עובר את בודק הטיפוסים המחמיר של Luau עם הגדרות ה-API של Roblox (luau-lsp, 20 בנובמבר 2026). בדיקת טיפוסים תופסת שגיאות בשמות API וטיפוסים שגויים, אבל לא שגיאות בלוגיקת המשחק, אז בדקו הכול ב-Studio לפני הפרסום.

נסו את RoCode במשחק שלכם.

קרדיטים חינמיים בכל יום, בלי כרטיס אשראי. התקינו את הפלאגין, תארו פיצ'ר ובדקו מה מופיע ב-Studio.