Туторіал · Ігрові системи

Як зробити магазин у Roblox Studio

Магазин у грі Roblox складається з двох задач: GUI, який показує предмети, і серверного скрипта, який вирішує, чи відбудеться покупка. У цьому гайді ми збираємо і те, і інше для магазину за монети, що продає інструменти, і показуємо, де місце покупкам за Robux.

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

Коротко

Зберігайте предмети й ціни в ModuleScript у ReplicatedStorage, зберіть вікно з ScreenGui, ScrollingFrame і UIGridLayout, і нехай кожна кнопка Buy викликає RemoteFunction, передаючи лише id предмета. Далі Script у ServerScriptService сам знаходить ціну, перевіряє й списує Coins гравця та видає предмет.

  • Ніколи не дозволяйте клієнту надсилати ціну. Будь-хто може викликати ваші ремоути з будь-якими значеннями, тому сервер бере ціну зі своєї копії каталогу.
  • Куплений Tool видавайте клонуванням із ServerStorage у Backpack гравця (щоб користуватися одразу) і в StarterGear (щоб він повернувся після респавну).
  • Те, що продається за Robux, це паси та developer products, з ними працює 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 ShopCatalogReplicatedStorageId предметів, назви, ціни і Tool, який дає кожен із них. Його читають обидві сторони.
RemoteFunction BuyItemReplicatedStorage, у папці ShopRemotesНесе запит на покупку на сервер і відповідь назад.
LocalScript ShopClientStarterPlayerScriptsЗбирає вікно магазину й надсилає id предмета, коли натиснуто кнопку Buy.
Script ShopServiceServerScriptServiceПеревіряє запит, списує Coins і видає Tool.
Tools, які ви продаєтеServerStorage, у папці 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: Монети та предмети на продаж

Магазин витрачає значення Coins у leaderstats гравця. Якщо ви проходили гайд про таблицю лідерів, воно у вас уже є, і цей скрипт можна пропустити. Інакше вставте Script у ServerScriptService з іменем Leaderstats. Він дає кожному 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, натисніть кнопку + і вставте Folder з іменем ShopRemotes. Усередину неї вставте RemoteFunction з іменем BuyItem.
  2. Наведіть курсор на ServerStorage і вставте Folder з іменем ShopItems.
  3. Покладіть у ShopItems по Tool на кожен предмет, з іменами ClassicSword, Flashlight, GrappleHook і SpeedCoil. Для першого тесту в Tool достатньо одного незаанкереного Part з іменем Handle. Підійде й будь-який Tool, який у вас уже є: дайте йому потрібне ім'я. Зброю, яка справді завдає шкоди, зберіть за гайдом про меч або гайдом про зброю; у кожному написано, як пов'язати її з каталогом.
  4. Виділіть кожен Tool і зніміть галочку CanBeDropped у вікні Properties. Коли вона стоїть, натискання 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, -- Tool у ServerStorage.ShopItems, який отримує гравець
}

-- Картки з'являються в такому порядку
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

-- Атрибут Player, який сервер ставить у true, коли предмет є в гравця
function ShopCatalog.ownedAttribute(id: string): string
	return "Owns_" .. id
end

return ShopCatalog

У кожного предмета є id і окремо відображуване name. Сервер записує саме id, коли щось є в гравця, тому "Classic Sword" можна потім перейменувати, не ламаючи збережені покупки. Описи це лише текст на картці; що робить Tool, вирішують його власні скрипти.

Гравці можуть прочитати ModuleScript у ReplicatedStorage, тож ці ціни публічні. Це нормально: вони й так написані на картках. Важливо те, що клієнт і сервер запускають кожен свою копію модуля, тому гравець, який змінив ціни у себе на пристрої, нічого не змінює на сервері.

Крок 3: Збираємо GUI магазину

Цей LocalScript збирає все вікно в коді: кнопку Shop, панель із сіткою карток, що прокручується, по кнопці Buy на кожен предмет каталогу, лічильник Coins і рядок статусу для відповідей сервера. Оскільки все зроблено кодом, його можна вставити й натиснути Play. У таблиці після нього перелічено кожен об'єкт, якщо ви хочете розкласти вікно вручну.

  1. В Explorer розгорніть StarterPlayer, наведіть курсор на StarterPlayerScripts і вставте LocalScript з іменем ShopClient.
  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() -- починається з нуля; 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()

Кнопки використовують Activated, а не MouseButton1Click: воно спрацьовує на клік мишею, на дотик на телефоні й на кнопку A або хрестик на геймпаді.

Визначення type угорі описують, що повертає ShopCatalog, щоб строга перевірка типів зловила одруківку в полі, наприклад item.prise. Коли гра запущена, вони нічого не змінюють.

Об'єкти GUI та важливі властивості
Об'єктЗадача в магазиніГоловні властивості
ScreenGuiЗберігає все, що намальовано на екраніResetOnSpawn false, щоб магазин пережив респавн
FrameВікно і кожна картка предметаAnchorPoint 0.5, 0.5 і Position 0.5, 0.5, щоб вікно було по центру
UISizeConstraintОбмежує вікно на великих екранахMaxSize 640 на 460
ScrollingFrameПрокручується, коли карток більше, ніж вміщуєтьсяCanvasSize 0 і AutomaticCanvasSize Y, щоб область прокручування росла разом із картками
UIGridLayoutСтавить картки рядами й переносить їхCellSize 180 на 200, CellPadding 12, SortOrder LayoutOrder
UICornerЗаокруглює кутиCornerRadius від 8 до 14 пікселів
UIPaddingВнутрішні відступиВід 10 до 12 пікселів з кожного боку
TextButtonКнопки Shop, закриття і BuyПодія Activated

Якщо хочете намалювати вікно вручну, зберіть ті самі об'єкти в StarterGui з цими властивостями, там теж поставте ResetOnSpawn у ScreenGui в false і залиште одну картку як шаблон, який LocalScript клонує для кожного предмета каталогу. Тоді скрипт лише заповнює картки й підключає кнопки. Логіка покупки в наступному кроці не змінюється.

Якщо ваша гра починається з головного меню, у тому гайді є один рядок, який треба додати в ShopClient, щоб кнопка Shop з'являлася лише після того, як гравець натиснув Play. Щоб магазин відкривався розмовою з продавцем, гайд про діалоги з NPC показує, як додати дію OpenShop, яка наказує ShopClient відкрити вікно, а покупки так само проходять через серверні перевірки магазину.

Крок 4: Перевірка й покупка на сервері

Цей Script єдине місце, де може відбутися покупка. Він отримує id предмета, перевіряє його, знаходить ціну, перевіряє Coins гравця, потім списує монети й видає Tool. Кнопці Buy він відповідає true або false і повідомленням для показу.

Наведіть курсор на ServerScriptService, вставте Script з іменем ShopService і вставте в нього це:

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)

Володіння зберігається як атрибут Player, наприклад Owns_sword. Атрибути, які ставить сервер, реплікуються на пристрій гравця, тому LocalScript може перемкнути картку на "Owned". Зміна, яку гравець робить у своїй копії, до сервера не доходить.

Tool потрапляє у два місця. Копія в Backpack одразу з'являється в хотбарі. Копію в StarterGear Roblox кладе в новий Backpack щоразу, коли з'являється персонаж. Без неї куплений предмет зникне під час першої ж смерті гравця.

Чому клієнт ніколи не надсилає ціну

Усе, що знаходиться на пристрої гравця, цей гравець може змінити. Чітери запускають свій код у своїй копії гри: вони можуть читати ваші LocalScript, змінювати GUI і викликати BuyItem:InvokeServer() з будь-якими аргументами скільки завгодно разів. Гайд Roblox з безпеки радить перевіряти і тип, і значення всього, що отримує ремоут, і як приклад там якраз магазин.

Що буде, якщо сервер довіряє клієнту
Чітер надсилаєЯкби сервер йому повіривЩо робить ShopService
Ціну 0Усі предмети безкоштовніІгнорує її. Ціна береться з каталогу.
Ціну -1000Coins.Value -= -1000 дає йому 1 000 монетІгнорує її.
NaN замість ціниБудь-яке порівняння з NaN хибне, тому перевірка "не вистачає монет" ніколи не спрацьовуєІгнорує її.
Id, якого немає в каталозі, або таблицю замість рядкаПомилки в скрипті або предмети, які ви не збиралися продаватиВідповідає "That item does not exist."
Сотні запитів за секундуНавантаження на сервер, а будь-яка діра в перевірках спрацьовує сотні разівОбробляє не більше одного запиту від гравця раз на пів секунди.
Coins, змінені у себе на екраніПокупки за монети, яких у нього немаєНе бачить цього взагалі. Сервер читає лише своє значення Coins.

Це правило підходить для кожного ремоута, який ви пишете: надсилайте те, що вибрав гравець, наприклад id предмета або номер слота, і ніколи те, скільки це коштує або що він має отримати. Гайд про RemoteEvent докладніше розбирає перевірку аргументів ремоута.

Крок 5: Тестуємо магазин

  1. Натисніть Play. Ліворуч з'явиться кнопка Shop. Відкрийте її й купіть Flashlight: Coins зменшаться на 25, інструмент з'явиться в хотбарі, а його кнопка зміниться на Owned.
  2. Спробуйте Speed Coil, який коштує 300. Рядок статусу напише, скільки монет ще бракує, і нічого не спишеться.
  3. Скиньте персонажа через внутрішньоігрове меню. Flashlight повернеться в новий Backpack завдяки копії в StarterGear.
  4. Щоб додати собі монет під час тесту, натисніть перемикач Client/Server і перейдіть на Server, знайдіть в Explorer Players, своє ім'я, leaderstats, Coins і змініть його Value у вікні Properties. Те саме в режимі Client змінює лише ваш екран, і це саме така зміна, яку сервер ігнорує.

Якщо кнопка відповідає "The shop did not answer", відкрийте вікно Output через меню Window у Studio і знайдіть червону помилку від ShopService. Якщо ж кнопка зависає на "Buying...", отже, ShopService не запущений або застряг в очікуванні об'єкта: дивіться часті помилки.

Продаж геймпаса за Robux

Монети це ваша власна валюта, тому магазин вище сам вирішує кожну покупку. Те, що гравець купує за Robux, працює інакше: геймпас купується один раз і залишається назавжди (VIP-бонуси, постійний інструмент), а developer product можна купувати знову і знову (пачка монет, пропуск рівня). Обидва йдуть через MarketplaceService від Roblox, і оплату приймає Roblox, а не ваш скрипт.

З цього гайду переносяться два правила: запускайте вікно покупки кнопкою на клієнті, а бонус видавайте лише на сервері, коли Roblox підтвердив покупку або пас у гравця вже є. Гайд про скрипт геймпаса збирає це повністю: перевірку володіння під час входу, вікно покупки, бонуси на зразок VIP-дверей і коли замість паса краще взяти developer product. Щоб вибрати ціну, безкоштовний калькулятор комісії Robux показує, скільки пас або developer product приносить вам після частки Roblox.

Зберігаємо покупки гравців

Усе, що ми зробили, живе одну сесію: монети й куплені предмети скидаються, коли гравець виходить, доки ви не збережете їх через сховище даних. Щоб не повторювати код збереження тут, пройдіть туторіал про DataStore (або крок 3 гайду про таблицю лідерів, там коротша версія) і пам'ятайте про правила магазину:

  • Зберігайте id предметів, наприклад { "sword", "flashlight" }, у тій самій таблиці, що й значення Coins, щоб одне збереження записувало і витрачені монети, і куплений предмет. Tool та інші інстанси в сховище даних покласти не можна.
  • Коли дані завантажилися, пройдіть по збережених id, пропустіть ті, яких більше немає в каталозі, виставте кожен атрибут Owns_ і видайте Tool так само, як це робить giveTool. Вікно магазину оновиться само, бо воно слухає ці атрибути.
  • Володіння пасом зберігати не треба: UserOwnsGamePassAsync питає Roblox щоразу, коли гравець заходить.
  • Ніколи не зберігайте гравця, чиї дані не завантажилися, інакше невдале завантаження може замінити його покупки порожнім списком.

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

Коли магазин поводиться дивно, перевірте спершу це. Насамперед відкрийте вікно Output (меню Window, потім Output): помилка скрипта називає скрипт і рядок.

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

Скрипт чекає на об'єкт, якого немає під цим точним іменем. Перевірте написання й великі літери в ShopRemotes, BuyItem, ShopCatalog і ShopItems, а також те, що ShopItems лежить у ServerStorage, а не в ReplicatedStorage. Гайд про помилки скриптів докладно розбирає це попередження.

Кнопка Buy зависає на "Buying..." і не відповідає

На сервері ніхто не задав BuyItem.OnServerInvoke, тому Roblox тримає запит, доки це не станеться. Переконайтеся, що ShopService це Script, а не LocalScript, і лежить у ServerScriptService, і пошукайте в Output попередження Infinite yield possible від ShopService: воно означає, що скрипт застряг в очікуванні ShopCatalog, ShopRemotes або ShopItems.

Кнопка Buy пише "The shop did not answer"

Виклик сервера впав, а не повернув відповідь. Звичайна причина це помилка всередині ShopService під час обробки запиту, тому знайдіть в Output червону помилку від ShopService: у ній вказано рядок.

Кнопка пише "This item is not available right now"

Сервер не знайшов Tool з toolName цього предмета всередині ServerStorage, ShopItems. В Output є попередження з точним іменем, яке він шукав.

Я купив інструмент, але персонаж не може його тримати або застрягає

У Tool має бути рівно один парт з іменем Handle безпосередньо всередині, і жоден з його партів не має бути заанкерений. Для інструмента, який не треба тримати в руці, натомість зніміть галочку RequiresHandle.

Монети зменшилися в мене на екрані, але не в інших

Покупка пройшла в LocalScript, тому змінився лише ваш пристрій. Перенесіть списання монет і видачу Tool у серверний Script, як у кроці 4.

Куплені предмети зникають після перезаходу

Поки що нічого не зберігається. Дивіться збереження покупок.

Зробити з RoCode

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

Ви пишете

Додай магазин за монети: кнопку Shop, яка відкриває сітку з чотирьох інструментів із цінами в Coins з моїх leaderstats. Сервер має перевіряти ціну й видавати інструмент у Backpack і StarterGear.

RoCode робить
  • Може переглянути ваш плейс через Search Scripts і Read Script у пошуках наявних leaderstats і коду магазину, щоб використати ваше значення Coins, а не додавати друге
  • Може зібрати заготовку вікна через Build UI: макет магазину йде з картками-заглушками та LocalScript для ефектів під час наведення і кнопки Close; логіка покупки пишеться окремими скриптами
  • Створює RemoteFunction через Create Instance і пише ModuleScript каталогу, серверний Script і LocalScript через Create Script
  • Перевіряє компіляцію кожного скрипта в Studio через Check Script (типи він не перевіряє і скрипти не запускає), і кожна пачка змін це точка скасування в Studio

Паси вам однаково треба створити в Creator Hub самим, бо RoCode не вміє створювати паси й developer products, і покупки теж тестуєте ви: з плагіном 3.9 або новішим RoCode може запустити короткий плейтест і прочитати помилки, а з плагіном 3.9.15 або новішим його тестовий персонаж може натискати кнопки Shop і Buy, але він перевіряє лише те, що сам вирішив протестувати. Магазин зазвичай іде після основного геймплея і збереження; покроковий цикл створення гри з RoCode показує, де його місце. Як RoCode підключається до Studio.

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

Що краще для кнопки Buy у Roblox: RemoteEvent чи RemoteFunction?

Підійде і те, і інше, якщо перевіряє сервер. RemoteFunction дозволяє кнопці дочекатися відповіді сервера й показати її, тому в гайді використовується він, і в гайді Roblox з безпеки приклад магазину теж на RemoteFunction. Викликайте його лише з клієнта: сервер, який викликає InvokeClient, може чекати вічно, якщо клієнт так і не відповість. Гайд про RemoteEvent порівнює обидва варіанти.

Як відкрити магазин через NPC, а не кнопкою?

Покладіть ProximityPrompt у якийсь парт NPC, наприклад у його HumanoidRootPart, слухайте його подію Triggered у серверному Script і надсилайте цьому гравцеві RemoteEvent, щоб LocalScript показав панель. Якщо купувати можна лише поруч із NPC, перевіряйте ще й відстань до NPC усередині обробника BuyItem, бо клієнт може викликати ремоут звідки завгодно.

Як продавати предмети, які можна купити кілька разів?

Для таких предметів пропустіть перевірку "уже є" і видавайте не Tool, а щось, що можна порахувати, наприклад додавайте 1 до IntValue, який рахує зілля. Пошук ціни й перевірку монет залиште як є.

Чому магазин зникає, коли персонаж респавниться?

У його ScreenGui ResetOnSpawn стоїть у true, це значення за замовчуванням, тому Roblox видаляє його під час респавну. Поставте false, як робить скрипт у кроці 3.

Можна взяти безкоштовний шаблон GUI магазину?

Так, підійде будь-який макет, якщо його кнопки Buy надсилають лише id предмета, а сама покупка відбувається в серверному Script на зразок ShopService. Перш ніж брати шаблон, перевірте, чи не списуються монети або чи не видаються предмети в LocalScript.

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

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

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

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