Hướng dẫn · Hệ thống game

Cách làm shop trong Roblox Studio

Shop trong game Roblox gồm hai việc: một GUI hiển thị vật phẩm và một script server quyết định giao dịch có diễn ra hay không. Trong hướng dẫn này, chúng ta dựng cả hai cho một shop bán Tool bằng xu, và chỉ ra chỗ dành cho các giao dịch bằng Robux.

Cập nhật ngày 20 tháng 11, 202615 phút đọcTác giả:

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
  1. Cách hoạt động
  2. 1. Chuẩn bị
  3. 2. Catalog vật phẩm
  4. 3. GUI shop
  5. 4. Mua trên server
  6. Vì sao client không gửi giá
  7. 5. Thử nghiệm
  8. Game pass
  9. Lưu đồ đã mua
  10. Common errors
  11. Với RoCode
  12. Câu hỏi thường gặp
  13. Nguồn và tài liệu đọc thêm

Một shop chạy được hoạt động thế nào

Minh họaNgười chơi mở shop và mua Flashlight với giá 25 xu: Coins giảm từ 200 xuống 175, nút đổi thành Owned, còn Tool xuất hiện trên hotbar.

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.

Năm phần của shop
PhầnNằm ở đâuLàm gì
ModuleScript ShopCatalogReplicatedStorageId 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 BuyItemReplicatedStorage, trong folder ShopRemotesMang yêu cầu mua lên server và mang câu trả lời về.
LocalScript ShopClientStarterPlayerScriptsDựng cửa sổ shop và gửi id vật phẩm khi nút Buy được nhấn.
Script ShopServiceServerScriptServiceKiểm tra yêu cầu, trừ Coins và trao Tool.
Các Tool bạn bánServerStorage, trong folder ShopItemsBản gốc mà server sao chép. Không thứ gì trong ServerStorage được gửi tới người chơi.
Explorer khi shop đã xong
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.

Script trong ServerScriptService tên là Leaderstats
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.

  1. 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ên BuyItem.
  2. Rê chuột lên ServerStorage và chèn một Folder tên ShopItems.
  3. Đặt vào ShopItems một Tool cho mỗi vật phẩm, với tên ClassicSword, Flashlight, GrappleHook và SpeedCoil. Cho lần thử đầu, mỗi Tool chỉ cần một Part không anchor tên Handle. 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.
  4. 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:

ModuleScript trong ReplicatedStorage tên là ShopCatalog
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.

  1. Trong Explorer, mở rộng StarterPlayer, rê chuột lên StarterPlayerScripts và chèn một LocalScript tên ShopClient.
  2. Thay nội dung của nó bằng code bên dưới.
LocalScript trong StarterPlayerScripts tên là ShopClient
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ì.

Các object GUI và thuộc tính quan trọng
ObjectVai trò trong shopThuộc tính chính
ScreenGuiChứa mọi thứ được vẽ trên màn hìnhResetOnSpawn false, để shop còn lại sau khi respawn
FrameCửa sổ và từng thẻ vật phẩmAnchorPoint 0.5, 0.5 và Position 0.5, 0.5, để cửa sổ nằm giữa
UISizeConstraintGiới hạn cửa sổ trên màn hình lớnMaxSize 640 x 460
ScrollingFrameCuộn được khi có nhiều thẻ hơn chỗ chứaCanvasSize 0 và AutomaticCanvasSize Y, để vùng cuộn lớn lên theo số thẻ
UIGridLayoutXếp thẻ thành hàng và xuống dòngCellSize 180 x 200, CellPadding 12, SortOrder LayoutOrder
UICornerBo tròn gócCornerRadius từ 8 tới 14 pixel
UIPaddingKhoảng đệm bên trongTừ 10 tới 12 pixel mỗi cạnh
TextButtonCác nút Shop, đóng và BuySự 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:

Script trong ServerScriptService tên là ShopService
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.

Chuyện gì xảy ra nếu server tin client
Kẻ gian lận gửiNếu server tin họShopService làm gì
Giá 0Mọi vật phẩm đều miễn phíBỏ qua nó. Giá được lấy từ catalog.
Giá -1000Coins.Value -= -1000 cho họ 1 000 xuBỏ 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ạtBỏ qua nó.
Id không có trong catalog, hoặc một bảng thay vì chuỗiLỗi trong script hoặc vật phẩm bạn không định bánTrả lời "That item does not exist."
Hàng trăm yêu cầu mỗi giâyTả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ầnXử 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

  1. 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.
  2. 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ừ.
  3. Reset nhân vật qua menu trong game. Flashlight quay lại Backpack mới nhờ bản trong StarterGear.
  4. Để 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, Coins và đổ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ư giveTool là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: UserOwnsGamePassAsync hỏ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.

Bạn gõ

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.

RoCode làm
  • 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

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.

Thử RoCode trong chính game của bạn.

Mỗi ngày có credit miễn phí, không cần thẻ. Cài plugin, mô tả tính năng và xem kết quả xuất hiện trong Studio.