Singkatnya
Simpan item dan harganya di ModuleScript di ReplicatedStorage, buat jendelanya dari ScreenGui, ScrollingFrame dan UIGridLayout, lalu buat setiap tombol Buy memanggil RemoteFunction dengan id item saja. Sebuah Script di ServerScriptService lalu mencari harganya sendiri, mengecek dan mengambil Coins pemain, dan memberikan item-nya.
- Jangan pernah biarkan client mengirim harga. Siapa pun bisa memanggil remote kamu dengan nilai apa pun, jadi server membaca harga dari salinan katalognya sendiri.
- Berikan Tool yang dibeli dengan meng-clone-nya dari ServerStorage ke Backpack pemain (untuk dipakai sekarang) dan StarterGear (supaya kembali setelah respawn).
- Barang yang dijual dengan Robux adalah pass dan developer product, yang ditangani dengan MarketplaceService. Roblox juga membuat Shop otomatis untuk barang-barang itu, yang terpisah dari shop berbasis coins.
Di halaman ini
Bagaimana bagian-bagian shop bekerja sama
Shop yang berfungsi di game live terbagi antara perangkat pemain dan server. Perangkat menggambar jendelanya dan bilang "aku mau beli pedang itu". Server, satu-satunya pihak yang bisa kamu percaya, memutuskan apakah itu terjadi. Script shop yang "tidak berfungsi", atau yang dieksploitasi pemain, sering mengambil keputusan itu di pihak yang salah.
| Bagian | Tempatnya | Fungsinya |
|---|---|---|
ModuleScript ShopCatalog | ReplicatedStorage | Id item, nama, harga dan Tool yang diberikan setiap item. Kedua pihak membacanya. |
RemoteFunction BuyItem | ReplicatedStorage, di folder bernama ShopRemotes | Membawa request pembelian ke server dan jawabannya kembali. |
LocalScript ShopClient | StarterPlayerScripts | Membuat jendela shop dan mengirim id item saat tombol Buy ditekan. |
Script ShopService | ServerScriptService | Mengecek request, mengambil Coins dan memberikan Tool. |
| Tool yang kamu jual | ServerStorage, di folder bernama ShopItems | Versi asli yang disalin server. Tidak ada isi ServerStorage yang dikirim ke 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: Siapkan coins dan item yang akan dijual
Shop memakai nilai Coins di leaderstats pemain. Kalau kamu sudah mengikuti panduan leaderboard, kamu sudah punya nilai itu, jadi lewati script ini. Kalau belum, sisipkan Script di ServerScriptService bernama Leaderstats. Script ini memberi semua orang 200 coins di awal supaya kamu bisa langsung mengetes pembelian.
local Players = game:GetService("Players")
local STARTING_COINS = 200 -- cukup untuk mengetes shop; ubah ke 0 kalau pemain sudah bisa mendapat coins
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
Pakai satu script leaderstats saja. Dua script yang masing-masing membuat folder leaderstats memberi setiap pemain dua folder, dan shop bisa membaca folder yang salah.
Berikutnya, buat objek-objek yang dicari script. Nama membedakan huruf besar dan kecil, jadi ketik persis seperti di bawah.
- Di Explorer, arahkan kursor ke ReplicatedStorage, klik tombol + dan sisipkan Folder bernama
ShopRemotes. Di dalamnya, sisipkan RemoteFunction bernamaBuyItem. - Arahkan kursor ke ServerStorage dan sisipkan Folder bernama
ShopItems. - Taruh satu Tool untuk setiap item di ShopItems, dengan nama
ClassicSword,Flashlight,GrappleHookdanSpeedCoil. Untuk tes pertama, Tool cukup berisi satu Part yang tidak di-anchor bernamaHandle. Tool apa pun yang sudah kamu punya juga bisa: beri saja nama yang cocok. Untuk senjata yang benar-benar memberi damage, buat dengan panduan pedang atau panduan senjata api (dalam bahasa Inggris); masing-masing menjelaskan cara mencocokkannya dengan katalog. - Pilih setiap Tool dan hapus centang CanBeDropped di jendela Properties. Kalau dicentang, menekan Backspace menjatuhkan tool ke Workspace, dan pemain mana pun bisa mengambil barang yang sudah dibayar pembeli.
Kamu bisa mulai dengan satu Tool saja. Kalau Tool sebuah item tidak ada, server menolak menjual item itu dan mencetak peringatan yang menyebut namanya, jadi tidak ada yang diambil dari pemain.
Langkah 2: Masukkan item dan harga ke katalog
Katalog adalah satu daftar berisi semua yang dijual shop. LocalScript membacanya untuk menggambar kartu dan server membacanya untuk mencari harga, jadi mengubah harga cukup satu edit di satu tempat.
Arahkan kursor ke ReplicatedStorage, sisipkan ModuleScript, ganti namanya menjadi ShopCatalog dan ganti isinya dengan ini:
export type ShopItem = {
id: string, -- nanti disimpan di data store: jangan pernah diubah setelah ada pemain yang memiliki item ini
name: string, -- ditampilkan di kartu; aman untuk diubah
price: number, -- dalam Coins
description: string,
toolName: string, -- Tool di ServerStorage.ShopItems yang diterima pemain
}
-- Kartu muncul dengan urutan 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
-- Mengembalikan item dengan id ini, atau nil kalau item itu tidak ada
function ShopCatalog.get(id: string): ShopItem?
return byId[id]
end
-- Atribut Player yang diatur server ke true saat pemain memiliki sebuah item
function ShopCatalog.ownedAttribute(id: string): string
return "Owns_" .. id
end
return ShopCatalog
Setiap item punya id selain name yang ditampilkan. Id adalah yang dicatat server saat pemain memiliki sesuatu, jadi kamu bisa mengganti nama "Classic Sword" nanti tanpa merusak pembelian yang tersimpan. Deskripsinya hanya teks di kartu; apa yang dilakukan sebuah Tool ditentukan oleh script Tool itu sendiri.
Pemain bisa membaca ModuleScript di ReplicatedStorage, jadi harga-harga ini publik. Itu tidak masalah: harganya toh tercetak di kartu. Yang penting, client dan server masing-masing menjalankan salinan module-nya sendiri, jadi pemain yang mengubah harga di perangkatnya tidak mengubah apa pun di server.
Langkah 3: Buat shop GUI
LocalScript ini membuat seluruh jendela lewat kode: tombol Shop, panel dengan grid kartu yang bisa di-scroll, satu tombol Buy per item katalog, penghitung Coins dan baris status untuk balasan server. Karena semuanya kode, kamu bisa menempelnya dan menekan Play. Tabel setelahnya mencantumkan setiap objek kalau kamu lebih suka menata jendelanya sendiri.
- Di Explorer, buka StarterPlayer, arahkan kursor ke StarterPlayerScripts dan sisipkan LocalScript bernama
ShopClient. - Ganti isinya dengan kode di bawah.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- Apa yang dikembalikan module ShopCatalog, supaya strict type checking bisa mengecek field yang kita pakai
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: menampung semua yang digambar shop di layar pemain
local gui = Instance.new("ScreenGui")
gui.Name = "ShopGui"
gui.ResetOnSpawn = false -- shop tetap ada saat karakter respawn
-- Tombol di tepi kiri yang membuka dan menutup shop
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)
-- Jendela shop: di tengah, tersembunyi sampai 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) -- mencegah jendela menjadi sangat besar di layar 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
-- Balasan dari server, seperti "You need 20 more coins.", muncul di sini
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: area yang bisa di-scroll saat kartunya lebih banyak dari 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() -- mulai dari nol; AutomaticCanvasSize memperbesarnya agar semua kartu muat
list.AutomaticCanvasSize = Enum.AutomaticSize.Y
list.Parent = panel
-- UIGridLayout: menyusun kartu dalam baris dan memindahkannya ke baris berikutnya
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..."
-- Kirim id item saja. Server mencari harganya 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)
-- Server mengatur atribut ini saat pembelian berhasil (atau saat item yang tersimpan dimuat)
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")
-- Tampilkan coins pemain. Nilai aslinya dipegang server; ini hanya menampilkannya.
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()
Tombol-tombolnya memakai Activated, bukan MouseButton1Click: Activated berjalan untuk klik mouse, ketukan di HP dan tombol A atau silang di controller.
Definisi type di bagian atas menjelaskan apa yang dikembalikan ShopCatalog, supaya strict type checking bisa menangkap field yang salah eja seperti item.prise. Definisi itu tidak mengubah apa pun saat game berjalan.
| Objek | Tugas di shop | Properti utama |
|---|---|---|
ScreenGui | Menampung semua yang digambar di layar | ResetOnSpawn false, supaya shop tetap ada setelah respawn |
Frame | Jendelanya, dan setiap kartu item | AnchorPoint 0.5, 0.5 dan Position 0.5, 0.5 untuk menaruh jendela di tengah |
UISizeConstraint | Membatasi ukuran jendela di layar besar | MaxSize 640 kali 460 |
ScrollingFrame | Bisa di-scroll saat kartunya lebih banyak dari yang muat | CanvasSize 0 dan AutomaticCanvasSize Y, supaya area scroll ikut membesar dengan kartunya |
UIGridLayout | Menaruh kartu dalam baris dan memindahkannya ke baris berikutnya | CellSize 180 kali 200, CellPadding 12, SortOrder LayoutOrder |
UICorner | Membulatkan sudut | CornerRadius 8 sampai 14 piksel |
UIPadding | Jarak di bagian dalam | 10 sampai 12 piksel di setiap sisi |
TextButton | Tombol Shop, tutup dan Buy | Event Activated |
Kalau kamu mau mendesain jendelanya sendiri, buat objek yang sama di bawah StarterGui dengan properti-properti itu, atur juga ResetOnSpawn ScreenGui-nya ke false di sana, dan simpan satu kartu sebagai template yang di-clone LocalScript untuk setiap item katalog. Script-nya lalu hanya mengisi kartu dan menyambungkan tombol. Logika pembelian di langkah berikutnya tidak berubah.
Kalau game kamu dibuka dengan main menu, panduan itu memberi satu baris yang perlu ditambahkan ke ShopClient supaya tombol Shop baru muncul setelah pemain menekan Play. Untuk membuka shop dengan berbicara ke penjaga toko, panduan dialog NPC menunjukkan cara menambahkan aksi OpenShop yang menyuruh ShopClient membuka jendelanya, sementara pembelian tetap melewati cek server milik shop sendiri.
Langkah 4: Cek dan selesaikan pembelian di server
Script ini satu-satunya tempat pembelian bisa terjadi. Script menerima id item, mengeceknya, mencari harganya, mengecek Coins pemain, lalu mengambil coins dan memberikan Tool. Script menjawab tombol Buy dengan true atau false dan pesan untuk ditampilkan.
Arahkan kursor ke ServerScriptService, sisipkan Script bernama ShopService dan tempel ini:
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")
-- Apa yang dikembalikan module ShopCatalog, supaya strict type checking bisa mengecek field yang kita pakai
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 bisa langsung memakai tool-nya
local backpack = player:FindFirstChildOfClass("Backpack")
if backpack then
template:Clone().Parent = backpack
end
-- StarterGear: Roblox menyalinnya lagi ke Backpack setiap kali karakter 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. Satu-satunya yang dikirim client adalah id item, jadi harus berupa string
if type(itemId) ~= "string" then
return false, "That item does not exist."
end
-- 2. Abaikan klik ganda dan banjir request dari script
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 di salinan katalog milik server 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 berasal dari katalog, tidak pernah dari client
if coins.Value < item.price then
return false, `You need {item.price - coins.Value} more coins.`
end
-- 5. Ambil coins-nya, lalu berikan item. Tidak ada yang yield di sini, jadi dua request
-- dari pemain yang sama tidak bisa sama-sama lolos cek di atas sebelum bagian ini berjalan.
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)
Kepemilikan disimpan sebagai atribut Player seperti Owns_sword. Atribut yang diatur server direplikasi ke perangkat pemain, jadi LocalScript bisa mengubah kartu itu menjadi "Owned". Perubahan yang dibuat pemain pada salinannya sendiri tidak pernah sampai ke server.
Tool-nya dikirim ke dua tempat. Salinan di Backpack langsung muncul di hotbar. Salinan di StarterGear adalah yang dimasukkan Roblox ke Backpack baru setiap kali karakter muncul. Tanpa salinan itu, item yang dibeli hilang saat pemain pertama kali mati.
Kenapa client tidak pernah mengirim harga
Apa pun di perangkat pemain bisa diubah oleh pemain itu. Exploiter menjalankan kode mereka sendiri di salinan game mereka: mereka bisa membaca LocalScript kamu, mengedit GUI, dan memanggil BuyItem:InvokeServer() dengan argumen apa pun, sesering yang mereka mau. Panduan keamanan Roblox menyuruh kamu mengecek tipe dan nilai dari semua yang diterima remote, dan memakai shop sebagai contohnya.
| Exploiter mengirim | Kalau server memercayainya | Yang dilakukan ShopService |
|---|---|---|
| Harga 0 | Semua item gratis | Mengabaikannya. Harga berasal dari katalog. |
| Harga -1000 | Coins.Value -= -1000 memberi mereka 1.000 coins | Mengabaikannya. |
NaN sebagai harga | Setiap perbandingan dengan NaN bernilai false, jadi cek "coins tidak cukup" tidak pernah berjalan | Mengabaikannya. |
| Id yang tidak ada di katalog, atau table sebagai ganti string | Script error, atau item yang tidak pernah ingin kamu jual | Membalas "That item does not exist." |
| Ratusan request per detik | Beban server, dan celah sekecil apa pun di cek kamu kena ratusan kali | Menangani paling banyak satu request per pemain setiap setengah detik. |
| Coins yang diedit di layar mereka sendiri | Pembelian dengan coins yang tidak mereka punya | Tidak pernah melihatnya. Server hanya membaca nilai Coins miliknya sendiri. |
Aturan ini berlaku untuk setiap remote yang kamu tulis: kirim apa yang dipilih pemain, seperti id item atau nomor slot, jangan pernah harga atau apa yang seharusnya mereka terima. Panduan RemoteEvent membahas lebih jauh cara memvalidasi argumen remote.
Langkah 5: Tes shop-nya
- Tekan Play. Tombol Shop muncul di kiri. Buka dan beli Flashlight: Coins kamu turun 25, tool-nya muncul di hotbar dan tombolnya berubah menjadi Owned.
- Coba Speed Coil, yang harganya 300. Baris status menyebut berapa coins lagi yang kamu butuhkan, dan tidak ada yang diambil.
- Reset karaktermu dari menu dalam game. Flashlight kembali di Backpack yang baru, berkat salinan di StarterGear.
- Untuk memberi dirimu lebih banyak coins saat mengetes, klik toggle Client/Server untuk pindah ke Server, cari
Players, namamu,leaderstats,Coinsdi Explorer dan ubah Value-nya di jendela Properties. Melakukan hal yang sama di mode Client hanya mengubah layarmu, dan perubahan seperti itulah yang diabaikan server.
Kalau sebuah tombol membalas "The shop did not answer", buka jendela Output dari menu Window di Studio dan cari error merah dari ShopService. Kalau sebuah tombol malah tertahan di "Buying...", ShopService tidak berjalan atau tertahan menunggu sebuah objek: lihat Error umum.
Menjual game pass dengan Robux
Coins adalah mata uangmu sendiri, jadi shop di atas memutuskan setiap pembelian sendiri. Barang yang dibeli pemain dengan Robux bekerja dengan cara lain: game pass dibeli sekali dan dimiliki selamanya (perk VIP, tool permanen), dan developer product bisa dibeli berulang kali (paket coins, skip). Keduanya lewat MarketplaceService milik Roblox, dan yang menerima pembayaran adalah Roblox, bukan script kamu.
Dua aturan dari panduan ini tetap berlaku: tampilkan prompt pembelian dari tombol di client, dan berikan perk-nya hanya di server setelah Roblox mengonfirmasi pembelian atau pemain sudah memiliki pass-nya. Panduan script game pass Roblox (dalam bahasa Inggris) membuat semua itu dari awal sampai akhir, dengan cek kepemilikan saat pemain bergabung, prompt pembelian, perk seperti pintu VIP, dan kapan memakai developer product sebagai gantinya. Untuk menentukan harga, kalkulator pajak Robux (dalam bahasa Inggris) yang gratis menunjukkan berapa yang kamu terima dari pass atau developer product setelah potongan Roblox.
Simpan apa yang dibeli pemain
Semua yang dibuat sejauh ini hanya bertahan satu sesi: coins dan item yang dimiliki ter-reset saat pemain keluar, sampai kamu menyimpannya dengan data store. Daripada mengulang kode penyimpanan di sini, ikuti tutorial DataStore (atau Langkah 3 di panduan leaderboard untuk versi yang lebih pendek) dan ingat aturan shop berikut:
- Simpan id item, seperti
{ "sword", "flashlight" }, di table yang sama dengan nilai Coins, supaya satu kali simpan mencatat coins yang dipakai sekaligus item yang dibeli. Tool dan instance lain tidak bisa disimpan di data store. - Saat data dimuat, telusuri id yang tersimpan, lewati id yang sudah tidak ada di katalog, atur setiap atribut
Owns_dan berikan Tool-nya dengan cara yang sama sepertigiveTool. Jendela shop ikut diperbarui sendiri, karena mendengarkan atribut-atribut itu. - Kepemilikan pass tidak perlu disimpan:
UserOwnsGamePassAsyncbertanya ke Roblox setiap kali pemain bergabung. - Jangan pernah menyimpan data pemain yang gagal dimuat, karena load yang gagal bisa mengganti pembelian mereka dengan daftar kosong.
Error umum dan cara memperbaikinya
Kalau shop-nya bermasalah, cek ini dulu. Buka jendela Output (menu Window, lalu Output) sebelum yang lain: error script menyebut nama script dan barisnya.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("ShopRemotes")'
Sebuah script menunggu objek yang tidak ada dengan nama persis itu. Cek ejaan dan huruf kapital ShopRemotes, BuyItem, ShopCatalog dan ShopItems, dan pastikan ShopItems ada di ServerStorage, bukan ReplicatedStorage. Panduan error script menjelaskan peringatan ini dengan detail.
Tombol Buy tertahan di "Buying..." dan tidak pernah menjawab
Tidak ada apa pun di server yang mengatur BuyItem.OnServerInvoke, jadi Roblox menahan request-nya sampai ada yang mengaturnya. Pastikan ShopService adalah Script, bukan LocalScript, di dalam ServerScriptService, dan cek Output untuk peringatan Infinite yield possible dari ShopService: artinya script tertahan menunggu ShopCatalog, ShopRemotes atau ShopItems.
Tombol Buy bertuliskan "The shop did not answer"
Panggilan ke server gagal, bukannya mengembalikan jawaban. Penyebab yang biasa adalah error di dalam ShopService saat menangani request, jadi cari error merah dari ShopService di Output: error itu menyebut barisnya.
Tombol bertuliskan "This item is not available right now"
Server tidak menemukan Tool dengan toolName item itu di ServerStorage, ShopItems. Output menampilkan peringatan dengan nama persis yang dicarinya.
Aku membeli tool tapi karakterku tidak bisa memegangnya, atau tersangkut
Tool butuh tepat satu part bernama Handle sebagai child langsung, dan tidak boleh ada part-nya yang di-anchor. Untuk tool yang tidak perlu dipegang, hapus centang RequiresHandle.
Coins turun di layarku tapi tidak bagi orang lain
Pembeliannya berjalan di LocalScript, jadi hanya perangkatmu yang berubah. Pindahkan perubahan coins dan pemberian Tool ke Script server, seperti di Langkah 4.
Item yang dibeli hilang setelah aku masuk lagi
Belum ada yang disimpan. Lihat Simpan apa yang dibeli pemain.
Buat dengan RoCode
Kalau kamu tidak mau menyambungkan ini secara manual, RoCode bisa membuatnya di place yang sedang kamu buka. RoCode adalah agen AI coding independen: kamu menjelaskan fiturnya di web chat, dan plugin Roblox Studio-nya membuat script, remote dan GUI di Explorer kamu, jadi kamu tidak menyalin kode dari jendela chat.
Tambahkan shop berbasis coins: tombol Shop yang membuka grid berisi empat tool yang harganya dalam Coins dari leaderstats-ku. Server harus mengecek harga dan memberikan tool ke Backpack dan StarterGear.
- Bisa memeriksa place kamu untuk mencari leaderstats dan kode shop yang sudah ada dengan Search Scripts dan Read Script, jadi bisa memakai nilai Coins kamu, bukan menambah yang kedua
- Bisa membuat kerangka jendelanya dengan Build UI, yang layout shop-nya datang dengan kartu item placeholder dan LocalScript untuk efek hover dan tombol Close; logika pembeliannya ditulis sebagai script terpisah
- Membuat RemoteFunction dengan Create Instance, dan menulis ModuleScript katalog, Script server dan LocalScript dengan Create Script
- Mengecek compile setiap script di dalam Studio dengan Check Script (tidak mengecek tipe atau menjalankannya), dan setiap batch perubahan menjadi titik undo di Studio
Kamu tetap membuat pass sendiri di Creator Hub, karena RoCode tidak bisa membuat pass atau developer product, dan kamu sendiri yang memainkan tes pembeliannya: dengan plugin 3.9 atau lebih baru RoCode bisa menjalankan playtest singkat dan membaca error-nya, dan dengan plugin 3.9.15 atau lebih baru karakter tesnya bisa mengeklik tombol Shop dan Buy, tapi yang dicek hanya apa yang dipilihnya untuk dites. Shop biasanya dibuat setelah core loop dan penyimpanan; langkah demi langkah membangun game dengan RoCode menunjukkan di mana shop masuk. Cara RoCode tersambung ke Studio.
Pertanyaan umum
Tombol Buy sebaiknya pakai RemoteEvent atau RemoteFunction?
Keduanya bisa, asalkan server yang mengecek. RemoteFunction membuat tombol bisa menunggu jawaban server dan menampilkannya, karena itulah panduan ini memakainya, dan panduan keamanan Roblox juga memakai RemoteFunction untuk contoh shop-nya. Panggil hanya dari client: server yang memanggil InvokeClient bisa menunggu selamanya kalau client tidak pernah menjawab. Panduan RemoteEvent membandingkan keduanya.
Bagaimana cara membuka shop dari NPC, bukan dari tombol?
Taruh ProximityPrompt di dalam salah satu part NPC, seperti HumanoidRootPart-nya, dengarkan event Triggered-nya di Script server, dan fire RemoteEvent ke pemain itu supaya LocalScript menampilkan panelnya. Kalau pembelian hanya boleh terjadi di dekat NPC, cek juga jarak ke NPC di dalam handler BuyItem, karena client bisa memanggil remote dari mana saja.
Bagaimana cara menjual item yang bisa dibeli lebih dari sekali?
Lewati cek "sudah punya" untuk item itu dan berikan sesuatu yang bisa dihitung, bukan Tool, misalnya tambahkan 1 ke IntValue yang menghitung potion. Biarkan pencarian harga dan cek coins persis seperti semula.
Kenapa shop-ku hilang saat karakterku respawn?
ScreenGui-nya punya ResetOnSpawn bernilai true, nilai default-nya, jadi Roblox menghapusnya saat respawn. Atur ke false, seperti yang dilakukan script di Langkah 3.
Bolehkah aku memakai template shop GUI gratis?
Boleh, layout apa pun bisa, asalkan tombol Buy-nya hanya mengirim id item dan pembeliannya sendiri terjadi di Script server seperti ShopService. Sebelum memakai template, cek script-nya apakah ada coins yang diambil atau item yang diberikan di LocalScript.
Sumber dan bacaan lanjutan
- Roblox Creator Docs: Securing the client-server boundary (dalam bahasa Inggris). memvalidasi argumen remote, NaN, rate limiting dan contoh shop di dalam game
- Roblox Creator Docs: Remote events and callbacks (dalam bahasa Inggris). RemoteFunction, InvokeServer, OnServerInvoke dan risiko InvokeClient
- Roblox Creator Docs: Passes (dalam bahasa Inggris). membuat dan menjual pass, UserOwnsGamePassAsync dan PromptGamePassPurchaseFinished
- Roblox Creator Docs: Shop (dalam bahasa Inggris). Shop dalam game yang dibuat otomatis oleh Roblox
- Roblox Creator Docs: Developer Products (dalam bahasa Inggris). pembelian Robux yang bisa diulang dan ProcessReceipt
- Roblox Creator Docs: StarterGear (dalam bahasa Inggris). kenapa Tool di StarterGear kembali setelah respawn
- Roblox Creator Docs: In-game tools (dalam bahasa Inggris). handle, anchoring dan RequiresHandle
Cara kode ini dicek: setiap skrip di halaman ini lolos pemeriksa tipe strict Luau dengan definisi API Roblox (luau-lsp, 14 November 2026). Pemeriksaan tipe menangkap nama API yang salah ketik dan tipe yang keliru, bukan logika game, jadi uji dulu di Studio sebelum dipublikasikan.