튜토리얼 · 게임 시스템

Roblox Studio로 상점 만들기

Roblox 게임의 상점은 두 가지 일로 나뉩니다. 아이템을 보여 주는 GUI, 그리고 구매가 이루어질지 결정하는 서버 스크립트입니다. 이 가이드에서는 도구를 파는 코인 상점을 위해 두 가지를 모두 만들고, Robux 구매는 어디에 들어가는지도 보여 줍니다.

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

요약

아이템과 가격은 ReplicatedStorage의 ModuleScript에 두고, 창은 ScreenGui, ScrollingFrame, UIGridLayout으로 만든 다음, 각 Buy 버튼이 아이템 id만 넘겨서 RemoteFunction을 호출하게 하세요. 그다음 ServerScriptService의 Script가 직접 가격을 찾고, 플레이어의 Coins를 확인해 차감한 뒤 아이템을 줍니다.

  • 클라이언트가 가격을 보내게 하지 마세요. 누구든 여러분의 리모트를 아무 값으로나 호출할 수 있으므로, 서버는 자기 카탈로그 사본에서 가격을 가져옵니다.
  • 구매한 Tool은 ServerStorage에서 복제해 플레이어의 Backpack(바로 쓰도록)과 StarterGear(리스폰 후에도 돌아오도록)에 넣어 주세요.
  • Robux로 파는 것은 패스와 developer product이며, MarketplaceService로 다룹니다. Roblox는 이것들을 위한 Shop도 자동으로 만들어 주는데, 이는 코인 상점과는 다른 것입니다.
이 페이지의 내용
  1. 작동 방식
  2. 1. 준비
  3. 2. 아이템 카탈로그
  4. 3. 상점 GUI
  5. 4. 서버 구매
  6. 클라이언트 가격을 받지 않는 이유
  7. 5. 테스트
  8. 게임 패스
  9. 구매 저장
  10. Common errors
  11. RoCode로
  12. 자주 묻는 질문
  13. 출처와 더 읽을거리

제대로 작동하는 상점의 구조

일러스트플레이어가 상점을 열고 Flashlight를 25코인에 삽니다. Coins가 200에서 175로 줄고, 버튼이 Owned로 바뀌며, 도구가 핫바에 나타납니다.

실제 게임에서 작동하는 상점은 플레이어의 기기와 서버로 나뉩니다. 기기는 창을 그리고 "검을 사고 싶어요"라고 말합니다. 믿을 수 있는 유일한 쪽인 서버가 그 일이 일어날지 결정합니다. "작동하지 않는" 상점 스크립트나 플레이어가 치트로 뚫는 상점 스크립트는 이 결정을 엉뚱한 쪽에서 내리는 경우가 많습니다.

상점의 다섯 가지 구성 요소
구성 요소위치하는 일
ModuleScript ShopCatalogReplicatedStorage아이템 id, 이름, 가격, 그리고 각 아이템이 주는 Tool. 양쪽 모두 이것을 읽습니다.
RemoteFunction BuyItemReplicatedStorage의 ShopRemotes 폴더구매 요청을 서버로 보내고 답을 다시 가져옵니다.
LocalScript ShopClientStarterPlayerScripts상점 창을 만들고 Buy 버튼이 눌리면 아이템 id를 보냅니다.
Script ShopServiceServerScriptService요청을 확인하고 Coins를 차감한 뒤 Tool을 줍니다.
판매하는 ToolServerStorage의 ShopItems 폴더서버가 복사하는 원본입니다. ServerStorage에 있는 것은 플레이어에게 전송되지 않습니다.
상점이 완성된 상태의 Explorer
ReplicatedStorage
  ShopCatalog ModuleScript new
  ShopRemotes Folder new
    BuyItem RemoteFunction new
ServerStorage
  ShopItems Folder new
    ClassicSword Tool new
      Handle Part
    Flashlight Tool new
    GrappleHook Tool new
    SpeedCoil Tool new
ServerScriptService
  Leaderstats Script
  ShopService Script new
StarterPlayer
  StarterPlayerScripts
    ShopClient LocalScript new

1단계: 코인과 판매할 아이템

상점은 플레이어 leaderstats의 Coins 값을 씁니다. 리더보드 가이드를 따라 했다면 이미 있으니 이 스크립트는 건너뛰어도 됩니다. 아니라면 ServerScriptService에 Leaderstats라는 이름의 Script를 넣으세요. 모두에게 시작 코인 200개를 주므로 바로 구매를 테스트할 수 있습니다.

Script 위치: ServerScriptService 이름: Leaderstats
local Players = game:GetService("Players")

local STARTING_COINS = 200 -- 상점 테스트에 충분한 양; 플레이어가 코인을 벌 수 있게 되면 0으로 바꾸세요

local function setupLeaderstats(player: Player)
	local leaderstats = Instance.new("Folder")
	leaderstats.Name = "leaderstats"

	local coins = Instance.new("IntValue")
	coins.Name = "Coins"
	coins.Value = STARTING_COINS
	coins.Parent = leaderstats

	leaderstats.Parent = player
end

Players.PlayerAdded:Connect(setupLeaderstats)
for _, player in Players:GetPlayers() do
	setupLeaderstats(player)
end

leaderstats 스크립트는 하나만 두세요. 각각 leaderstats 폴더를 만드는 스크립트가 두 개 있으면 플레이어마다 폴더가 두 개 생기고, 상점이 엉뚱한 폴더를 읽을 수 있습니다.

다음으로 스크립트가 찾는 오브젝트를 만드세요. 이름의 대소문자가 중요하니 여기 적힌 그대로 입력하세요.

  1. Explorer에서 ReplicatedStorage에 마우스를 올리고 + 버튼을 눌러 ShopRemotes라는 Folder를 넣으세요. 그 안에 BuyItem이라는 RemoteFunction을 넣으세요.
  2. ServerStorage에 마우스를 올리고 ShopItems라는 Folder를 넣으세요.
  3. ShopItems에 아이템마다 Tool을 하나씩 넣고 이름을 ClassicSword, Flashlight, GrappleHook, SpeedCoil로 지으세요. 첫 테스트라면 Tool 안에 Handle이라는 이름의 고정되지 않은(Anchored 해제) Part 하나면 충분합니다. 이미 가지고 있는 아무 Tool이나 맞는 이름만 붙여도 됩니다. 실제로 피해를 주는 무기는 검 가이드나 총 가이드를 따라 만드세요. 각 가이드에 카탈로그와 연결하는 방법이 나와 있습니다.
  4. 각 Tool을 선택하고 Properties 창에서 CanBeDropped 체크를 해제하세요. 체크되어 있으면 Backspace를 눌렀을 때 도구가 Workspace에 떨어지고, 구매자가 돈을 낸 물건을 아무 플레이어나 주울 수 있습니다.

Tool 하나만으로 시작해도 됩니다. 어떤 아이템의 Tool이 없으면 서버는 그 아이템 판매를 거부하고 이름이 들어간 경고를 출력하므로, 플레이어에게서 아무것도 차감되지 않습니다.

2단계: 카탈로그의 아이템과 가격

카탈로그는 상점이 파는 모든 것의 단 하나뿐인 목록입니다. LocalScript는 카드를 그리려고 이것을 읽고, 서버는 가격을 찾으려고 읽으므로, 가격을 바꾸는 것은 한 곳에서 한 번만 고치면 됩니다.

ReplicatedStorage에 마우스를 올리고 ModuleScript를 넣은 다음, 이름을 ShopCatalog로 바꾸고 내용을 다음으로 교체하세요.

ModuleScript 위치: ReplicatedStorage 이름: ShopCatalog
export type ShopItem = {
	id: string, -- 나중에 데이터 스토어에 저장됨: 플레이어가 이미 가진 아이템이면 바꾸지 마세요
	name: string, -- 카드에 표시됨; 바꿔도 됨
	price: number, -- Coins 단위
	description: string,
	toolName: string, -- 플레이어가 받는 ServerStorage.ShopItems의 Tool
}

-- 카드는 이 순서로 나타남
local items: { ShopItem } = {
	{
		id = "sword",
		name = "Classic Sword",
		price = 50,
		description = "A basic sword for close fights.",
		toolName = "ClassicSword",
	},
	{
		id = "flashlight",
		name = "Flashlight",
		price = 25,
		description = "Lights up dark corners.",
		toolName = "Flashlight",
	},
	{
		id = "grapple",
		name = "Grapple Hook",
		price = 150,
		description = "Reach high ledges.",
		toolName = "GrappleHook",
	},
	{
		id = "speedcoil",
		name = "Speed Coil",
		price = 300,
		description = "Run faster while you hold it.",
		toolName = "SpeedCoil",
	},
}

local byId: { [string]: ShopItem } = {}
for _, item in items do
	byId[item.id] = item
end

local ShopCatalog = {}

ShopCatalog.items = items

-- 이 id의 아이템을 반환하고, 그런 아이템이 없으면 nil
function ShopCatalog.get(id: string): ShopItem?
	return byId[id]
end

-- 플레이어가 아이템을 가지고 있을 때 서버가 true로 설정하는 Player 속성
function ShopCatalog.ownedAttribute(id: string): string
	return "Owns_" .. id
end

return ShopCatalog

각 아이템에는 id와 별도의 표시용 name이 있습니다. 플레이어가 무언가를 가지면 서버는 id를 기록하므로, 나중에 "Classic Sword"의 이름을 바꿔도 저장된 구매가 깨지지 않습니다. 설명은 카드의 텍스트일 뿐이며, Tool이 무엇을 하는지는 Tool 자체의 스크립트가 정합니다.

플레이어는 ReplicatedStorage의 ModuleScript를 읽을 수 있으므로 이 가격은 공개됩니다. 괜찮습니다. 어차피 카드에 적혀 있으니까요. 중요한 점은 클라이언트와 서버가 각자 모듈 사본을 실행한다는 것입니다. 그래서 자기 기기에서 가격을 바꾼 플레이어는 서버에서 아무것도 바꾸지 못합니다.

3단계: 상점 GUI 만들기

이 LocalScript는 창 전체를 코드로 만듭니다. Shop 버튼, 스크롤되는 카드 그리드가 있는 패널, 카탈로그 아이템마다 하나씩인 Buy 버튼, Coins 표시, 그리고 서버 답변을 위한 상태 줄입니다. 모두 코드로 되어 있으니 붙여 넣고 Play를 누르면 됩니다. 창을 직접 배치하고 싶다면 코드 다음의 표에 오브젝트가 모두 정리되어 있습니다.

  1. Explorer에서 StarterPlayer를 펼치고 StarterPlayerScripts에 마우스를 올린 다음 ShopClient라는 LocalScript를 넣으세요.
  2. 내용을 아래 코드로 교체하세요.
LocalScript 위치: StarterPlayerScripts 이름: ShopClient
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

-- ShopCatalog 모듈이 반환하는 것. 엄격한 타입 검사가 우리가 쓰는 필드를 확인하도록
type ShopItem = { id: string, name: string, price: number, description: string, toolName: string }
type Catalog = {
	items: { ShopItem },
	get: (id: string) -> ShopItem?,
	ownedAttribute: (id: string) -> string,
}

local ShopCatalog = require(ReplicatedStorage:WaitForChild("ShopCatalog")) :: Catalog
local buyItem = ReplicatedStorage:WaitForChild("ShopRemotes"):WaitForChild("BuyItem") :: RemoteFunction

local player = Players.LocalPlayer

local COLOURS = {
	panel = Color3.fromRGB(24, 20, 36),
	card = Color3.fromRGB(38, 32, 56),
	accent = Color3.fromRGB(124, 77, 255),
	owned = Color3.fromRGB(70, 66, 84),
	text = Color3.fromRGB(240, 238, 245),
	muted = Color3.fromRGB(170, 165, 185),
	good = Color3.fromRGB(120, 220, 150),
}
local REGULAR = Font.fromEnum(Enum.Font.BuilderSans)
local BOLD = Font.fromEnum(Enum.Font.BuilderSansBold)

local function addCorner(parent: GuiObject, radius: number)
	local corner = Instance.new("UICorner")
	corner.CornerRadius = UDim.new(0, radius)
	corner.Parent = parent
end

local function addPadding(parent: GuiObject, pixels: number)
	local padding = Instance.new("UIPadding")
	padding.PaddingTop = UDim.new(0, pixels)
	padding.PaddingBottom = UDim.new(0, pixels)
	padding.PaddingLeft = UDim.new(0, pixels)
	padding.PaddingRight = UDim.new(0, pixels)
	padding.Parent = parent
end

local function newLabel(parent: GuiObject, text: string, textSize: number, font: Font): TextLabel
	local label = Instance.new("TextLabel")
	label.BackgroundTransparency = 1
	label.Text = text
	label.TextSize = textSize
	label.FontFace = font
	label.TextColor3 = COLOURS.text
	label.TextXAlignment = Enum.TextXAlignment.Left
	label.TextWrapped = true
	label.Parent = parent
	return label
end

local function newButton(parent: GuiObject, text: string): TextButton
	local button = Instance.new("TextButton")
	button.BackgroundColor3 = COLOURS.accent
	button.TextColor3 = COLOURS.text
	button.FontFace = BOLD
	button.TextSize = 18
	button.Text = text
	button.Parent = parent
	addCorner(button, 8)
	return button
end

-- ScreenGui: 상점이 플레이어 화면에 그리는 모든 것을 담음
local gui = Instance.new("ScreenGui")
gui.Name = "ShopGui"
gui.ResetOnSpawn = false -- 캐릭터가 리스폰해도 상점이 남아 있음

-- 왼쪽 가장자리에서 상점을 열고 닫는 버튼
local openButton = Instance.new("TextButton")
openButton.Name = "OpenShop"
openButton.AnchorPoint = Vector2.new(0, 0.5)
openButton.Position = UDim2.new(0, 16, 0.5, 0)
openButton.Size = UDim2.fromOffset(110, 44)
openButton.BackgroundColor3 = COLOURS.accent
openButton.TextColor3 = COLOURS.text
openButton.FontFace = BOLD
openButton.TextSize = 20
openButton.Text = "Shop"
openButton.Parent = gui
addCorner(openButton, 10)

-- 상점 창: 가운데에 있고, 플레이어가 열기 전까지 숨겨져 있음
local panel = Instance.new("Frame")
panel.Name = "Panel"
panel.AnchorPoint = Vector2.new(0.5, 0.5)
panel.Position = UDim2.fromScale(0.5, 0.5)
panel.Size = UDim2.fromScale(0.8, 0.75)
panel.BackgroundColor3 = COLOURS.panel
panel.Visible = false
panel.Parent = gui
addCorner(panel, 14)
addPadding(panel, 12)

local sizeLimit = Instance.new("UISizeConstraint")
sizeLimit.MaxSize = Vector2.new(640, 460) -- 큰 화면에서 창이 너무 커지지 않게 함
sizeLimit.Parent = panel

local title = newLabel(panel, "Shop", 26, BOLD)
title.Size = UDim2.new(0.5, 0, 0, 32)

local coinsLabel = newLabel(panel, "Coins: ...", 20, BOLD)
coinsLabel.AnchorPoint = Vector2.new(1, 0)
coinsLabel.Position = UDim2.new(1, -44, 0, 0)
coinsLabel.Size = UDim2.new(0.5, -44, 0, 32)
coinsLabel.TextXAlignment = Enum.TextXAlignment.Right

local closeButton = newButton(panel, "X")
closeButton.AnchorPoint = Vector2.new(1, 0)
closeButton.Position = UDim2.fromScale(1, 0)
closeButton.Size = UDim2.fromOffset(32, 32)
closeButton.BackgroundColor3 = COLOURS.card

-- 서버의 답변이 여기 표시됨. 예: "You need 20 more coins."
local status = newLabel(panel, "", 18, REGULAR)
status.AnchorPoint = Vector2.new(0, 1)
status.Position = UDim2.fromScale(0, 1)
status.Size = UDim2.new(1, 0, 0, 24)
status.TextColor3 = COLOURS.muted

-- ScrollingFrame: 카드가 다 들어가지 않을 때 스크롤되는 영역
local list = Instance.new("ScrollingFrame")
list.Name = "Items"
list.Position = UDim2.fromOffset(0, 44)
list.Size = UDim2.new(1, 0, 1, -76)
list.BackgroundTransparency = 1
list.BorderSizePixel = 0
list.ScrollBarThickness = 6
list.ScrollingDirection = Enum.ScrollingDirection.Y
list.CanvasSize = UDim2.new() -- 0에서 시작; AutomaticCanvasSize가 카드에 맞게 늘려 줌
list.AutomaticCanvasSize = Enum.AutomaticSize.Y
list.Parent = panel

-- UIGridLayout: 카드를 행으로 배치하고 다음 행으로 넘김
local grid = Instance.new("UIGridLayout")
grid.CellSize = UDim2.fromOffset(180, 200)
grid.CellPadding = UDim2.fromOffset(12, 12)
grid.SortOrder = Enum.SortOrder.LayoutOrder
grid.Parent = list

local function makeCard(item: ShopItem, order: number)
	local card = Instance.new("Frame")
	card.Name = item.id
	card.LayoutOrder = order
	card.BackgroundColor3 = COLOURS.card
	card.Parent = list
	addCorner(card, 10)
	addPadding(card, 10)

	local nameLabel = newLabel(card, item.name, 20, BOLD)
	nameLabel.Size = UDim2.new(1, 0, 0, 26)

	local description = newLabel(card, item.description, 15, REGULAR)
	description.Position = UDim2.fromOffset(0, 30)
	description.Size = UDim2.new(1, 0, 1, -80)
	description.TextColor3 = COLOURS.muted
	description.TextYAlignment = Enum.TextYAlignment.Top

	local buyButton = newButton(card, "")
	buyButton.Name = "Buy"
	buyButton.AnchorPoint = Vector2.new(0, 1)
	buyButton.Position = UDim2.fromScale(0, 1)
	buyButton.Size = UDim2.new(1, 0, 0, 40)

	local ownedAttribute = ShopCatalog.ownedAttribute(item.id)
	local busy = false

	local function refresh()
		if player:GetAttribute(ownedAttribute) == true then
			buyButton.Text = "Owned"
			buyButton.BackgroundColor3 = COLOURS.owned
			buyButton.AutoButtonColor = false
		else
			buyButton.Text = `Buy: {item.price} coins`
			buyButton.BackgroundColor3 = COLOURS.accent
			buyButton.AutoButtonColor = true
		end
	end

	buyButton.Activated:Connect(function()
		if busy or player:GetAttribute(ownedAttribute) == true then
			return
		end
		busy = true
		buyButton.Text = "Buying..."

		-- 아이템 id만 보냅니다. 가격은 서버가 직접 찾습니다.
		local ok, bought, message = pcall(function()
			return buyItem:InvokeServer(item.id)
		end)
		if ok and type(message) == "string" then
			status.Text = message
			status.TextColor3 = if bought == true then COLOURS.good else COLOURS.muted
		else
			status.Text = "The shop did not answer. Try again."
			status.TextColor3 = COLOURS.muted
		end

		busy = false
		refresh()
	end)

	-- 구매가 성공하면(또는 저장된 아이템이 로드되면) 서버가 이 속성을 설정함
	player:GetAttributeChangedSignal(ownedAttribute):Connect(refresh)
	refresh()
end

for index, item in ShopCatalog.items do
	makeCard(item, index)
end

openButton.Activated:Connect(function()
	panel.Visible = not panel.Visible
	status.Text = ""
end)

closeButton.Activated:Connect(function()
	panel.Visible = false
end)

gui.Parent = player:WaitForChild("PlayerGui")

-- 플레이어의 코인을 표시합니다. 실제 값은 서버에 있고, 여기서는 보여 주기만 합니다.
local leaderstats = player:WaitForChild("leaderstats")
local coins = leaderstats:WaitForChild("Coins") :: IntValue
local function updateCoins()
	coinsLabel.Text = `Coins: {coins.Value}`
end
coins.Changed:Connect(updateCoins)
updateCoins()

버튼에는 MouseButton1Click이 아니라 Activated를 씁니다. 마우스 클릭, 휴대폰 터치, 게임패드의 A 버튼이나 X 버튼에 모두 반응합니다.

맨 위의 type 정의는 ShopCatalog가 반환하는 것을 설명하므로, 엄격한 타입 검사가 item.prise 같은 필드 오타를 잡아냅니다. 게임이 실행될 때는 아무것도 바꾸지 않습니다.

GUI 오브젝트와 중요한 속성
오브젝트상점에서의 역할주요 속성
ScreenGui화면에 그려지는 모든 것을 담음ResetOnSpawn을 false로 해서 상점이 리스폰 후에도 남도록
Frame창과 각 아이템 카드AnchorPoint 0.5, 0.5와 Position 0.5, 0.5로 창을 가운데에
UISizeConstraint큰 화면에서 창 크기를 제한MaxSize 640 x 460
ScrollingFrame카드가 다 들어가지 않을 때 스크롤CanvasSize 0과 AutomaticCanvasSize Y로 스크롤 영역이 카드와 함께 늘어나도록
UIGridLayout카드를 행으로 놓고 다음 행으로 넘김CellSize 180 x 200, CellPadding 12, SortOrder LayoutOrder
UICorner모서리를 둥글게CornerRadius 8~14픽셀
UIPadding안쪽 여백각 방향 10~12픽셀
TextButtonShop, 닫기, Buy 버튼Activated 이벤트

창을 직접 그리고 싶다면 같은 오브젝트를 이 속성들로 StarterGui에 만드세요. 거기서도 ScreenGui의 ResetOnSpawn을 false로 하고, LocalScript가 카탈로그 아이템마다 복제할 템플릿으로 카드 하나를 남겨 두세요. 그러면 스크립트는 카드를 채우고 버튼을 연결하기만 합니다. 다음 단계의 구매 로직은 바뀌지 않습니다.

게임이 메인 메뉴로 시작한다면, 그 가이드에 ShopClient에 추가할 한 줄이 있어서 플레이어가 Play를 누른 뒤에만 Shop 버튼이 나타나게 할 수 있습니다. 상인과 대화해서 상점이 열리게 하려면 NPC 대화 가이드에서 ShopClient에게 창을 열라고 알리는 OpenShop 동작을 추가하는 방법을 보여 주며, 구매는 여전히 상점의 서버 검사를 거칩니다.

4단계: 서버에서 확인하고 구매하기

이 Script가 구매가 일어날 수 있는 유일한 곳입니다. 아이템 id를 받아 확인하고, 가격을 찾고, 플레이어의 Coins를 확인한 다음, 코인을 차감하고 Tool을 줍니다. Buy 버튼에는 true 또는 false와 표시할 메시지로 답합니다.

ServerScriptService에 마우스를 올리고 ShopService라는 Script를 넣은 뒤 다음을 붙여 넣으세요.

Script 위치: ServerScriptService 이름: ShopService
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")

-- ShopCatalog 모듈이 반환하는 것. 엄격한 타입 검사가 우리가 쓰는 필드를 확인하도록
type ShopItem = { id: string, name: string, price: number, description: string, toolName: string }
type Catalog = {
	items: { ShopItem },
	get: (id: string) -> ShopItem?,
	ownedAttribute: (id: string) -> string,
}

local ShopCatalog = require(ReplicatedStorage:WaitForChild("ShopCatalog")) :: Catalog
local buyItem = ReplicatedStorage:WaitForChild("ShopRemotes"):WaitForChild("BuyItem") :: RemoteFunction
local shopItems = ServerStorage:WaitForChild("ShopItems")

local COOLDOWN_SECONDS = 0.5
local lastRequest: { [Player]: number } = {}

local function giveTool(player: Player, template: Tool)
	-- Backpack: 플레이어가 도구를 바로 쓸 수 있음
	local backpack = player:FindFirstChildOfClass("Backpack")
	if backpack then
		template:Clone().Parent = backpack
	end
	-- StarterGear: 캐릭터가 나타날 때마다 Roblox가 다시 Backpack으로 복사함
	local starterGear = player:FindFirstChildOfClass("StarterGear")
	if starterGear then
		template:Clone().Parent = starterGear
	end
end

local function onBuyItem(player: Player, itemId: unknown): (boolean, string)
	-- 1. 클라이언트는 아이템 id만 보내므로 문자열이어야 함
	if type(itemId) ~= "string" then
		return false, "That item does not exist."
	end

	-- 2. 더블 클릭과 스크립트가 보내는 요청 폭주를 무시
	local now = os.clock()
	local last = lastRequest[player]
	if last and now - last < COOLDOWN_SECONDS then
		return false, "Slow down a little."
	end
	lastRequest[player] = now

	-- 3. 서버 자신의 카탈로그 사본에서 아이템을 찾음
	local item = ShopCatalog.get(itemId)
	if not item then
		return false, "That item does not exist."
	end

	local ownedAttribute = ShopCatalog.ownedAttribute(item.id)
	if player:GetAttribute(ownedAttribute) == true then
		return false, "You already own this."
	end

	local template = shopItems:FindFirstChild(item.toolName)
	if not (template and template:IsA("Tool")) then
		warn(`ShopItems has no Tool named {item.toolName} for shop item {item.id}`)
		return false, "This item is not available right now."
	end

	local leaderstats = player:FindFirstChild("leaderstats")
	local coins = leaderstats and leaderstats:FindFirstChild("Coins")
	if not (coins and coins:IsA("IntValue")) then
		return false, "Your coins have not loaded yet."
	end

	-- 4. 가격은 카탈로그에서 가져오며 절대 클라이언트에게서 받지 않음
	if coins.Value < item.price then
		return false, `You need {item.price - coins.Value} more coins.`
	end

	-- 5. 코인을 차감한 뒤 아이템을 줌. 여기서는 아무것도 실행을 양보하지 않으므로, 같은 플레이어의 두 요청이
	-- 이 코드가 끝나기 전에 위의 검사를 둘 다 통과할 수 없음.
	coins.Value -= item.price
	giveTool(player, template)
	player:SetAttribute(ownedAttribute, true)

	return true, `You bought {item.name}.`
end

buyItem.OnServerInvoke = onBuyItem

Players.PlayerRemoving:Connect(function(player: Player)
	lastRequest[player] = nil
end)

소유 여부는 Owns_sword 같은 Player 속성으로 저장됩니다. 서버가 설정한 속성은 플레이어 기기로 복제되므로 LocalScript가 카드를 "Owned"로 바꿀 수 있습니다. 플레이어가 자기 사본에서 바꾼 것은 서버에 닿지 않습니다.

Tool은 두 곳에 들어갑니다. Backpack의 사본은 바로 핫바에 나타납니다. StarterGear의 사본은 캐릭터가 나타날 때마다 Roblox가 새 Backpack에 넣어 줍니다. 이것이 없으면 구매한 아이템은 플레이어가 처음 죽을 때 사라집니다.

클라이언트가 가격을 절대 보내지 않는 이유

플레이어의 기기에 있는 것은 모두 그 플레이어가 바꿀 수 있습니다. 치터는 자기 게임 사본에서 자기 코드를 실행합니다. 여러분의 LocalScript를 읽고, GUI를 바꾸고, BuyItem:InvokeServer()를 어떤 인수로든 몇 번이든 호출할 수 있습니다. Roblox의 보안 가이드는 리모트가 받는 모든 것의 타입과 값을 둘 다 확인하라고 하며, 예시가 바로 상점입니다.

서버가 클라이언트를 믿으면 생기는 일
치터가 보내는 것서버가 그것을 믿었다면ShopService가 하는 일
가격 0모든 아이템이 무료무시합니다. 가격은 카탈로그에서 가져옵니다.
가격 -1000Coins.Value -= -1000으로 코인 1,000개를 얻음무시합니다.
가격 대신 NaNNaN과의 비교는 모두 거짓이므로 "코인이 부족함" 검사가 절대 작동하지 않음무시합니다.
카탈로그에 없는 id, 또는 문자열 대신 테이블스크립트 오류, 또는 팔 생각이 없던 아이템"That item does not exist."라고 답합니다.
초당 수백 건의 요청서버에 부하가 걸리고, 검사의 허점이 수백 번 작동함플레이어당 0.5초에 한 건까지만 처리합니다.
자기 화면에서 바꾼 Coins가지고 있지 않은 코인으로 구매아예 보지 못합니다. 서버는 자신의 Coins 값만 읽습니다.

이 규칙은 여러분이 작성하는 모든 리모트에 적용됩니다. 아이템 id나 슬롯 번호처럼 플레이어가 고른 것을 보내고, 그것이 얼마인지나 무엇을 받아야 하는지는 절대 보내지 마세요. RemoteEvent 가이드에서 리모트 인수 검사를 더 자세히 다룹니다.

5단계: 상점 테스트하기

  1. Play를 누르세요. 왼쪽에 Shop 버튼이 나타납니다. 열고 Flashlight를 사세요. Coins가 25 줄고, 도구가 핫바에 나타나며, 버튼이 Owned로 바뀝니다.
  2. 300짜리 Speed Coil을 사 보세요. 상태 줄에 코인이 얼마나 더 필요한지 표시되고, 아무것도 차감되지 않습니다.
  3. 게임 내 메뉴에서 캐릭터를 리셋하세요. StarterGear의 사본 덕분에 Flashlight가 새 Backpack에 돌아옵니다.
  4. 테스트 중에 코인을 더하려면 Client/Server 전환 버튼을 눌러 Server로 바꾸고, Explorer에서 Players, 자기 이름, leaderstats, Coins를 찾아 Properties 창에서 Value를 바꾸세요. Client 모드에서 같은 일을 하면 자기 화면만 바뀌는데, 이것이 바로 서버가 무시하는 종류의 변경입니다.

버튼이 "The shop did not answer"라고 답하면 Studio의 Window 메뉴에서 Output 창을 열고 ShopService에서 나온 빨간 오류를 찾으세요. 버튼이 "Buying..."에서 멈춰 있다면 ShopService가 실행되지 않았거나 오브젝트를 기다리다 멈춘 것입니다. 자주 발생하는 오류를 보세요.

Robux로 게임 패스 판매하기

코인은 여러분만의 화폐이므로 위의 상점이 모든 구매를 직접 결정합니다. 플레이어가 Robux로 사는 것은 다르게 작동합니다. 게임 패스는 한 번 사면 영원히 남고(VIP 혜택, 영구 도구), developer product는 몇 번이고 다시 살 수 있습니다(코인 묶음, 레벨 건너뛰기). 둘 다 Roblox의 MarketplaceService를 거치며, 결제는 여러분의 스크립트가 아니라 Roblox가 받습니다.

이 가이드에서 가져갈 규칙은 두 가지입니다. 구매 창은 클라이언트의 버튼으로 띄우고, 보상은 Roblox가 구매를 확인했거나 플레이어가 이미 패스를 가지고 있을 때 서버에서만 주세요. 게임 패스 스크립트 가이드가 이것을 전부 다룹니다. 입장 시 소유 확인, 구매 창, VIP 문 같은 혜택, 그리고 패스 대신 developer product가 나은 경우입니다. 가격을 정할 때는 무료 Robux 수수료 계산기가 Roblox 몫을 뗀 뒤 패스나 developer product가 얼마를 벌어 주는지 보여 줍니다.

플레이어 구매 저장하기

지금까지 만든 것은 한 세션 동안만 유지됩니다. 데이터 스토어로 저장하기 전까지는 플레이어가 나가면 코인과 구매한 아이템이 초기화됩니다. 여기서 저장 코드를 반복하지 않도록 DataStore 튜토리얼(또는 더 짧은 버전인 리더보드 가이드의 3단계)을 따라 하고, 상점의 규칙을 기억하세요.

  • 아이템 id를, 예를 들어 { "sword", "flashlight" }처럼 Coins 값과 같은 테이블에 저장하세요. 그러면 한 번의 저장으로 쓴 코인과 산 아이템이 함께 기록됩니다. Tool 같은 인스턴스는 데이터 스토어에 넣을 수 없습니다.
  • 데이터가 로드되면 저장된 id를 하나씩 돌면서 카탈로그에 더 이상 없는 것은 건너뛰고, 각 Owns_ 속성을 설정한 뒤 giveTool과 같은 방식으로 Tool을 주세요. 상점 창은 이 속성들을 듣고 있으므로 저절로 갱신됩니다.
  • 패스 소유 여부는 저장할 필요가 없습니다. UserOwnsGamePassAsync가 플레이어가 들어올 때마다 Roblox에 물어봅니다.
  • 데이터가 로드되지 않은 플레이어는 절대 저장하지 마세요. 그렇지 않으면 로드 실패 때문에 구매 목록이 빈 목록으로 덮어써질 수 있습니다.

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

상점이 이상하게 동작하면 먼저 이것을 확인하세요. 가장 먼저 Output 창(Window 메뉴, 그다음 Output)을 여세요. 스크립트 오류는 스크립트와 줄 번호를 알려 줍니다.

Infinite yield possible on 'ReplicatedStorage:WaitForChild("ShopRemotes")'

스크립트가 정확히 그 이름으로 존재하지 않는 오브젝트를 기다리고 있습니다. ShopRemotes, BuyItem, ShopCatalog, ShopItems의 철자와 대문자를 확인하고, ShopItems가 ReplicatedStorage가 아니라 ServerStorage에 있는지 확인하세요. 스크립트 오류 가이드에서 이 경고를 자세히 다룹니다.

Buy 버튼이 "Buying..."에서 멈추고 응답하지 않음

서버에서 아무도 BuyItem.OnServerInvoke를 설정하지 않았기 때문에, Roblox가 설정될 때까지 요청을 붙잡고 있습니다. ShopService가 LocalScript가 아니라 Script이고 ServerScriptService에 있는지 확인하고, Output에서 ShopService가 낸 Infinite yield possible 경고를 찾아보세요. 이 경고는 스크립트가 ShopCatalog, ShopRemotes, ShopItems를 기다리다 멈췄다는 뜻입니다.

Buy 버튼에 "The shop did not answer"가 표시됨

서버 호출이 답을 돌려주지 못하고 실패했습니다. 흔한 원인은 요청을 처리하는 도중 ShopService 안에서 난 오류이므로, Output에서 ShopService의 빨간 오류를 찾으세요. 줄 번호가 나와 있습니다.

버튼에 "This item is not available right now"가 표시됨

서버가 ServerStorage, ShopItems 안에서 그 아이템의 toolName을 가진 Tool을 찾지 못했습니다. Output에 서버가 찾던 정확한 이름이 들어간 경고가 있습니다.

도구를 샀는데 캐릭터가 들지 못하거나 끼어서 움직이지 못함

Tool 바로 안에는 Handle이라는 이름의 파트가 정확히 하나 있어야 하고, 어떤 파트도 Anchored되어 있으면 안 됩니다. 손에 들 필요가 없는 도구라면 대신 RequiresHandle 체크를 해제하세요.

내 화면에서는 코인이 줄었는데 다른 사람에게는 그대로임

구매가 LocalScript에서 일어났기 때문에 여러분의 기기만 바뀌었습니다. 4단계처럼 코인 차감과 Tool 지급을 서버 Script로 옮기세요.

다시 접속하면 구매한 아이템이 사라짐

아직 아무것도 저장되지 않습니다. 구매 저장을 보세요.

RoCode로 만들기

이 모든 것을 직접 만들고 싶지 않다면 RoCode가 지금 열려 있는 플레이스 안에 만들어 줄 수 있습니다. RoCode는 독립적인 AI 코딩 에이전트입니다. 웹 채팅에서 기능을 설명하면 Roblox Studio 플러그인이 Explorer에 스크립트, 리모트, GUI를 만들어 주므로 채팅 창에서 코드를 복사할 필요가 없습니다.

입력하는 내용

코인 상점을 추가해 줘. Shop 버튼을 누르면 도구 네 개가 그리드로 열리고, 가격은 내 leaderstats의 Coins로 표시돼. 서버가 가격을 확인하고 도구를 Backpack과 StarterGear에 넣어 줘야 해.

RoCode가 하는 일
  • Search Scripts와 Read Script로 플레이스를 살펴서 이미 있는 leaderstats와 상점 코드를 찾을 수 있으므로, 값을 하나 더 추가하는 대신 기존 Coins 값을 사용합니다
  • Build UI로 창의 기본 틀을 만들 수 있습니다. 상점 레이아웃에는 자리 표시용 카드와, 마우스 오버 효과 및 Close 버튼을 위한 LocalScript가 함께 들어 있으며, 구매 로직은 별도의 스크립트로 작성됩니다
  • Create Instance로 RemoteFunction을 만들고, Create Script로 카탈로그 ModuleScript, 서버 Script, LocalScript를 작성합니다
  • Check Script로 각 스크립트가 Studio에서 컴파일되는지 확인하고(타입 검사나 스크립트 실행은 하지 않습니다), 변경 묶음 하나하나가 Studio의 실행 취소 지점이 됩니다

패스는 여전히 Creator Hub에서 직접 만들어야 합니다. RoCode는 패스와 developer product를 만들 수 없기 때문입니다. 구매 테스트도 직접 해야 합니다. 플러그인 3.9 이상에서는 RoCode가 짧은 플레이테스트를 실행하고 오류를 읽을 수 있고, 플러그인 3.9.15 이상에서는 테스트 캐릭터가 Shop 버튼과 Buy 버튼을 누를 수 있지만, 스스로 테스트하기로 고른 것만 확인합니다. 상점은 보통 핵심 게임플레이와 저장 다음에 만듭니다. RoCode로 게임을 만드는 단계별 과정에서 상점이 들어갈 자리를 보여 줍니다. RoCode가 Studio에 연결되는 방식.

자주 묻는 질문

Roblox의 Buy 버튼에는 RemoteEvent와 RemoteFunction 중 무엇이 좋나요?

서버가 확인한다면 둘 다 괜찮습니다. RemoteFunction은 버튼이 서버 답변을 기다렸다가 보여 줄 수 있어서 이 가이드에서 사용하며, Roblox 보안 가이드의 상점 예시도 RemoteFunction을 씁니다. 클라이언트에서만 호출하세요. InvokeClient를 호출하는 서버는 클라이언트가 끝내 답하지 않으면 영원히 기다릴 수 있습니다. RemoteEvent 가이드에서 두 방식을 비교합니다.

버튼 대신 NPC로 상점을 열려면 어떻게 하나요?

NPC의 파트, 예를 들어 HumanoidRootPart에 ProximityPrompt를 넣고, 서버 Script에서 그 Triggered 이벤트를 듣다가 해당 플레이어에게 RemoteEvent를 보내 LocalScript가 패널을 보여 주게 하세요. NPC 근처에서만 살 수 있게 하려면 BuyItem 처리기 안에서 NPC와의 거리도 확인하세요. 클라이언트는 어디서든 리모트를 호출할 수 있기 때문입니다.

여러 번 살 수 있는 아이템은 어떻게 파나요?

그런 아이템은 "이미 가지고 있음" 검사를 건너뛰고, Tool 대신 셀 수 있는 것을 주세요. 예를 들어 물약 개수를 세는 IntValue에 1을 더하는 식입니다. 가격 조회와 코인 확인은 그대로 두세요.

캐릭터가 리스폰하면 왜 상점이 사라지나요?

그 ScreenGui의 ResetOnSpawn이 기본값인 true로 되어 있어서 Roblox가 리스폰 때 삭제합니다. 3단계의 스크립트처럼 false로 설정하세요.

무료 상점 GUI 템플릿을 써도 되나요?

네, Buy 버튼이 아이템 id만 보내고 실제 구매가 ShopService 같은 서버 Script에서 이루어진다면 어떤 레이아웃이든 괜찮습니다. 템플릿을 쓰기 전에 LocalScript에서 코인을 차감하거나 아이템을 주고 있지 않은지 확인하세요.

출처와 더 읽을거리

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

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

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