Útmutató · Jutalmak

Hogyan készíts napi jutalmakat a Roblox Studióban

A napi jutalom okot ad a játékosoknak, hogy holnap is megnyissák a játékodat, a sorozat pedig okot ad arra, hogy egy napot se hagyjanak ki. Az egész logika egy elmentett időbélyegen múlik: mikor gyűjtötte be a játékos utoljára a jutalmat, és hány napja egymás után. Ez az útmutató mindkét értéket megbízhatóan tárolja, hogy a játékos ne tudja kétszer begyűjteni a jutalmat újracsatlakozással vagy két szerver megnyitásával, és hozzáad egy gombot, amely visszaszámol a következő jutalomig.

Frissítve 2026. november 20.4 perc olvasásSzerző:

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
  1. Hogyan működik
  2. 1. Szerver
  3. 2. Gomb
  4. Common errors
  5. With RoCode
  6. Gyakori kérdések
  7. Források és további olvasnivaló

Hogyan működnek a napi jutalmak és a sorozatok

Mi történik begyűjtéskor attól függően, mennyi idő telt el a legutóbbi óta
Idő a legutóbbi begyűjtés ótaEredmény
Kevesebb mint 24 óraMég korai. A gomb visszaszámlálást mutat.
24 és 48 óra közöttA jutalom begyűjthető, a sorozat egy nappal nő.
Több mint 48 óraA jutalom begyűjthető, a sorozat újraindul az 1. naptól.
A 7. nap utánA 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 helye: ServerScriptService neve: DailyRewards
-- 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 helye: StarterPlayerScripts neve: DailyRewardsMenu
-- 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

  1. A teszthez állítsd a CLAIM_EVERY értékét 30-ra, a STREAK_LOST_AFTER értékét 60-ra.
  2. Nyomd meg a Play gombot. A gombon „Claim day 1!” áll. Nyomd meg: +50 érme.
  3. A gomb 30 másodpercet számol vissza. Gyűjtsd be újra a következő 30 másodpercen belül: 2. nap, +75.
  4. Várj több mint egy percet: a következő begyűjtés megint az 1. nap lesz.
  5. 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.

Te írod

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.

A RoCode elvégzi
  • 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ó

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.

Próbáld ki a RoCode-ot a saját játékodban.

Ingyenes kreditek minden nap, bankkártya nélkül. Telepítsd a plugint, írd le a funkciót, és nézd meg, mi jelenik meg a Studióban.