Kort fortalt
Gem ting og priser i et ModuleScript i ReplicatedStorage, byg vinduet af ScreenGui, ScrollingFrame og UIGridLayout, og lad hver Buy-knap kalde en RemoteFunction, der kun sender tingens id. Derefter finder et Script i ServerScriptService selv prisen, tjekker og trækker spillerens Coins og giver tingen.
- Lad aldrig klienten sende prisen. Hvem som helst kan kalde dine remotes med hvilke værdier som helst, så serveren tager prisen fra sin egen kopi af kataloget.
- Giv et købt Tool ved at klone det fra ServerStorage til spillerens Backpack (så det kan bruges med det samme) og til StarterGear (så det kommer tilbage efter respawn).
- Det, der sælges for Robux, er passes og developer products, og dem håndterer MarketplaceService. Til dem laver Roblox desuden selv en Shop, og det er ikke det samme som en butik med mønter.
På denne side
Sådan er en fungerende butik bygget op
En butik, der virker i et rigtigt spil, er delt mellem spillerens enhed og serveren. Enheden tegner vinduet og siger "jeg vil købe et sværd". Serveren, den eneste side, man kan stole på, afgør, om det sker. Butiks-scripts, der "ikke virker", eller som spillere ødelægger med snyd, træffer ofte den beslutning på den forkerte side.
| Del | Hvor den ligger | Hvad den gør |
|---|---|---|
ModuleScript ShopCatalog | ReplicatedStorage | Tingenes id, navne, priser og det Tool, hver af dem giver. Begge sider læser det. |
RemoteFunction BuyItem | ReplicatedStorage, i mappen ShopRemotes | Bærer købsforespørgslen til serveren og svaret tilbage. |
LocalScript ShopClient | StarterPlayerScripts | Bygger butiksvinduet og sender tingens id, når der trykkes på en Buy-knap. |
Script ShopService | ServerScriptService | Tjekker forespørgslen, trækker Coins og giver toolet. |
| De tools, du sælger | ServerStorage, i mappen ShopItems | De originaler, som serveren kopierer. Intet fra ServerStorage sendes til spillerne. |
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
Trin 1: Mønter og ting til salg
Butikken bruger værdien Coins i spillerens leaderstats. Hvis du har fulgt guiden til leaderboards, har du den allerede og kan springe dette script over. Ellers skal du indsætte et Script i ServerScriptService med navnet Leaderstats. Det giver alle 200 mønter fra start, så du kan teste køb med det samme.
local Players = game:GetService("Players")
local STARTING_COINS = 200 -- nok til at teste butikken; sæt til 0, når spillerne kan tjene mønter
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
Hav kun ét leaderstats-script. To scripts, der hver opretter en mappe leaderstats, giver hver spiller to mapper, og butikken kan komme til at læse den forkerte.
Opret derefter de objekter, som scriptene leder efter. Store og små bogstaver i navnene betyder noget, så skriv dem præcis som her.
- Hold markøren over ReplicatedStorage i Explorer, klik på knappen +, og indsæt en Folder med navnet
ShopRemotes. Indsæt en RemoteFunction med navnetBuyIteminde i den. - Hold markøren over ServerStorage, og indsæt en Folder med navnet
ShopItems. - Læg ét Tool for hver ting i ShopItems, med navnene
ClassicSword,Flashlight,GrappleHookogSpeedCoil. Til den første test er det nok med én Part, der ikke er anchored, med navnetHandlei hvert Tool. Ethvert Tool, du allerede har, kan også bruges: giv det bare det rigtige navn. Våben, der faktisk giver skade, kan du bygge med guiden til sværd eller guiden til våben; begge forklarer, hvordan du kobler dem til kataloget. - Markér hvert Tool, og fjern fluebenet i CanBeDropped i vinduet Properties. Når det er sat, smider et tryk på Backspace toolet ud i Workspace, og en hvilken som helst spiller kan samle det op, som køberen har betalt for.
Du kan starte med bare ét Tool. Hvis en tings Tool mangler, nægter serveren at sælge den ting og skriver en advarsel med dens navn, så spilleren ikke bliver trukket noget.
Trin 2: Ting og priser i kataloget
Kataloget er den eneste liste over alt, hvad butikken sælger. LocalScriptet læser det for at tegne kortene, og serveren læser det for at finde priserne, så en prisændring er én rettelse ét sted.
Hold markøren over ReplicatedStorage, indsæt et ModuleScript, omdøb det til ShopCatalog, og erstat indholdet med dette:
export type ShopItem = {
id: string, -- gemmes senere i datastore: ændr det ikke, når spillere allerede har tingen
name: string, -- vises på kortet; kan ændres
price: number, -- i Coins
description: string,
toolName: string, -- det Tool i ServerStorage.ShopItems, som spilleren får
}
-- Kortene vises i denne rækkefølge
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
-- Returnerer tingen med dette id eller nil, hvis der ikke findes en sådan ting
function ShopCatalog.get(id: string): ShopItem?
return byId[id]
end
-- Attribut på Player, som serveren sætter til true, når spilleren har tingen
function ShopCatalog.ownedAttribute(id: string): string
return "Owns_" .. id
end
return ShopCatalog
Hver ting har et id og et separat name, der vises. Serveren gemmer netop id, når en spiller har noget, så "Classic Sword" kan omdøbes senere uden at ødelægge gemte køb. Beskrivelserne er kun tekst på kortet; hvad toolet gør, afgør dets egne scripts.
Spillere kan læse et ModuleScript i ReplicatedStorage, så disse priser er offentlige. Det er fint: de står jo også på kortene. Det vigtige er, at klienten og serveren hver kører deres egen kopi af modulet, så en spiller, der ændrer priserne på sin enhed, ikke ændrer noget på serveren.
Trin 3: Byg butikkens GUI
Dette LocalScript bygger hele vinduet i kode: Shop-knappen, et panel med et rullbart gitter af kort, én Buy-knap for hver ting i kataloget, en Coins-tæller og en statuslinje til serverens svar. Fordi alt er lavet i kode, kan du sætte det ind og trykke på Play. Tabellen efter det viser hvert objekt, hvis du vil bygge vinduet i hånden.
- Fold StarterPlayer ud i Explorer, hold markøren over StarterPlayerScripts, og indsæt et LocalScript med navnet
ShopClient. - Erstat indholdet med koden nedenfor.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- Hvad modulet ShopCatalog returnerer, så det strenge typetjek kan tjekke de felter, vi bruger
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: holder alt, hvad butikken tegner på spillerens skærm
local gui = Instance.new("ScreenGui")
gui.Name = "ShopGui"
gui.ResetOnSpawn = false -- butikken bliver, når karakteren respawner
-- Knappen ved venstre kant, der åbner og lukker butikken
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)
-- Butiksvinduet: i midten, skjult, indtil spilleren åbner det
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) -- forhindrer vinduet i at blive kæmpestort på store skærme
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
-- Her vises serverens svar, for eksempel "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: et område, der kan rulles, når der er flere kort, end der er plads til
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() -- starter ved nul; AutomaticCanvasSize strækker det, så kortene passer
list.AutomaticCanvasSize = Enum.AutomaticSize.Y
list.Parent = panel
-- UIGridLayout: lægger kortene i rækker og ombryder dem til næste række
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..."
-- Vi sender kun tingens id. Prisen finder serveren selv.
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)
-- Serveren sætter denne attribut, når købet er gået igennem (eller når gemte ting er indlæst)
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")
-- Vis spillerens mønter. Den rigtige værdi ligger på serveren; her bliver den kun vist.
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()
Knapperne bruger Activated og ikke MouseButton1Click: det udløses ved et museklik, et tryk på en telefon og knappen A eller krydset på en gamepad.
Definitionerne med type øverst beskriver, hvad ShopCatalog returnerer, så det strenge typetjek fanger en tastefejl i et felt, for eksempel item.prise. Når spillet kører, ændrer de ingenting.
| Objekt | Opgave i butikken | Vigtigste egenskaber |
|---|---|---|
ScreenGui | Holder alt, hvad der er tegnet på skærmen | ResetOnSpawn false, så butikken overlever respawn |
Frame | Vinduet og hvert kort med en ting | AnchorPoint 0.5, 0.5 og Position 0.5, 0.5, så vinduet står i midten |
UISizeConstraint | Begrænser vinduet på store skærme | MaxSize 640 gange 460 |
ScrollingFrame | Kan rulles, når der er flere kort, end der er plads til | CanvasSize 0 og AutomaticCanvasSize Y, så rulleområdet vokser med kortene |
UIGridLayout | Sætter kortene i rækker og ombryder dem | CellSize 180 gange 200, CellPadding 12, SortOrder LayoutOrder |
UICorner | Runder hjørnerne | CornerRadius fra 8 til 14 pixels |
UIPadding | Indvendig afstand | Fra 10 til 12 pixels på hver side |
TextButton | Knapperne Shop, luk og Buy | Eventet Activated |
Hvis du vil tegne vinduet i hånden, så byg de samme objekter i StarterGui med disse egenskaber, sæt også dér ScreenGuis ResetOnSpawn til false, og behold ét kort som skabelon, som LocalScriptet kloner for hver ting i kataloget. Så skal scriptet kun udfylde kortene og forbinde knapperne. Købslogikken i næste trin ændrer sig ikke.
Hvis dit spil starter med en hovedmenu, har den guide én linje, du skal tilføje i ShopClient, så Shop-knappen først dukker op, når spilleren har trykket på Play. For at få butikken til at åbne via en samtale med en sælger viser guiden til NPC-dialoger, hvordan du tilføjer handlingen OpenShop, som beder ShopClient om at åbne vinduet, mens købene stadig går gennem butikkens tjek på serveren.
Trin 4: Tjek og køb på serveren
Dette Script er det eneste sted, hvor et køb kan ske. Det modtager tingens id, tjekker det, finder prisen, tjekker spillerens Coins, trækker derefter mønterne og giver toolet. Det svarer Buy-knappen med true eller false og en besked, der skal vises.
Hold markøren over ServerScriptService, indsæt et Script med navnet ShopService, og sæt dette ind i det:
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")
-- Hvad modulet ShopCatalog returnerer, så det strenge typetjek kan tjekke de felter, vi bruger
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: spilleren kan bruge toolet med det samme
local backpack = player:FindFirstChildOfClass("Backpack")
if backpack then
template:Clone().Parent = backpack
end
-- StarterGear: Roblox kopierer det igen til Backpack, hver gang karakteren dukker op
local starterGear = player:FindFirstChildOfClass("StarterGear")
if starterGear then
template:Clone().Parent = starterGear
end
end
local function onBuyItem(player: Player, itemId: unknown): (boolean, string)
-- 1. Klienten sender kun tingens id, så det skal være en streng
if type(itemId) ~= "string" then
return false, "That item does not exist."
end
-- 2. Ignorer dobbeltklik og strømme af forespørgsler fra scripts
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. Find tingen i serverens egen kopi af kataloget
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. Prisen kommer fra kataloget og aldrig fra klienten
if coins.Value < item.price then
return false, `You need {item.price - coins.Value} more coins.`
end
-- 5. Træk mønterne, og giv derefter tingen. Intet her giver kørslen fra sig, så to forespørgsler
-- fra samme spiller kan ikke begge komme igennem tjekkene ovenfor, før dette er kørt.
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)
Ejerskab gemmes som en attribut på Player, for eksempel Owns_sword. Attributter, som serveren sætter, replikeres til spillerens enhed, så LocalScriptet kan skifte kortet til "Owned". En ændring, som spilleren laver i sin kopi, når ikke frem til serveren.
Toolet havner to steder. Kopien i Backpack dukker straks op i hotbaren. Kopien i StarterGear lægger Roblox i en ny Backpack, hver gang karakteren dukker op. Uden den forsvinder den købte ting, første gang spilleren dør.
Hvorfor klienten aldrig sender prisen
Alt, hvad der ligger på spillerens enhed, kan den spiller ændre. Snydere kører deres egen kode i deres kopi af spillet: de kan læse dine LocalScripts, ændre GUI'en og kalde BuyItem:InvokeServer() med hvilke argumenter som helst så mange gange, de vil. Roblox' guide til sikkerhed siger, at du skal tjekke både typen og værdien af alt, hvad en remote modtager, og eksemplet dér er netop en butik.
| Snyderen sender | Hvis serveren troede på ham | Hvad ShopService gør |
|---|---|---|
| Prisen 0 | Alle ting er gratis | Ignorerer den. Prisen kommer fra kataloget. |
| Prisen -1000 | Coins.Value -= -1000 giver ham 1 000 mønter | Ignorerer den. |
NaN i stedet for en pris | Enhver sammenligning med NaN er falsk, så tjekket "ikke nok mønter" slår aldrig til | Ignorerer den. |
| Et id, der ikke findes i kataloget, eller en tabel i stedet for en streng | Fejl i scriptet eller ting, du ikke havde tænkt dig at sælge | Svarer "That item does not exist." |
| Hundredvis af forespørgsler i sekundet | Belastning af serveren, og ethvert hul i tjekkene slår til hundredvis af gange | Behandler højst én forespørgsel fra en spiller hvert halve sekund. |
| Coins ændret på hans egen skærm | Køb for mønter, han ikke har | Ser det slet ikke. Serveren læser kun sin egen værdi af Coins. |
Denne regel passer til hver remote, du skriver: send det, spilleren valgte, for eksempel tingens id eller et slotnummer, og aldrig hvad det koster, eller hvad han skal have. Guiden til RemoteEvent går mere i dybden med at tjekke en remotes argumenter.
Trin 5: Test butikken
- Tryk på Play. Til venstre dukker Shop-knappen op. Åbn den, og køb Flashlight: Coins falder med 25, toolet dukker op i hotbaren, og dets knap skifter til Owned.
- Prøv Speed Coil, som koster 300. Statuslinjen skriver, hvor mange mønter du mangler, og der bliver ikke trukket noget.
- Nulstil karakteren via menuen i spillet. Flashlight kommer tilbage i den nye Backpack takket være kopien i StarterGear.
- For at give dig selv flere mønter under testen skal du klikke på knappen Client/Server og skifte til Server, finde
Players, dit navn,leaderstats,Coinsi Explorer og ændre dens Value i vinduet Properties. Det samme i tilstanden Client ændrer kun din skærm, og det er netop den slags ændring, som serveren ignorerer.
Hvis knappen svarer "The shop did not answer", så åbn vinduet Output via menuen Window i Studio, og find den røde fejl fra ShopService. Hvis knappen derimod hænger på "Buying...", kører ShopService ikke eller sidder fast og venter på et objekt: se almindelige fejl.
Sælg et gamepass for Robux
Mønter er din egen valuta, så butikken ovenfor afgør selv hvert køb. Det, en spiller køber for Robux, virker anderledes: et gamepass købes én gang og bliver for altid (VIP-bonusser, et permanent tool), mens et developer product kan købes igen og igen (en pakke mønter, at springe et level over). Begge går gennem Roblox' MarketplaceService, og betalingen modtages af Roblox, ikke af dit script.
To regler fra denne guide gælder også her: åbn købsvinduet med en knap på klienten, og giv kun bonussen på serveren, når Roblox har bekræftet købet, eller spilleren allerede har passet. Guiden til gamepass-scripts bygger det hele: tjek af ejerskab ved indgang, købsvinduet, bonusser som en VIP-dør, og hvornår et developer product er bedre end et pass. Til at vælge en pris viser den gratis Robux-gebyrberegner, hvor meget et pass eller developer product giver dig efter Roblox' andel.
Gem spillernes køb
Alt, hvad vi har lavet, lever i én session: mønter og købte ting nulstilles, når spilleren går, indtil du gemmer dem med datastore. For ikke at gentage koden til at gemme her kan du følge tutorialen om DataStore (eller trin 3 i guiden til leaderboards, hvor versionen er kortere) og huske butikkens regler:
- Gem tingenes id, for eksempel
{ "sword", "flashlight" }, i den samme tabel som værdien Coins, så ét gem skriver både de brugte mønter og den købte ting. Tools og andre instanser kan ikke lægges i datastore. - Når dataene er indlæst, så gå de gemte id igennem, spring dem over, der ikke længere findes i kataloget, sæt hver attribut
Owns_, og giv toolet på samme måde, somgiveToolgør. Butiksvinduet opdaterer sig selv, fordi det lytter efter disse attributter. - Ejerskab af et pass behøver du ikke gemme:
UserOwnsGamePassAsyncspørger Roblox, hver gang spilleren kommer ind. - Gem aldrig en spiller, hvis data ikke blev indlæst, ellers kan en mislykket indlæsning erstatte hans køb med en tom liste.
Almindelige fejl og løsninger
Når butikken opfører sig mærkeligt, så tjek dette først. Åbn først vinduet Output (menuen Window og derefter Output): en script-fejl nævner scriptet og linjen.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("ShopRemotes")'
Scriptet venter på et objekt, der ikke findes med netop det navn. Tjek stavning og store bogstaver i ShopRemotes, BuyItem, ShopCatalog og ShopItems, og at ShopItems ligger i ServerStorage og ikke i ReplicatedStorage. Guiden til script-fejl gennemgår denne advarsel i detaljer.
Buy-knappen hænger på "Buying..." og svarer ikke
Ingen på serveren har sat BuyItem.OnServerInvoke, så Roblox holder forespørgslen, indtil det sker. Sørg for, at ShopService er et Script og ikke et LocalScript, og at det ligger i ServerScriptService, og kig i Output efter advarslen Infinite yield possible fra ShopService: den betyder, at scriptet sidder fast og venter på ShopCatalog, ShopRemotes eller ShopItems.
Buy-knappen skriver "The shop did not answer"
Kaldet til serveren gik ned i stedet for at returnere et svar. Den sædvanlige årsag er en fejl inde i ShopService, mens forespørgslen blev behandlet, så find den røde fejl fra ShopService i Output: den nævner linjen.
Knappen skriver "This item is not available right now"
Serveren fandt ikke et Tool med tingens toolName inde i ServerStorage, ShopItems. Output har en advarsel med det præcise navn, den ledte efter.
Jeg købte et tool, men karakteren kan ikke holde det eller sidder fast
Et Tool skal have præcis én part med navnet Handle direkte indeni, og ingen af dets parts må være anchored. Til et tool, der ikke skal holdes i hånden, skal du i stedet fjerne fluebenet i RequiresHandle.
Mønterne faldt på min skærm, men ikke hos de andre
Købet skete i et LocalScript, så kun din enhed ændrede sig. Flyt fratrækningen af mønter og udleveringen af toolet til et Script på serveren, som i trin 4.
Købte ting forsvinder, når jeg kommer ind igen
Indtil videre gemmes intet. Se gem køb.
Lav det med RoCode
Hvis du ikke har lyst til at bygge alt dette i hånden, kan RoCode gøre det i det place, du har åbent. Det er en uafhængig AI-agent til kode: du beskriver funktionen i dens webchat, og dens plugin til Roblox Studio opretter scripts, remote og GUI i din Explorer, så du ikke skal kopiere kode fra chatvinduet.
Tilføj en butik med mønter: en Shop-knap, der åbner et gitter med fire tools med priser i Coins fra mine leaderstats. Serveren skal tjekke prisen og give toolet i Backpack og StarterGear.
- Kan gennemse dit place med Search Scripts og Read Script for at finde eksisterende leaderstats og butikskode, så den bruger din værdi af Coins i stedet for at tilføje en ny
- Kan bygge et udkast til vinduet med Build UI: butikslayoutet kommer med pladsholderkort og et LocalScript til hover-effekter og knappen Close; købslogikken skrives i separate scripts
- Opretter en RemoteFunction med Create Instance og skriver katalogets ModuleScript, server-Scriptet og LocalScriptet med Create Script
- Tjekker kompileringen af hvert script i Studio med Check Script (den tjekker ikke typer og kører ikke scripts), og hver omgang ændringer er et fortryd-punkt i Studio
Passes skal du stadig selv oprette i Creator Hub, fordi RoCode ikke kan oprette passes og developer products, og købene tester du også selv: med plugin 3.9 eller nyere kan RoCode køre en kort playtest og læse fejlene, og med plugin 3.9.15 eller nyere kan dens testkarakter trykke på knapperne Shop og Buy, men den tjekker kun det, den selv har valgt at teste. En butik kommer som regel efter selve gameplayet og gemningen; trin-for-trin-løkken til at lave et spil med RoCode viser, hvor den hører hjemme. Sådan forbinder RoCode til Studio.
Ofte stillede spørgsmål
Hvad er bedst til en Buy-knap i Roblox: RemoteEvent eller RemoteFunction?
Begge virker, så længe serveren tjekker. En RemoteFunction lader knappen vente på serverens svar og vise det, så den bruges i denne guide, og eksemplet med en butik i Roblox' guide til sikkerhed bruger også en RemoteFunction. Kald den kun fra klienten: en server, der kalder InvokeClient, kan komme til at vente for evigt, hvis klienten aldrig svarer. Guiden til RemoteEvent sammenligner begge muligheder.
Hvordan åbner man butikken via en NPC i stedet for en knap?
Læg en ProximityPrompt i en af NPC'ens parts, for eksempel dens HumanoidRootPart, lyt efter dens event Triggered i et Script på serveren, og send en RemoteEvent til den spiller, så et LocalScript viser panelet. Hvis man kun må købe tæt på NPC'en, så tjek også afstanden til NPC'en inde i handleren til BuyItem, fordi klienten kan kalde remoten hvor som helst fra.
Hvordan sælger man ting, der kan købes flere gange?
For den slags ting skal du springe tjekket "har allerede" over og ikke give et Tool, men noget, der kan tælles, for eksempel lægge 1 til en IntValue, der tæller eliksirer. Behold opslaget af prisen og tjekket af mønter, som de er.
Hvorfor forsvinder butikken, når karakteren respawner?
Dens ScreenGui har ResetOnSpawn sat til true, som er standardværdien, så Roblox sletter den ved respawn. Sæt den til false, som scriptet i trin 3 gør.
Kan man bruge en gratis skabelon til en butiks-GUI?
Ja, ethvert layout kan bruges, så længe dets Buy-knapper kun sender tingens id, og selve købet sker i et Script på serveren som ShopService. Før du bruger en skabelon, så tjek, om den trækker mønter eller giver ting i et LocalScript.
Kilder og videre læsning
- Roblox Creator Docs: Securing the client-server boundary (på engelsk). tjek af remotes' argumenter, NaN, begrænsning af hyppighed og eksemplet med en butik i spillet
- Roblox Creator Docs: Remote events and callbacks (på engelsk). RemoteFunction, InvokeServer, OnServerInvoke og risikoen ved InvokeClient
- Roblox Creator Docs: Passes (på engelsk). oprettelse og salg af passes, UserOwnsGamePassAsync og PromptGamePassPurchaseFinished
- Roblox Creator Docs: Shop (på engelsk). den Shop i spillet, som Roblox laver automatisk
- Roblox Creator Docs: Developer Products (på engelsk). gentagne køb for Robux og ProcessReceipt
- Roblox Creator Docs: StarterGear (på engelsk). hvorfor et Tool i StarterGear kommer tilbage efter respawn
- Roblox Creator Docs: In-game tools (på engelsk). Handle, anchoring og RequiresHandle
Sådan blev koden tjekket: hvert script på denne side gennemgår streng Luau-typekontrol med Roblox API-definitionerne (luau-lsp, 20. november 2026). Typekontrollen fanger fejl i API-navne og forkerte typer, men ikke fejl i spillogikken, så test alt i Studio, før du udgiver.