Lyhyesti
Säilytä esineet ja hinnat ModuleScriptissä ReplicatedStoragessa, kokoa ikkuna ScreenGui-, ScrollingFrame- ja UIGridLayout-objekteista ja anna jokaisen Buy-painikkeen kutsua RemoteFunction-objektia niin, että se välittää vain esineen id:n. Sen jälkeen Script ServerScriptServicessä hakee hinnan itse, tarkistaa ja veloittaa pelaajan Coins-arvon ja antaa esineen.
- Älä koskaan anna asiakkaan lähettää hintaa. Kuka tahansa voi kutsua remotejasi millä arvoilla tahansa, joten palvelin ottaa hinnan omasta kopiostaan hintaluettelosta.
- Anna ostettu Tool kloonaamalla se ServerStoragesta pelaajan Backpackiin (jotta sitä voi käyttää heti) ja StarterGeariin (jotta se palaa respawnin jälkeen).
- Robuxilla myytävät asiat ovat passeja ja developer producteja, ja niitä käsitellään MarketplaceServicellä. Niille Roblox luo myös itse Shopin, eikä se ole sama asia kuin kolikkokauppa.
Tällä sivulla
Miten toimiva kauppa on rakennettu
Kauppa, joka toimii oikeassa pelissä, on jaettu pelaajan laitteen ja palvelimen kesken. Laite piirtää ikkunan ja sanoo "haluan ostaa miekan". Palvelin, ainoa osapuoli, johon voi luottaa, päättää, tapahtuuko se. Kauppaskriptit, jotka "eivät toimi" tai jotka pelaajat rikkovat huijauksilla, tekevät tämän päätöksen usein väärällä puolella.
| Osa | Missä se on | Mitä se tekee |
|---|---|---|
ModuleScript ShopCatalog | ReplicatedStorage | Esineiden id:t, nimet, hinnat ja Tool, jonka kukin antaa. Molemmat puolet lukevat sitä. |
RemoteFunction BuyItem | ReplicatedStorage, kansiossa ShopRemotes | Vie ostopyynnön palvelimelle ja vastauksen takaisin. |
LocalScript ShopClient | StarterPlayerScripts | Kokoaa kauppaikkunan ja lähettää esineen id:n, kun Buy-painiketta painetaan. |
Script ShopService | ServerScriptService | Tarkistaa pyynnön, veloittaa Coins-arvon ja antaa Toolin. |
| Toolit, joita myyt | ServerStorage, kansiossa ShopItems | Alkuperäiset, jotka palvelin kopioi. Mitään ServerStoragesta ei lähetetä pelaajille. |
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
Vaihe 1: Kolikot ja myytävät esineet
Kauppa kuluttaa pelaajan leaderstatsin Coins-arvoa. Jos kävit läpi tulostaulukko-oppaan, sinulla on se jo, ja tämän skriptin voi ohittaa. Muuten lisää Script ServerScriptServiceen nimellä Leaderstats. Se antaa jokaiselle 200 kolikkoa aluksi, jotta ostoja voi testata heti.
local Players = game:GetService("Players")
local STARTING_COINS = 200 -- riittää kaupan testaamiseen; aseta 0, kun pelaajat voivat ansaita kolikoita
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
Pidä vain yksi leaderstats-skripti. Kaksi skriptiä, jotka kumpikin luovat leaderstats-kansion, antavat jokaiselle pelaajalle kaksi kansiota, ja kauppa voi lukea väärän.
Luo seuraavaksi objektit, joita skriptit etsivät. Kirjainkoko nimissä on tärkeä, joten kirjoita ne täsmälleen kuten tässä.
- Vie Explorerissa kursori ReplicatedStoragen päälle, paina +-painiketta ja lisää Folder nimellä
ShopRemotes. Lisää sen sisään RemoteFunction nimelläBuyItem. - Vie kursori ServerStoragen päälle ja lisää Folder nimellä
ShopItems. - Laita ShopItemsiin yksi Tool jokaista esinettä kohden, nimillä
ClassicSword,Flashlight,GrappleHookjaSpeedCoil. Ensimmäiseen testiin Toolissa riittää yksi ankkuroimaton Part nimelläHandle. Myös mikä tahansa Tool, joka sinulla jo on, käy: anna sille oikea nimi. Ase, joka oikeasti tekee vahinkoa, kootaan miekkaoppaan tai aseoppaan mukaan; kummassakin kerrotaan, miten se liitetään hintaluetteloon. - Valitse jokainen Tool ja poista rasti kohdasta CanBeDropped Properties-ikkunassa. Kun se on päällä, Backspacen painaminen pudottaa työkalun Workspaceen, ja kuka tahansa pelaaja voi poimia sen, mistä ostaja maksoi.
Voit aloittaa vain yhdellä Toolilla. Jos esineen Tool puuttuu, palvelin kieltäytyy myymästä sitä ja kirjoittaa varoituksen sen nimellä, joten pelaajalta ei veloiteta mitään.
Vaihe 2: Esineet ja hinnat hintaluettelossa
Hintaluettelo on ainoa lista kaikesta, mitä kauppa myy. LocalScript lukee sitä piirtääkseen kortit, ja palvelin lukee sitä löytääkseen hinnat, joten hinnan muuttaminen on yksi muokkaus yhdessä paikassa.
Vie kursori ReplicatedStoragen päälle, lisää ModuleScript, nimeä se uudelleen ShopCatalog ja korvaa sen sisältö tällä:
export type ShopItem = {
id: string, -- tallennetaan myöhemmin tietovarastoon: älä muuta sitä, kun esine on jo pelaajilla
name: string, -- näytetään kortissa; saa muuttaa
price: number, -- Coinseina
description: string,
toolName: string, -- Tool ServerStorage.ShopItemsissa, jonka pelaaja saa
}
-- Kortit ilmestyvät tässä järjestyksessä
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
-- Palauttaa esineen tällä id:llä tai nil, jos sellaista esinettä ei ole
function ShopCatalog.get(id: string): ShopItem?
return byId[id]
end
-- Playerin attribuutti, jonka palvelin asettaa arvoon true, kun esine on pelaajalla
function ShopCatalog.ownedAttribute(id: string): string
return "Owns_" .. id
end
return ShopCatalog
Jokaisella esineellä on id ja erikseen näytettävä name. Palvelin tallentaa nimenomaan id:n, kun jokin on pelaajalla, joten "Classic Sword" voidaan myöhemmin nimetä uudelleen rikkomatta tallennettuja ostoja. Kuvaukset ovat vain korttien tekstiä; sen, mitä Tool tekee, päättävät sen omat skriptit.
Pelaajat voivat lukea ReplicatedStoragen ModuleScriptin, joten nämä hinnat ovat julkisia. Se ei haittaa: ne lukevat korteissa joka tapauksessa. Tärkeää on, että asiakas ja palvelin ajavat kumpikin oman kopionsa moduulista, joten pelaaja, joka muuttaa hintoja omalla laitteellaan, ei muuta mitään palvelimella.
Vaihe 3: Kootaan kaupan GUI
Tämä LocalScript kokoaa koko ikkunan koodissa: Shop-painikkeen, paneelin, jossa on vieritettävä korttiruudukko, Buy-painikkeen jokaiselle hintaluettelon esineelle, Coins-laskurin ja tilarivin palvelimen vastauksille. Koska kaikki on tehty koodilla, voit liittää sen ja painaa Play. Sen jälkeinen taulukko luettelee jokaisen objektin, jos haluat koota ikkunan käsin.
- Avaa Explorerissa StarterPlayer, vie kursori StarterPlayerScriptsin päälle ja lisää LocalScript nimellä
ShopClient. - Korvaa sen sisältö alla olevalla koodilla.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- Mitä ShopCatalog-moduuli palauttaa, jotta tiukka tyyppitarkistus tarkistaa käyttämämme kentät
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: sisältää kaiken, mitä kauppa piirtää pelaajan näytölle
local gui = Instance.new("ScreenGui")
gui.Name = "ShopGui"
gui.ResetOnSpawn = false -- kauppa pysyy, kun hahmo respawnaa
-- Painike vasemmassa reunassa, joka avaa ja sulkee kaupan
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)
-- Kauppaikkuna: keskellä, piilossa kunnes pelaaja avaa sen
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) -- estää ikkunaa kasvamasta valtavaksi suurilla näytöillä
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
-- Tässä näytetään palvelimen vastaukset, esimerkiksi "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: alue, joka vierittyy, kun kortteja on enemmän kuin mahtuu
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() -- alkaa nollasta; AutomaticCanvasSize venyttää sen korttien mukaan
list.AutomaticCanvasSize = Enum.AutomaticSize.Y
list.Parent = panel
-- UIGridLayout: asettelee kortit riveihin ja rivittää ne seuraavalle riville
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..."
-- Lähetetään vain esineen id. Hinnan palvelin hakee itse.
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)
-- Palvelin asettaa tämän attribuutin, kun osto onnistui (tai kun tallennetut esineet latautuivat)
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")
-- Näytetään pelaajan kolikot. Oikea arvo on palvelimella; tässä se vain näytetään.
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()
Painikkeet käyttävät Activated-tapahtumaa eivätkä MouseButton1Click-tapahtumaa: se laukeaa hiiren klikkauksesta, puhelimen kosketuksesta ja ohjaimen A- tai ristipainikkeesta.
Ylhäällä olevat type-määritykset kuvaavat, mitä ShopCatalog palauttaa, jotta tiukka tyyppitarkistus löytää kentän kirjoitusvirheen, kuten item.prise. Kun peli on käynnissä, ne eivät muuta mitään.
| Objekti | Tehtävä kaupassa | Tärkeimmät ominaisuudet |
|---|---|---|
ScreenGui | Sisältää kaiken näytölle piirretyn | ResetOnSpawn false, jotta kauppa säilyy respawnin yli |
Frame | Ikkuna ja jokainen esinekortti | AnchorPoint 0.5, 0.5 ja Position 0.5, 0.5, jotta ikkuna on keskellä |
UISizeConstraint | Rajoittaa ikkunaa suurilla näytöillä | MaxSize 640 x 460 |
ScrollingFrame | Vierittyy, kun kortteja on enemmän kuin mahtuu | CanvasSize 0 ja AutomaticCanvasSize Y, jotta vieritysalue kasvaa korttien mukana |
UIGridLayout | Asettaa kortit riveihin ja rivittää ne | CellSize 180 x 200, CellPadding 12, SortOrder LayoutOrder |
UICorner | Pyöristää kulmat | CornerRadius 8-14 pikseliä |
UIPadding | Sisäiset reunukset | 10-12 pikseliä joka puolella |
TextButton | Shop-, sulje- ja Buy-painikkeet | Tapahtuma Activated |
Jos haluat piirtää ikkunan käsin, kokoa samat objektit StarterGuihin näillä ominaisuuksilla, aseta sielläkin ScreenGuin ResetOnSpawn arvoon false ja jätä yksi kortti pohjaksi, jonka LocalScript kloonaa jokaiselle hintaluettelon esineelle. Silloin skripti vain täyttää kortit ja kytkee painikkeet. Seuraavan vaiheen ostologiikka ei muutu.
Jos pelisi alkaa päävalikosta, siinä oppaassa on yksi rivi, joka lisätään ShopClientiin, jotta Shop-painike ilmestyy vasta sen jälkeen, kun pelaaja on painanut Play. Jotta kauppa aukeaisi kauppiaan kanssa puhumalla, NPC-dialogiopas näyttää, miten lisätään OpenShop-toiminto, joka käskee ShopClientin avata ikkunan, ja ostot kulkevat edelleen kaupan palvelintarkistusten kautta.
Vaihe 4: Tarkistus ja osto palvelimella
Tämä Script on ainoa paikka, jossa osto voi tapahtua. Se saa esineen id:n, tarkistaa sen, hakee hinnan, tarkistaa pelaajan Coins-arvon, veloittaa sitten kolikot ja antaa Toolin. Buy-painikkeelle se vastaa true tai false sekä näytettävän viestin.
Vie kursori ServerScriptServicen päälle, lisää Script nimellä ShopService ja liitä siihen tämä:
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")
-- Mitä ShopCatalog-moduuli palauttaa, jotta tiukka tyyppitarkistus tarkistaa käyttämämme kentät
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: pelaaja voi käyttää työkalua heti
local backpack = player:FindFirstChildOfClass("Backpack")
if backpack then
template:Clone().Parent = backpack
end
-- StarterGear: Roblox kopioi sen uudelleen Backpackiin aina, kun hahmo ilmestyy
local starterGear = player:FindFirstChildOfClass("StarterGear")
if starterGear then
template:Clone().Parent = starterGear
end
end
local function onBuyItem(player: Player, itemId: unknown): (boolean, string)
-- 1. Asiakas lähettää vain esineen id:n, joten sen on oltava merkkijono
if type(itemId) ~= "string" then
return false, "That item does not exist."
end
-- 2. Ohitetaan tuplaklikkaukset ja skriptien pyyntötulvat
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. Etsitään esine palvelimen omasta kopiosta hintaluettelosta
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. Hinta otetaan hintaluettelosta eikä koskaan asiakkaalta
if coins.Value < item.price then
return false, `You need {item.price - coins.Value} more coins.`
end
-- 5. Veloitetaan kolikot, sitten annetaan esine. Mikään tässä ei luovuta suoritusvuoroa, joten kaksi pyyntöä
-- samalta pelaajalta eivät voi molemmat läpäistä yllä olevia tarkistuksia ennen kuin tämä on suoritettu.
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)
Omistus tallennetaan Playerin attribuuttina, esimerkiksi Owns_sword. Palvelimen asettamat attribuutit replikoituvat pelaajan laitteelle, joten LocalScript voi vaihtaa kortin tilaan "Owned". Muutos, jonka pelaaja tekee omaan kopioonsa, ei mene palvelimelle asti.
Tool päätyy kahteen paikkaan. Backpackin kopio ilmestyy heti pikapalkkiin. StarterGearin kopion Roblox laittaa uuteen Backpackiin aina, kun hahmo ilmestyy. Ilman sitä ostettu esine katoaa heti pelaajan ensimmäisessä kuolemassa.
Miksi asiakas ei koskaan lähetä hintaa
Kaiken, mikä on pelaajan laitteella, pelaaja voi muuttaa. Huijarit ajavat omaa koodiaan omassa kopiossaan pelistä: he voivat lukea LocalScriptisi, muuttaa GUI:ta ja kutsua BuyItem:InvokeServer() millä argumenteilla tahansa niin monta kertaa kuin haluavat. Robloxin turvallisuusoppaan mukaan kaiken, mitä remote saa, tyyppi ja arvo on tarkistettava, ja esimerkkinä on juuri kauppa.
| Huijari lähettää | Jos palvelin uskoisi häntä | Mitä ShopService tekee |
|---|---|---|
| Hinnan 0 | Kaikki esineet ovat ilmaisia | Ohittaa sen. Hinta otetaan hintaluettelosta. |
| Hinnan -1000 | Coins.Value -= -1000 antaa hänelle 1 000 kolikkoa | Ohittaa sen. |
NaN hinnan sijaan | Mikä tahansa vertailu NaN:iin on epätosi, joten "kolikot eivät riitä" -tarkistus ei koskaan laukea | Ohittaa sen. |
| Id:n, jota ei ole hintaluettelossa, tai taulukon merkkijonon sijaan | Virheitä skriptissä tai esineitä, joita et aikonut myydä | Vastaa "That item does not exist." |
| Satoja pyyntöjä sekunnissa | Kuormaa palvelimelle, ja mikä tahansa aukko tarkistuksissa laukeaa satoja kertoja | Käsittelee enintään yhden pyynnön pelaajalta puolessa sekunnissa. |
| Omalla näytöllään muutetut Coinsit | Ostoja kolikoilla, joita hänellä ei ole | Ei näe sitä lainkaan. Palvelin lukee vain omaa Coins-arvoaan. |
Tämä sääntö sopii jokaiseen kirjoittamaasi remoteen: lähetä se, minkä pelaaja valitsi, esimerkiksi esineen id tai paikan numero, äläkä koskaan sitä, paljonko se maksaa tai mitä hänen pitäisi saada. RemoteEvent-opas käy remoten argumenttien tarkistuksen läpi tarkemmin.
Vaihe 5: Testataan kauppa
- Paina Play. Vasemmalle ilmestyy Shop-painike. Avaa se ja osta Flashlight: Coins vähenee 25:llä, työkalu ilmestyy pikapalkkiin ja sen painike vaihtuu tekstiin Owned.
- Kokeile Speed Coilia, joka maksaa 300. Tilarivi kertoo, montako kolikkoa vielä puuttuu, eikä mitään veloiteta.
- Nollaa hahmo pelin sisäisestä valikosta. Flashlight palaa uuteen Backpackiin StarterGearin kopion ansiosta.
- Lisätäksesi itsellesi kolikoita testin aikana paina Client/Server-kytkintä ja siirry Serveriin, etsi Explorerista
Players, oma nimesi,leaderstats,Coinsja muuta sen Value Properties-ikkunassa. Sama Client-tilassa muuttaa vain omaa näyttöäsi, ja se on juuri sellainen muutos, jonka palvelin ohittaa.
Jos painike vastaa "The shop did not answer", avaa Output-ikkuna Studion Window-valikosta ja etsi ShopServicen punainen virhe. Jos taas painike jää tilaan "Buying...", ShopService ei ole käynnissä tai on jumissa odottamassa objektia: katso yleiset virheet.
Pelipassin myynti Robuxilla
Kolikot ovat omaa valuuttaasi, joten yllä oleva kauppa päättää itse jokaisesta ostosta. Se, mitä pelaaja ostaa Robuxilla, toimii toisin: pelipassi ostetaan kerran ja se pysyy ikuisesti (VIP-edut, pysyvä työkalu), kun taas developer productin voi ostaa yhä uudelleen (kolikkopaketti, tason ohitus). Molemmat kulkevat Robloxin MarketplaceServicen kautta, ja maksun ottaa vastaan Roblox eikä skriptisi.
Tästä oppaasta siirtyy kaksi sääntöä: käynnistä ostoikkuna painikkeella asiakkaalla, mutta anna etu vain palvelimella, kun Roblox on vahvistanut oston tai passi on jo pelaajalla. Pelipassiskriptin opas kokoaa tämän kokonaan: omistuksen tarkistuksen liittymisen yhteydessä, ostoikkunan, edut kuten VIP-oven ja milloin passin sijaan kannattaa ottaa developer product. Hinnan valintaan ilmainen Robux-palkkiolaskuri näyttää, paljonko passi tai developer product tuo sinulle Robloxin osuuden jälkeen.
Pelaajien ostojen tallennus
Kaikki tekemämme elää yhden istunnon: kolikot ja ostetut esineet nollautuvat, kun pelaaja poistuu, kunnes tallennat ne tietovaraston kautta. Jotta tallennuskoodia ei toisteta tässä, käy läpi DataStore-tutoriaali (tai tulostaulukko-oppaan vaihe 3, siellä on lyhyempi versio) ja muista kaupan säännöt:
- Tallenna esineiden id:t, esimerkiksi
{ "sword", "flashlight" }, samaan taulukkoon kuin Coins-arvo, jotta yksi tallennus kirjaa sekä käytetyt kolikot että ostetun esineen. Tooleja ja muita instansseja ei voi laittaa tietovarastoon. - Kun tiedot ovat latautuneet, käy tallennetut id:t läpi, ohita ne, joita ei enää ole hintaluettelossa, aseta jokainen
Owns_-attribuutti ja anna Tool samalla tavalla kuingiveTooltekee. Kauppaikkuna päivittyy itsestään, koska se kuuntelee näitä attribuutteja. - Passin omistusta ei tarvitse tallentaa:
UserOwnsGamePassAsynckysyy Robloxilta aina, kun pelaaja liittyy. - Älä koskaan tallenna pelaajaa, jonka tiedot eivät latautuneet, muuten epäonnistunut lataus voi korvata hänen ostonsa tyhjällä listalla.
Yleiset virheet ja ratkaisut
Kun kauppa käyttäytyy oudosti, tarkista ensin nämä. Avaa ensimmäiseksi Output-ikkuna (Window-valikko, sitten Output): skriptivirhe kertoo skriptin ja rivin.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("ShopRemotes")'
Skripti odottaa objektia, jota ei ole juuri tällä nimellä. Tarkista ShopRemotesin, BuyItemin, ShopCatalogin ja ShopItemsin kirjoitusasu ja isot kirjaimet sekä se, että ShopItems on ServerStoragessa eikä ReplicatedStoragessa. Skriptivirheiden opas käy tämän varoituksen läpi tarkemmin.
Buy-painike jää tilaan "Buying..." eikä vastaa
Palvelimella kukaan ei ole asettanut BuyItem.OnServerInvoke-arvoa, joten Roblox pitää pyyntöä, kunnes niin tapahtuu. Varmista, että ShopService on Script eikä LocalScript ja että se on ServerScriptServicessä, ja etsi Outputista ShopServicen varoitus Infinite yield possible: se tarkoittaa, että skripti on jumissa odottamassa ShopCatalogia, ShopRemotesia tai ShopItemsia.
Buy-painikkeessa lukee "The shop did not answer"
Palvelinkutsu kaatui eikä palauttanut vastausta. Tavallinen syy on virhe ShopServicen sisällä pyynnön käsittelyn aikana, joten etsi Outputista ShopServicen punainen virhe: siinä on rivi.
Painikkeessa lukee "This item is not available right now"
Palvelin ei löytänyt Toolia, jolla on tämän esineen toolName, ServerStoragen ShopItemsin sisältä. Outputissa on varoitus, jossa on tarkka nimi, jota se etsi.
Ostin työkalun, mutta hahmo ei pysty pitämään sitä tai jää jumiin
Toolissa pitää olla täsmälleen yksi part nimellä Handle suoraan sisällä, eikä mikään sen parteista saa olla ankkuroitu. Työkalulle, jota ei tarvitse pitää kädessä, poista sen sijaan rasti kohdasta RequiresHandle.
Kolikot vähenivät omalla näytölläni, mutta eivät muilla
Osto tapahtui LocalScriptissä, joten vain sinun laitteesi muuttui. Siirrä kolikoiden veloitus ja Toolin antaminen palvelimen Scriptiin, kuten vaiheessa 4.
Ostetut esineet katoavat uudelleen liittymisen jälkeen
Mitään ei vielä tallenneta. Katso ostojen tallennus.
Tee se RoCodella
Jos et halua koota tätä kaikkea käsin, RoCode voi tehdä sen paikkaan, joka sinulla on auki. Se on itsenäinen tekoälyagentti koodille: kuvailet ominaisuuden sen verkkochatissa, ja sen Roblox Studio -lisäosa luo skriptit, remoten ja GUI:n Exploreriisi, joten koodia ei tarvitse kopioida chat-ikkunasta.
Lisää kolikkokauppa: Shop-painike, joka avaa neljän työkalun ruudukon, jonka hinnat ovat Coinseina leaderstatsistani. Palvelimen pitää tarkistaa hinta ja antaa työkalu Backpackiin ja StarterGeariin.
- Voi käydä paikkasi läpi Search Scriptsillä ja Read Scriptillä etsien jo olemassa olevia leaderstatseja ja kauppakoodia, jotta se käyttää sinun Coins-arvoasi eikä lisää toista
- Voi koota ikkunan rungon Build UI:lla: kaupan asettelussa on paikkamerkkikortit ja LocalScript hover-efekteille ja Close-painikkeelle; ostologiikka kirjoitetaan erillisinä skripteinä
- Luo RemoteFunctionin Create Instancella ja kirjoittaa hintaluettelon ModuleScriptin, palvelimen Scriptin ja LocalScriptin Create Scriptillä
- Tarkistaa jokaisen skriptin kääntymisen Studiossa Check Scriptillä (se ei tarkista tyyppejä eikä aja skriptejä), ja jokainen muutoserä on kumouspiste Studiossa
Passit sinun on silti luotava Creator Hubissa itse, koska RoCode ei osaa luoda passeja eikä developer producteja, ja myös ostot testaat sinä: lisäosalla 3.9 tai uudemmalla RoCode voi ajaa lyhyen pelitestin ja lukea virheet, ja lisäosalla 3.9.15 tai uudemmalla sen testihahmo voi painaa Shop- ja Buy-painikkeita, mutta se tarkistaa vain sen, minkä se itse päätti testata. Kauppa tulee yleensä ydinpelattavuuden ja tallennuksen jälkeen; pelin teon vaiheittainen kierros RoCodella näyttää, mihin se kuuluu. Miten RoCode yhdistyy Studioon.
Usein kysytyt kysymykset
Kumpi on parempi Buy-painikkeelle Robloxissa: RemoteEvent vai RemoteFunction?
Kumpi tahansa käy, kunhan palvelin tarkistaa. RemoteFunctionin avulla painike voi odottaa palvelimen vastausta ja näyttää sen, joten oppaassa käytetään sitä, ja Robloxin turvallisuusoppaan kauppaesimerkkikin käyttää RemoteFunctionia. Kutsu sitä vain asiakkaalta: palvelin, joka kutsuu InvokeClient-metodia, voi odottaa ikuisesti, jos asiakas ei koskaan vastaa. RemoteEvent-opas vertaa molempia vaihtoehtoja.
Miten kauppa avataan NPC:n kautta eikä painikkeella?
Laita ProximityPrompt johonkin NPC:n parttiin, esimerkiksi sen HumanoidRootPartiin, kuuntele sen Triggered-tapahtumaa palvelimen Scriptissä ja lähetä tälle pelaajalle RemoteEvent, jotta LocalScript näyttää paneelin. Jos ostaa saa vain NPC:n lähellä, tarkista lisäksi etäisyys NPC:hen BuyItemin käsittelijän sisällä, koska asiakas voi kutsua remotea mistä tahansa.
Miten myydään esineitä, joita voi ostaa useita kertoja?
Ohita sellaisille esineille "on jo" -tarkistus ja anna Toolin sijaan jotain laskettavaa, esimerkiksi lisää 1 IntValueen, joka laskee juomia. Jätä hinnan haku ja kolikkotarkistus ennalleen.
Miksi kauppa katoaa, kun hahmo respawnaa?
Sen ScreenGuin ResetOnSpawn on true, mikä on oletusarvo, joten Roblox poistaa sen respawnissa. Aseta false, kuten vaiheen 3 skripti tekee.
Voiko käyttää ilmaista kaupan GUI-pohjaa?
Kyllä, mikä tahansa asettelu käy, kunhan sen Buy-painikkeet lähettävät vain esineen id:n ja itse osto tapahtuu ShopServicen kaltaisessa palvelimen Scriptissä. Ennen kuin otat pohjan käyttöön, tarkista, ettei kolikoita veloiteta tai esineitä anneta LocalScriptissä.
Lähteet ja lisälukemista
- Roblox Creator Docs: Securing the client-server boundary (englanniksi). remotejen argumenttien tarkistus, NaN, pyyntötiheyden rajoitus ja esimerkki pelin sisäisestä kaupasta
- Roblox Creator Docs: Remote events and callbacks (englanniksi). RemoteFunction, InvokeServer, OnServerInvoke ja InvokeClientin riskit
- Roblox Creator Docs: Passes (englanniksi). passien luonti ja myynti, UserOwnsGamePassAsync ja PromptGamePassPurchaseFinished
- Roblox Creator Docs: Shop (englanniksi). pelin sisäinen Shop, jonka Roblox luo automaattisesti
- Roblox Creator Docs: Developer Products (englanniksi). toistettavat Robux-ostot ja ProcessReceipt
- Roblox Creator Docs: StarterGear (englanniksi). miksi StarterGearissa oleva Tool palaa respawnin jälkeen
- Roblox Creator Docs: In-game tools (englanniksi). Handle, ankkurointi ja RequiresHandle
Miten koodi tarkistettiin: jokainen tämän sivun skripti läpäisee Luaun tiukan tyyppitarkistuksen Roblox API:n määrittelyillä (luau-lsp, 20. marraskuuta 2026). Tyyppitarkistus löytää virheet API-nimissä ja väärät tyypit, mutta ei pelilogiikan virheitä, joten testaa kaikki Studiossa ennen julkaisua.