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
Cara kedai yang berfungsi disusun
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.
| Bahagian | Lokasi | Apa yang dibuat |
|---|---|---|
ModuleScript ShopCatalog | ReplicatedStorage | Id item, nama, harga dan Tool yang diberi oleh setiap satu. Dibaca oleh kedua-dua pihak. |
RemoteFunction BuyItem | ReplicatedStorage, dalam folder ShopRemotes | Membawa permintaan pembelian ke pelayan dan jawapan kembali. |
LocalScript ShopClient | StarterPlayerScripts | Membina tetingkap kedai dan menghantar id item apabila butang Buy ditekan. |
Script ShopService | ServerScriptService | Menyemak permintaan, menolak Coins dan memberi Tool. |
| Tools yang anda jual | ServerStorage, dalam folder ShopItems | Asal yang disalin oleh pelayan. Tiada apa dalam ServerStorage dihantar kepada pemain. |
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.
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.
- Dalam Explorer, halakan kursor pada ReplicatedStorage, klik butang + dan masukkan Folder bernama
ShopRemotes. Di dalamnya, masukkan RemoteFunction bernamaBuyItem. - Halakan kursor pada ServerStorage dan masukkan Folder bernama
ShopItems. - Letakkan dalam ShopItems satu Tool bagi setiap item, bernama
ClassicSword,Flashlight,GrappleHookdanSpeedCoil. Untuk ujian pertama, Tool cukup dengan satu Part tidak diikat (unanchored) bernamaHandle. 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. - 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:
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.
- Dalam Explorer, kembangkan StarterPlayer, halakan kursor pada StarterPlayerScripts dan masukkan LocalScript bernama
ShopClient. - Gantikan kandungannya dengan kod di bawah.
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 | Tugas dalam kedai | Sifat utama |
|---|---|---|
ScreenGui | Menyimpan semua yang dilukis pada skrin | ResetOnSpawn false, supaya kedai kekal selepas respawn |
Frame | Tetingkap dan setiap kad item | AnchorPoint 0.5, 0.5 dan Position 0.5, 0.5, supaya tetingkap berada di tengah |
UISizeConstraint | Mengehadkan tetingkap pada skrin besar | MaxSize 640 kali 460 |
ScrollingFrame | Diskrol apabila kad lebih banyak daripada yang muat | CanvasSize 0 dan AutomaticCanvasSize Y, supaya kawasan skrol membesar bersama kad |
UIGridLayout | Menyusun kad dalam baris dan memindahkannya | CellSize 180 kali 200, CellPadding 12, SortOrder LayoutOrder |
UICorner | Membulatkan bucu | CornerRadius 8 hingga 14 piksel |
UIPadding | Jarak dalaman | 10 hingga 12 piksel pada setiap sisi |
TextButton | Butang Shop, tutup dan Buy | Event 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:
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.
| Penipu menghantar | Jika pelayan mempercayainya | Apa yang dibuat ShopService |
|---|---|---|
| Harga 0 | Semua item percuma | Mengabaikannya. Harga diambil daripada katalog. |
| Harga -1000 | Coins.Value -= -1000 memberinya 1,000 syiling | Mengabaikannya. |
NaN sebagai harga | Sebarang perbandingan dengan NaN adalah palsu, jadi semakan "syiling tidak cukup" tidak pernah berlaku | Mengabaikannya. |
| Id yang tiada dalam katalog, atau jadual sebagai ganti rentetan | Ralat dalam skrip atau item yang anda tidak berniat menjual | Menjawab "That item does not exist." |
| Ratusan permintaan sesaat | Beban pada pelayan, dan sebarang lubang dalam semakan berlaku ratusan kali | Mengendalikan tidak lebih daripada satu permintaan setiap pemain setiap setengah saat. |
| Coins yang diubah pada skrin sendiri | Pembelian dengan syiling yang dia tiada | Tidak 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
- Tekan Play. Butang Shop muncul di sebelah kiri. Bukanya dan beli Flashlight: Coins berkurang 25, tool muncul dalam hotbar, dan butangnya berubah kepada Owned.
- Cuba Speed Coil yang berharga 300. Baris status menulis berapa syiling lagi yang kurang, dan tiada apa ditolak.
- Set semula watak melalui menu dalam game. Flashlight kembali ke dalam Backpack baharu berkat salinan dalam StarterGear.
- Untuk menambah syiling sendiri semasa ujian, klik suis Client/Server dan beralih ke Server, cari dalam Explorer
Players, nama anda,leaderstats,Coinsdan 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 sepertigiveTool. Tetingkap kedai dikemas kini sendiri kerana ia mendengar atribut itu. - Pemilikan pass tidak perlu disimpan:
UserOwnsGamePassAsyncbertanya 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.
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.
- 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
- Roblox Creator Docs: Securing the client-server boundary (dalam bahasa Inggeris). semakan argumen remote, NaN, had kekerapan dan contoh kedai dalam game
- Roblox Creator Docs: Remote events and callbacks (dalam bahasa Inggeris). RemoteFunction, InvokeServer, OnServerInvoke dan risiko InvokeClient
- Roblox Creator Docs: Passes (dalam bahasa Inggeris). mencipta dan menjual pass, UserOwnsGamePassAsync dan PromptGamePassPurchaseFinished
- Roblox Creator Docs: Shop (dalam bahasa Inggeris). Shop dalam game yang dicipta Roblox secara automatik
- Roblox Creator Docs: Developer Products (dalam bahasa Inggeris). pembelian Robux berulang dan ProcessReceipt
- Roblox Creator Docs: StarterGear (dalam bahasa Inggeris). kenapa Tool dalam StarterGear kembali selepas respawn
- Roblox Creator Docs: In-game tools (dalam bahasa Inggeris). Handle, anchor dan RequiresHandle
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.