Tutoriaali · Pelijärjestelmät

Miten tehdä kauppa Roblox Studiossa

Kauppa Roblox-pelissä on kaksi tehtävää: GUI, joka näyttää esineet, ja palvelinskripti, joka päättää, toteutuuko osto. Tässä oppaassa kokoamme molemmat kolikkokauppaan, joka myy työkaluja, ja näytämme, mihin Robux-ostot kuuluvat.

Päivitetty 20. marraskuuta 202610 min lukuaikaKirjoittaja:

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
  1. Miten se toimii
  2. 1. Valmistelu
  3. 2. Esineluettelo
  4. 3. Kaupan GUI
  5. 4. Ostot palvelimella
  6. Miksi ei hintaa asiakkaalta
  7. 5. Testi
  8. Pelipassi
  9. Ostojen tallennus
  10. Common errors
  11. RoCodella
  12. Usein kysytyt kysymykset
  13. Lähteet ja lisälukemista

Miten toimiva kauppa on rakennettu

HavainnekuvaPelaaja avaa kaupan ja ostaa Flashlightin 25 kolikolla: Coins putoaa 200:sta 175:een, painike vaihtuu tekstiin Owned ja työkalu ilmestyy pikapalkkiin.

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.

Kaupan viisi osaa
OsaMissä se onMitä se tekee
ModuleScript ShopCatalogReplicatedStorageEsineiden id:t, nimet, hinnat ja Tool, jonka kukin antaa. Molemmat puolet lukevat sitä.
RemoteFunction BuyItemReplicatedStorage, kansiossa ShopRemotesVie ostopyynnön palvelimelle ja vastauksen takaisin.
LocalScript ShopClientStarterPlayerScriptsKokoaa kauppaikkunan ja lähettää esineen id:n, kun Buy-painiketta painetaan.
Script ShopServiceServerScriptServiceTarkistaa pyynnön, veloittaa Coins-arvon ja antaa Toolin.
Toolit, joita myytServerStorage, kansiossa ShopItemsAlkuperäiset, jotka palvelin kopioi. Mitään ServerStoragesta ei lähetetä pelaajille.
Explorer, kun kauppa on valmis
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.

Script kohteessa ServerScriptService nimeltä Leaderstats
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ä.

  1. Vie Explorerissa kursori ReplicatedStoragen päälle, paina +-painiketta ja lisää Folder nimellä ShopRemotes. Lisää sen sisään RemoteFunction nimellä BuyItem.
  2. Vie kursori ServerStoragen päälle ja lisää Folder nimellä ShopItems.
  3. Laita ShopItemsiin yksi Tool jokaista esinettä kohden, nimillä ClassicSword, Flashlight, GrappleHook ja SpeedCoil. 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.
  4. 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ä:

ModuleScript kohteessa ReplicatedStorage nimeltä ShopCatalog
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.

  1. Avaa Explorerissa StarterPlayer, vie kursori StarterPlayerScriptsin päälle ja lisää LocalScript nimellä ShopClient.
  2. Korvaa sen sisältö alla olevalla koodilla.
LocalScript kohteessa StarterPlayerScripts nimeltä ShopClient
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.

GUI-objektit ja tärkeät ominaisuudet
ObjektiTehtävä kaupassaTärkeimmät ominaisuudet
ScreenGuiSisältää kaiken näytölle piirretynResetOnSpawn false, jotta kauppa säilyy respawnin yli
FrameIkkuna ja jokainen esinekorttiAnchorPoint 0.5, 0.5 ja Position 0.5, 0.5, jotta ikkuna on keskellä
UISizeConstraintRajoittaa ikkunaa suurilla näytöilläMaxSize 640 x 460
ScrollingFrameVierittyy, kun kortteja on enemmän kuin mahtuuCanvasSize 0 ja AutomaticCanvasSize Y, jotta vieritysalue kasvaa korttien mukana
UIGridLayoutAsettaa kortit riveihin ja rivittää neCellSize 180 x 200, CellPadding 12, SortOrder LayoutOrder
UICornerPyöristää kulmatCornerRadius 8-14 pikseliä
UIPaddingSisäiset reunukset10-12 pikseliä joka puolella
TextButtonShop-, sulje- ja Buy-painikkeetTapahtuma 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ä:

Script kohteessa ServerScriptService nimeltä ShopService
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.

Mitä tapahtuu, jos palvelin luottaa asiakkaaseen
Huijari lähettääJos palvelin uskoisi häntäMitä ShopService tekee
Hinnan 0Kaikki esineet ovat ilmaisiaOhittaa sen. Hinta otetaan hintaluettelosta.
Hinnan -1000Coins.Value -= -1000 antaa hänelle 1 000 kolikkoaOhittaa sen.
NaN hinnan sijaanMikä tahansa vertailu NaN:iin on epätosi, joten "kolikot eivät riitä" -tarkistus ei koskaan laukeaOhittaa sen.
Id:n, jota ei ole hintaluettelossa, tai taulukon merkkijonon sijaanVirheitä skriptissä tai esineitä, joita et aikonut myydäVastaa "That item does not exist."
Satoja pyyntöjä sekunnissaKuormaa palvelimelle, ja mikä tahansa aukko tarkistuksissa laukeaa satoja kertojaKäsittelee enintään yhden pyynnön pelaajalta puolessa sekunnissa.
Omalla näytöllään muutetut CoinsitOstoja kolikoilla, joita hänellä ei oleEi 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

  1. 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.
  2. Kokeile Speed Coilia, joka maksaa 300. Tilarivi kertoo, montako kolikkoa vielä puuttuu, eikä mitään veloiteta.
  3. Nollaa hahmo pelin sisäisestä valikosta. Flashlight palaa uuteen Backpackiin StarterGearin kopion ansiosta.
  4. Lisätäksesi itsellesi kolikoita testin aikana paina Client/Server-kytkintä ja siirry Serveriin, etsi Explorerista Players, oma nimesi, leaderstats, Coins ja 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 kuin giveTool tekee. Kauppaikkuna päivittyy itsestään, koska se kuuntelee näitä attribuutteja.
  • Passin omistusta ei tarvitse tallentaa: UserOwnsGamePassAsync kysyy 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.

Sinä kirjoitat

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.

RoCode tekee
  • 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

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.

Kokeile RoCodea omassa pelissäsi.

Ilmaisia krediittejä joka päivä, ei korttia. Asenna lisäosa, kuvaile ominaisuus ja katso, mitä Studioon ilmestyi.