Tóm tắt
Tạo một Script trong ServerScriptService lắng nghe Players.PlayerAdded, tạo một Folder có tên đúng là leaderstats (toàn chữ thường) và đặt nó làm con của người chơi. Mỗi IntValue, NumberValue hoặc StringValue trong thư mục đó sẽ thành một cột trong danh sách người chơi.
- Chỉ tạo và thay đổi chỉ số trên server. Thay đổi do LocalScript làm chỉ người chơi đó thấy, không ai khác thấy.
- leaderstats không tự lưu. Tải và lưu giá trị bằng data store nếu chúng cần còn đến phiên chơi sau.
- Để xếp hạng trên mọi người chơi, ghi từng điểm số vào ordered data store và hiện nó trên một bảng trong thế giới của bạn hoặc ở chế độ Global của danh sách người chơi.
Trong trang này
leaderstats hoạt động thế nào
Roblox hiện danh sách người chơi trong mọi game. Khi người chơi có một Folder con tên là leaderstats, danh sách sẽ thêm một cột cho mỗi đối tượng giá trị bên trong và hiện giá trị của người chơi đó trên hàng của họ. Tiêu đề cột là Name của đối tượng giá trị.
| Đối tượng | Lưu gì | Hợp cho |
|---|---|---|
IntValue | Số nguyên | Xu, số lần hạ gục, số trận thắng, cấp độ |
NumberValue | Số thập phân | Thời gian vòng tốt nhất, quãng đường |
StringValue | Văn bản | Hạng hoặc danh hiệu đội |
Hai quy tắc làm hỏng gần như mọi bảng xếp hạng không chạy. Tên thư mục phải đúng là leaderstats: Leaderstats hoặc leaderStats sẽ bị bỏ qua. Và thư mục phải do một Script server tạo, vì chỉ thay đổi trên server mới được sao chép cho mọi người chơi. Nếu chưa chắc code chạy ở đâu, hãy đọc trước Script vs LocalScript vs ModuleScript (bằng tiếng Anh).
Bước 1: tạo script leaderstats
- Trong Explorer, rê chuột lên ServerScriptService, bấm nút + và chèn một Script.
- Đổi tên nó thành
Leaderstatsđể sau này dễ tìm. - Thay nội dung của nó bằng code bên dưới và bấm Play. Tên bạn sẽ hiện trong danh sách người chơi với Coins và Wins bằng 0.
local Players = game:GetService("Players")
local function setupLeaderstats(player: Player)
local leaderstats = Instance.new("Folder")
leaderstats.Name = "leaderstats" -- tên phải đúng như vậy, toàn chữ thường
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 -- đặt Parent sau cùng, khi các giá trị đã ở bên trong
end
Players.PlayerAdded:Connect(setupLeaderstats)
-- Trong Studio bạn có thể vào trước khi script này chạy, nên thiết lập cho những người đã có mặt
for _, player in Players:GetPlayers() do
setupLeaderstats(player)
end
Vòng lặp ở cuối quan trọng khi test trong Studio: người chơi đầu tiên đôi khi vào trước khi PlayerAdded được kết nối, và không có vòng lặp thì sẽ không có chỉ số.
Bước 2: cộng điểm an toàn
Để thay đổi một chỉ số, hãy đặt Value của nó từ một script server. Tấm nhặt xu này cho 10 xu khi người chơi chạm vào. Touched kích hoạt nhiều lần mỗi giây khi nhân vật đứng trên part, nên script giữ một thời gian hồi ngắn cho từng người chơi.
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 kích hoạt nhiều lần mỗi bước; điều này ngăn một lần chạm trả tiền mười lần
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") tìm được nhân vật ngay cả khi part chạm vào nằm trong một phụ kiện, còn kiểm tra hit.Parent đơn giản sẽ bỏ sót trường hợp đó.
Nếu điểm được cho vì việc người chơi làm trên màn hình của họ, ví dụ bấm một nút, LocalScript phải nhờ server qua RemoteEvent, và server phải quyết định có trả hay không. Đừng bao giờ để client gửi số tiền. Hướng dẫn về RemoteEvent trình bày mẫu này kèm kiểm tra.
Bốn ví dụ làm sẵn: hướng dẫn game đầu tiên cho 1 Coin cho mỗi đồng xu người chơi chạm trên đường đua và một Win ở tấm đích sau 3 đồng xu, hướng dẫn game simulator nhấp chuột cho Coins khi bấm nút với giới hạn số lần nhấp trên server, hướng dẫn làm kiếm cộng 1 vào Kills cho người ra đòn cuối trước khi người chơi chết, còn hướng dẫn làm súng chỉ cách tính một lần hạ gục khi phát bắn đưa Health của mục tiêu về 0.
Bước 3: lưu chỉ số giữa các phiên
leaderstats chỉ tồn tại khi server còn chạy. Để lưu xu và số trận thắng, hãy tải chúng từ data store khi người chơi vào và lưu khi họ rời đi. Phiên bản này thay cho script ở bước 1. Nó không bao giờ lưu người chơi mà dữ liệu chưa tải được: chính lỗi đó xóa sạch tiến trình trong phần lớn các script lưu dữ liệu sao chép trên mạng.
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
-- Được gọi bên trong mỗi pcall bên dưới, nên place chưa publish
-- (không có quyền truy cập data store) vẫn có bảng xếp hạng
local function statsStore(): DataStore
return DataStoreService:GetDataStore("PlayerStats_v1")
end
-- Những người chơi đã tải được chỉ số đã lưu. Ai không có ở đây thì không bao giờ được lưu,
-- nên một lần tải thất bại sẽ không ghi đè tiến trình thật bằng số 0.
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)
-- Khi server tắt, lưu tất cả mọi người trước khi đóng
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)
Với một game nhỏ, chừng này là đủ. Về thử lại, UpdateAsync, giới hạn yêu cầu và cách chống hai server cùng ghi một người chơi, hãy đọc tiếp hướng dẫn DataStore.
Bước 4: top 10 toàn cầu
leaderstats chỉ so sánh người chơi trên cùng một server. Bảng xếp hạng toàn cầu cần một ordered data store: data store lưu một số cho mỗi key và có thể trả về các key đã sắp xếp theo giá trị. Ghi điểm của từng người chơi vào đó từ server, rồi đọc lại các mục đứng đầu.
Có hai cách để hiển thị nó. Danh sách người chơi của Roblox có các chế độ Friends và Global, đọc một ordered data store đã đăng ký trong Creator Hub (tại thời điểm viết, đây là tính năng beta, mỗi game một bảng xếp hạng đang hoạt động). Hoặc bạn có thể tự vẽ bảng xếp hạng trên một tấm bảng trong thế giới của mình: cách này chạy được trong mọi game và cho phép trang trí tùy ý. Script bên dưới làm theo cách thứ hai, và nó ghi điểm với user ID của người chơi làm key, cũng là định dạng mà bảng xếp hạng trong Creator Hub cần.
- Thêm vào Workspace một Part được anchor, đặt tên là
WinsBoardvà cho nó cỡ một tấm biển (ví dụ 12 x 8 x 1 stud), mặt trước hướng về chỗ spawn. - Chèn vào ServerScriptService một Script tên
GlobalWinsBoardvới code bên dưới. - Bấm Play. Bảng sẽ có dữ liệu sau lần làm mới đầu tiên và cập nhật mỗi phút.
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
local winsBoard = DataStoreService:GetOrderedDataStore("GlobalWins_v1")
local TOP_N = 10
local REFRESH_SECONDS = 60
-- Tấm bảng: một Part được anchor tên WinsBoard trong Workspace. Script tự thêm
-- SurfaceGui và các dòng, nên bạn chỉ cần dựng 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) trả về 10 giá trị lớn nhất trước. Ordered data store chỉ lưu số nguyên, nên hãy lưu điểm dưới dạng số nguyên. Script ghi mỗi người chơi một lần mỗi phút và đọc top 10 một lần mỗi phút, còn dư rất nhiều so với giới hạn chuẩn trên mỗi server (30 + 5 cho mỗi người chơi mỗi phút với lượt ghi vào ordered data store và 5 + 2 cho mỗi người chơi với lượt đọc đã sắp xếp, theo tài liệu ngày 30 tháng 9 năm 2026).
Lỗi thường gặp và cách sửa
Các vấn đề dưới đây bao quát phần lớn các lời phàn nàn kiểu "bảng xếp hạng của tôi không chạy". Trước hết hãy xem cửa sổ Output (mở từ menu Window trong Studio hoặc ở tab Script): nếu script bị lỗi, ở đó sẽ có số dòng.
Bảng xếp hạng hoàn toàn không hiện
Kiểm tra thư mục tên là leaderstats viết thường, Parent của nó là Player (không phải nhân vật) và code là một Script trong ServerScriptService, không phải LocalScript.
Người chơi khác không thấy chỉ số của tôi thay đổi
Giá trị đã được đổi trên client. Hãy chuyển thay đổi đó vào một Script server, và nếu nó do một nút hoặc phím kích hoạt, hãy gửi một RemoteEvent và để server đổi giá trị.
attempt to index nil with 'Coins'
Code cố đọc player.leaderstats.Coins trước khi thư mục xuất hiện, hoặc tên bị viết khác. Trên server, dùng FindFirstChild và kiểm tra kết quả; trong LocalScript, dùng player:WaitForChild("leaderstats"). Hướng dẫn về lỗi script giải thích chi tiết lỗi này.
Xu cộng thêm 10, 20 hoặc 50 chỉ từ một lần chạm
Touched kích hoạt liên tục khi các part còn chồng lên nhau. Thêm thời gian hồi cho từng người chơi như ở bước 2, hoặc xóa vật phẩm sau khi nhặt.
Chỉ số bị reset mỗi lần vào lại game
Roblox không lưu leaderstats. Hãy thêm script ở bước 3. Để test việc lưu trong Studio, hãy publish place và bật Studio Access to API Services trong Experience Settings.
Làm với RoCode
Nếu không muốn tự ráp mọi thứ, RoCode có thể dựng tất cả bên trong place bạn đang mở. Đây là AI agent làm việc qua plugin Roblox Studio, nên nó tạo script và part trong Explorer của bạn, chứ không đưa code để bạn tự dán.
Thêm bảng xếp hạng có Coins và Wins được lưu giữa các phiên, và một bảng top 10 theo số trận thắng trên một part gần chỗ spawn.
- Có thể tìm trước trong place code leaderstats hoặc DataStore đã có, để bổ sung vào cái sẵn có thay vì thêm bảng xếp hạng thứ hai
- Tạo script server trong ServerScriptService và part làm bảng trong Workspace
- Kiểm tra biên dịch các script đã viết ngay trong Studio trước khi kết thúc
- Gửi thay đổi theo từng đợt, và mỗi đợt được đánh dấu là một điểm hoàn tác trong lịch sử Studio
Bạn vẫn là người kiểm tra kết quả và tự test chỉ số và việc lưu dữ liệu trong game: với plugin 3.9 trở lên, RoCode có thể chạy một playtest ngắn và đọc lỗi, còn với plugin 3.9.11 trở lên nó có thể điều khiển một nhân vật thử nghiệm và kiểm tra các giá trị như Coins và Wins, nhưng nó chỉ kiểm tra những gì nó tự chọn để test. Leaderstats thường là hệ thống đầu tiên trong nhiều hệ thống của một game: dựng phần còn lại của game, mỗi prompt một hệ thống theo cùng cách đó. RoCode kết nối với Studio thế nào.
Câu hỏi thường gặp
leaderstats trong Roblox là gì?
Một Folder có tên đúng là leaderstats, toàn chữ thường, nằm trong Player. Roblox hiện mỗi IntValue, NumberValue hoặc StringValue trong đó thành một cột trong danh sách người chơi. Hãy tạo nó từ một Script server, như ở bước 1.
Làm bảng xếp hạng toàn cầu trong Roblox thế nào?
Ghi điểm của từng người chơi vào ordered data store từ server, rồi đọc lại các mục đứng đầu và hiện chúng trên một tấm bảng trong thế giới của bạn. Bước 4 có script đầy đủ cho top 10.
Roblox có tự động lưu leaderstats không?
Không. leaderstats chỉ tồn tại khi người chơi còn ở trên server. Hãy lưu giá trị bằng data store khi người chơi rời đi và tải lại khi họ vào, như ở bước 3.
Có thể ẩn một giá trị khỏi bảng xếp hạng không?
Có. Chỉ những giá trị trong thư mục leaderstats mới được hiện. Hãy giữ dữ liệu riêng tư trong một thư mục khác của người chơi hoặc trong một table ở script server.
Làm sao ẩn cả danh sách người chơi?
Từ một LocalScript, gọi StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, false). Truyền true để hiện lại.
Có thể dùng NumberValue cho xu không?
Được, nhưng với tiền tệ là số nguyên thì IntValue hợp hơn, và ordered data store chỉ nhận số nguyên nếu sau này bạn muốn xếp hạng theo nó.
Nguồn và tài liệu đọc thêm
- Roblox Creator Docs: Leaderboards (bằng tiếng Anh). leaderstats, thứ tự chỉ số và các chế độ cố định Friends và Global
- Roblox Creator Docs: Data stores (bằng tiếng Anh). GetAsync, SetAsync, ordered data store và giới hạn
Cách kiểm tra code: mọi script trong trang này đều qua trình kiểm tra kiểu nghiêm ngặt (strict) của Luau với định nghĩa API của Roblox (luau-lsp, 20 tháng 11, 2026). Kiểm tra kiểu bắt được API gõ sai và kiểu dữ liệu sai, không bắt được lỗi logic của game, nên hãy thử trong Studio trước khi xuất bản.