教學 · 獎勵

如何在 Roblox Studio 製作每日獎勵

每日獎勵讓玩家明天有理由再打開你的遊戲,連續登入則讓他們有理由一天都不缺席。整套邏輯都建立在一個儲存起來的時間戳記上:玩家上次領取的時間,以及已經連續幾天。這篇教學會可靠地儲存這兩個值,讓玩家無法靠重新進入遊戲或開兩個伺服器重複領取,並加上一個倒數到下一次獎勵的按鈕。

更新日期 2026年11月20日閱讀約 3 分鐘作者

重點摘要

在 DataStore 中替每位玩家儲存兩個數字:last,也就是上次領取時的 os.time() 值,以及 streak。經過 24 小時就可以領取。如果超過 48 小時,連續天數會從第 1 天重新開始;否則就增加一天,並以 7 天為一輪循環,獎勵逐日增加。請在 UpdateAsync 裡面做檢查,讓判斷和儲存同時完成。

  • 在伺服器上使用 os.time(),不要用用戶端傳來的時間。
  • 在 UpdateAsync 中,不能領取時回傳 nil:儲存會被取消,也不會發放任何東西。
  • 用戶端只負責查詢狀態與要求領取;由伺服器來回應。
本頁內容
  1. 運作方式
  2. 1. 伺服器
  3. 2. 按鈕
  4. Common errors
  5. With RoCode
  6. 常見問題
  7. 來源與延伸閱讀

每日獎勵與連續登入如何運作

依距離上次領取的時間,領取時會發生什麼事
距離上次領取的時間結果
不到 24 小時還太早。按鈕顯示倒數。
24 到 48 小時可以領取,連續天數增加一天。
超過 48 小時可以領取,連續天數從第 1 天重新開始。
第 7 天之後下一次領取是新一週的第 1 天。

伺服器上的 os.time() 會回傳目前的 Unix 時間(以 UTC 計的秒數),所以每台伺服器都一致。玩家電腦上的時鐘不參與計算,所以改手機日期沒有任何用處。

步驟 1:獎勵伺服器

在 Game Settings 的 Security 中開啟 Enable Studio Access to API Services(場景必須已經發布)。接著在 ServerScriptService 中插入一個名為 DailyRewards 的 Script:

Script 位於 ServerScriptService 名稱為 DailyRewards
-- ServerScriptService 中名為 DailyRewards 的 Script。
-- 每 24 小時一次獎勵。在 48 小時內再次領取,連續天數就會延續,
-- 一週內獎勵每天增加,之後新的一週重新開始。
local DataStoreService = game:GetService("DataStoreService")
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local REWARDS = { 50, 75, 100, 150, 200, 300, 500 } -- 連續第 1 到第 7 天的金幣
local CLAIM_EVERY = 24 * 60 * 60 -- 兩次領取之間的秒數
local STREAK_LOST_AFTER = 48 * 60 * 60 -- 錯過一整天,連續天數就重新開始

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

-- 下一次領取是連續的第幾天,1 到 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)

-- 選單要顯示的內容:距離下次領取的秒數(0 = 現在就能領)以及是第幾天
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 會讀取最新儲存的紀錄,並在更新內部做判斷,所以
	-- 第二台伺服器(或第二次點擊)無法把同一天領兩次
	local ok, err = pcall(function()
		store:UpdateAsync(tostring(player.UserId), function(old: any)
			-- UpdateAsync 可能會呼叫這裡好幾次:只有最後一次呼叫才算數
			claimedDay = nil
			local saved = readRecord(old)
			if now - saved.last < CLAIM_EVERY then
				return nil -- 還太早:回傳 nil 會取消儲存
			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

領取是在傳給 UpdateAsync 的函式裡完成的。Roblox 會用最新儲存的紀錄呼叫它。如果還太早,函式回傳 nil,Roblox 就會取消寫入。否則它會回傳新的紀錄,而 Script 會記住領取的是第幾天。只有在 UpdateAsync 沒有錯誤地完成後,才會加金幣。如果在這段時間內另一台伺服器修改了這個鍵,Roblox 可能會用較新的值再次呼叫這個函式,所以判斷才要放在它裡面。

步驟 2:有倒數的按鈕

在 StarterPlayer > StarterPlayerScripts 中插入一個名為 DailyRewardsMenu 的 LocalScript:

LocalScript 位於 StarterPlayerScripts 名稱為 DailyRewardsMenu
-- StarterPlayerScripts 中名為 DailyRewardsMenu 的 LocalScript。
-- 有倒數的 Daily 按鈕。獎勵準備好時,按鈕上會顯示 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 -- 獎勵準備好時的 os.clock() 時間
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

按鈕只問伺服器一次要等多久,之後就自己用 os.clock() 每秒倒數,所以不必每秒都詢問伺服器。領取後它會再問一次。倒數只是為了顯示:玩家按下 Claim 時,伺服器仍然會檢查時間。

測試看看

  1. 測試時,把 CLAIM_EVERY 設為 30,STREAK_LOST_AFTER 設為 60。
  2. 按下 Play。按鈕上顯示「Claim day 1!」。按下它:+50 金幣。
  3. 按鈕倒數 30 秒。在接下來的 30 秒內再領一次:第 2 天,+75。
  4. 等一分鐘以上:下一次領取又會是第 1 天。
  5. 發布前,把兩個值改回 24 小時與 48 小時的那兩行。

常見錯誤與解法

請在 Server 模式下留意 Output 視窗。

按鈕一直顯示 Loading...

玩家的紀錄沒有載入。請在 Studio 中開啟 Enable Studio Access to API Services。Output 中「could not load」後面會顯示錯誤。

領取時顯示「Come back later」,但按鈕上明明是 Claim

儲存的紀錄比按鈕知道的更新,例如在另一台伺服器上領過了。伺服器給的答案才是正確的。

連續天數每天都被重設

玩家領取的間隔超過 48 小時,或是 STREAK_LOST_AFTER 還是測試用的值。

金幣沒有增加

玩家的 leaderstats 中必須有由伺服器 Script 建立的 IntValue Coins。

用 RoCode 來做

如果不想手動設定,RoCode 可以在你開啟的場景中幫你建立。RoCode 是獨立的 Roblox Studio AI 代理,不是 Roblox 推出的:你在網頁聊天中描述變更,它的 Studio 外掛程式就會在你的 Explorer 中建立 Script。

你輸入

加入 7 天連續登入的每日獎勵:第 1 到 6 天給金幣,第 7 天給寶石,要有倒數按鈕,並在伺服器上儲存與檢查。

RoCode 會做
  • 可以一步放入它高品質 UI 套件中現成的動畫每日獎勵畫面,有五種主題可選(candy、neon、gold、blocky、pastel),附可運作的伺服器 Script
  • 或者撰寫本教學中的伺服器 Script 與按鈕,接上你現有的貨幣
  • 它被指示用 Check Script 檢查每個 Script 能否編譯,並在每一批變更前後設下復原點

建立完成後,RoCode 可以啟動它的測試機器人:它會在 Studio 中玩你的遊戲、按按鈕,並回報 PASS 或 FAIL。它只檢查自己選定的項目,而 24 小時的計時器需要你自己用較短的數值測試。RoCode 如何連接 Studio。

常見問題

要怎麼在 Roblox 製作每日獎勵?

在伺服器上用 os.time() 儲存每位玩家上次領取的時間,經過 24 小時才允許領取,並在發放獎勵前於 UpdateAsync 中儲存。Script 請見步驟 1。

要怎麼做連續登入獎勵?

把連續天數計數和領取時間一起儲存。如果下一次領取在 48 小時內,就加一;如果更晚,就從 1 重新開始。

玩家能靠調整時鐘作弊領取每日獎勵嗎?

用這個 Script 不行:它只使用伺服器的 os.time()。

是不是在午夜重設獎勵比較好?

你可以改用 UTC 的日曆日來計算,而不是 24 小時。滾動式的 24 小時比較簡單,而且對所有時區都一樣有效。

來源與延伸閱讀

程式碼如何驗證:本頁每一段 Script 都通過 Luau 嚴格型別檢查,並使用 Roblox API 定義(luau-lsp,2026年11月20日)。型別檢查能找出拼錯的 API 與錯誤的型別,但無法檢查遊戲邏輯,所以發布前請先在 Studio 中測試。

在你自己的遊戲裡試試 RoCode。

每天都有免費點數,不需要信用卡。安裝外掛程式,描述你要的功能,再看看 Studio 裡出現了什麼。