Kısaca
Her oyuncu için DataStore'da iki sayı sakla: son alımın os.time() değeri olan last ve streak. 24 saat geçince ödül alınabilir. 48 saatten fazla geçtiyse seri 1. günden yeniden başlar; yoksa bir gün büyür ve büyüyen ödüllerle 7 günlük bir döngüde ilerler. Kontrolü UpdateAsync içinde yap, böylece karar ve kayıt birlikte olur.
- İstemcinin gönderdiği zamanı değil, sunucuda
os.time()kullan. - Ödül alınamıyorsa UpdateAsync içinde nil döndür: kayıt iptal olur ve hiçbir şey verilmez.
- İstemci sadece durumu sorar ve ödülü ister; cevabı sunucu verir.
Bu sayfada
Günlük ödüller ve seriler nasıl çalışır
| Son alımdan bu yana geçen süre | Sonuç |
|---|---|
| 24 saatten az | Henüz erken. Buton bir geri sayım gösterir. |
| 24 ile 48 saat arası | Ödül alınabilir, seri bir gün büyür. |
| 48 saatten fazla | Ödül alınabilir, seri 1. günden yeniden başlar. |
| 7. günden sonra | Bir sonraki alım yeni haftanın 1. günüdür. |
Sunucudaki os.time() UTC'ye göre saniye cinsinden şu anki Unix zamanını döndürür, bu yüzden tüm sunucular onda hemfikirdir. Oyuncunun bilgisayarındaki saat işin içinde değil, bu yüzden telefonda tarihi değiştirmek hiçbir işe yaramaz.
Adım 1: ödül sunucusu
Game Settings, Security içinde Enable Studio Access to API Services'ı aç (place yayınlanmış olmalı). Sonra ServerScriptService'e DailyRewards adlı bir Script ekle:
-- ServerScriptService içinde DailyRewards adlı Script.
-- 24 saatte bir ödül. 48 saat içinde tekrar alınırsa seri devam eder
-- ve ödüller bir hafta boyunca her gün büyür, sonra hafta yeniden başlar.
local DataStoreService = game:GetService("DataStoreService")
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local REWARDS = { 50, 75, 100, 150, 200, 300, 500 } -- serinin 1. ile 7. günleri için coin
local CLAIM_EVERY = 24 * 60 * 60 -- iki alım arasındaki saniye
local STREAK_LOST_AFTER = 48 * 60 * 60 -- koca bir gün kaçırıldı ve seri yeniden başlıyor
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
-- Bir sonraki alım için serinin günü, 1 ile 7 arası
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)
-- Menünün gösterdiği: bir sonraki alıma kalan saniye (0 = şimdi alınabilir) ve hangi gün olduğu
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 en son kaydedilmiş kaydı okur ve kararı güncellemenin içinde verir, bu yüzden
-- ikinci bir sunucu (ya da ikinci bir tık) aynı günü iki kez alamaz
local ok, err = pcall(function()
store:UpdateAsync(tostring(player.UserId), function(old: any)
-- UpdateAsync bunu birkaç kez çağırabilir: sadece son çağrı sayılır
claimedDay = nil
local saved = readRecord(old)
if now - saved.last < CLAIM_EVERY then
return nil -- henüz erken: nil döndürmek kaydı iptal eder
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
Alım, UpdateAsync'e verilen fonksiyonun içinde olur. Roblox onu en son kaydedilmiş kayıtla çağırır. Henüz erkense fonksiyon nil döndürür ve Roblox yazmayı iptal eder. Değilse yeni kaydı döndürür, script de hangi günün alındığını hatırlar. Coin'ler ancak UpdateAsync hatasız bittikten sonra eklenir. Bu arada başka bir sunucu anahtarı değiştirdiyse Roblox fonksiyonu daha yeni değerle tekrar çağırabilir, karar da bu yüzden onun içinde veriliyor.
Adım 2: geri sayımlı buton
StarterPlayer > StarterPlayerScripts'e DailyRewardsMenu adlı bir LocalScript ekle:
-- StarterPlayerScripts içinde DailyRewardsMenu adlı LocalScript.
-- Geri sayımlı Daily butonu. Ödül hazır olunca üzerinde Claim yazar.
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 -- ödülün hazır olacağı os.clock() zamanı
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
Buton sunucuya bir kez ne kadar bekleyeceğini sorar, sonra os.clock() ile her saniye geri sayımı kendisi yapar, yani her saniye sunucuya gitmez. Alımdan sonra yine sorar. Geri sayım sadece görünüş için: oyuncu Claim'e bastığında sunucu zamanı yine kontrol eder.
Dene
- Test için
CLAIM_EVERY'yi30,STREAK_LOST_AFTER'ı da60yap. - Play'e bas. Butonda "Claim day 1!" yazar. Ona bas: +50 coin.
- Buton 30 saniye geri sayar. Sonraki 30 saniye içinde tekrar al: 2. gün, +75.
- Bir dakikadan fazla bekle: bir sonraki alım yine 1. gün olur.
- Yayınlamadan önce iki değeri de 24 ve 48 saatlik satırlara geri döndür.
Sık yapılan hatalar ve çözümleri
Output penceresini Server modunda izle.
Buton sürekli Loading... gösteriyor
Oyuncunun kaydı yüklenmedi. Studio'da Enable Studio Access to API Services'ı aç. Output'ta hata "could not load"dan sonra görünür.
Butonda Claim yazmasına rağmen alırken "Come back later" diyor
Kaydedilmiş kayıt butonun bildiğinden daha yeniydi, örneğin başka bir sunucuda alımdan sonra. Doğru cevap sunucunun verdiği cevap.
Seri her gün sıfırlanıyor
Oyuncular ödülü 48 saatten uzun aralıklarla alıyor ya da STREAK_LOST_AFTER test değerinde kalmış.
Coin'ler eklenmiyor
Oyuncunun leaderstats içinde bir sunucu scriptinin oluşturduğu Coins adlı bir IntValue'su olmalı.
RoCode ile yap
Bunu elle kurmak istemiyorsan RoCode onu açık olan place'inde kurabilir. RoCode Roblox Studio için bağımsız bir yapay zeka ajanı, Roblox'un değil: değişikliği bir web chat'inde anlatırsın, Studio plugin'i de scriptleri Explorer'ında oluşturur.
7 günlük serili günlük ödüller ekle: 1. ile 6. günler arası coin ve 7. günde bir gem, geri sayımlı bir buton, kayıtlı ve sunucuda kontrol edilen.
- Premium UI setlerinden beş temadan birinde (candy, neon, gold, blocky, pastel) hazır, animasyonlu bir günlük ödül ekranını çalışan sunucu scriptleriyle tek adımda ekleyebilir
- Ya da bu rehberdeki sunucu scriptini ve butonu mevcut para birimine bağlı olarak yazar
- Her scriptin derlendiğini Check Script ile kontrol etmesi söylenmiştir ve her değişiklik grubunun etrafına geri alma noktaları koyar
Kurulumdan sonra RoCode kendi test robotunu çalıştırabilir: robot oyununu Studio'da oynar, butonlara basar ve PASS ya da FAIL bildirir. Sadece test için kendi seçtiği şeyi kontrol eder, 24 saatlik zamanlayıcı için de kısa değerlerle kendi testini yapman gerekir. RoCode Studio'ya nasıl bağlanır.
Sık sorulan sorular
Roblox'ta günlük ödül nasıl yapılır?
Her oyuncunun son alım zamanını sunucuda os.time() ile sakla, alıma 24 saat sonra izin ver ve ödülü vermeden önce alımı UpdateAsync içinde kaydet. Script 1. adımda.
Günlük giriş serisi nasıl yapılır?
Seri sayacını alım zamanıyla birlikte sakla. Bir sonraki alım 48 saat içinde geldiyse bir ekle; daha sonra geldiyse 1'den yeniden başla.
Oyuncular saati değiştirerek günlük ödülleri kandırabilir mi?
Bu scriptle hayır: sadece sunucunun os.time()'ını kullanır.
Ödülü gece yarısı sıfırlamak daha mı iyi?
24 saat yerine UTC'ye göre takvim günlerini sayabilirsin. Kayan 24 saat daha basittir ve tüm saat dilimlerinde aynı şekilde çalışır.
Kaynaklar ve ek okumalar
- Roblox Creator Docs: GlobalDataStore:UpdateAsync (İngilizce). güncelleme fonksiyonu ve nil ile iptal
- Roblox Creator Docs: Data stores (İngilizce). Studio erişimi ve data store temelleri
- Roblox Creator Docs: Remote events and functions (İngilizce). RemoteFunction
Kod nasıl kontrol edildi: bu sayfadaki her script, Roblox API tanımlarıyla Luau'nun katı tür denetleyicisinden geçiyor (luau-lsp, 20 Kasım 2026). Tür denetimi yanlış yazılmış API'leri ve hatalı türleri yakalar, oyun mantığını değil. Bu yüzden yayınlamadan önce Studio'da test et.