Tutorial · Rewards

Paano gumawa ng daily rewards sa Roblox Studio

Ang daily reward ay dahilan para buksan ulit ng mga player ang game mo bukas, at ang streak ay dahilan para hindi sila lumaktaw kahit isang araw. Nakasalalay ang buong logic sa isang naka-save na timestamp: kailan huling kinuha ng player ang reward at ilang araw nang sunod-sunod. Ligtas na sine-save ng guide na ito ang dalawang value para hindi makakuha ng reward nang dalawang beses ang player sa pag-rejoin o pagbukas ng dalawang server, at nagdadagdag ito ng button na may countdown hanggang sa susunod na reward.

In-update Nobyembre 20, 20265 minutong basaIsinulat ni

Sa madaling salita

Mag-save ng dalawang number para sa bawat player sa DataStore: last, ang value ng os.time() sa huling claim, at streak. Puwedeng i-claim ang reward kapag lumipas na ang 24 oras. Kapag lumampas ng 48 oras, magsisimula ulit ang streak sa day 1; kung hindi, madadagdagan ito ng isang araw at iikot sa 7 araw na palaki nang palaki ang reward. Gawin ang check sa loob ng UpdateAsync para sabay ang desisyon at ang pag-save.

  • Gamitin ang os.time() sa server, hindi ang oras na ipinadala ng client.
  • Sa loob ng UpdateAsync, mag-return ng nil kapag hindi pa puwedeng mag-claim: makakansela ang save at walang ibibigay.
  • Ang client ay humihingi lang ng status at humihiling ng reward; ang server ang sumasagot.
Sa page na ito
  1. Paano ito gumagana
  2. 1. Server
  3. 2. Button
  4. Common errors
  5. With RoCode
  6. Mga madalas itanong
  7. Mga source at dagdag na babasahin

Paano gumagana ang daily rewards at streaks

Ano ang nangyayari sa claim depende sa oras mula sa huling claim
Oras mula sa huling claimResulta
Wala pang 24 orasMasyado pang maaga. Countdown ang ipinapakita ng button.
24 hanggang 48 orasPuwedeng i-claim ang reward, madadagdagan ng isang araw ang streak.
Lampas 48 orasPuwedeng i-claim ang reward, magsisimula ulit ang streak sa day 1.
Pagkatapos ng day 7Ang susunod na claim ay day 1 ng bagong linggo.

Sa server, ibinabalik ng os.time() ang kasalukuyang Unix time sa seconds sa UTC, kaya pareho ito sa lahat ng server. Hindi kasali ang orasan sa computer ng player, kaya walang epekto ang pagpalit ng petsa sa phone.

Step 1: ang reward server

I-on ang Enable Studio Access to API Services sa Game Settings, Security (dapat naka-publish ang place). Pagkatapos, maglagay ng Script sa ServerScriptService na pinangalanang DailyRewards:

Script sa ServerScriptService na pinangalanang DailyRewards
-- Script sa ServerScriptService na pinangalanang DailyRewards.
-- Isang reward kada 24 oras. Kapag nag-claim ulit sa loob ng 48 oras, tuloy ang streak,
-- at lumalaki ang reward araw-araw sa loob ng isang linggo, tapos magsisimula ulit ang linggo.
local DataStoreService = game:GetService("DataStoreService")
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local REWARDS = { 50, 75, 100, 150, 200, 300, 500 } -- coins para sa day 1 hanggang 7 ng streak
local CLAIM_EVERY = 24 * 60 * 60 -- seconds sa pagitan ng mga claim
local STREAK_LOST_AFTER = 48 * 60 * 60 -- lumaktaw ng isang buong araw, kaya magsisimula ulit ang streak

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

-- Ang streak day para sa susunod na claim, 1 hanggang 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)

-- Ang ipinapakita ng menu: seconds bago ang susunod na claim (0 = puwede na ngayon) at kung anong araw ito
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
	-- Binabasa ng UpdateAsync ang pinakabagong naka-save na record at nagdedesisyon sa loob ng update, kaya
	-- hindi makaka-claim ng parehong araw nang dalawang beses ang ibang server (o pangalawang click)
	local ok, err = pcall(function()
		store:UpdateAsync(tostring(player.UserId), function(old: any)
			-- Puwedeng tawagin ito ng UpdateAsync nang ilang beses: ang huling tawag lang ang bilang
			claimedDay = nil
			local saved = readRecord(old)
			if now - saved.last < CLAIM_EVERY then
				return nil -- masyado pang maaga: kinakansela ng pag-return ng nil ang save
			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

Nangyayari ang claim sa loob ng function na ipinasa sa UpdateAsync. Tinatawag ito ng Roblox gamit ang pinakabagong naka-save na record. Kapag masyado pang maaga, nil ang ibinabalik ng function at kinakansela ng Roblox ang write. Kung hindi, ibinabalik nito ang bagong record at tinatandaan ng script kung anong araw ang na-claim. Idinadagdag lang ang coins pagkatapos matapos ang UpdateAsync nang walang error. Kapag binago ng ibang server ang key sa pagitan nito, puwedeng tawagin ulit ng Roblox ang function gamit ang mas bagong value, kaya sa loob nito ginagawa ang desisyon.

Step 2: ang button na may countdown

Maglagay ng LocalScript sa StarterPlayer > StarterPlayerScripts na pinangalanang DailyRewardsMenu:

LocalScript sa StarterPlayerScripts na pinangalanang DailyRewardsMenu
-- LocalScript sa StarterPlayerScripts na pinangalanang DailyRewardsMenu.
-- Daily button na may countdown. Kapag handa na ang reward, Claim ang nakasulat dito.
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 -- ang os.clock() time kung kailan magiging handa ang reward
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

Isang beses lang tinatanong ng button sa server kung gaano katagal maghihintay, tapos ito na mismo ang nagbibilang bawat segundo gamit ang os.clock(), kaya hindi nito kinokontak ang server bawat segundo. Pagkatapos ng claim, nagtatanong ulit ito. Pang-display lang ang countdown: chine-check pa rin ng server ang oras kapag pinindot ng player ang Claim.

I-test ito

  1. Para sa test, gawing 30 ang CLAIM_EVERY at 60 ang STREAK_LOST_AFTER.
  2. Pindutin ang Play. "Claim day 1!" ang nakasulat sa button. Pindutin ito: +50 coins.
  3. Magbibilang ang button ng 30 segundo. Mag-claim ulit sa loob ng susunod na 30 segundo: day 2, +75.
  4. Maghintay nang lampas isang minuto: day 1 ulit ang susunod na claim.
  5. Bago mag-publish, ibalik ang dalawang value sa mga line na 24 at 48 oras.

Mga karaniwang error at solusyon

Bantayan ang Output window sa Server mode.

Loading... lang palagi ang ipinapakita ng button

Hindi nag-load ang record ng player. Sa Studio, i-on ang Enable Studio Access to API Services. Sa Output, makikita ang error pagkatapos ng "could not load".

Sa claim, "Come back later" ang lumalabas kahit Claim ang nasa button

Mas bago ang naka-save na record kaysa sa alam ng button, halimbawa pagkatapos mag-claim sa ibang server. Ang tamang sagot ay ang ibinigay ng server.

Nare-reset ang streak araw-araw

Lampas 48 oras ang pagitan ng mga claim ng player, o naiwan sa test value ang STREAK_LOST_AFTER.

Hindi nadadagdag ang coins

Dapat may IntValue na Coins sa leaderstats ang player, na ginawa ng server script.

Buuin ito gamit ang RoCode

Kung ayaw mong i-set up ito nang mano-mano, kaya itong buuin ng RoCode sa place na bukas mo. Ang RoCode ay isang independent na AI agent para sa Roblox Studio, hindi galing sa Roblox: ilalarawan mo ang pagbabago sa web chat, at gagawa ang Studio plugin nito ng mga script sa Explorer mo.

Ang tina-type mo

Magdagdag ng daily rewards na may 7-day streak: coins sa day 1 hanggang 6 at isang gem sa day 7, button na may countdown, may saving at check sa server.

Ang ginagawa ng RoCode
  • Kaya nitong maglagay sa isang step ng handa nang animated na daily rewards screen mula sa sarili nitong premium UI kits, sa isa sa limang theme (candy, neon, gold, blocky, pastel), na may gumaganang server scripts
  • O isusulat nito ang server script at ang button mula sa guide na ito, nakakonekta sa existing mong currency
  • Inutusan itong i-check ang compile ng bawat script gamit ang Check Script, at naglalagay ito ng undo points sa bawat set ng pagbabago

Pagkatapos ng build, kayang patakbuhin ng RoCode ang test robot nito: nilalaro nito ang game mo sa Studio, pumipindot ng mga button at nagre-report ng PASS o FAIL. Ang chine-check lang nito ay ang mga piniling i-test nito mismo, at para sa 24-hour timer kailangan mo ng sarili mong test na maiikli ang value. Paano kumokonekta ang RoCode sa Studio.

Mga madalas itanong

Paano gumawa ng daily rewards sa Roblox?

I-save ang oras ng huling claim ng bawat player gamit ang os.time() sa server, payagan ang claim pagkalipas ng 24 oras, at i-save ito sa loob ng UpdateAsync bago ibigay ang reward. Nasa step 1 ang script.

Paano gumawa ng daily login streak?

Mag-save ng streak counter kasama ng oras ng claim. Kapag dumating ang susunod na claim sa loob ng 48 oras, dagdagan ng isa; kung mas huli, magsimula ulit sa 1.

Puwede bang dayain ng mga player ang daily rewards sa pagpalit ng orasan?

Hindi sa script na ito: ang os.time() lang ng server ang ginagamit nito.

Mas mabuti bang i-reset ang reward tuwing hatinggabi?

Puwede kang magbilang ng calendar days sa UTC sa halip na 24 oras. Mas simple ang rolling 24 hours at pareho ang gana nito sa lahat ng time zone.

Mga source at dagdag na babasahin

Paano sinuri ang code: bawat script sa page na ito ay dumaan sa strict Luau type check gamit ang mga definition ng Roblox API (luau-lsp, Nobyembre 20, 2026). Nahuhuli ng type check ang maling pangalan ng API at maling type, pero hindi ang mga mali sa game logic, kaya i-test muna ang lahat sa Studio bago mag-publish.

Subukan ang RoCode sa sarili mong game.

Libreng credits araw-araw, walang card. I-install ang plugin, ilarawan ang feature, at tingnan kung ano ang lumabas sa Studio.