要点
プレイヤーごとに2つの数値を DataStore に保存します。最後に受け取ったときの os.time() の値である last と、streak です。24時間が過ぎたら受け取れます。48時間より長くあいた場合、連続日数は1日目からやり直しになります。そうでなければ1日増え、報酬が増えていく7日間を繰り返します。判定は UpdateAsync の中で行い、判断と保存が同時に起きるようにします。
- クライアントから送られた時刻ではなく、サーバーの
os.time()を使います。 - UpdateAsync の中では、受け取れないときに nil を返します。保存が取り消され、何も渡されません。
- クライアントは状態を問い合わせて報酬を求めるだけで、答えるのはサーバーです。
デイリー報酬と連続ボーナスの仕組み
| 前回の受け取りからの時間 | 結果 |
|---|---|
| 24時間未満 | まだ早すぎます。ボタンにカウントダウンが表示されます。 |
| 24時間から48時間 | 受け取れて、連続日数が1日増えます。 |
| 48時間より長い | 受け取れますが、連続日数は1日目からやり直しです。 |
| 7日目のあと | 次の受け取りは新しい週の1日目です。 |
サーバーの os.time() は、UTC の現在の Unix 時刻を秒で返すので、すべてのサーバーで値が一致します。プレイヤーのパソコンの時計は関係しないため、スマートフォンの日付を変えても意味がありません。
ステップ1: 報酬のサーバー
Game Settings の Security で Enable Studio Access to API Services をオンにします(プレイスが公開されている必要があります)。次に、ServerScriptService に DailyRewards という名前の Script を入れます:
-- ServerScriptService の Script、名前は DailyRewards。
-- 24時間に1回の報酬。48時間以内にまた受け取ると連続日数が続き、
-- 1週間のあいだ毎日報酬が増えて、そのあと週が最初からになります。
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 -- まる1日あくと、連続日数は最初からになる
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 は最新の保存済みレコードを読み、更新の中で判断するので、
-- 2つ目のサーバー(または2回目のクリック)が同じ日を2回受け取ることはできない
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 は書き込みを取り消します。そうでなければ新しいレコードを返し、スクリプトはどの日を受け取ったかを覚えておきます。コインが加算されるのは、UpdateAsync がエラーなく終わったあとだけです。そのあいだに別のサーバーがキーを変更していた場合、Roblox はより新しい値で関数をもう一度呼ぶことがあるので、判断はその関数の中で行います。
ステップ2: カウントダウン付きのボタン
StarterPlayer > StarterPlayerScripts に DailyRewardsMenu という名前の LocalScript を入れます:
-- StarterPlayerScripts の LocalScript、名前は DailyRewardsMenu。
-- カウントダウン付きの 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
ボタンは待ち時間をサーバーに1回だけ問い合わせ、そのあとは os.clock() で毎秒自分でカウントダウンするので、毎秒サーバーにアクセスすることはありません。受け取ったあとは、もう一度問い合わせます。カウントダウンは見た目のためだけのもので、プレイヤーが Claim を押したときには、サーバーが必ず時刻を確認します。
確認しましょう
- テストのために、
CLAIM_EVERYを30、STREAK_LOST_AFTERを60にします。 - Play を押します。ボタンに「Claim day 1!」と表示されます。押すと +50 コインです。
- ボタンが30秒をカウントダウンします。次の30秒以内にもう一度受け取ると、2日目で +75 です。
- 1分より長く待つと、次の受け取りはまた1日目になります。
- 公開する前に、両方の値を24時間と48時間の行に戻してください。
よくあるエラーと対処法
Output ウィンドウを Server モードで確認してください。
ボタンがずっと Loading... のまま
プレイヤーのレコードが読み込まれていません。Studio で Enable Studio Access to API Services をオンにしてください。Output では「could not load」のあとにエラーが表示されます。
ボタンは Claim だったのに、受け取ると「Come back later」と出る
保存済みのレコードが、ボタンが知っていたものより新しかったためです。たとえば別のサーバーで受け取ったあとです。正しいのはサーバーが返した答えです。
連続日数が毎日リセットされる
プレイヤーが48時間より長い間隔で受け取っているか、STREAK_LOST_AFTER がテスト用の値のままになっています。
コインが加算されない
プレイヤーの leaderstats に、サーバースクリプトで作った IntValue Coins が必要です。
RoCode で作る
自分で設定したくない場合は、RoCode があなたの開いているプレイスにこれを作れます。RoCode は Roblox 製ではない、独立した Roblox Studio 向けの AI エージェントです。ウェブチャットで変更内容を説明すると、Studio プラグインがあなたの Explorer にスクリプトを作ります。
7日間の連続ボーナス付きのデイリー報酬を追加して。1日目から6日目はコイン、7日目はジェム、カウントダウン付きのボタン、保存とサーバーでのチェックも入れて。
- プレミアム UI キットから、完成したアニメーション付きのデイリー報酬画面を、5つのテーマ(candy、neon、gold、blocky、pastel)のいずれかで、動くサーバースクリプトと一緒に1ステップで入れられます
- または、このガイドのサーバースクリプトとボタンを書き、あなたの既存の通貨につなぎます
- すべてのスクリプトのコンパイルを Check Script で確認するよう指示されていて、変更のまとまりごとに元に戻すポイントを作ります
作ったあと、RoCode はテスト用ロボットを動かせます。ロボットは Studio であなたのゲームを遊び、ボタンを押して、PASS か FAIL を報告します。確認するのは自分がテストすると決めたことだけなので、24時間のタイマーには短い値を使ったあなた自身のテストが必要です。RoCode が Studio に接続する仕組み。
よくある質問
Roblox でデイリー報酬を作るには?
各プレイヤーが最後に受け取った時刻をサーバーの os.time() で保存し、24時間後に受け取りを許可して、報酬を渡す前に UpdateAsync の中で保存します。スクリプトはステップ1にあります。
連続ログインボーナスを作るには?
受け取りの時刻と一緒に連続日数のカウンターを保存します。次の受け取りが48時間以内なら1を足し、それより遅ければ1から始め直します。
プレイヤーは時計を変えてデイリー報酬をごまかせますか?
このスクリプトではできません。使っているのはサーバーの os.time() だけです。
深夜0時に報酬をリセットするほうがいいですか?
24時間の代わりに UTC の暦日で数えることもできます。24時間のローリング方式のほうがシンプルで、どのタイムゾーンでも同じように動きます。
参考資料
- Roblox Creator Docs: GlobalDataStore:UpdateAsync(英語). 更新関数と nil による取り消し
- Roblox Creator Docs: Data stores(英語). Studio からのアクセスと data store の基本
- Roblox Creator Docs: Remote events and functions(英語). RemoteFunction
コードの検証方法: このページのスクリプトはすべて、Roblox API の型定義(luau-lsp、2026年11月20日)を使った Luau の strict 型チェックを通っています。型チェックで見つかるのは API 名の誤りや型の不一致であり、ゲームロジックの誤りは見つかりません。公開する前に必ず Studio でテストしてください。