Tóm tắt
Lưu vật phẩm và giá trong một ModuleScript trong ReplicatedStorage, dựng cửa sổ từ ScreenGui, ScrollingFrame và UIGridLayout, và cho mỗi nút Buy gọi một RemoteFunction chỉ gửi id vật phẩm. Sau đó Script trong ServerScriptService tự tìm giá, kiểm tra và trừ Coins của người chơi rồi trao vật phẩm.
- Đừng bao giờ để client gửi giá. Ai cũng có thể gọi remote của bạn với bất kỳ giá trị nào, nên server lấy giá từ bản catalog của chính nó.
- Trao Tool đã mua bằng cách clone từ ServerStorage vào Backpack của người chơi (để dùng ngay) và vào StarterGear (để nó quay lại sau khi respawn).
- Thứ bán bằng Robux là pass và developer product, chúng dùng MarketplaceService. Roblox còn tự tạo một Shop cho chúng, và nó không giống shop bằng xu.
Trong trang này
Một shop chạy được hoạt động thế nào
Một shop chạy được trong game thật được chia giữa thiết bị của người chơi và server. Thiết bị vẽ cửa sổ và nói "tôi muốn mua kiếm". Server, bên duy nhất có thể tin được, quyết định việc đó có xảy ra không. Những script shop "không chạy" hoặc bị người chơi phá bằng hack thường đưa ra quyết định này ở sai phía.
| Phần | Nằm ở đâu | Làm gì |
|---|---|---|
ModuleScript ShopCatalog | ReplicatedStorage | Id vật phẩm, tên, giá và Tool mà mỗi vật phẩm trao. Cả hai phía đều đọc nó. |
RemoteFunction BuyItem | ReplicatedStorage, trong folder ShopRemotes | Mang yêu cầu mua lên server và mang câu trả lời về. |
LocalScript ShopClient | StarterPlayerScripts | Dựng cửa sổ shop và gửi id vật phẩm khi nút Buy được nhấn. |
Script ShopService | ServerScriptService | Kiểm tra yêu cầu, trừ Coins và trao Tool. |
| Các Tool bạn bán | ServerStorage, trong folder ShopItems | Bản gốc mà server sao chép. Không thứ gì trong ServerStorage được gửi tới người chơi. |
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
Bước 1: Xu và vật phẩm để bán
Shop tiêu giá trị Coins trong leaderstats của người chơi. Nếu bạn đã làm theo hướng dẫn bảng xếp hạng, bạn đã có nó và có thể bỏ qua script này. Nếu chưa, chèn một Script vào ServerScriptService với tên Leaderstats. Nó cho mỗi người 200 xu lúc bắt đầu để bạn thử mua ngay.
local Players = game:GetService("Players")
local STARTING_COINS = 200 -- đủ để thử shop; đặt về 0 khi người chơi đã kiếm được xu
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
Chỉ giữ một script leaderstats. Hai script cùng tạo folder leaderstats sẽ cho mỗi người chơi hai folder, và shop có thể đọc nhầm folder.
Tiếp theo, tạo các object mà script sẽ tìm. Tên phân biệt chữ hoa chữ thường, nên hãy gõ chính xác như ở đây.
- Trong Explorer, rê chuột lên ReplicatedStorage, nhấn nút + và chèn một Folder tên
ShopRemotes. Bên trong nó, chèn một RemoteFunction tênBuyItem. - Rê chuột lên ServerStorage và chèn một Folder tên
ShopItems. - Đặt vào ShopItems một Tool cho mỗi vật phẩm, với tên
ClassicSword,Flashlight,GrappleHookvàSpeedCoil. Cho lần thử đầu, mỗi Tool chỉ cần một Part không anchor tênHandle. Tool nào bạn đã có cũng dùng được: đặt cho nó đúng tên. Vũ khí gây sát thương thật, hãy dựng theo hướng dẫn làm kiếm hoặc hướng dẫn làm súng; mỗi hướng dẫn đều nói cách nối nó với catalog. - Chọn từng Tool và bỏ dấu tích CanBeDropped trong cửa sổ Properties. Khi nó được tích, nhấn Backspace sẽ ném Tool ra Workspace, và người chơi nào cũng có thể nhặt món mà người mua đã trả tiền.
Bạn có thể bắt đầu chỉ với một Tool. Nếu thiếu Tool của một vật phẩm, server từ chối bán vật phẩm đó và ghi cảnh báo kèm tên của nó, nên người chơi không bị trừ gì cả.
Bước 2: Vật phẩm và giá trong catalog
Catalog là danh sách duy nhất chứa mọi thứ shop bán. LocalScript đọc nó để vẽ thẻ, còn server đọc nó để tìm giá, nên đổi giá chỉ là một lần sửa ở một chỗ.
Rê chuột lên ReplicatedStorage, chèn một ModuleScript, đổi tên thành ShopCatalog và thay nội dung bằng đoạn này:
export type ShopItem = {
id: string, -- sau này được lưu vào data store: đừng đổi nó khi người chơi đã có vật phẩm
name: string, -- hiện trên thẻ; đổi được
price: number, -- tính bằng Coins
description: string,
toolName: string, -- Tool trong ServerStorage.ShopItems mà người chơi nhận được
}
-- Các thẻ xuất hiện theo thứ tự này
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
-- Trả về vật phẩm có id này, hoặc nil nếu không có vật phẩm đó
function ShopCatalog.get(id: string): ShopItem?
return byId[id]
end
-- Attribute của Player mà server đặt thành true khi người chơi có vật phẩm
function ShopCatalog.ownedAttribute(id: string): string
return "Owns_" .. id
end
return ShopCatalog
Mỗi vật phẩm có một id và một name hiển thị riêng. Server ghi lại chính id khi người chơi sở hữu thứ gì đó, nên sau này bạn có thể đổi tên "Classic Sword" mà không làm hỏng các giao dịch đã lưu. Mô tả chỉ là chữ trên thẻ; Tool làm gì là do script riêng của nó quyết định.
Người chơi đọc được ModuleScript trong ReplicatedStorage, nên những giá này là công khai. Điều đó không sao: chúng vốn đã ghi trên thẻ. Điều quan trọng là client và server mỗi bên chạy bản module riêng, nên người chơi đổi giá trên thiết bị của mình cũng không thay đổi được gì trên server.
Bước 3: Dựng GUI shop
LocalScript này dựng toàn bộ cửa sổ bằng code: nút Shop, một bảng có lưới thẻ cuộn được, mỗi vật phẩm trong catalog một nút Buy, bộ đếm Coins và một dòng trạng thái cho câu trả lời của server. Vì mọi thứ đều làm bằng code, bạn có thể dán vào và nhấn Play. Bảng phía sau liệt kê từng object nếu bạn muốn tự sắp xếp cửa sổ bằng tay.
- Trong Explorer, mở rộng StarterPlayer, rê chuột lên StarterPlayerScripts và chèn một LocalScript tên
ShopClient. - Thay nội dung của nó bằng code bên dưới.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- Thứ module ShopCatalog trả về, để kiểm tra kiểu nghiêm ngặt kiểm tra các trường chúng ta dùng
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: chứa mọi thứ shop vẽ trên màn hình người chơi
local gui = Instance.new("ScreenGui")
gui.Name = "ShopGui"
gui.ResetOnSpawn = false -- shop vẫn còn khi nhân vật respawn
-- Nút ở mép trái để mở và đóng 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)
-- Cửa sổ shop: ở giữa, ẩn cho tới khi người chơi mở nó
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) -- không cho cửa sổ trở nên quá to trên màn hình lớn
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
-- Câu trả lời của server hiện ở đây, ví dụ "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: vùng cuộn được khi có nhiều thẻ hơn chỗ chứa
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() -- bắt đầu từ 0; AutomaticCanvasSize giãn nó theo số thẻ
list.AutomaticCanvasSize = Enum.AutomaticSize.Y
list.Parent = panel
-- UIGridLayout: xếp thẻ thành hàng và đưa chúng xuống hàng tiếp theo
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..."
-- Chỉ gửi id vật phẩm. Server tự tìm giá.
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 đặt attribute này khi giao dịch thành công (hoặc khi vật phẩm đã lưu được tải xong)
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")
-- Hiện số xu của người chơi. Giá trị thật nằm ở server; ở đây chỉ để hiển thị.
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()
Các nút dùng Activated, không dùng MouseButton1Click: nó kích hoạt khi click chuột, khi chạm trên điện thoại và khi nhấn nút A hoặc nút X trên tay cầm.
Các định nghĩa type ở đầu mô tả thứ ShopCatalog trả về, để kiểm tra kiểu nghiêm ngặt bắt được lỗi gõ sai tên trường, ví dụ item.prise. Khi game chạy, chúng không thay đổi gì.
| Object | Vai trò trong shop | Thuộc tính chính |
|---|---|---|
ScreenGui | Chứa mọi thứ được vẽ trên màn hình | ResetOnSpawn false, để shop còn lại sau khi respawn |
Frame | Cửa sổ và từng thẻ vật phẩm | AnchorPoint 0.5, 0.5 và Position 0.5, 0.5, để cửa sổ nằm giữa |
UISizeConstraint | Giới hạn cửa sổ trên màn hình lớn | MaxSize 640 x 460 |
ScrollingFrame | Cuộn được khi có nhiều thẻ hơn chỗ chứa | CanvasSize 0 và AutomaticCanvasSize Y, để vùng cuộn lớn lên theo số thẻ |
UIGridLayout | Xếp thẻ thành hàng và xuống dòng | CellSize 180 x 200, CellPadding 12, SortOrder LayoutOrder |
UICorner | Bo tròn góc | CornerRadius từ 8 tới 14 pixel |
UIPadding | Khoảng đệm bên trong | Từ 10 tới 12 pixel mỗi cạnh |
TextButton | Các nút Shop, đóng và Buy | Sự kiện Activated |
Nếu muốn tự vẽ cửa sổ bằng tay, hãy dựng các object giống vậy trong StarterGui với các thuộc tính này, ở đó cũng đặt ResetOnSpawn của ScreenGui thành false và giữ một thẻ làm mẫu để LocalScript clone cho từng vật phẩm trong catalog. Khi đó script chỉ điền thẻ và nối các nút. Logic mua ở bước sau không đổi.
Nếu game của bạn bắt đầu bằng menu chính, hướng dẫn đó có một dòng cần thêm vào ShopClient để nút Shop chỉ hiện sau khi người chơi đã nhấn Play. Để shop mở khi nói chuyện với người bán, hướng dẫn hội thoại NPC chỉ cách thêm hành động OpenShop bảo ShopClient mở cửa sổ, còn giao dịch vẫn đi qua các bước kiểm tra trên server của shop.
Bước 4: Kiểm tra và mua trên server
Script này là nơi duy nhất giao dịch có thể xảy ra. Nó nhận id vật phẩm, kiểm tra id, tìm giá, kiểm tra Coins của người chơi, rồi trừ xu và trao Tool. Nó trả lời nút Buy bằng true hoặc false kèm một thông báo để hiển thị.
Rê chuột lên ServerScriptService, chèn một Script tên ShopService và dán đoạn này vào:
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")
-- Thứ module ShopCatalog trả về, để kiểm tra kiểu nghiêm ngặt kiểm tra các trường chúng ta dùng
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: người chơi dùng được Tool ngay
local backpack = player:FindFirstChildOfClass("Backpack")
if backpack then
template:Clone().Parent = backpack
end
-- StarterGear: Roblox sao chép lại nó vào Backpack mỗi lần nhân vật xuất hiện
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 chỉ gửi id vật phẩm, nên nó phải là chuỗi
if type(itemId) ~= "string" then
return false, "That item does not exist."
end
-- 2. Bỏ qua click đúp và luồng yêu cầu từ 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. Tìm vật phẩm trong bản catalog của chính server
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. Giá lấy từ catalog, không bao giờ từ client
if coins.Value < item.price then
return false, `You need {item.price - coins.Value} more coins.`
end
-- 5. Trừ xu rồi mới trao vật phẩm. Không có gì ở đây nhường quyền thực thi, nên hai yêu cầu
-- từ cùng một người chơi không thể cùng vượt qua các bước kiểm tra ở trên trước khi đoạn này chạy xong.
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)
Quyền sở hữu được lưu thành attribute của Player, ví dụ Owns_sword. Attribute do server đặt được replicate tới thiết bị người chơi, nên LocalScript có thể đổi thẻ sang "Owned". Thay đổi người chơi tự làm trên bản của mình không tới được server.
Tool được đưa vào hai chỗ. Bản trong Backpack xuất hiện ngay trên hotbar. Bản trong StarterGear được Roblox đặt vào Backpack mới mỗi lần nhân vật xuất hiện. Không có nó, vật phẩm đã mua sẽ mất ngay lần đầu người chơi chết.
Vì sao client không bao giờ gửi giá
Mọi thứ trên thiết bị của người chơi thì người chơi đó đều có thể thay đổi. Kẻ gian lận chạy code riêng trong bản game của họ: họ có thể đọc LocalScript của bạn, đổi GUI và gọi BuyItem:InvokeServer() với bất kỳ đối số nào, bao nhiêu lần tùy thích. Hướng dẫn bảo mật của Roblox khuyên kiểm tra cả kiểu lẫn giá trị của mọi thứ remote nhận được, và ví dụ ở đó chính là một shop.
| Kẻ gian lận gửi | Nếu server tin họ | ShopService làm gì |
|---|---|---|
| Giá 0 | Mọi vật phẩm đều miễn phí | Bỏ qua nó. Giá được lấy từ catalog. |
| Giá -1000 | Coins.Value -= -1000 cho họ 1 000 xu | Bỏ qua nó. |
NaN thay cho giá | Mọi phép so sánh với NaN đều sai, nên bước kiểm tra "không đủ xu" không bao giờ kích hoạt | Bỏ qua nó. |
| Id không có trong catalog, hoặc một bảng thay vì chuỗi | Lỗi trong script hoặc vật phẩm bạn không định bán | Trả lời "That item does not exist." |
| Hàng trăm yêu cầu mỗi giây | Tải lên server, và bất kỳ lỗ hổng nào trong phần kiểm tra cũng kích hoạt hàng trăm lần | Xử lý không quá một yêu cầu từ mỗi người chơi trong nửa giây. |
| Coins đã sửa trên màn hình của họ | Mua bằng số xu họ không có | Hoàn toàn không thấy điều đó. Server chỉ đọc giá trị Coins của chính nó. |
Quy tắc này áp dụng cho mọi remote bạn viết: hãy gửi thứ người chơi đã chọn, ví dụ id vật phẩm hoặc số slot, và không bao giờ gửi giá của nó hay thứ họ phải nhận được. Hướng dẫn RemoteEvent nói kỹ hơn về việc kiểm tra đối số của remote.
Bước 5: Thử shop
- Nhấn Play. Nút Shop sẽ xuất hiện bên trái. Mở nó và mua Flashlight: Coins giảm 25, Tool xuất hiện trên hotbar, còn nút của nó đổi thành Owned.
- Thử Speed Coil, giá 300. Dòng trạng thái sẽ ghi bạn còn thiếu bao nhiêu xu, và không có gì bị trừ.
- Reset nhân vật qua menu trong game. Flashlight quay lại Backpack mới nhờ bản trong StarterGear.
- Để tự thêm xu khi thử, nhấn công tắc Client/Server và chuyển sang Server, tìm trong Explorer
Players, tên của bạn,leaderstats,Coinsvà đổi Value của nó trong cửa sổ Properties. Làm y hệt ở chế độ Client chỉ đổi màn hình của bạn, và đó chính là kiểu thay đổi mà server bỏ qua.
Nếu nút trả lời "The shop did not answer", mở cửa sổ Output qua menu Window trong Studio và tìm lỗi màu đỏ từ ShopService. Còn nếu nút đứng yên ở "Buying...", nghĩa là ShopService không chạy hoặc bị kẹt khi chờ một object: xem lỗi thường gặp.
Bán game pass bằng Robux
Xu là tiền tệ riêng của bạn, nên shop ở trên tự quyết định mọi giao dịch. Thứ người chơi mua bằng Robux hoạt động khác: game pass mua một lần và giữ mãi (quyền lợi VIP, Tool vĩnh viễn), còn developer product có thể mua lại nhiều lần (gói xu, bỏ qua màn). Cả hai đều đi qua MarketplaceService của Roblox, và việc thanh toán do Roblox nhận, không phải script của bạn.
Hai quy tắc từ hướng dẫn này vẫn áp dụng: mở cửa sổ mua bằng một nút trên client, và chỉ trao phần thưởng trên server khi Roblox đã xác nhận giao dịch hoặc người chơi đã có pass. Hướng dẫn script game pass dựng trọn vẹn việc này: kiểm tra quyền sở hữu khi vào game, cửa sổ mua, phần thưởng như cửa VIP và khi nào nên dùng developer product thay cho pass. Để chọn giá, máy tính phí Robux miễn phí cho thấy pass hoặc developer product mang về cho bạn bao nhiêu sau phần của Roblox.
Lưu đồ người chơi đã mua
Mọi thứ chúng ta đã làm chỉ tồn tại trong một phiên: xu và vật phẩm đã mua bị reset khi người chơi thoát, cho tới khi bạn lưu chúng bằng data store. Để không lặp lại code lưu ở đây, hãy làm theo hướng dẫn DataStore (hoặc bước 3 của hướng dẫn bảng xếp hạng, bản ngắn hơn) và nhớ các quy tắc của shop:
- Lưu id vật phẩm, ví dụ
{ "sword", "flashlight" }, trong cùng bảng với giá trị Coins, để một lần lưu ghi cả số xu đã tiêu lẫn vật phẩm đã mua. Không thể đặt Tool và các instance khác vào data store. - Khi dữ liệu đã tải xong, duyệt qua các id đã lưu, bỏ qua những id không còn trong catalog, đặt từng attribute
Owns_và trao Tool giống nhưgiveToollàm. Cửa sổ shop tự cập nhật vì nó lắng nghe các attribute này. - Không cần lưu quyền sở hữu pass:
UserOwnsGamePassAsynchỏi Roblox mỗi lần người chơi vào game. - Không bao giờ lưu người chơi mà dữ liệu chưa tải được, nếu không một lần tải thất bại có thể thay đồ đã mua của họ bằng danh sách rỗng.
Lỗi thường gặp và cách sửa
Khi shop hoạt động lạ, hãy kiểm tra những điều này trước. Việc đầu tiên là mở cửa sổ Output (menu Window, rồi Output): lỗi script ghi rõ tên script và dòng.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("ShopRemotes")'
Script đang chờ một object không tồn tại với đúng tên đó. Kiểm tra chính tả và chữ hoa trong ShopRemotes, BuyItem, ShopCatalog và ShopItems, và xem ShopItems có nằm trong ServerStorage chứ không phải ReplicatedStorage. Hướng dẫn lỗi script giải thích kỹ cảnh báo này.
Nút Buy đứng yên ở "Buying..." và không trả lời
Trên server chưa ai đặt BuyItem.OnServerInvoke, nên Roblox giữ yêu cầu cho tới khi việc đó xảy ra. Hãy chắc rằng ShopService là Script chứ không phải LocalScript, nằm trong ServerScriptService, và tìm trong Output cảnh báo Infinite yield possible từ ShopService: nó nghĩa là script bị kẹt khi chờ ShopCatalog, ShopRemotes hoặc ShopItems.
Nút Buy ghi "The shop did not answer"
Lời gọi server bị lỗi thay vì trả về câu trả lời. Nguyên nhân thường gặp là lỗi bên trong ShopService khi xử lý yêu cầu, nên hãy tìm trong Output lỗi màu đỏ từ ShopService: trong đó có số dòng.
Nút ghi "This item is not available right now"
Server không tìm thấy Tool có toolName của vật phẩm này bên trong ServerStorage, ShopItems. Trong Output có cảnh báo kèm đúng tên nó đã tìm.
Tôi đã mua Tool nhưng nhân vật không cầm được hoặc bị kẹt
Tool phải có đúng một part tên Handle nằm trực tiếp bên trong, và không part nào của nó được anchor. Với Tool không cần cầm trên tay, hãy bỏ dấu tích RequiresHandle thay vì vậy.
Xu giảm trên màn hình của tôi nhưng không giảm ở người khác
Giao dịch diễn ra trong LocalScript, nên chỉ thiết bị của bạn thay đổi. Chuyển phần trừ xu và trao Tool sang Script server, như ở bước 4.
Vật phẩm đã mua biến mất sau khi vào lại game
Hiện chưa có gì được lưu. Xem lưu đồ đã mua.
Làm bằng RoCode
Nếu không muốn tự dựng tất cả bằng tay, RoCode có thể làm việc này trong place bạn đang mở. Đây là AI agent viết code độc lập: bạn mô tả tính năng trong web chat của nó, còn plugin cho Roblox Studio của nó tạo script, remote và GUI trong Explorer của bạn, nên không cần chép code từ cửa sổ chat.
Thêm shop bằng xu: nút Shop mở một lưới bốn Tool có giá bằng Coins từ leaderstats của tôi. Server phải kiểm tra giá và trao Tool vào Backpack và StarterGear.
- Có thể xem qua place của bạn bằng Search Scripts và Read Script để tìm leaderstats và code shop sẵn có, để dùng giá trị Coins của bạn thay vì thêm cái thứ hai
- Có thể dựng khung cửa sổ bằng Build UI: bố cục shop đi kèm thẻ giữ chỗ và một LocalScript cho hiệu ứng rê chuột và nút Close; logic mua được viết bằng các script riêng
- Tạo RemoteFunction bằng Create Instance và viết ModuleScript catalog, Script server và LocalScript bằng Create Script
- Kiểm tra từng script biên dịch được trong Studio bằng Check Script (nó không kiểm tra kiểu và không chạy script), và mỗi đợt thay đổi là một điểm hoàn tác trong Studio
Bạn vẫn phải tự tạo pass trong Creator Hub, vì RoCode không tạo được pass và developer product, và việc thử mua cũng do bạn làm: với plugin 3.9 trở lên RoCode có thể chạy một lượt playtest ngắn và đọc lỗi, còn với plugin 3.9.15 trở lên nhân vật thử nghiệm của nó có thể nhấn nút Shop và Buy, nhưng nó chỉ kiểm tra những gì nó tự quyết định thử. Shop thường đến sau gameplay chính và phần lưu dữ liệu; quy trình làm game từng bước với RoCode cho thấy vị trí của nó. RoCode kết nối với Studio thế nào.
Câu hỏi thường gặp
Nút Buy trong Roblox nên dùng RemoteEvent hay RemoteFunction?
Dùng cái nào cũng được, miễn là server kiểm tra. RemoteFunction cho phép nút chờ câu trả lời của server và hiển thị nó, nên hướng dẫn này dùng nó, và ví dụ shop trong hướng dẫn bảo mật của Roblox cũng dùng RemoteFunction. Chỉ gọi nó từ client: server gọi InvokeClient có thể chờ mãi nếu client không bao giờ trả lời. Hướng dẫn RemoteEvent so sánh cả hai cách.
Làm sao mở shop qua NPC thay vì bằng nút?
Đặt một ProximityPrompt vào một part nào đó của NPC, ví dụ HumanoidRootPart của nó, lắng nghe sự kiện Triggered của nó trong Script server và gửi cho người chơi đó một RemoteEvent để LocalScript hiện bảng. Nếu chỉ được mua khi ở gần NPC, hãy kiểm tra thêm khoảng cách tới NPC bên trong handler của BuyItem, vì client có thể gọi remote từ bất kỳ đâu.
Làm sao bán vật phẩm mua được nhiều lần?
Với những vật phẩm đó, bỏ qua bước kiểm tra "đã có" và thay vì trao Tool, hãy trao thứ đếm được, ví dụ cộng 1 vào IntValue đếm số bình thuốc. Giữ nguyên phần tìm giá và kiểm tra xu.
Vì sao shop biến mất khi nhân vật respawn?
ScreenGui của nó có ResetOnSpawn là true, đây là giá trị mặc định, nên Roblox xóa nó khi respawn. Đặt thành false, như script ở bước 3 làm.
Có thể dùng mẫu GUI shop miễn phí không?
Có, bố cục nào cũng được, miễn là nút Buy của nó chỉ gửi id vật phẩm, còn giao dịch thật diễn ra trong Script server như ShopService. Trước khi dùng mẫu, hãy kiểm tra xem nó có trừ xu hay trao vật phẩm trong LocalScript không.
Nguồn và tài liệu đọc thêm
- Roblox Creator Docs: Securing the client-server boundary (tiếng Anh). kiểm tra đối số của remote, NaN, giới hạn tần suất và ví dụ shop trong game
- Roblox Creator Docs: Remote events and callbacks (tiếng Anh). RemoteFunction, InvokeServer, OnServerInvoke và rủi ro của InvokeClient
- Roblox Creator Docs: Passes (tiếng Anh). tạo và bán pass, UserOwnsGamePassAsync và PromptGamePassPurchaseFinished
- Roblox Creator Docs: Shop (tiếng Anh). Shop trong game mà Roblox tự động tạo
- Roblox Creator Docs: Developer Products (tiếng Anh). giao dịch Robux mua lại được và ProcessReceipt
- Roblox Creator Docs: StarterGear (tiếng Anh). vì sao Tool trong StarterGear quay lại sau khi respawn
- Roblox Creator Docs: In-game tools (tiếng Anh). Handle, anchor và RequiresHandle
Cách kiểm tra code: mọi script trong trang này đều qua trình kiểm tra kiểu nghiêm ngặt (strict) của Luau với định nghĩa API của Roblox (luau-lsp, 20 tháng 11, 2026). Kiểm tra kiểu bắt được API gõ sai và kiểu dữ liệu sai, không bắt được lỗi logic của game, nên hãy thử trong Studio trước khi xuất bản.