Накратко
Пази предметите и цените в 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, преди да публикуваш.