Коротко
Храните предметы и цены в ModuleScript в ReplicatedStorage, соберите окно из ScreenGui, ScrollingFrame и UIGridLayout, и пусть каждая кнопка Buy вызывает RemoteFunction, передавая только id предмета. Дальше Script в ServerScriptService сам находит цену, проверяет и списывает Coins игрока и выдаёт предмет.
- Никогда не давайте клиенту присылать цену. Кто угодно может вызвать ваши ремоуты с любыми значениями, поэтому сервер берёт цену из своей копии каталога.
- Купленный Tool выдавайте клонированием из ServerStorage в Backpack игрока (чтобы пользоваться сразу) и в StarterGear (чтобы он вернулся после респавна).
- То, что продаётся за Robux, это пассы и developer products, с ними работает MarketplaceService. Для них Roblox ещё и сам создаёт Shop, и это не то же самое, что магазин за монеты.
На этой странице
Как устроен рабочий магазин
Магазин, который работает в настоящей игре, разделён между устройством игрока и сервером. Устройство рисует окно и говорит "хочу купить меч". Сервер, единственная сторона, которой можно доверять, решает, произойдёт ли это. Скрипты магазина, которые "не работают" или которые игроки ломают читами, часто принимают это решение не на той стороне.
| Часть | Где находится | Что делает |
|---|---|---|
ModuleScript ShopCatalog | ReplicatedStorage | Id предметов, названия, цены и Tool, который даёт каждый из них. Его читают обе стороны. |
RemoteFunction BuyItem | ReplicatedStorage, в папке ShopRemotes | Несёт запрос на покупку на сервер и ответ обратно. |
LocalScript ShopClient | StarterPlayerScripts | Собирает окно магазина и отправляет id предмета, когда нажата кнопка Buy. |
Script ShopService | ServerScriptService | Проверяет запрос, списывает Coins и выдаёт Tool. |
| Tools, которые вы продаёте | ServerStorage, в папке ShopItems | Оригиналы, которые копирует сервер. Ничего из ServerStorage не отправляется игрокам. |
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 монет на старте, чтобы покупки можно было тестировать сразу.
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, дают каждому игроку две папки, и магазин может прочитать не ту.
Дальше создайте объекты, которые ищут скрипты. Регистр в именах важен, поэтому пишите их точно так, как здесь.
- В Explorer наведите курсор на ReplicatedStorage, нажмите кнопку + и вставьте Folder с именем
ShopRemotes. Внутрь неё вставьте RemoteFunction с именемBuyItem. - Наведите курсор на ServerStorage и вставьте Folder с именем
ShopItems. - Положите в ShopItems по Tool на каждый предмет, с именами
ClassicSword,Flashlight,GrappleHookиSpeedCoil. Для первого теста в Tool достаточно одного незаанкеренного Part с именемHandle. Подойдёт и любой Tool, который у вас уже есть: дайте ему нужное имя. Оружие, которое реально наносит урон, соберите по гайду по мечу или гайду по пушке; в каждом написано, как связать его с каталогом. - Выделите каждый Tool и снимите галочку CanBeDropped в окне Properties. Когда она стоит, нажатие Backspace выбрасывает инструмент в Workspace, и любой игрок может подобрать то, за что заплатил покупатель.
Можно начать всего с одного Tool. Если Tool предмета не хватает, сервер отказывается продавать этот предмет и пишет предупреждение с его именем, так что у игрока ничего не списывается.
Шаг 2: Предметы и цены в каталоге
Каталог это единственный список всего, что продаёт магазин. LocalScript читает его, чтобы нарисовать карточки, а сервер читает его, чтобы найти цены, поэтому смена цены это одна правка в одном месте.
Наведите курсор на ReplicatedStorage, вставьте ModuleScript, переименуйте его в 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. В таблице после него перечислен каждый объект, если вы хотите разложить окно вручную.
- В Explorer раскройте StarterPlayer, наведите курсор на StarterPlayerScripts и вставьте LocalScript с именем
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. Когда игра запущена, они ничего не меняют.
| Объект | Задача в магазине | Главные свойства |
|---|---|---|
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 и вставьте в него это:
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 | Все предметы бесплатные | Игнорирует её. Цена берётся из каталога. |
| Цену -1000 | Coins.Value -= -1000 даёт ему 1 000 монет | Игнорирует её. |
NaN вместо цены | Любое сравнение с NaN ложно, поэтому проверка "не хватает монет" никогда не срабатывает | Игнорирует её. |
| Id, которого нет в каталоге, или таблицу вместо строки | Ошибки в скрипте или предметы, которые вы не собирались продавать | Отвечает "That item does not exist." |
| Сотни запросов в секунду | Нагрузка на сервер, а любая дыра в проверках срабатывает сотни раз | Обрабатывает не больше одного запроса от игрока раз в полсекунды. |
| Coins, изменённые у себя на экране | Покупки за монеты, которых у него нет | Не видит этого вообще. Сервер читает только своё значение Coins. |
Это правило подходит для каждого ремоута, который вы пишете: отправляйте то, что выбрал игрок, например id предмета или номер слота, и никогда то, сколько это стоит или что он должен получить. Гайд по RemoteEvent подробнее разбирает проверку аргументов ремоута.
Шаг 5: Тестируем магазин
- Нажмите Play. Слева появится кнопка Shop. Откройте её и купите Flashlight: Coins уменьшатся на 25, инструмент появится в хотбаре, а его кнопка сменится на Owned.
- Попробуйте Speed Coil, который стоит 300. Строка статуса напишет, сколько монет ещё не хватает, и ничего не спишется.
- Сбросьте персонажа через внутриигровое меню. Flashlight вернётся в новый Backpack благодаря копии в StarterGear.
- Чтобы добавить себе монет во время теста, нажмите переключатель 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.
- Может просмотреть ваш плейс через 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.
Источники и что почитать
- Roblox Creator Docs: Securing the client-server boundary (на английском). проверка аргументов ремоутов, NaN, ограничение частоты и пример внутриигрового магазина
- Roblox Creator Docs: Remote events and callbacks (на английском). RemoteFunction, InvokeServer, OnServerInvoke и риски InvokeClient
- Roblox Creator Docs: Passes (на английском). создание и продажа пассов, UserOwnsGamePassAsync и PromptGamePassPurchaseFinished
- Roblox Creator Docs: Shop (на английском). внутриигровой Shop, который Roblox создаёт автоматически
- Roblox Creator Docs: Developer Products (на английском). повторяемые покупки за Robux и ProcessReceipt
- Roblox Creator Docs: StarterGear (на английском). почему Tool в StarterGear возвращается после респавна
- Roblox Creator Docs: In-game tools (на английском). Handle, анкер и RequiresHandle
Как проверялся код: каждый скрипт на этой странице проходит строгую проверку типов Luau с определениями Roblox API (luau-lsp, 14 ноября 2026 г.). Проверка типов ловит опечатки в API и неверные типы, но не ошибки игровой логики, поэтому протестируйте всё в Studio перед публикацией.