Коротко
Зберігайте предмети й ціни в 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, 20 листопада 2026 р.). Перевірка типів ловить помилки в назвах API та неправильні типи, але не помилки ігрової логіки, тому протестуйте все в Studio перед публікацією.