Ringkasnya
Simpan dua nombor bagi setiap pemain dalam DataStore: last, nilai os.time() tuntutan terakhir, dan streak. Ganjaran boleh dituntut apabila 24 jam telah berlalu. Jika lebih daripada 48 jam telah berlalu, streak bermula semula dari hari 1; jika tidak, ia bertambah satu hari dan berputar dalam kitaran 7 hari dengan ganjaran yang meningkat. Buat semakan di dalam UpdateAsync, supaya keputusan dan penyimpanan berlaku serentak.
- Gunakan
os.time()pada pelayan, bukan masa yang dihantar oleh client. - Di dalam UpdateAsync, pulangkan nil apabila ganjaran tidak boleh dituntut: penyimpanan dibatalkan dan tiada apa-apa diberikan.
- Client hanya meminta status dan meminta ganjaran; pelayan yang menjawab.
Di halaman ini
Cara ganjaran harian dan streak berfungsi
| Masa sejak tuntutan terakhir | Hasil |
|---|---|
| Kurang daripada 24 jam | Masih terlalu awal. Butang menunjukkan kiraan detik. |
| Antara 24 dan 48 jam | Ganjaran boleh dituntut, streak bertambah satu hari. |
| Lebih daripada 48 jam | Ganjaran boleh dituntut, streak bermula semula dari hari 1. |
| Selepas hari 7 | Tuntutan seterusnya ialah hari 1 minggu baharu. |
os.time() pada pelayan memulangkan masa Unix semasa dalam saat mengikut UTC, jadi semua pelayan bersetuju dengannya. Jam pada komputer pemain tidak terlibat, dan sebab itu menukar tarikh pada telefon tidak memberi apa-apa kesan.
Langkah 1: pelayan ganjaran
Hidupkan Enable Studio Access to API Services dalam Game Settings, Security (place mesti sudah diterbitkan). Kemudian masukkan Script ke dalam ServerScriptService dengan nama DailyRewards:
-- Script dalam ServerScriptService bernama DailyRewards.
-- Satu ganjaran setiap 24 jam. Jika dituntut semula dalam 48 jam, streak diteruskan,
-- dan ganjaran meningkat setiap hari selama seminggu, kemudian minggu bermula semula.
local DataStoreService = game:GetService("DataStoreService")
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local REWARDS = { 50, 75, 100, 150, 200, 300, 500 } -- syiling untuk hari 1 hingga 7 streak
local CLAIM_EVERY = 24 * 60 * 60 -- saat antara tuntutan
local STREAK_LOST_AFTER = 48 * 60 * 60 -- terlepas sehari penuh, dan streak bermula semula
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
-- Hari streak untuk tuntutan seterusnya, dari 1 hingga 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)
-- Apa yang ditunjukkan menu: saat hingga tuntutan seterusnya (0 = boleh sekarang) dan hari yang mana
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 membaca rekod tersimpan yang paling baharu dan membuat keputusan di dalam kemas kini, jadi
-- pelayan kedua (atau klik kedua) tidak boleh menuntut hari yang sama dua kali
local ok, err = pcall(function()
store:UpdateAsync(tostring(player.UserId), function(old: any)
-- UpdateAsync mungkin memanggil ini beberapa kali: hanya panggilan terakhir yang dikira
claimedDay = nil
local saved = readRecord(old)
if now - saved.last < CLAIM_EVERY then
return nil -- masih terlalu awal: memulangkan nil membatalkan penyimpanan
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
Tuntutan berlaku di dalam fungsi yang dihantar kepada UpdateAsync. Roblox memanggilnya dengan rekod tersimpan yang paling baharu. Jika masih terlalu awal, fungsi itu memulangkan nil dan Roblox membatalkan penulisan. Jika tidak, ia memulangkan rekod baharu, dan skrip mengingati hari mana yang dituntut. Syiling hanya ditambah selepas UpdateAsync selesai tanpa ralat. Jika pelayan lain menukar kunci itu dalam masa yang sama, Roblox mungkin memanggil fungsi itu sekali lagi dengan nilai yang lebih baharu, dan sebab itu keputusan dibuat di dalamnya.
Langkah 2: butang dengan kiraan detik
Masukkan LocalScript ke dalam StarterPlayer > StarterPlayerScripts dengan nama DailyRewardsMenu:
-- LocalScript dalam StarterPlayerScripts bernama DailyRewardsMenu.
-- Butang Daily dengan kiraan detik. Apabila ganjaran sedia, butang tertulis 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 -- masa os.clock() apabila ganjaran akan sedia
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
Butang bertanya kepada pelayan sekali berapa lama perlu menunggu, kemudian mengira detik sendiri setiap saat melalui os.clock(), jadi ia tidak menghubungi pelayan setiap saat. Selepas tuntutan, ia bertanya sekali lagi. Kiraan detik hanya untuk paparan: pelayan tetap menyemak masa apabila pemain menekan Claim.
Uji
- Untuk ujian, tetapkan
CLAIM_EVERYkepada30danSTREAK_LOST_AFTERkepada60. - Tekan Play. Butang tertulis "Claim day 1!". Tekan: +50 syiling.
- Butang mengira detik 30 saat. Tuntut semula dalam 30 saat berikutnya: hari 2, +75.
- Tunggu lebih daripada seminit: tuntutan seterusnya akan menjadi hari 1 semula.
- Sebelum menerbitkan, kembalikan kedua-dua nilai kepada baris 24 dan 48 jam.
Ralat biasa dan cara membaikinya
Perhatikan tetingkap Output dalam mod Server.
Butang sentiasa menunjukkan Loading...
Rekod pemain tidak dimuatkan. Dalam Studio, hidupkan Enable Studio Access to API Services. Dalam Output, ralat kelihatan selepas "could not load".
Semasa menuntut tertulis "Come back later", walaupun butang menunjukkan Claim
Rekod tersimpan lebih baharu daripada yang diketahui butang, contohnya selepas tuntutan pada pelayan lain. Jawapan yang betul ialah jawapan yang diberi oleh pelayan.
Streak diset semula setiap hari
Pemain menuntut ganjaran dengan jarak lebih daripada 48 jam, atau STREAK_LOST_AFTER masih dengan nilai ujian.
Syiling tidak ditambah
Pemain mesti ada IntValue Coins dalam leaderstats, yang dicipta oleh skrip pelayan.
Bina ini dengan RoCode
Jika anda tidak mahu menyediakan ini secara manual, RoCode boleh membinanya dalam place yang sedang anda buka. RoCode ialah ejen AI bebas untuk Roblox Studio, bukan daripada Roblox: anda terangkan perubahan dalam chat web, dan plugin Studio miliknya mencipta skrip dalam Explorer anda.
Tambah ganjaran harian dengan streak 7 hari: syiling pada hari 1 hingga 6 dan gem pada hari 7, butang dengan kiraan detik, dengan penyimpanan dan semakan pada pelayan.
- Boleh memasukkan dalam satu langkah skrin ganjaran harian beranimasi yang siap daripada kit UI premiumnya dalam salah satu daripada lima tema (candy, neon, gold, blocky, pastel), dengan skrip pelayan yang berfungsi
- Atau menulis skrip pelayan dan butang daripada panduan ini, disambungkan kepada mata wang sedia ada anda
- Ia diarahkan untuk menyemak kompilasi setiap skrip melalui Check Script, dan ia meletakkan titik undo di sekeliling setiap set perubahan
Selepas binaan, RoCode boleh menjalankan robot ujiannya: ia bermain game anda dalam Studio, menekan butang dan melaporkan PASS atau FAIL. Ia hanya menyemak perkara yang dipilihnya sendiri untuk diuji, dan untuk pemasa 24 jam anda perlukan ujian sendiri dengan nilai pendek. Cara RoCode bersambung ke Studio.
Soalan lazim
Bagaimana cara buat ganjaran harian dalam Roblox?
Simpan masa tuntutan terakhir setiap pemain melalui os.time() pada pelayan, benarkan tuntutan selepas 24 jam, dan simpan di dalam UpdateAsync sebelum memberi ganjaran. Skripnya dalam langkah 1.
Bagaimana cara buat streak log masuk harian?
Simpan kaunter streak bersama masa tuntutan. Jika tuntutan seterusnya datang dalam 48 jam, tambah satu; jika lebih lewat, mulakan semula dari 1.
Bolehkah pemain menipu ganjaran harian dengan menukar jam?
Dengan skrip ini tidak boleh: ia hanya menggunakan os.time() pelayan.
Adakah lebih baik set semula ganjaran pada tengah malam?
Anda boleh mengira hari kalendar mengikut UTC dan bukannya 24 jam. Tempoh 24 jam bergerak lebih mudah dan berfungsi sama untuk semua zon waktu.
Sumber dan bacaan lanjut
- Roblox Creator Docs: GlobalDataStore:UpdateAsync (dalam bahasa Inggeris). fungsi kemas kini dan pembatalan melalui nil
- Roblox Creator Docs: Data stores (dalam bahasa Inggeris). akses daripada Studio dan asas data store
- Roblox Creator Docs: Remote events and functions (dalam bahasa Inggeris). RemoteFunction
Cara kod disemak: setiap skrip di halaman ini lulus semakan jenis Luau yang ketat dengan definisi API Roblox (luau-lsp, 20 November 2026). Semakan jenis mengesan kesilapan nama API dan jenis yang salah, tetapi bukan kesilapan logik permainan, jadi uji semuanya dalam Studio sebelum anda menerbitkannya.