Tutorial · Sistem permainan

Cara buat kedai dalam Roblox Studio

Kedai dalam game Roblox terdiri daripada dua tugas: GUI yang memaparkan item, dan skrip pelayan yang memutuskan sama ada pembelian berlaku. Dalam panduan ini kita membina kedua-duanya untuk kedai syiling yang menjual tool, dan menunjukkan tempat untuk pembelian dengan Robux.

Dikemas kini 20 November 202612 minit bacaanDitulis oleh

Ringkasnya

Simpan item dan harga dalam ModuleScript dalam ReplicatedStorage, bina tetingkap daripada ScreenGui, ScrollingFrame dan UIGridLayout, dan biarkan setiap butang Buy memanggil RemoteFunction dengan menghantar id item sahaja. Selepas itu Script dalam ServerScriptService mencari harga sendiri, menyemak dan menolak Coins pemain dan memberi item.

  • Jangan sekali-kali biarkan client menghantar harga. Sesiapa sahaja boleh memanggil remote anda dengan apa-apa nilai, jadi pelayan mengambil harga daripada salinan katalognya sendiri.
  • Beri Tool yang dibeli dengan mengklon daripada ServerStorage ke Backpack pemain (untuk digunakan serta-merta) dan ke StarterGear (supaya ia kembali selepas respawn).
  • Apa yang dijual dengan Robux ialah pass dan developer product, dan ia diuruskan oleh MarketplaceService. Untuk barangan itu Roblox juga mencipta Shop sendiri, dan itu tidak sama dengan kedai syiling.
Di halaman ini
  1. Cara ia disusun
  2. 1. Persediaan
  3. 2. Katalog item
  4. 3. GUI kedai
  5. 4. Pembelian pada pelayan
  6. Kenapa tiada harga daripada client
  7. 5. Ujian
  8. Game pass
  9. Simpan pembelian
  10. Common errors
  11. Dengan RoCode
  12. Soalan lazim
  13. Sumber dan bacaan lanjut

Cara kedai yang berfungsi disusun

IlustrasiPemain membuka kedai dan membeli Flashlight dengan 25 syiling: Coins turun daripada 200 kepada 175, butang berubah kepada Owned, dan tool muncul dalam hotbar.

Kedai yang berfungsi dalam game sebenar dibahagikan antara peranti pemain dan pelayan. Peranti melukis tetingkap dan berkata "saya mahu beli pedang". Pelayan, satu-satunya pihak yang boleh dipercayai, memutuskan sama ada ia berlaku. Skrip kedai yang "tidak berfungsi" atau yang dirosakkan pemain dengan cheat selalunya membuat keputusan ini di pihak yang salah.

Lima bahagian kedai
BahagianLokasiApa yang dibuat
ModuleScript ShopCatalogReplicatedStorageId item, nama, harga dan Tool yang diberi oleh setiap satu. Dibaca oleh kedua-dua pihak.
RemoteFunction BuyItemReplicatedStorage, dalam folder ShopRemotesMembawa permintaan pembelian ke pelayan dan jawapan kembali.
LocalScript ShopClientStarterPlayerScriptsMembina tetingkap kedai dan menghantar id item apabila butang Buy ditekan.
Script ShopServiceServerScriptServiceMenyemak permintaan, menolak Coins dan memberi Tool.
Tools yang anda jualServerStorage, dalam folder ShopItemsAsal yang disalin oleh pelayan. Tiada apa dalam ServerStorage dihantar kepada pemain.
Explorer apabila kedai sudah siap
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

Langkah 1: Syiling dan item untuk dijual

Kedai membelanjakan nilai Coins dalam leaderstats pemain. Jika anda sudah mengikuti panduan leaderboard, anda sudah ada nilai itu dan boleh langkau skrip ini. Jika tidak, masukkan Script ke dalam ServerScriptService bernama Leaderstats. Ia memberi setiap orang 200 syiling pada permulaan supaya pembelian boleh diuji serta-merta.

Script dalam ServerScriptService bernama Leaderstats
local Players = game:GetService("Players")

local STARTING_COINS = 200 -- cukup untuk menguji kedai; tetapkan 0 apabila pemain boleh memperoleh syiling

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

Simpan satu skrip leaderstats sahaja. Dua skrip yang masing-masing mencipta folder leaderstats memberi setiap pemain dua folder, dan kedai mungkin membaca yang salah.

Seterusnya cipta objek yang dicari oleh skrip. Huruf besar dan kecil dalam nama penting, jadi tulis tepat seperti di sini.

  1. Dalam Explorer, halakan kursor pada ReplicatedStorage, klik butang + dan masukkan Folder bernama ShopRemotes. Di dalamnya, masukkan RemoteFunction bernama BuyItem.
  2. Halakan kursor pada ServerStorage dan masukkan Folder bernama ShopItems.
  3. Letakkan dalam ShopItems satu Tool bagi setiap item, bernama ClassicSword, Flashlight, GrappleHook dan SpeedCoil. Untuk ujian pertama, Tool cukup dengan satu Part tidak diikat (unanchored) bernama Handle. Mana-mana Tool yang sudah anda ada juga sesuai: beri nama yang betul. Senjata yang benar-benar mencederakan boleh dibina dengan panduan pedang atau panduan senapang; setiap satu menerangkan cara menyambungkannya dengan katalog.
  4. Pilih setiap Tool dan nyahtanda CanBeDropped dalam tetingkap Properties. Apabila ia ditanda, menekan Backspace menjatuhkan tool ke dalam Workspace, dan mana-mana pemain boleh mengambil apa yang dibayar oleh pembeli.

Anda boleh bermula dengan satu Tool sahaja. Jika Tool sesuatu item tiada, pelayan enggan menjual item itu dan menulis amaran dengan namanya, jadi tiada apa ditolak daripada pemain.

Langkah 2: Item dan harga dalam katalog

Katalog ialah satu-satunya senarai semua yang dijual oleh kedai. LocalScript membacanya untuk melukis kad, dan pelayan membacanya untuk mencari harga, jadi menukar harga ialah satu suntingan di satu tempat.

Halakan kursor pada ReplicatedStorage, masukkan ModuleScript, namakan semula sebagai ShopCatalog dan gantikan kandungannya dengan ini:

ModuleScript dalam ReplicatedStorage bernama ShopCatalog
export type ShopItem = {
	id: string, -- kemudian disimpan dalam stor data: jangan ubah apabila pemain sudah memiliki item ini
	name: string, -- dipaparkan pada kad; boleh diubah
	price: number, -- dalam Coins
	description: string,
	toolName: string, -- Tool dalam ServerStorage.ShopItems yang diterima pemain
}

-- Kad muncul mengikut susunan ini
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

-- Memulangkan item dengan id ini, atau nil jika item itu tiada
function ShopCatalog.get(id: string): ShopItem?
	return byId[id]
end

-- Atribut Player yang ditetapkan pelayan kepada true apabila pemain memiliki item itu
function ShopCatalog.ownedAttribute(id: string): string
	return "Owns_" .. id
end

return ShopCatalog

Setiap item ada id dan name paparan yang berasingan. Pelayan merekod id apabila pemain memiliki sesuatu, jadi "Classic Sword" boleh dinamakan semula kemudian tanpa merosakkan pembelian yang disimpan. Penerangan hanyalah teks pada kad; apa yang dibuat oleh Tool ditentukan oleh skripnya sendiri.

Pemain boleh membaca ModuleScript dalam ReplicatedStorage, jadi harga ini terbuka kepada umum. Itu tidak mengapa: harga memang tertulis pada kad. Yang penting, client dan pelayan masing-masing menjalankan salinan modul sendiri, jadi pemain yang menukar harga pada perantinya tidak mengubah apa-apa pada pelayan.

Langkah 3: Bina GUI kedai

LocalScript ini membina seluruh tetingkap dalam kod: butang Shop, panel dengan grid kad yang boleh diskrol, satu butang Buy bagi setiap item katalog, kaunter Coins dan baris status untuk jawapan pelayan. Kerana semuanya dibuat dengan kod, anda boleh tampal dan tekan Play. Jadual selepasnya menyenaraikan setiap objek jika anda mahu menyusun tetingkap secara manual.

  1. Dalam Explorer, kembangkan StarterPlayer, halakan kursor pada StarterPlayerScripts dan masukkan LocalScript bernama ShopClient.
  2. Gantikan kandungannya dengan kod di bawah.
LocalScript dalam StarterPlayerScripts bernama ShopClient
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

-- Apa yang dipulangkan oleh modul ShopCatalog, supaya semakan jenis ketat menyemak medan yang kita guna
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: menyimpan semua yang dilukis oleh kedai pada skrin pemain
local gui = Instance.new("ScreenGui")
gui.Name = "ShopGui"
gui.ResetOnSpawn = false -- kedai kekal apabila watak respawn

-- Butang di tepi kiri yang membuka dan menutup kedai
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)

-- Tetingkap kedai: di tengah, tersembunyi sehingga pemain membukanya
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) -- menghalang tetingkap menjadi terlalu besar pada skrin besar
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

-- Jawapan pelayan dipaparkan di sini, contohnya "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: kawasan yang diskrol apabila kad lebih banyak daripada yang muat
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() -- bermula dari sifar; AutomaticCanvasSize meregangkannya mengikut kad
list.AutomaticCanvasSize = Enum.AutomaticSize.Y
list.Parent = panel

-- UIGridLayout: menyusun kad dalam baris dan memindahkannya ke baris seterusnya
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..."

		-- Hantar id item sahaja. Pelayan mencari harga sendiri.
		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)

	-- Pelayan menetapkan atribut ini apabila pembelian berjaya (atau apabila item yang disimpan dimuatkan)
	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")

-- Paparkan syiling pemain. Nilai sebenar ada pada pelayan; di sini ia hanya dipaparkan.
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()

Butang menggunakan Activated, bukan MouseButton1Click: ia dicetuskan oleh klik tetikus, sentuhan pada telefon dan butang A atau silang pada gamepad.

Definisi type di bahagian atas menerangkan apa yang dipulangkan oleh ShopCatalog, supaya semakan jenis ketat menangkap salah taip dalam medan, contohnya item.prise. Semasa game berjalan, ia tidak mengubah apa-apa.

Objek GUI dan sifat penting
ObjekTugas dalam kedaiSifat utama
ScreenGuiMenyimpan semua yang dilukis pada skrinResetOnSpawn false, supaya kedai kekal selepas respawn
FrameTetingkap dan setiap kad itemAnchorPoint 0.5, 0.5 dan Position 0.5, 0.5, supaya tetingkap berada di tengah
UISizeConstraintMengehadkan tetingkap pada skrin besarMaxSize 640 kali 460
ScrollingFrameDiskrol apabila kad lebih banyak daripada yang muatCanvasSize 0 dan AutomaticCanvasSize Y, supaya kawasan skrol membesar bersama kad
UIGridLayoutMenyusun kad dalam baris dan memindahkannyaCellSize 180 kali 200, CellPadding 12, SortOrder LayoutOrder
UICornerMembulatkan bucuCornerRadius 8 hingga 14 piksel
UIPaddingJarak dalaman10 hingga 12 piksel pada setiap sisi
TextButtonButang Shop, tutup dan BuyEvent Activated

Jika anda mahu melukis tetingkap secara manual, bina objek yang sama dalam StarterGui dengan sifat ini, tetapkan juga ResetOnSpawn pada ScreenGui kepada false di situ, dan simpan satu kad sebagai templat yang diklon oleh LocalScript untuk setiap item katalog. Dengan cara itu skrip hanya mengisi kad dan menyambung butang. Logik pembelian dalam langkah seterusnya tidak berubah.

Jika game anda bermula dengan menu utama, panduan itu ada satu baris untuk ditambah dalam ShopClient supaya butang Shop hanya muncul selepas pemain menekan Play. Supaya kedai dibuka dengan bercakap dengan penjual, panduan dialog NPC menunjukkan cara menambah tindakan OpenShop yang mengarahkan ShopClient membuka tetingkap, manakala pembelian tetap melalui semakan pelayan kedai.

Langkah 4: Semakan dan pembelian pada pelayan

Script ini satu-satunya tempat pembelian boleh berlaku. Ia menerima id item, menyemaknya, mencari harga, menyemak Coins pemain, kemudian menolak syiling dan memberi Tool. Kepada butang Buy, ia menjawab true atau false serta mesej untuk dipaparkan.

Halakan kursor pada ServerScriptService, masukkan Script bernama ShopService dan tampal ini ke dalamnya:

Script dalam ServerScriptService bernama ShopService
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")

-- Apa yang dipulangkan oleh modul ShopCatalog, supaya semakan jenis ketat menyemak medan yang kita guna
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: pemain boleh menggunakan tool serta-merta
	local backpack = player:FindFirstChildOfClass("Backpack")
	if backpack then
		template:Clone().Parent = backpack
	end
	-- StarterGear: Roblox menyalinnya semula ke Backpack setiap kali watak muncul
	local starterGear = player:FindFirstChildOfClass("StarterGear")
	if starterGear then
		template:Clone().Parent = starterGear
	end
end

local function onBuyItem(player: Player, itemId: unknown): (boolean, string)
	-- 1. Client hanya menghantar id item, jadi ia mesti rentetan
	if type(itemId) ~= "string" then
		return false, "That item does not exist."
	end

	-- 2. Abaikan klik berganda dan aliran permintaan daripada skrip
	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. Cari item dalam salinan katalog pelayan sendiri
	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. Harga diambil daripada katalog dan tidak pernah daripada client
	if coins.Value < item.price then
		return false, `You need {item.price - coins.Value} more coins.`
	end

	-- 5. Tolak syiling, kemudian beri item. Tiada apa di sini yang menyerahkan pelaksanaan, jadi dua permintaan
	-- daripada pemain yang sama tidak boleh kedua-duanya melepasi semakan di atas sebelum ini selesai.
	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)

Pemilikan disimpan sebagai atribut Player, contohnya Owns_sword. Atribut yang ditetapkan pelayan direplikasi ke peranti pemain, jadi LocalScript boleh menukar kad kepada "Owned". Perubahan yang dibuat pemain pada salinannya sendiri tidak sampai ke pelayan.

Tool masuk ke dua tempat. Salinan dalam Backpack terus muncul dalam hotbar. Salinan dalam StarterGear diletakkan oleh Roblox ke dalam Backpack baharu setiap kali watak muncul. Tanpanya, item yang dibeli hilang pada kematian pertama pemain.

Kenapa client tidak pernah menghantar harga

Apa sahaja pada peranti pemain boleh diubah oleh pemain itu. Penipu menjalankan kod sendiri dalam salinan game mereka: mereka boleh membaca LocalScript anda, mengubah GUI dan memanggil BuyItem:InvokeServer() dengan apa-apa argumen seberapa banyak kali yang mereka mahu. Panduan keselamatan Roblox menyuruh anda menyemak jenis dan nilai bagi semua yang diterima oleh remote, dan contohnya ialah kedai.

Apa yang berlaku jika pelayan mempercayai client
Penipu menghantarJika pelayan mempercayainyaApa yang dibuat ShopService
Harga 0Semua item percumaMengabaikannya. Harga diambil daripada katalog.
Harga -1000Coins.Value -= -1000 memberinya 1,000 syilingMengabaikannya.
NaN sebagai hargaSebarang perbandingan dengan NaN adalah palsu, jadi semakan "syiling tidak cukup" tidak pernah berlakuMengabaikannya.
Id yang tiada dalam katalog, atau jadual sebagai ganti rentetanRalat dalam skrip atau item yang anda tidak berniat menjualMenjawab "That item does not exist."
Ratusan permintaan sesaatBeban pada pelayan, dan sebarang lubang dalam semakan berlaku ratusan kaliMengendalikan tidak lebih daripada satu permintaan setiap pemain setiap setengah saat.
Coins yang diubah pada skrin sendiriPembelian dengan syiling yang dia tiadaTidak melihatnya langsung. Pelayan hanya membaca nilai Coins sendiri.

Peraturan ini sesuai untuk setiap remote yang anda tulis: hantar apa yang dipilih pemain, contohnya id item atau nombor slot, dan tidak sekali-kali berapa harganya atau apa yang patut dia terima. Panduan RemoteEvent menerangkan semakan argumen remote dengan lebih terperinci.

Langkah 5: Uji kedai

  1. Tekan Play. Butang Shop muncul di sebelah kiri. Bukanya dan beli Flashlight: Coins berkurang 25, tool muncul dalam hotbar, dan butangnya berubah kepada Owned.
  2. Cuba Speed Coil yang berharga 300. Baris status menulis berapa syiling lagi yang kurang, dan tiada apa ditolak.
  3. Set semula watak melalui menu dalam game. Flashlight kembali ke dalam Backpack baharu berkat salinan dalam StarterGear.
  4. Untuk menambah syiling sendiri semasa ujian, klik suis Client/Server dan beralih ke Server, cari dalam Explorer Players, nama anda, leaderstats, Coins dan ubah Valuenya dalam tetingkap Properties. Perkara yang sama dalam mod Client hanya mengubah skrin anda, dan itulah jenis perubahan yang diabaikan oleh pelayan.

Jika butang menjawab "The shop did not answer", buka tetingkap Output melalui menu Window dalam Studio dan cari ralat merah daripada ShopService. Jika butang tersekat pada "Buying...", ShopService tidak berjalan atau tersekat menunggu objek: lihat ralat biasa.

Menjual game pass dengan Robux

Syiling ialah mata wang anda sendiri, jadi kedai di atas memutuskan setiap pembelian sendiri. Apa yang dibeli pemain dengan Robux berfungsi secara berbeza: game pass dibeli sekali dan kekal selamanya (bonus VIP, tool kekal), manakala developer product boleh dibeli berulang kali (pek syiling, langkau peringkat). Kedua-duanya melalui MarketplaceService Roblox, dan bayaran diterima oleh Roblox, bukan skrip anda.

Dua peraturan daripada panduan ini terpakai: lancarkan tetingkap pembelian dengan butang pada client, dan beri bonus hanya pada pelayan, apabila Roblox mengesahkan pembelian atau pemain sudah memiliki pass itu. Panduan skrip game pass membina semua ini: semakan pemilikan semasa masuk, tetingkap pembelian, bonus seperti pintu VIP dan bila developer product lebih sesuai daripada pass. Untuk memilih harga, kalkulator komisen Robux percuma menunjukkan berapa yang diberi oleh pass atau developer product kepada anda selepas bahagian Roblox.

Simpan pembelian pemain

Semua yang kita buat hanya kekal untuk satu sesi: syiling dan item yang dibeli ditetapkan semula apabila pemain keluar, selagi anda tidak menyimpannya melalui stor data. Supaya kod simpanan tidak diulang di sini, ikuti tutorial DataStore (atau langkah 3 panduan leaderboard, versi yang lebih pendek) dan ingat peraturan kedai:

  • Simpan id item, contohnya { "sword", "flashlight" }, dalam jadual yang sama dengan nilai Coins, supaya satu simpanan merekod kedua-dua syiling yang dibelanjakan dan item yang dibeli. Tool dan instance lain tidak boleh diletakkan dalam stor data.
  • Apabila data dimuatkan, lalui id yang disimpan, langkau yang tiada lagi dalam katalog, tetapkan setiap atribut Owns_ dan beri Tool dengan cara yang sama seperti giveTool. Tetingkap kedai dikemas kini sendiri kerana ia mendengar atribut itu.
  • Pemilikan pass tidak perlu disimpan: UserOwnsGamePassAsync bertanya kepada Roblox setiap kali pemain masuk.
  • Jangan sekali-kali simpan pemain yang datanya gagal dimuatkan, kerana pemuatan yang gagal boleh menggantikan pembeliannya dengan senarai kosong.

Ralat biasa dan cara membaikinya

Apabila kedai berkelakuan pelik, semak perkara ini dahulu. Pertama sekali, buka tetingkap Output (menu Window, kemudian Output): ralat skrip menyebut nama skrip dan baris.

Infinite yield possible on 'ReplicatedStorage:WaitForChild("ShopRemotes")'

Skrip menunggu objek yang tiada dengan nama tepat itu. Semak ejaan dan huruf besar dalam ShopRemotes, BuyItem, ShopCatalog dan ShopItems, dan pastikan ShopItems berada dalam ServerStorage, bukan ReplicatedStorage. Panduan ralat skrip menerangkan amaran ini dengan terperinci.

Butang Buy tersekat pada "Buying..." dan tidak menjawab

Tiada siapa pada pelayan yang menetapkan BuyItem.OnServerInvoke, jadi Roblox menahan permintaan sehingga ia ditetapkan. Pastikan ShopService ialah Script, bukan LocalScript, dan berada dalam ServerScriptService, dan cari dalam Output amaran Infinite yield possible daripada ShopService: ia bermakna skrip tersekat menunggu ShopCatalog, ShopRemotes atau ShopItems.

Butang Buy menulis "The shop did not answer"

Panggilan pelayan gagal dan tidak memulangkan jawapan. Punca biasa ialah ralat di dalam ShopService semasa mengendalikan permintaan, jadi cari ralat merah daripada ShopService dalam Output: ia menyebut baris.

Butang menulis "This item is not available right now"

Pelayan tidak menjumpai Tool dengan toolName item itu di dalam ServerStorage, ShopItems. Dalam Output ada amaran dengan nama tepat yang dicarinya.

Saya beli tool, tetapi watak tidak boleh memegangnya atau tersekat

Tool mesti ada tepat satu part bernama Handle terus di dalamnya, dan tiada part yang diikat (anchored). Untuk tool yang tidak perlu dipegang, nyahtanda RequiresHandle sebagai gantinya.

Syiling berkurang pada skrin saya, tetapi tidak bagi orang lain

Pembelian berlaku dalam LocalScript, jadi hanya peranti anda yang berubah. Pindahkan penolakan syiling dan pemberian Tool ke Script pelayan, seperti dalam langkah 4.

Item yang dibeli hilang selepas masuk semula

Belum ada apa yang disimpan. Lihat simpan pembelian.

Buat dengan RoCode

Jika anda tidak mahu membina semua ini secara manual, RoCode boleh membuatnya dalam place yang sedang anda buka. Ia ejen AI bebas untuk kod: anda terangkan ciri dalam chat webnya, dan plugin Roblox Studionya mencipta skrip, remote dan GUI dalam Explorer anda, jadi anda tidak perlu menyalin kod daripada tetingkap chat.

Anda tulis

Tambah kedai syiling: butang Shop yang membuka grid empat tool dengan harga dalam Coins daripada leaderstats saya. Pelayan mesti menyemak harga dan memberi tool ke Backpack dan StarterGear.

RoCode buat
  • Boleh meninjau place anda melalui Search Scripts dan Read Script untuk mencari leaderstats dan kod kedai yang sedia ada, supaya menggunakan nilai Coins anda dan bukan menambah yang kedua
  • Boleh membina rangka tetingkap melalui Build UI: susun atur kedai datang dengan kad pemegang tempat dan LocalScript untuk kesan hover dan butang Close; logik pembelian ditulis dalam skrip berasingan
  • Mencipta RemoteFunction melalui Create Instance dan menulis ModuleScript katalog, Script pelayan dan LocalScript melalui Create Script
  • Menyemak setiap skrip berjaya dikompil dalam Studio melalui Check Script (ia tidak menyemak jenis dan tidak menjalankan skrip), dan setiap kumpulan perubahan ialah titik undo dalam Studio

Anda masih perlu mencipta pass sendiri dalam Creator Hub, kerana RoCode tidak boleh mencipta pass dan developer product, dan pembelian juga diuji oleh anda: dengan plugin 3.9 atau lebih baharu RoCode boleh menjalankan playtest pendek dan membaca ralat, dan dengan plugin 3.9.15 atau lebih baharu watak ujiannya boleh menekan butang Shop dan Buy, tetapi ia hanya menyemak apa yang ia sendiri putuskan untuk diuji. Kedai biasanya datang selepas gameplay utama dan simpanan; kitaran langkah demi langkah membina game dengan RoCode menunjukkan tempatnya. Cara RoCode bersambung dengan Studio.

Soalan lazim

Mana lebih baik untuk butang Buy dalam Roblox: RemoteEvent atau RemoteFunction?

Kedua-duanya sesuai jika pelayan yang menyemak. RemoteFunction membolehkan butang menunggu jawapan pelayan dan memaparkannya, sebab itu panduan ini menggunakannya, dan contoh kedai dalam panduan keselamatan Roblox juga menggunakan RemoteFunction. Panggil ia daripada client sahaja: pelayan yang memanggil InvokeClient boleh menunggu selamanya jika client tidak pernah menjawab. Panduan RemoteEvent membandingkan kedua-dua pilihan.

Bagaimana membuka kedai melalui NPC dan bukan butang?

Letakkan ProximityPrompt dalam mana-mana part NPC, contohnya HumanoidRootPart, dengar event Triggerednya dalam Script pelayan dan hantar RemoteEvent kepada pemain itu supaya LocalScript memaparkan panel. Jika pembelian hanya dibenarkan berhampiran NPC, semak juga jarak ke NPC di dalam pengendali BuyItem, kerana client boleh memanggil remote dari mana-mana.

Bagaimana menjual item yang boleh dibeli beberapa kali?

Untuk item seperti itu, langkau semakan "sudah dimiliki" dan jangan beri Tool, tetapi sesuatu yang boleh dikira, contohnya tambah 1 kepada IntValue yang mengira ramuan. Kekalkan carian harga dan semakan syiling seperti sedia ada.

Kenapa kedai hilang apabila watak respawn?

ResetOnSpawn pada ScreenGuinya ditetapkan kepada true, iaitu nilai lalai, jadi Roblox memadamnya semasa respawn. Tetapkan kepada false, seperti yang dibuat oleh skrip dalam langkah 3.

Bolehkah saya guna templat GUI kedai percuma?

Ya, mana-mana susun atur sesuai, asalkan butang Buy hanya menghantar id item, dan pembelian itu sendiri berlaku dalam Script pelayan seperti ShopService. Sebelum menggunakan templat, semak sama ada syiling ditolak atau item diberi dalam LocalScript.

Sumber dan bacaan lanjut

Cara kod disemak: setiap skrip di halaman ini lulus semakan jenis Luau yang ketat dengan definisi API Roblox (luau-lsp, 20 November 2026). Semakan jenis mengesan kesilapan nama API dan jenis yang salah, tetapi bukan kesilapan logik permainan, jadi uji semuanya dalam Studio sebelum anda menerbitkannya.

Cuba RoCode dalam permainan anda.

Kredit percuma setiap hari, tanpa kad. Pasang plugin, terangkan ciri yang anda mahu dan semak hasilnya dalam Studio.