튜토리얼 · 보상

Roblox Studio에서 일일 보상 만들기

일일 보상은 플레이어가 내일도 게임을 열 이유가 되고, 연속 기록은 하루도 빠지지 않을 이유가 됩니다. 모든 로직은 저장된 타임스탬프 하나에 달려 있습니다. 플레이어가 마지막으로 보상을 받은 시각과 며칠 연속으로 받았는지입니다. 이 가이드는 두 값을 안전하게 저장해서 플레이어가 다시 접속하거나 서버 두 개를 열어도 보상을 두 번 받을 수 없게 하고, 다음 보상까지 남은 시간을 보여 주는 버튼을 추가합니다.

업데이트: 2026년 11월 20일읽는 데 3분작성:

요약

플레이어마다 숫자 두 개를 DataStore에 저장하세요. 마지막 수령 시점의 os.time() 값인 last와 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단계: 보상 서버

Game Settings의 Security에서 Enable Studio Access to API Services를 켜세요(플레이스가 게시되어 있어야 합니다). 그런 다음 ServerScriptService에 DailyRewards라는 이름의 Script를 넣으세요:

Script 위치: ServerScriptService 이름: DailyRewards
-- ServerScriptService 안의 DailyRewards라는 이름의 Script.
-- 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단계: 남은 시간을 보여 주는 버튼

StarterPlayer > StarterPlayerScripts에 DailyRewardsMenu라는 이름의 LocalScript를 넣으세요:

LocalScript 위치: StarterPlayerScripts 이름: DailyRewardsMenu
-- StarterPlayerScripts 안의 DailyRewardsMenu라는 이름의 LocalScript.
-- 남은 시간을 보여 주는 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분 넘게 기다리면 다음 수령은 다시 1일차가 됩니다.
  5. 게시하기 전에 두 값을 24시간과 48시간짜리 줄로 되돌리세요.

자주 발생하는 오류와 해결 방법

Server 모드에서 Output 창을 지켜보세요.

버튼에 계속 Loading...이 표시됩니다

플레이어의 기록이 불러와지지 않았습니다. Studio에서 Enable Studio Access to API Services를 켜세요. Output에서 "could not load" 뒤에 오류가 보입니다.

버튼에 Claim이 표시됐는데 받으려 하면 "Come back later"가 나옵니다

저장된 기록이 버튼이 알던 것보다 더 새로웠습니다. 예를 들어 다른 서버에서 보상을 받은 뒤라면 그렇습니다. 맞는 답은 서버가 준 답입니다.

연속 기록이 매일 초기화됩니다

플레이어가 48시간보다 긴 간격으로 보상을 받고 있거나, STREAK_LOST_AFTER가 테스트 값으로 남아 있습니다.

코인이 늘지 않습니다

플레이어의 leaderstats 안에 서버 스크립트가 만든 IntValue Coins가 있어야 합니다.

RoCode로 만들어 보기

직접 설정하고 싶지 않다면 RoCode가 지금 열려 있는 플레이스에 만들어 줄 수 있습니다. RoCode는 Roblox와 무관한 독립 제품으로, Roblox Studio용 AI 에이전트입니다. 웹 채팅에서 변경할 내용을 설명하면 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을 더하고, 그보다 늦으면 1부터 다시 시작합니다.

플레이어가 시계를 바꿔서 일일 보상을 속일 수 있나요?

이 스크립트로는 불가능합니다. 서버의 os.time()만 쓰기 때문입니다.

자정에 보상을 초기화하는 편이 낫지 않나요?

24시간 대신 UTC 기준 달력 날짜로 셀 수도 있습니다. 24시간 기준이 더 간단하고 모든 시간대에서 똑같이 작동합니다.

출처와 더 읽을거리

코드 검증 방법: 이 페이지의 모든 스크립트는 Roblox API 정의를 적용한 Luau의 엄격한 타입 검사기(luau-lsp, 2026년 11월 20일)를 통과합니다. 타입 검사는 잘못 쓴 API 이름과 잘못된 타입을 찾아내지만 게임 로직의 오류는 찾지 못하므로, 게시하기 전에 Studio에서 직접 테스트하세요.

내 게임에서 RoCode를 사용해 보세요.

매일 무료 크레딧, 카드 등록 없이 시작합니다. 플러그인을 설치하고, 원하는 기능을 설명한 뒤, Studio에 만들어진 결과를 확인하세요.