Röviden
Minden játékoshoz ments el két számot a DataStore-ban: last, az utolsó begyűjtés os.time() értéke, és streak. A jutalom akkor gyűjthető be, ha eltelt 24 óra. Ha 48 óránál több telt el, a sorozat újraindul az 1. naptól; különben egy nappal nő, és körbejár egy 7 napos ciklust növekvő jutalmakkal. Az ellenőrzést az UpdateAsync belsejében végezd, hogy a döntés és a mentés együtt történjen.
- A szerveren az
os.time()értékét használd, ne a kliens által küldött időt. - Az UpdateAsync belsejében adj vissza nilt, ha a jutalom nem gyűjthető be: a mentés elmarad, és semmi sem kerül kiosztásra.
- A kliens csak lekéri az állapotot és kéri a jutalmat; a szerver válaszol.
Ezen az oldalon
Hogyan működnek a napi jutalmak és a sorozatok
| Idő a legutóbbi begyűjtés óta | Eredmény |
|---|---|
| Kevesebb mint 24 óra | Még korai. A gomb visszaszámlálást mutat. |
| 24 és 48 óra között | A jutalom begyűjthető, a sorozat egy nappal nő. |
| Több mint 48 óra | A jutalom begyűjthető, a sorozat újraindul az 1. naptól. |
| A 7. nap után | A következő begyűjtés egy új hét 1. napja. |
A szerveren az os.time() a jelenlegi Unix-időt adja vissza másodpercben, UTC szerint, így minden szerver egyetért vele. A játékos számítógépének órája nem számít, ezért a dátum átállítása a telefonon semmit sem ér.
1. lépés: a jutalmak szervere
Kapcsold be az Enable Studio Access to API Services beállítást a Game Settings, Security alatt (a place-nek publikáltnak kell lennie). Ezután tegyél egy Scriptet a ServerScriptService-be DailyRewards néven:
-- Script a ServerScriptService-ben DailyRewards néven.
-- Egy jutalom 24 óránként. Ha 48 órán belül újra begyűjtöd, a sorozat folytatódik,
-- és a jutalmak egy héten át minden nap nőnek, aztán a hét újraindul.
local DataStoreService = game:GetService("DataStoreService")
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local REWARDS = { 50, 75, 100, 150, 200, 300, 500 } -- érmék a sorozat 1-7. napjára
local CLAIM_EVERY = 24 * 60 * 60 -- másodpercek két begyűjtés között
local STREAK_LOST_AFTER = 48 * 60 * 60 -- kihagytál egy egész napot, és a sorozat újraindul
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
-- A sorozat napja a következő begyűjtéshez, 1-től 7-ig
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)
-- Amit a menü mutat: másodpercek a következő begyűjtésig (0 = most lehet) és hányadik nap az
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
-- Az UpdateAsync a legfrissebb mentett rekordot olvassa, és a frissítésen belül dönt, így
-- egy második szerver (vagy egy második kattintás) nem gyűjtheti be ugyanazt a napot kétszer
local ok, err = pcall(function()
store:UpdateAsync(tostring(player.UserId), function(old: any)
-- Az UpdateAsync ezt többször is meghívhatja: csak az utolsó hívás számít
claimedDay = nil
local saved = readRecord(old)
if now - saved.last < CLAIM_EVERY then
return nil -- még korai: a nil visszaadása elveti a mentést
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
A begyűjtés az UpdateAsync-nak átadott függvényen belül történik. A Roblox a legfrissebb mentett rekorddal hívja meg. Ha még korai, a függvény nilt ad vissza, és a Roblox elveti az írást. Különben az új rekordot adja vissza, a script pedig megjegyzi, melyik napot gyűjtötték be. Az érmék csak azután kerülnek jóváírásra, hogy az UpdateAsync hiba nélkül lefutott. Ha közben egy másik szerver módosította a kulcsot, a Roblox újra meghívhatja a függvényt az újabb értékkel, ezért születik a döntés a függvényen belül.
2. lépés: gomb visszaszámlálással
Tegyél egy LocalScriptet a StarterPlayer > StarterPlayerScripts mappába DailyRewardsMenu néven:
-- LocalScript a StarterPlayerScripts-ben DailyRewardsMenu néven.
-- Daily gomb visszaszámlálással. Amikor a jutalom kész, Claim felirat van rajta.
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 -- az os.clock() ideje, amikor a jutalom kész lesz
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
A gomb egyszer megkérdezi a szervert, mennyit kell várni, aztán az os.clock() segítségével maga számol vissza másodpercenként, így nem kérdezi a szervert minden másodpercben. Begyűjtés után újra megkérdezi. A visszaszámlálás csak a látvány kedvéért van: a szerver akkor is ellenőrzi az időt, amikor a játékos megnyomja a Claim gombot.
Teszteld
- A teszthez állítsd a
CLAIM_EVERYértékét30-ra, aSTREAK_LOST_AFTERértékét60-ra. - Nyomd meg a Play gombot. A gombon „Claim day 1!” áll. Nyomd meg: +50 érme.
- A gomb 30 másodpercet számol vissza. Gyűjtsd be újra a következő 30 másodpercen belül: 2. nap, +75.
- Várj több mint egy percet: a következő begyűjtés megint az 1. nap lesz.
- Publikálás előtt állítsd vissza mindkét értéket a 24 és 48 órás sorokra.
Gyakori hibák és megoldásaik
Figyeld az Output ablakot Server módban.
A gomb folyton Loading... feliratot mutat
A játékos rekordja nem töltődött be. A Studióban kapcsold be az Enable Studio Access to API Services beállítást. Az Outputban a hiba a „could not load” után látszik.
Begyűjtéskor „Come back later” jön, pedig a gombon Claim állt
A mentett rekord újabb volt annál, amit a gomb tudott, például egy másik szerveren történt begyűjtés után. A szerver válasza a helyes.
A sorozat minden nap nullázódik
A játékosok 48 óránál nagyobb időközönként gyűjtik be a jutalmat, vagy a STREAK_LOST_AFTER a tesztértéken maradt.
Az érmék nem adódnak hozzá
A játékosnak kell egy Coins IntValue a leaderstats alatt, amelyet egy szerverscript hoz létre.
Építsd meg a RoCode-dal
Ha nincs kedved ezt kézzel beállítani, a RoCode megépítheti a nálad nyitott place-ben. A RoCode egy független AI-ügynök a Roblox Studióhoz, nem a Robloxtól: a webes chatben leírod a módosítást, a Studio pluginja pedig létrehozza a scripteket az Explorerben.
Adj hozzá napi jutalmakat 7 napos sorozattal: érmék az 1-6. napon és egy drágakő a 7. napon, gomb visszaszámlálással, mentéssel és szerveroldali ellenőrzéssel.
- Egy lépésben beillesztheti a prémium UI kitjeiből egy kész, animált napi jutalom képernyőt az öt téma egyikében (candy, neon, gold, blocky, pastel), működő szerverscriptekkel
- Vagy megírja az ebben az útmutatóban szereplő szerverscriptet és gombot, a meglévő pénznemedhez kötve
- Az a feladata, hogy minden script fordítását ellenőrizze a Check Scripttel, és minden módosításcsomag köré visszavonási pontot tesz
Az építés után a RoCode elindíthatja a tesztrobotját: játszik a játékodban a Studióban, gombokat nyom, és PASS vagy FAIL eredményt jelent. Csak azt ellenőrzi, amit maga választott ki tesztelésre, a 24 órás időzítőhöz pedig saját teszt kell rövid értékekkel. Hogyan csatlakozik a RoCode a Studióhoz.
Gyakori kérdések
Hogyan készítsek napi jutalmakat Robloxban?
Mentsd el minden játékos utolsó begyűjtésének idejét az os.time() segítségével a szerveren, engedd a begyűjtést 24 óra után, és mentsd el az UpdateAsync belsejében, mielőtt kiosztod a jutalmat. A script az 1. lépésben van.
Hogyan készítsek napi belépési sorozatot?
Mentsd el a sorozat számlálóját a begyűjtés idejével együtt. Ha a következő begyűjtés 48 órán belül jön, adj hozzá egyet; ha később, kezdd újra 1-ről.
Átverhetik a játékosok a napi jutalmakat az óra átállításával?
Ezzel a scripttel nem: csak a szerver os.time() értékét használja.
Nem jobb éjfélkor nullázni a jutalmat?
Számolhatsz UTC szerinti naptári napokat is 24 óra helyett. A csúszó 24 óra egyszerűbb, és minden időzónában ugyanúgy működik.
Források és további olvasnivaló
- Roblox Creator Docs: GlobalDataStore:UpdateAsync (angolul). a frissítő függvény és az elvetés nillel
- Roblox Creator Docs: Data stores (angolul). hozzáférés a Studióból és a data store alapjai
- Roblox Creator Docs: Remote events and functions (angolul). RemoteFunction
Hogyan ellenőriztük a kódot: az oldalon minden script átmegy a Luau szigorú típusellenőrzésén a Roblox API definícióival (luau-lsp, 2026. november 20.). A típusellenőrzés kiszűri az elírt API-neveket és a rossz típusokat, de a játéklogikai hibákat nem, ezért publikálás előtt mindent tesztelj a Studióban.