V skratke
Predmety a ceny držte v ModuleScripte v ReplicatedStorage, okno postavte zo ScreenGui, ScrollingFrame a UIGridLayout a nech každé tlačidlo Buy volá RemoteFunction a odovzdáva len id predmetu. Ďalej si Script v ServerScriptService sám nájde cenu, skontroluje a strhne Coins hráča a vydá predmet.
- Nikdy nedovoľte klientovi posielať cenu. Ktokoľvek môže vaše remoty volať s akýmikoľvek hodnotami, preto server berie cenu zo svojej kópie katalógu.
- Kúpený Tool vydajte klonovaním zo ServerStorage do Backpacku hráča (aby sa dal hneď použiť) a do StarterGear (aby sa vrátil po respawne).
- Čo sa predáva za Robux, sú passy a developer products a pracuje s nimi MarketplaceService. Pre ne Roblox navyše sám vytvára Shop, a to nie je to isté ako obchod za mince.
Na tejto stránke
Ako je funkčný obchod postavený
Obchod, ktorý funguje v skutočnej hre, je rozdelený medzi zariadenie hráča a server. Zariadenie kreslí okno a hovorí „chcem kúpiť meč“. Server, jediná strana, ktorej sa dá veriť, rozhoduje, či sa to stane. Skripty obchodu, ktoré „nefungujú“ alebo ktoré hráči pokazia podvodmi, často robia toto rozhodnutie na nesprávnej strane.
| Časť | Kde je | Čo robí |
|---|---|---|
ModuleScript ShopCatalog | ReplicatedStorage | Id predmetov, názvy, ceny a Tool, ktorý každý z nich dáva. Čítajú ho obe strany. |
RemoteFunction BuyItem | ReplicatedStorage, v priečinku ShopRemotes | Nesie požiadavku na nákup na server a odpoveď späť. |
LocalScript ShopClient | StarterPlayerScripts | Postaví okno obchodu a pošle id predmetu, keď sa klikne na tlačidlo Buy. |
Script ShopService | ServerScriptService | Overí požiadavku, strhne Coins a vydá Tool. |
| Tools, ktoré predávate | ServerStorage, v priečinku ShopItems | Originály, ktoré server kopíruje. Nič zo ServerStorage sa hráčom neposiela. |
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
Krok 1: Mince a predmety na predaj
Obchod míňa hodnotu Coins v leaderstats hráča. Ak ste prešli návod k leaderboardu, už ju máte a tento skript môžete vynechať. Inak vložte Script do ServerScriptService s názvom Leaderstats. Každému dá na začiatok 200 mincí, aby ste mohli nákupy testovať hneď.
local Players = game:GetService("Players")
local STARTING_COINS = 200 -- stačí na test obchodu; nastavte 0, keď hráči budú môcť zarábať mince
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
Majte len jeden skript leaderstats. Dva skripty, z ktorých každý vytvára priečinok leaderstats, dajú každému hráčovi dva priečinky a obchod môže prečítať ten nesprávny.
Ďalej vytvorte objekty, ktoré skripty hľadajú. Na veľkosti písmen v názvoch záleží, preto ich píšte presne ako tu.
- V Exploreri prejdite myšou na ReplicatedStorage, kliknite na tlačidlo + a vložte Folder s názvom
ShopRemotes. Doň vložte RemoteFunction s názvomBuyItem. - Prejdite myšou na ServerStorage a vložte Folder s názvom
ShopItems. - Do ShopItems dajte jeden Tool na každý predmet, s názvami
ClassicSword,Flashlight,GrappleHookaSpeedCoil. Na prvý test stačí v Toole jeden neukotvený Part s názvomHandle. Poslúži aj akýkoľvek Tool, ktorý už máte: dajte mu správny názov. Zbrane, ktoré naozaj spôsobujú poškodenie, postavte podľa návodu k meču alebo návodu k zbrani; v každom je napísané, ako ich prepojiť s katalógom. - Vyberte každý Tool a v okne Properties odškrtnite CanBeDropped. Keď je zaškrtnuté, stlačenie Backspace vyhodí nástroj do Workspace a ktorýkoľvek hráč môže zobrať to, za čo kupujúci zaplatil.
Začať môžete aj s jediným Toolom. Ak Tool predmetu chýba, server ho odmietne predať a vypíše varovanie s jeho názvom, takže hráčovi sa nič nestrhne.
Krok 2: Predmety a ceny v katalógu
Katalóg je jediný zoznam všetkého, čo obchod predáva. LocalScript ho číta, aby nakreslil karty, a server ho číta, aby našiel ceny, takže zmena ceny je jedna úprava na jednom mieste.
Prejdite myšou na ReplicatedStorage, vložte ModuleScript, premenujte ho na ShopCatalog a nahraďte obsah týmto:
export type ShopItem = {
id: string, -- neskôr sa ukladá do úložiska dát: nemeňte ho, keď predmet už majú hráči
name: string, -- zobrazuje sa na karte; meniť sa dá
price: number, -- v Coins
description: string,
toolName: string, -- Tool v ServerStorage.ShopItems, ktorý hráč dostane
}
-- Karty sa objavia v tomto poradí
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
-- Vráti predmet s týmto id alebo nil, ak taký predmet neexistuje
function ShopCatalog.get(id: string): ShopItem?
return byId[id]
end
-- Atribút Player, ktorý server nastaví na true, keď hráč predmet má
function ShopCatalog.ownedAttribute(id: string): string
return "Owns_" .. id
end
return ShopCatalog
Každý predmet má id a zvlášť zobrazovaný name. Server zapisuje práve id, keď hráč niečo má, takže "Classic Sword" môžete neskôr premenovať bez toho, aby ste pokazili uložené nákupy. Popisy sú len text na karte; čo Tool robí, rozhodujú jeho vlastné skripty.
Hráči môžu ModuleScript v ReplicatedStorage prečítať, takže tieto ceny sú verejné. To nevadí: aj tak sú napísané na kartách. Dôležité je, že klient aj server spúšťajú každý vlastnú kópiu modulu, takže hráč, ktorý si ceny zmenil na svojom zariadení, na serveri nič nezmení.
Krok 3: Staviame GUI obchodu
Tento LocalScript postaví celé okno v kóde: tlačidlo Shop, panel s posuvnou mriežkou kariet, jedno tlačidlo Buy na každý predmet katalógu, počítadlo Coins a riadok stavu pre odpovede servera. Keďže je všetko urobené kódom, stačí ho vložiť a kliknúť na Play. Tabuľka za ním vypisuje každý objekt, ak chcete okno rozvrhnúť ručne.
- V Exploreri rozbaľte StarterPlayer, prejdite myšou na StarterPlayerScripts a vložte LocalScript s názvom
ShopClient. - Nahraďte jeho obsah kódom nižšie.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- Čo vracia modul ShopCatalog, aby prísna kontrola typov overila polia, ktoré používame
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: drží všetko, čo obchod kreslí na obrazovke hráča
local gui = Instance.new("ScreenGui")
gui.Name = "ShopGui"
gui.ResetOnSpawn = false -- obchod zostane, keď sa postava respawne
-- Tlačidlo pri ľavom okraji, ktoré otvára a zatvára obchod
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)
-- Okno obchodu: v strede, skryté, kým ho hráč neotvorí
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) -- nedovolí, aby okno bolo na veľkých obrazovkách obrovské
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
-- Tu sa zobrazujú odpovede servera, napríklad "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: oblasť, ktorá sa posúva, keď je kariet viac, ako sa zmestí
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() -- začína od nuly; AutomaticCanvasSize ho natiahne podľa kariet
list.AutomaticCanvasSize = Enum.AutomaticSize.Y
list.Parent = panel
-- UIGridLayout: ukladá karty do radov a zalamuje ich do ďalšieho radu
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..."
-- Posielame len id predmetu. Cenu si server nájde sám.
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)
-- Server nastaví tento atribút, keď nákup prešiel (alebo keď sa načítali uložené predmety)
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")
-- Zobrazujeme mince hráča. Skutočnú hodnotu má server; tu sa len zobrazuje.
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()
Tlačidlá používajú Activated, nie MouseButton1Click: spustia sa kliknutím myši, dotykom na telefóne aj tlačidlom A alebo krížikom na gamepade.
Definície type hore opisujú, čo vracia ShopCatalog, aby prísna kontrola typov zachytila preklep v poli, napríklad item.prise. Keď hra beží, nič nemenia.
| Objekt | Úloha v obchode | Hlavné vlastnosti |
|---|---|---|
ScreenGui | Drží všetko nakreslené na obrazovke | ResetOnSpawn false, aby obchod prežil respawn |
Frame | Okno a každá karta predmetu | AnchorPoint 0.5, 0.5 a Position 0.5, 0.5, aby bolo okno v strede |
UISizeConstraint | Obmedzuje okno na veľkých obrazovkách | MaxSize 640 na 460 |
ScrollingFrame | Posúva sa, keď je kariet viac, ako sa zmestí | CanvasSize 0 a AutomaticCanvasSize Y, aby posuvná oblasť rástla s kartami |
UIGridLayout | Ukladá karty do radov a zalamuje ich | CellSize 180 na 200, CellPadding 12, SortOrder LayoutOrder |
UICorner | Zaobľuje rohy | CornerRadius od 8 do 14 pixelov |
UIPadding | Vnútorné odsadenie | Od 10 do 12 pixelov z každej strany |
TextButton | Tlačidlá Shop, zatvorenie a Buy | Udalosť Activated |
Ak chcete okno nakresliť ručne, postavte rovnaké objekty v StarterGui s týmito vlastnosťami, aj tam nastavte ResetOnSpawn pri ScreenGui na false a nechajte jednu kartu ako šablónu, ktorú LocalScript naklonuje pre každý predmet katalógu. Skript potom len vyplní karty a pripojí tlačidlá. Logika nákupu v ďalšom kroku sa nemení.
Ak vaša hra začína hlavným menu, v tom návode je jeden riadok, ktorý pridáte do ShopClient, aby sa tlačidlo Shop objavilo až po tom, čo hráč klikne na Play. Aby sa obchod otváral rozhovorom s predavačom, návod k dialógom s NPC ukazuje, ako pridať akciu OpenShop, ktorá ShopClient povie, nech okno otvorí, a nákupy pritom naďalej prechádzajú kontrolami obchodu na serveri.
Krok 4: Kontrola a nákup na serveri
Tento Script je jediné miesto, kde nákup môže prebehnúť. Dostane id predmetu, overí ho, nájde cenu, skontroluje Coins hráča, potom strhne mince a vydá Tool. Tlačidlu Buy odpovie true alebo false a správou na zobrazenie.
Prejdite myšou na ServerScriptService, vložte Script s názvom ShopService a vložte doň toto:
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")
-- Čo vracia modul ShopCatalog, aby prísna kontrola typov overila polia, ktoré používame
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: hráč môže nástroj použiť hneď
local backpack = player:FindFirstChildOfClass("Backpack")
if backpack then
template:Clone().Parent = backpack
end
-- StarterGear: Roblox ho znova skopíruje do Backpacku pri každom objavení postavy
local starterGear = player:FindFirstChildOfClass("StarterGear")
if starterGear then
template:Clone().Parent = starterGear
end
end
local function onBuyItem(player: Player, itemId: unknown): (boolean, string)
-- 1. Klient posiela len id predmetu, takže to musí byť reťazec
if type(itemId) ~= "string" then
return false, "That item does not exist."
end
-- 2. Ignorujeme dvojité kliknutia a záplavy požiadaviek zo skriptov
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. Hľadáme predmet vo vlastnej kópii katalógu na serveri
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. Cena sa berie z katalógu a nikdy od klienta
if coins.Value < item.price then
return false, `You need {item.price - coins.Value} more coins.`
end
-- 5. Strhneme mince, potom vydáme predmet. Nič tu neodovzdáva vykonávanie, preto dve požiadavky
-- od jedného hráča nemôžu obe prejsť kontrolami vyššie, kým sa toto nevykoná.
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)
Vlastníctvo sa ukladá ako atribút Player, napríklad Owns_sword. Atribúty nastavené serverom sa replikujú na zariadenie hráča, takže LocalScript môže kartu prepnúť na "Owned". Zmena, ktorú hráč urobí vo svojej kópii, sa na server nedostane.
Tool sa dostane na dve miesta. Kópia v Backpacku sa hneď objaví v hotbare. Kópiu v StarterGear Roblox dá do nového Backpacku zakaždým, keď sa objaví postava. Bez nej by kúpený predmet zmizol hneď pri prvej smrti hráča.
Prečo klient nikdy neposiela cenu
Všetko, čo je na zariadení hráča, môže tento hráč zmeniť. Podvodníci spúšťajú vlastný kód vo svojej kópii hry: môžu čítať vaše LocalScripty, meniť GUI a volať BuyItem:InvokeServer() s akýmikoľvek argumentmi, koľkokrát chcú. Návod Robloxu k bezpečnosti hovorí kontrolovať typ aj hodnotu všetkého, čo remote dostane, a ako príklad tam slúži práve obchod.
| Podvodník pošle | Keby mu server veril | Čo robí ShopService |
|---|---|---|
| Cenu 0 | Všetky predmety zadarmo | Ignoruje ju. Cena sa berie z katalógu. |
| Cenu -1000 | Coins.Value -= -1000 mu dá 1 000 mincí | Ignoruje ju. |
NaN namiesto ceny | Každé porovnanie s NaN je nepravdivé, takže kontrola „nemá dosť mincí“ sa nikdy nespustí | Ignoruje ju. |
| Id, ktoré v katalógu nie je, alebo tabuľku namiesto reťazca | Chyby v skripte alebo predmety, ktoré ste predávať nechceli | Odpovie "That item does not exist." |
| Stovky požiadaviek za sekundu | Záťaž servera a každá diera v kontrolách sa spustí stovky ráz | Spracuje najviac jednu požiadavku od hráča za pol sekundy. |
| Coins zmenené na svojej obrazovke | Nákupy za mince, ktoré nemá | Vôbec to nevidí. Server číta len svoju hodnotu Coins. |
Toto pravidlo platí pre každý remote, ktorý píšete: posielajte to, čo hráč vybral, napríklad id predmetu alebo číslo slotu, a nikdy to, koľko to stojí alebo čo má dostať. Návod k RemoteEvent kontrolu argumentov remotu rozoberá podrobnejšie.
Krok 5: Testujeme obchod
- Kliknite na Play. Vľavo sa objaví tlačidlo Shop. Otvorte ho a kúpte Flashlight: Coins sa znížia o 25, nástroj sa objaví v hotbare a jeho tlačidlo sa zmení na Owned.
- Skúste Speed Coil, ktorý stojí 300. Riadok stavu napíše, koľko mincí ešte chýba, a nič sa nestrhne.
- Resetujte postavu cez herné menu. Flashlight sa vďaka kópii v StarterGear vráti do nového Backpacku.
- Ak si chcete počas testu pridať mince, kliknite na prepínač Client/Server a prejdite na Server, nájdite v Exploreri
Players, svoje meno,leaderstats,Coinsa zmeňte jeho Value v okne Properties. To isté v režime Client zmení len vašu obrazovku a je to presne ten druh zmeny, ktorý server ignoruje.
Ak tlačidlo odpovie "The shop did not answer", otvorte okno Output cez menu Window v Studiu a nájdite červenú chybu od ShopService. Ak však tlačidlo visí na "Buying...", ShopService nebeží alebo uviazol pri čakaní na objekt: pozrite časté chyby.
Predaj gamepassu za Robux
Mince sú vaša vlastná mena, takže obchod vyššie rozhoduje o každom nákupe sám. Čo hráč kupuje za Robux, funguje inak: gamepass sa kupuje raz a zostáva navždy (VIP bonusy, trvalý nástroj) a developer product sa dá kupovať znova a znova (balík mincí, preskočenie levelu). Oboje ide cez MarketplaceService od Robloxu a platbu prijíma Roblox, nie váš skript.
Z tohto návodu sa prenášajú dve pravidlá: okno nákupu spúšťajte tlačidlom na klientovi a bonus vydávajte len na serveri, keď Roblox nákup potvrdil alebo hráč pass už má. Návod k skriptu gamepassu to stavia celé: kontrolu vlastníctva pri vstupe, okno nákupu, bonusy ako VIP dvere a kedy je namiesto passu lepší developer product. Pri voľbe ceny vám bezplatná kalkulačka poplatku z Robux ukáže, koľko vám pass alebo developer product zarobí po podiele Robloxu.
Ukladáme nákupy hráčov
Všetko, čo sme urobili, žije jednu reláciu: mince a kúpené predmety sa vynulujú, keď hráč odíde, kým ich neuložíte cez úložisko dát. Aby sme tu kód ukladania neopakovali, prejdite tutoriál k DataStore (alebo krok 3 návodu k leaderboardu, tam je kratšia verzia) a pamätajte na pravidlá obchodu:
- Ukladajte id predmetov, napríklad
{ "sword", "flashlight" }, v tej istej tabuľke ako hodnotu Coins, aby jedno uloženie zapísalo minuté mince aj kúpený predmet. Tool a iné inštancie sa do úložiska dát dať nedajú. - Keď sa dáta načítajú, prejdite uložené id, preskočte tie, ktoré už v katalógu nie sú, nastavte každý atribút
Owns_a vydajte Tool rovnako, ako to robígiveTool. Okno obchodu sa aktualizuje samo, pretože tieto atribúty počúva. - Vlastníctvo passu ukladať nemusíte:
UserOwnsGamePassAsyncsa opýta Robloxu zakaždým, keď hráč príde. - Nikdy neukladajte hráča, ktorého dáta sa nenačítali, inak neúspešné načítanie môže jeho nákupy nahradiť prázdnym zoznamom.
Časté chyby a riešenia
Keď sa obchod správa čudne, skontrolujte najprv toto. Ako prvé otvorte okno Output (menu Window, potom Output): chyba skriptu uvádza skript aj riadok.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("ShopRemotes")'
Skript čaká na objekt, ktorý pod týmto presným názvom neexistuje. Skontrolujte pravopis a veľké písmená pri ShopRemotes, BuyItem, ShopCatalog a ShopItems a to, či ShopItems leží v ServerStorage, nie v ReplicatedStorage. Návod k chybám v skriptoch toto varovanie podrobne rozoberá.
Tlačidlo Buy visí na "Buying..." a neodpovedá
Na serveri nikto nenastavil BuyItem.OnServerInvoke, takže Roblox požiadavku drží, kým sa to nestane. Uistite sa, že ShopService je Script, nie LocalScript, a leží v ServerScriptService, a hľadajte v Output varovanie Infinite yield possible od ShopService: znamená, že skript uviazol pri čakaní na ShopCatalog, ShopRemotes alebo ShopItems.
Tlačidlo Buy píše "The shop did not answer"
Volanie servera spadlo namiesto toho, aby vrátilo odpoveď. Zvyčajná príčina je chyba vnútri ShopService pri spracovaní požiadavky, preto nájdite v Output červenú chybu od ShopService: je v nej uvedený riadok.
Tlačidlo píše "This item is not available right now"
Server nenašiel Tool s toolName tohto predmetu vnútri ServerStorage, ShopItems. V Output je varovanie s presným názvom, ktorý hľadal.
Kúpil som nástroj, ale postava ho nevie držať alebo uviazne
Tool musí mať priamo vnútri presne jeden part s názvom Handle a žiadny z jeho partov nesmie byť ukotvený. Pri nástroji, ktorý sa nemusí držať v ruke, namiesto toho odškrtnite RequiresHandle.
Mince sa znížili na mojej obrazovke, ale nie u ostatných
Nákup prebehol v LocalScripte, takže sa zmenilo len vaše zariadenie. Presuňte strhávanie mincí a vydanie Toolu do serverového Scriptu, ako v kroku 4.
Kúpené predmety po novom pripojení zmiznú
Zatiaľ sa nič neukladá. Pozrite ukladanie nákupov.
Urobiť s RoCode
Ak sa vám to všetko nechce stavať ručne, RoCode to môže urobiť vo vašom otvorenom place. Je to nezávislý AI agent na kód: funkciu opíšete v jeho webovom chate a jeho plugin pre Roblox Studio vytvorí skripty, remote a GUI vo vašom Exploreri, takže kód z okna chatu kopírovať nemusíte.
Pridaj obchod za mince: tlačidlo Shop, ktoré otvorí mriežku štyroch nástrojov s cenami v Coins z mojich leaderstats. Server má kontrolovať cenu a vydávať nástroj do Backpacku a StarterGear.
- Môže si prezrieť váš place cez Search Scripts a Read Script kvôli existujúcim leaderstats a kódu obchodu, aby použil vašu hodnotu Coins a nepridával druhú
- Vie postaviť kostru okna cez Build UI: šablóna obchodu prichádza so zástupnými kartami a LocalScriptom pre efekty pri prejdení myšou a tlačidlo Close; logika nákupu sa píše samostatnými skriptmi
- Vytvorí RemoteFunction cez Create Instance a napíše ModuleScript katalógu, serverový Script a LocalScript cez Create Script
- Overí kompiláciu každého skriptu v Studiu cez Check Script (typy nekontroluje a skripty nespúšťa) a každá dávka zmien je bod na vrátenie v Studiu
Passy musíte aj tak vytvoriť v Creator Hube sami, pretože RoCode nevie vytvárať passy ani developer products, a nákupy tiež testujete vy: s pluginom 3.9 alebo novším môže RoCode spustiť krátky playtest a prečítať chyby a s pluginom 3.9.15 alebo novším jeho testovacia postava vie stláčať tlačidlá Shop a Buy, ale kontroluje len to, čo sa sám rozhodol otestovať. Obchod zvyčajne prichádza po hlavnej hrateľnosti a ukladaní; postupná slučka tvorby hry s RoCode ukazuje, kam patrí. Ako sa RoCode pripája k Studiu.
Časté otázky
Čo je lepšie pre tlačidlo Buy v Robloxe: RemoteEvent, alebo RemoteFunction?
Poslúži oboje, ak kontroluje server. RemoteFunction umožní tlačidlu počkať na odpoveď servera a ukázať ju, preto ju návod používa, a príklad obchodu v návode Robloxu k bezpečnosti je tiež na RemoteFunction. Volajte ju len z klienta: server, ktorý volá InvokeClient, môže čakať večne, ak klient nikdy neodpovie. Návod k RemoteEvent obe možnosti porovnáva.
Ako otvoriť obchod cez NPC namiesto tlačidla?
Dajte ProximityPrompt do nejakého partu NPC, napríklad do jeho HumanoidRootPart, počúvajte jeho udalosť Triggered v serverovom Scripte a pošlite tomuto hráčovi RemoteEvent, aby LocalScript ukázal panel. Ak sa má nakupovať len pri NPC, kontrolujte vzdialenosť od NPC aj vnútri handlera BuyItem, pretože klient môže remote zavolať odkiaľkoľvek.
Ako predávať predmety, ktoré sa dajú kúpiť viackrát?
Pri takých predmetoch vynechajte kontrolu „už má“ a nevydávajte Tool, ale niečo, čo sa dá počítať, napríklad pripočítajte 1 k IntValue, ktorý počíta elixíry. Hľadanie ceny a kontrolu mincí nechajte, ako sú.
Prečo obchod zmizne, keď sa postava respawne?
Jeho ScreenGui má ResetOnSpawn nastavené na true, čo je predvolená hodnota, takže ho Roblox pri respawne zmaže. Nastavte false, ako to robí skript v kroku 3.
Môžem použiť bezplatnú šablónu GUI obchodu?
Áno, poslúži akékoľvek rozloženie, ak jeho tlačidlá Buy posielajú len id predmetu a samotný nákup prebieha v serverovom Scripte ako ShopService. Skôr ako šablónu použijete, skontrolujte, či sa mince nestrhávajú alebo predmety nevydávajú v LocalScripte.
Zdroje a ďalšie čítanie
- Roblox Creator Docs: Securing the client-server boundary (po anglicky). kontrola argumentov remotov, NaN, obmedzenie frekvencie a príklad herného obchodu
- Roblox Creator Docs: Remote events and callbacks (po anglicky). RemoteFunction, InvokeServer, OnServerInvoke a riziká InvokeClient
- Roblox Creator Docs: Passes (po anglicky). vytváranie a predaj passov, UserOwnsGamePassAsync a PromptGamePassPurchaseFinished
- Roblox Creator Docs: Shop (po anglicky). herný Shop, ktorý Roblox vytvára automaticky
- Roblox Creator Docs: Developer Products (po anglicky). opakované nákupy za Robux a ProcessReceipt
- Roblox Creator Docs: StarterGear (po anglicky). prečo sa Tool v StarterGear po respawne vráti
- Roblox Creator Docs: In-game tools (po anglicky). Handle, ukotvenie a RequiresHandle
Ako bol kód overený: každý skript na tejto stránke prechádza prísnou kontrolou typov Luau s definíciami Roblox API (luau-lsp, 20. novembra 2026). Kontrola typov zachytí chyby v názvoch API a nesprávne typy, ale nie chyby v hernej logike, preto všetko pred publikovaním otestujte v Studiu.