Hướng dẫn · Phần thưởng

Cách làm phần thưởng hằng ngày trong Roblox Studio

Phần thưởng hằng ngày cho người chơi lý do để mở game của bạn vào ngày mai, còn chuỗi ngày cho họ lý do để không bỏ ngày nào. Toàn bộ logic dựa trên một mốc thời gian đã lưu: lần cuối người chơi nhận thưởng là khi nào và đã nhận bao nhiêu ngày liên tiếp. Hướng dẫn này lưu an toàn cả hai giá trị để người chơi không thể nhận thưởng hai lần bằng cách vào lại game hay mở hai server, và thêm một nút đếm ngược tới phần thưởng tiếp theo.

Cập nhật ngày 20 tháng 11, 20265 phút đọcTác giả:

Tóm tắt

Với mỗi người chơi, lưu hai con số trong DataStore: last, giá trị os.time() của lần nhận gần nhất, và streak. Người chơi được nhận thưởng khi đã qua 24 giờ. Nếu đã qua hơn 48 giờ, chuỗi bắt đầu lại từ ngày 1; nếu không, chuỗi tăng thêm một ngày và quay vòng 7 ngày với phần thưởng tăng dần. Hãy kiểm tra bên trong UpdateAsync để việc quyết định và việc lưu diễn ra cùng lúc.

  • Dùng os.time() trên server, không dùng thời gian do client gửi.
  • Bên trong UpdateAsync, trả về nil khi chưa được nhận thưởng: việc lưu bị hủy và không có gì được phát.
  • Client chỉ hỏi trạng thái và xin nhận thưởng; server là bên trả lời.
Trong trang này
  1. Cách hoạt động
  2. 1. Server
  3. 2. Nút bấm
  4. Common errors
  5. With RoCode
  6. Câu hỏi thường gặp
  7. Nguồn và tài liệu đọc thêm

Phần thưởng hằng ngày và chuỗi ngày hoạt động thế nào

Điều xảy ra khi nhận thưởng, tùy theo thời gian kể từ lần trước
Thời gian kể từ lần nhận trướcKết quả
Dưới 24 giờCòn sớm. Nút hiện đồng hồ đếm ngược.
Từ 24 tới 48 giờĐược nhận thưởng, chuỗi tăng thêm một ngày.
Hơn 48 giờĐược nhận thưởng, chuỗi bắt đầu lại từ ngày 1.
Sau ngày 7Lần nhận tiếp theo là ngày 1 của tuần mới.

os.time() trên server trả về thời gian Unix hiện tại tính bằng giây theo UTC, nên mọi server đều thống nhất với nhau. Đồng hồ trên máy của người chơi không tham gia, vì vậy đổi ngày trên điện thoại cũng không có tác dụng gì.

Bước 1: server phát thưởng

Bật Enable Studio Access to API Services trong Game Settings, Security (place phải được xuất bản). Sau đó chèn một Script vào ServerScriptService với tên DailyRewards:

Script trong ServerScriptService tên là DailyRewards
-- Script trong ServerScriptService, tên là DailyRewards.
-- Một phần thưởng mỗi 24 giờ. Nếu nhận lại trong vòng 48 giờ, chuỗi được giữ,
-- và phần thưởng tăng mỗi ngày trong suốt một tuần, sau đó tuần mới bắt đầu lại.
local DataStoreService = game:GetService("DataStoreService")
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local REWARDS = { 50, 75, 100, 150, 200, 300, 500 } -- xu cho ngày 1 tới ngày 7 của chuỗi
local CLAIM_EVERY = 24 * 60 * 60 -- số giây giữa hai lần nhận
local STREAK_LOST_AFTER = 48 * 60 * 60 -- bỏ lỡ trọn một ngày thì chuỗi bắt đầu lại

type Record = { last: number, streak: number }

local store = DataStoreService:GetDataStore("DailyRewards_v1")
local statusFunction = Instance.new("RemoteFunction")
statusFunction.Name = "GetDailyStatus"
statusFunction.Parent = ReplicatedStorage
local claimFunction = Instance.new("RemoteFunction")
claimFunction.Name = "ClaimDaily"
claimFunction.Parent = ReplicatedStorage

local records: { [Player]: Record } = {}
local claiming: { [Player]: boolean } = {}

local function readRecord(data: any): Record
	if type(data) == "table" and type(data.last) == "number" and type(data.streak) == "number" then
		return { last = data.last, streak = data.streak }
	end
	return { last = 0, streak = 0 }
end

-- Ngày trong chuỗi cho lần nhận tiếp theo, từ 1 tới 7
local function nextDay(record: Record, now: number): number
	if now - record.last >= STREAK_LOST_AFTER then
		return 1
	end
	return record.streak % #REWARDS + 1
end

local function addCoins(player: Player, amount: number)
	local leaderstats = player:FindFirstChild("leaderstats")
	local coins = leaderstats and leaderstats:FindFirstChild("Coins")
	if coins and coins:IsA("IntValue") then
		coins.Value += amount
	end
end

Players.PlayerAdded:Connect(function(player: Player)
	local ok, data = pcall(function()
		return store:GetAsync(tostring(player.UserId))
	end)
	if ok then
		records[player] = readRecord(data)
	else
		warn("DailyRewards: could not load", player.Name, data)
	end
end)

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

-- Thứ menu hiển thị: số giây tới lần nhận tiếp theo (0 = nhận được ngay) và đó là ngày mấy
statusFunction.OnServerInvoke = function(player: Player)
	local record = records[player]
	if not record then
		return nil
	end
	local now = os.time()
	return {
		wait = math.max(0, record.last + CLAIM_EVERY - now),
		day = nextDay(record, now),
		rewards = REWARDS,
	}
end

claimFunction.OnServerInvoke = function(player: Player): string
	local record = records[player]
	if not record then
		return "Still loading, try again in a moment"
	end
	if claiming[player] then
		return "One moment..."
	end
	claiming[player] = true
	local now = os.time()
	local claimedDay: number? = nil
	-- UpdateAsync đọc bản ghi mới nhất đã lưu và quyết định ngay trong lần cập nhật, nên
	-- server thứ hai (hoặc cú click thứ hai) không thể nhận cùng một ngày hai lần
	local ok, err = pcall(function()
		store:UpdateAsync(tostring(player.UserId), function(old: any)
			-- UpdateAsync có thể gọi hàm này nhiều lần: chỉ lần gọi cuối cùng được tính
			claimedDay = nil
			local saved = readRecord(old)
			if now - saved.last < CLAIM_EVERY then
				return nil -- còn sớm: trả về nil sẽ hủy việc lưu
			end
			local day = nextDay(saved, now)
			claimedDay = day
			return { last = now, streak = day }
		end)
	end)
	claiming[player] = nil
	if not ok then
		warn("DailyRewards: could not save", player.Name, err)
		return "Could not save, try again later"
	end
	local day = claimedDay
	if not day then
		return "Come back later for your next reward"
	end
	records[player] = { last = now, streak = day }
	addCoins(player, REWARDS[day])
	return string.format("Day %d reward: +%d coins!", day, REWARDS[day])
end

Việc nhận thưởng diễn ra bên trong hàm được truyền vào UpdateAsync. Roblox gọi hàm này với bản ghi mới nhất đã lưu. Nếu còn sớm, hàm trả về nil và Roblox hủy việc ghi. Nếu không, hàm trả về bản ghi mới, còn script ghi nhớ ngày nào đã được nhận. Xu chỉ được cộng sau khi UpdateAsync kết thúc mà không lỗi. Nếu trong lúc đó một server khác đã đổi key, Roblox có thể gọi lại hàm với giá trị mới hơn, vì vậy quyết định được đưa ra ngay bên trong hàm.

Bước 2: nút có đồng hồ đếm ngược

Chèn một LocalScript vào StarterPlayer > StarterPlayerScripts với tên DailyRewardsMenu:

LocalScript trong StarterPlayerScripts tên là DailyRewardsMenu
-- LocalScript trong StarterPlayerScripts, tên là DailyRewardsMenu.
-- Nút Daily có đồng hồ đếm ngược. Khi phần thưởng sẵn sàng, nút hiện chữ Claim.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local statusFunction = ReplicatedStorage:WaitForChild("GetDailyStatus") :: RemoteFunction
local claimFunction = ReplicatedStorage:WaitForChild("ClaimDaily") :: RemoteFunction

local gui = Instance.new("ScreenGui")
gui.Name = "DailyGui"
gui.ResetOnSpawn = false
local button = Instance.new("TextButton")
button.Size = UDim2.fromOffset(170, 48)
button.Position = UDim2.new(0, 12, 0.5, 52)
button.BackgroundColor3 = Color3.fromRGB(240, 170, 40)
button.TextColor3 = Color3.new(1, 1, 1)
button.Font = Enum.Font.GothamBold
button.TextSize = 17
button.Text = "Daily reward"
local corner = Instance.new("UICorner")
corner.CornerRadius = UDim.new(0, 10)
corner.Parent = button
button.Parent = gui
gui.Parent = Players.LocalPlayer:WaitForChild("PlayerGui")

local readyAt: number? = nil -- thời điểm os.clock() khi phần thưởng sẵn sàng
local day = 1
local busy = false

local function refresh()
	local ok, status = pcall(function()
		return statusFunction:InvokeServer()
	end)
	if ok and type(status) == "table" and type(status.wait) == "number" then
		readyAt = os.clock() + status.wait
		day = if type(status.day) == "number" then status.day else 1
	end
end

local function format(seconds: number): string
	local h = seconds // 3600
	local m = (seconds % 3600) // 60
	local s = seconds % 60
	return string.format("%02d:%02d:%02d", h, m, s)
end

button.Activated:Connect(function()
	if busy or not readyAt or os.clock() < readyAt then
		return
	end
	busy = true
	button.Text = "Claiming..."
	local ok, message = pcall(function()
		return claimFunction:InvokeServer()
	end)
	button.Text = if ok and type(message) == "string" then message else "Try again"
	task.wait(2)
	refresh()
	busy = false
end)

refresh()
while true do
	if not busy then
		if not readyAt then
			button.Text = "Loading..."
			refresh()
		elseif os.clock() >= readyAt then
			button.Text = string.format("Claim day %d!", day)
		else
			button.Text = "Next: " .. format(math.ceil(readyAt - os.clock()))
		end
	end
	task.wait(1)
end

Nút hỏi server một lần xem cần chờ bao lâu, rồi tự đếm ngược mỗi giây bằng os.clock(), nên không phải gọi server mỗi giây. Sau khi nhận thưởng, nó hỏi lại. Đồng hồ đếm ngược chỉ để hiển thị: server vẫn kiểm tra thời gian khi người chơi bấm Claim.

Kiểm tra

  1. Để thử, đặt CLAIM_EVERY bằng 30 và STREAK_LOST_AFTER bằng 60.
  2. Bấm Play. Nút hiện "Claim day 1!". Bấm vào: +50 xu.
  3. Nút đếm ngược 30 giây. Nhận lại trong 30 giây tiếp theo: ngày 2, +75.
  4. Chờ hơn một phút: lần nhận tiếp theo lại là ngày 1.
  5. Trước khi xuất bản, đưa cả hai giá trị về các dòng 24 và 48 giờ.

Lỗi thường gặp và cách sửa

Theo dõi cửa sổ Output ở chế độ Server.

Nút cứ hiện Loading...

Bản ghi của người chơi chưa tải được. Trong Studio, bật Enable Studio Access to API Services. Lỗi hiện trong Output sau dòng "could not load".

Khi nhận thưởng lại báo "Come back later", dù nút đang hiện Claim

Bản ghi đã lưu mới hơn những gì nút biết, ví dụ sau khi nhận thưởng ở một server khác. Câu trả lời đúng là câu trả lời của server.

Chuỗi bị đặt lại mỗi ngày

Người chơi nhận thưởng cách nhau hơn 48 giờ, hoặc STREAK_LOST_AFTER vẫn đang để giá trị thử nghiệm.

Xu không được cộng

Người chơi phải có IntValue Coins trong leaderstats, được tạo bởi script server.

Làm bằng RoCode

Nếu bạn không muốn tự thiết lập, RoCode có thể làm việc này trong place bạn đang mở. RoCode là AI agent độc lập cho Roblox Studio, không phải của Roblox: bạn mô tả thay đổi trong web chat, còn plugin cho Studio của nó tạo script trong Explorer của bạn.

Bạn gõ

Thêm phần thưởng hằng ngày với chuỗi 7 ngày: xu từ ngày 1 tới ngày 6 và một viên gem vào ngày 7, nút có đồng hồ đếm ngược, có lưu dữ liệu và kiểm tra trên server.

RoCode làm
  • Có thể chèn trong một bước một màn hình phần thưởng hằng ngày có hoạt ảnh làm sẵn từ các bộ UI cao cấp của nó, với một trong năm chủ đề (candy, neon, gold, blocky, pastel), kèm script server chạy được
  • Hoặc viết script server và nút bấm như trong hướng dẫn này, nối với loại tiền tệ bạn đang có
  • Nó được dặn kiểm tra biên dịch mọi script bằng Check Script, và đặt điểm hoàn tác quanh mỗi nhóm thay đổi

Sau khi dựng xong, RoCode có thể chạy robot thử nghiệm của nó: robot chơi game của bạn trong Studio, bấm các nút và báo PASS hoặc FAIL. Nó chỉ kiểm tra những gì nó tự chọn để thử, còn với bộ đếm 24 giờ, bạn cần tự thử với các giá trị ngắn. RoCode kết nối với Studio thế nào.

Câu hỏi thường gặp

Làm sao làm phần thưởng hằng ngày trong Roblox?

Lưu thời gian nhận thưởng gần nhất của mỗi người chơi bằng os.time() trên server, cho phép nhận sau 24 giờ và lưu việc nhận bên trong UpdateAsync trước khi phát thưởng. Script có ở bước 1.

Làm sao làm chuỗi đăng nhập hằng ngày?

Lưu bộ đếm chuỗi cùng với thời gian nhận. Nếu lần nhận tiếp theo đến trong vòng 48 giờ, cộng thêm một; nếu muộn hơn, bắt đầu lại từ 1.

Người chơi có gian lận phần thưởng hằng ngày bằng cách chỉnh đồng hồ được không?

Với script này thì không: nó chỉ dùng os.time() của server.

Có nên đặt lại phần thưởng vào nửa đêm không?

Bạn có thể tính theo ngày lịch UTC thay cho 24 giờ. Khoảng 24 giờ trượt đơn giản hơn và hoạt động như nhau với mọi múi giờ.

Nguồn và tài liệu đọc thêm

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.

Thử RoCode trong chính game của bạn.

Mỗi ngày có credit miễn phí, không cần thẻ. Cài plugin, mô tả tính năng và xem kết quả xuất hiện trong Studio.