Туторіал · Нагороди

Як зробити щоденні нагороди в Roblox Studio

Щоденна нагорода дає гравцям привід відкрити вашу гру завтра, а серія дає привід не пропускати жодного дня. Уся логіка тримається на збереженій позначці часу: коли гравець забрав нагороду востаннє і скільки днів поспіль. Цей гайд надійно зберігає обидва значення, щоб гравець не міг забрати нагороду двічі, перезайшовши в гру або відкривши два сервери, і додає кнопку зі зворотним відліком до наступної нагороди.

Оновлено 20 листопада 2026 р.4 хв читанняАвтор:

Коротко

Зберігайте для кожного гравця два числа в DataStore: last, значення os.time() останнього отримання, і streak. Нагороду можна забрати, коли минуло 24 години. Якщо минуло понад 48 годин, серія починається заново з дня 1; інакше вона зростає на один день і йде по колу 7 днів зі зростаючими нагородами. Робіть перевірку всередині UpdateAsync, щоб рішення і збереження відбувалися разом.

  • Використовуйте os.time() на сервері, а не час, надісланий клієнтом.
  • Усередині UpdateAsync повертайте nil, коли нагороду забрати не можна: збереження скасовується, і нічого не видається.
  • Клієнт лише запитує статус і просить нагороду; відповідає сервер.
На цій сторінці
  1. Як це працює
  2. 1. Сервер
  3. 2. Кнопка
  4. Common errors
  5. With RoCode
  6. Поширені запитання
  7. Джерела та що почитати

Як працюють щоденні нагороди та серії

Що відбувається при отриманні залежно від часу з минулого разу
Час з минулого отриманняРезультат
Менше 24 годинЩе зарано. Кнопка показує зворотний відлік.
Від 24 до 48 годинНагороду можна забрати, серія зростає на один день.
Понад 48 годинНагороду можна забрати, серія починається заново з дня 1.
Після дня 7Наступне отримання це день 1 нового тижня.

os.time() на сервері повертає поточний час Unix у секундах за UTC, тому всі сервери з ним згодні. Годинник на комп'ютері гравця не бере участі, і тому зміна дати на телефоні нічого не дає.

Крок 1: сервер нагород

Увімкніть Enable Studio Access to API Services у Game Settings, Security (плейс має бути опублікований). Потім вставте Script у ServerScriptService з назвою DailyRewards:

Script у ServerScriptService з назвою DailyRewards
-- Script у ServerScriptService з назвою DailyRewards.
-- Одна нагорода раз на 24 години. Якщо забрати знову протягом 48 годин, серія триває,
-- і нагороди зростають щодня протягом тижня, потім тиждень починається заново.
local DataStoreService = game:GetService("DataStoreService")
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local REWARDS = { 50, 75, 100, 150, 200, 300, 500 } -- монети за дні з 1 по 7 серії
local CLAIM_EVERY = 24 * 60 * 60 -- секунди між отриманнями
local STREAK_LOST_AFTER = 48 * 60 * 60 -- пропустили цілий день, і серія починається заново

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

-- День серії для наступного отримання, від 1 до 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)

-- Що показує меню: секунди до наступного отримання (0 = можна зараз) і який це день
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 читає найсвіжіший збережений запис і вирішує всередині оновлення, тому
	-- другий сервер (або другий клік) не може забрати один і той самий день двічі
	local ok, err = pcall(function()
		store:UpdateAsync(tostring(player.UserId), function(old: any)
			-- UpdateAsync може викликати це кілька разів: рахується лише останній виклик
			claimedDay = nil
			local saved = readRecord(old)
			if now - saved.last < CLAIM_EVERY then
				return nil -- ще зарано: повернення nil скасовує збереження
			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

Отримання відбувається всередині функції, переданої в UpdateAsync. Roblox викликає її з найсвіжішим збереженим записом. Якщо ще зарано, функція повертає nil, і Roblox скасовує запис. Інакше вона повертає новий запис, а скрипт запам'ятовує, який день було отримано. Монети додаються лише після того, як UpdateAsync завершиться без помилки. Якщо інший сервер за цей час змінив ключ, Roblox може викликати функцію знову з новішим значенням, тому рішення й ухвалюється всередині неї.

Крок 2: кнопка зі зворотним відліком

Вставте LocalScript у StarterPlayer > StarterPlayerScripts з назвою DailyRewardsMenu:

LocalScript у StarterPlayerScripts з назвою DailyRewardsMenu
-- LocalScript у StarterPlayerScripts з назвою DailyRewardsMenu.
-- Кнопка Daily зі зворотним відліком. Коли нагорода готова, на ній написано 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 -- час os.clock(), коли нагорода буде готова
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

Кнопка один раз питає сервер, скільки чекати, а потім сама веде відлік щосекунди через os.clock(), тому не звертається до сервера щосекунди. Після отримання вона питає знову. Відлік потрібен лише для вигляду: сервер однаково перевіряє час, коли гравець натискає Claim.

Перевірте

  1. Для тесту поставте CLAIM_EVERY рівним 30, а STREAK_LOST_AFTER рівним 60.
  2. Натисніть Play. На кнопці написано «Claim day 1!». Натисніть її: +50 монет.
  3. Кнопка відлічує 30 секунд. Заберіть знову протягом наступних 30 секунд: день 2, +75.
  4. Зачекайте понад хвилину: наступне отримання знову буде днем 1.
  5. Перед публікацією поверніть обидва значення до рядків на 24 і 48 годин.

Поширені помилки та рішення

Стежте за вікном Output у режимі Server.

Кнопка весь час показує Loading...

Запис гравця не завантажився. У Studio увімкніть Enable Studio Access to API Services. В Output помилку видно після «could not load».

При отриманні пише «Come back later», хоча на кнопці було Claim

Збережений запис був новішим, ніж знала кнопка, наприклад після отримання на іншому сервері. Правильна відповідь та, яку дав сервер.

Серія скидається щодня

Гравці забирають нагороду з проміжком понад 48 годин, або STREAK_LOST_AFTER залишився з тестовим значенням.

Монети не додаються

Гравець має мати IntValue Coins у leaderstats, створений серверним скриптом.

Зберіть це з RoCode

Якщо не хочете налаштовувати це вручну, RoCode може зібрати це у відкритому у вас плейсі. RoCode це незалежний ШІ-агент для Roblox Studio, не від Roblox: ви описуєте зміну у веб-чаті, а його плагін для Studio створює скрипти у вашому Explorer.

Ви пишете

Додай щоденні нагороди із серією на 7 днів: монети в дні з 1 по 6 і гем у день 7, кнопку зі зворотним відліком, зі збереженням і перевіркою на сервері.

RoCode робить
  • Може за один крок вставити готовий анімований екран щоденних нагород зі своїх преміум-наборів UI в одній із п'яти тем (candy, neon, gold, blocky, pastel), з робочими серверними скриптами
  • Або пише серверний скрипт і кнопку з цього гайду, підключені до вашої наявної валюти
  • Йому наказано перевіряти компіляцію кожного скрипту через Check Script, і він ставить точки скасування навколо кожного набору змін

Після збирання RoCode може запустити свого тестового робота: він грає у вашу гру в Studio, натискає кнопки й повідомляє PASS або FAIL. Він перевіряє лише те, що сам обрав для тесту, а для 24-годинного таймера потрібен ваш власний тест із короткими значеннями. Як RoCode підключається до Studio.

Поширені запитання

Як зробити щоденні нагороди в Roblox?

Зберігайте час останнього отримання кожного гравця через os.time() на сервері, дозволяйте отримання через 24 години і зберігайте його всередині UpdateAsync до видачі нагороди. Скрипт у кроці 1.

Як зробити серію щоденних входів?

Зберігайте лічильник серії разом із часом отримання. Якщо наступне отримання прийшло протягом 48 годин, додавайте один; якщо пізніше, починайте заново з 1.

Чи можуть гравці обдурити щоденні нагороди, перевівши годинник?

З цим скриптом ні: він використовує лише os.time() сервера.

Може, краще скидати нагороду опівночі?

Можна рахувати календарні дні за UTC замість 24 годин. Ковзні 24 години простіші й однаково працюють для всіх часових поясів.

Джерела та що почитати

Як перевірявся код: кожен скрипт на цій сторінці проходить сувору перевірку типів Luau з визначеннями Roblox API (luau-lsp, 20 листопада 2026 р.). Перевірка типів ловить помилки в назвах API та неправильні типи, але не помилки ігрової логіки, тому протестуйте все в Studio перед публікацією.

Спробуйте RoCode у своїй грі.

Безкоштовні кредити щодня, без картки. Встановіть плагін, опишіть функцію та перевірте, що з'явилося в Studio.