Tutorial · Ganjaran

Cara buat ganjaran harian dalam Roblox Studio

Ganjaran harian memberi pemain sebab untuk membuka game anda esok, dan streak memberi sebab untuk tidak terlepas walau sehari. Seluruh logiknya bergantung pada cap masa yang disimpan: bila pemain kali terakhir menuntut ganjaran dan berapa hari berturut-turut. Panduan ini menyimpan kedua-dua nilai dengan selamat supaya pemain tidak boleh menuntut ganjaran dua kali dengan masuk semula ke game atau membuka dua pelayan, dan menambah butang dengan kiraan detik hingga ganjaran seterusnya.

Dikemas kini 20 November 20264 minit bacaanDitulis oleh

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
  1. Cara ia berfungsi
  2. 1. Pelayan
  3. 2. Butang
  4. Common errors
  5. With RoCode
  6. Soalan lazim
  7. Sumber dan bacaan lanjut

Cara ganjaran harian dan streak berfungsi

Apa yang berlaku semasa tuntutan bergantung pada masa sejak kali terakhir
Masa sejak tuntutan terakhirHasil
Kurang daripada 24 jamMasih terlalu awal. Butang menunjukkan kiraan detik.
Antara 24 dan 48 jamGanjaran boleh dituntut, streak bertambah satu hari.
Lebih daripada 48 jamGanjaran boleh dituntut, streak bermula semula dari hari 1.
Selepas hari 7Tuntutan 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
-- 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
-- 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

  1. Untuk ujian, tetapkan CLAIM_EVERY kepada 30 dan STREAK_LOST_AFTER kepada 60.
  2. Tekan Play. Butang tertulis "Claim day 1!". Tekan: +50 syiling.
  3. Butang mengira detik 30 saat. Tuntut semula dalam 30 saat berikutnya: hari 2, +75.
  4. Tunggu lebih daripada seminit: tuntutan seterusnya akan menjadi hari 1 semula.
  5. 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.

Anda tulis

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.

RoCode buat
  • 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

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.

Cuba RoCode dalam permainan anda.

Kredit percuma setiap hari, tanpa kad. Pasang plugin, terangkan ciri yang anda mahu dan semak hasilnya dalam Studio.