สรุปสั้น ๆ
เก็บไอเทมและราคาไว้ใน ModuleScript ใน ReplicatedStorage สร้างหน้าต่างจาก ScreenGui, ScrollingFrame และ UIGridLayout และให้ปุ่ม Buy แต่ละปุ่มเรียก RemoteFunction โดยส่งแค่ id ของไอเทม จากนั้น Script ใน ServerScriptService จะหาราคาเอง ตรวจและหัก Coins ของผู้เล่น และให้ไอเทม
- อย่าให้ไคลเอนต์ส่งราคามาเด็ดขาด ใครก็เรียก remote ของคุณด้วยค่าอะไรก็ได้ เซิร์ฟเวอร์จึงเอาราคาจากแค็ตตาล็อกสำเนาของตัวเอง
- ให้ Tool ที่ซื้อด้วยการโคลนจาก ServerStorage ไปใส่ Backpack ของผู้เล่น (เพื่อใช้ได้ทันที) และใส่ StarterGear (เพื่อให้มันกลับมาหลังเกิดใหม่)
- สิ่งที่ขายด้วย Robux คือพาสและ developer products ซึ่งใช้งานผ่าน MarketplaceService สำหรับสิ่งเหล่านี้ Roblox ยังสร้าง Shop ให้เอง ซึ่งไม่ใช่สิ่งเดียวกับร้านค้าที่ใช้เหรียญ
ในหน้านี้
ร้านค้าที่ใช้งานได้จริงมีโครงสร้างอย่างไร
ร้านค้าที่ใช้งานได้ในเกมจริงถูกแบ่งระหว่างอุปกรณ์ของผู้เล่นกับเซิร์ฟเวอร์ อุปกรณ์วาดหน้าต่างและบอกว่า "อยากซื้อดาบ" เซิร์ฟเวอร์ซึ่งเป็นฝั่งเดียวที่ไว้ใจได้ เป็นผู้ตัดสินว่าจะเกิดขึ้นหรือไม่ สคริปต์ร้านค้าที่ "ใช้ไม่ได้" หรือที่ผู้เล่นโกงได้ มักตัดสินใจเรื่องนี้ผิดฝั่ง
| ส่วน | อยู่ที่ไหน | หน้าที่ |
|---|---|---|
ModuleScript ShopCatalog | ReplicatedStorage | id ของไอเทม ชื่อ ราคา และ Tool ที่แต่ละตัวให้ ทั้งสองฝั่งอ่านมัน |
RemoteFunction BuyItem | ReplicatedStorage ในโฟลเดอร์ ShopRemotes | ส่งคำขอซื้อไปยังเซิร์ฟเวอร์และส่งคำตอบกลับ |
LocalScript ShopClient | StarterPlayerScripts | สร้างหน้าต่างร้านค้าและส่ง id ของไอเทมเมื่อกดปุ่ม Buy |
Script ShopService | ServerScriptService | ตรวจคำขอ หัก Coins และให้ Tool |
| Tools ที่คุณขาย | ServerStorage ในโฟลเดอร์ ShopItems | ต้นฉบับที่เซิร์ฟเวอร์ก๊อป ไม่มีอะไรใน ServerStorage ถูกส่งให้ผู้เล่น |
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
ขั้นตอนที่ 1: เหรียญและไอเทมที่จะขาย
ร้านค้าใช้ค่า Coins ใน leaderstats ของผู้เล่น ถ้าคุณทำตามคู่มือลีดเดอร์บอร์ดแล้ว คุณมีค่านี้อยู่แล้ว และข้ามสคริปต์นี้ได้ ไม่อย่างนั้นให้ใส่ Script ใน ServerScriptService ชื่อ Leaderstats มันให้ทุกคน 200 เหรียญตอนเริ่ม เพื่อให้ทดสอบการซื้อได้ทันที
local Players = game:GetService("Players")
local STARTING_COINS = 200 -- พอสำหรับทดสอบร้านค้า ตั้งเป็น 0 เมื่อผู้เล่นหาเหรียญได้แล้ว
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
มีสคริปต์ leaderstats แค่ตัวเดียว สองสคริปต์ที่ต่างสร้างโฟลเดอร์ leaderstats ทำให้ผู้เล่นทุกคนมีสองโฟลเดอร์ และร้านค้าอาจอ่านผิดโฟลเดอร์
ต่อไปสร้างอ็อบเจกต์ที่สคริปต์จะค้นหา ตัวพิมพ์ใหญ่เล็กในชื่อมีผล ให้เขียนตรงตามนี้
- ใน Explorer เอาเมาส์ไปวางที่ ReplicatedStorage กดปุ่ม + แล้วใส่ Folder ชื่อ
ShopRemotesข้างในใส่ RemoteFunction ชื่อBuyItem - เอาเมาส์ไปวางที่ ServerStorage แล้วใส่ Folder ชื่อ
ShopItems - ใส่ Tool หนึ่งตัวต่อไอเทมลงใน ShopItems ชื่อ
ClassicSword,Flashlight,GrappleHookและSpeedCoilสำหรับการทดสอบแรก Tool มีแค่ Part ที่ไม่ Anchored ชื่อHandleหนึ่งชิ้นก็พอ Tool ใดที่คุณมีอยู่แล้วก็ใช้ได้: ตั้งชื่อให้ตรง อาวุธที่ทำดาเมจได้จริง ให้สร้างตามคู่มือดาบหรือคู่มือปืน แต่ละคู่มือบอกวิธีเชื่อมมันกับแค็ตตาล็อก - เลือก Tool แต่ละตัวแล้วเอาเครื่องหมายถูกที่ CanBeDropped ออกในหน้าต่าง Properties ถ้าติ๊กไว้ การกด Backspace จะโยนเครื่องมือลงใน Workspace และผู้เล่นคนไหนก็เก็บสิ่งที่คนซื้อจ่ายเงินไปได้
เริ่มด้วย Tool แค่ตัวเดียวก็ได้ ถ้า Tool ของไอเทมไหนไม่มี เซิร์ฟเวอร์จะปฏิเสธการขายไอเทมนั้นและเขียนคำเตือนพร้อมชื่อของมัน ผู้เล่นจึงไม่ถูกหักอะไร
ขั้นตอนที่ 2: ไอเทมและราคาในแค็ตตาล็อก
แค็ตตาล็อกคือรายการเดียวของทุกอย่างที่ร้านขาย LocalScript อ่านมันเพื่อวาดการ์ด และเซิร์ฟเวอร์อ่านมันเพื่อหาราคา การเปลี่ยนราคาจึงเป็นการแก้ครั้งเดียวในที่เดียว
เอาเมาส์ไปวางที่ ReplicatedStorage ใส่ ModuleScript เปลี่ยนชื่อเป็น ShopCatalog แล้วแทนที่เนื้อหาด้วยโค้ดนี้:
export type ShopItem = {
id: string, -- ภายหลังจะถูกบันทึกในที่เก็บข้อมูล: อย่าเปลี่ยนเมื่อผู้เล่นมีไอเทมนี้แล้ว
name: string, -- แสดงบนการ์ด เปลี่ยนได้
price: number, -- เป็น Coins
description: string,
toolName: string, -- Tool ใน ServerStorage.ShopItems ที่ผู้เล่นได้รับ
}
-- การ์ดแสดงตามลำดับนี้
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
-- คืนไอเทมที่มี id นี้ หรือ nil ถ้าไม่มีไอเทมนั้น
function ShopCatalog.get(id: string): ShopItem?
return byId[id]
end
-- แอตทริบิวต์ของ Player ที่เซิร์ฟเวอร์ตั้งเป็น true เมื่อผู้เล่นมีไอเทมนั้น
function ShopCatalog.ownedAttribute(id: string): string
return "Owns_" .. id
end
return ShopCatalog
ไอเทมแต่ละตัวมี id และ name ที่แสดงแยกกัน เซิร์ฟเวอร์บันทึก id เมื่อผู้เล่นมีของ จึงเปลี่ยนชื่อ "Classic Sword" ภายหลังได้โดยไม่ทำให้การซื้อที่บันทึกไว้พัง คำอธิบายเป็นแค่ข้อความบนการ์ด สิ่งที่ Tool ทำขึ้นกับสคริปต์ของมันเอง
ผู้เล่นอ่าน ModuleScript ใน ReplicatedStorage ได้ ราคาเหล่านี้จึงเป็นสาธารณะ ซึ่งไม่เป็นไร: มันเขียนอยู่บนการ์ดอยู่แล้ว ที่สำคัญคือไคลเอนต์และเซิร์ฟเวอร์ต่างรันสำเนาโมดูลของตัวเอง ผู้เล่นที่เปลี่ยนราคาบนอุปกรณ์ของตัวเองจึงไม่ได้เปลี่ยนอะไรบนเซิร์ฟเวอร์
ขั้นตอนที่ 3: สร้าง GUI ร้านค้า
LocalScript นี้สร้างหน้าต่างทั้งหมดด้วยโค้ด: ปุ่ม Shop แผงที่มีตารางการ์ดแบบเลื่อนได้ ปุ่ม Buy หนึ่งปุ่มต่อไอเทมในแค็ตตาล็อก ตัวนับ Coins และบรรทัดสถานะสำหรับคำตอบจากเซิร์ฟเวอร์ เพราะทุกอย่างทำด้วยโค้ด จึงวางแล้วกด Play ได้เลย ตารางหลังโค้ดแสดงอ็อบเจกต์ทุกตัว ถ้าคุณอยากจัดหน้าต่างเอง
- ใน Explorer กาง StarterPlayer เอาเมาส์ไปวางที่ StarterPlayerScripts แล้วใส่ LocalScript ชื่อ
ShopClient - แทนที่เนื้อหาด้วยโค้ดด้านล่าง
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- สิ่งที่โมดูล ShopCatalog คืน เพื่อให้การตรวจชนิดข้อมูลแบบ strict ตรวจฟิลด์ที่เราใช้
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: เก็บทุกอย่างที่ร้านค้าวาดบนหน้าจอของผู้เล่น
local gui = Instance.new("ScreenGui")
gui.Name = "ShopGui"
gui.ResetOnSpawn = false -- ร้านค้ายังอยู่เมื่อตัวละครเกิดใหม่
-- ปุ่มที่ขอบซ้ายที่เปิดและปิดร้านค้า
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)
-- หน้าต่างร้านค้า: อยู่กลางจอ ซ่อนไว้จนกว่าผู้เล่นจะเปิด
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) -- กันไม่ให้หน้าต่างใหญ่เกินไปบนจอใหญ่
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
-- คำตอบของเซิร์ฟเวอร์แสดงที่นี่ เช่น "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: พื้นที่ที่เลื่อนได้เมื่อการ์ดมีมากกว่าที่แสดงได้
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() -- เริ่มที่ศูนย์ AutomaticCanvasSize จะขยายตามการ์ด
list.AutomaticCanvasSize = Enum.AutomaticSize.Y
list.Parent = panel
-- UIGridLayout: จัดการ์ดเป็นแถวและขึ้นแถวใหม่เมื่อเต็ม
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..."
-- ส่งแค่ id ของไอเทม เซิร์ฟเวอร์หาราคาเอง
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)
-- เซิร์ฟเวอร์ตั้งแอตทริบิวต์นี้เมื่อซื้อสำเร็จ (หรือเมื่อโหลดไอเทมที่บันทึกไว้แล้ว)
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")
-- แสดงเหรียญของผู้เล่น ค่าจริงอยู่ที่เซิร์ฟเวอร์ ที่นี่แค่แสดง
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()
ปุ่มใช้ Activated ไม่ใช่ MouseButton1Click: มันทำงานเมื่อคลิกเมาส์ แตะบนโทรศัพท์ และกดปุ่ม A หรือปุ่มกากบาทบนจอยเกม
นิยาม type ด้านบนอธิบายสิ่งที่ ShopCatalog คืน เพื่อให้การตรวจชนิดข้อมูลแบบ strict จับการพิมพ์ชื่อฟิลด์ผิดได้ เช่น item.prise เมื่อเกมรันอยู่ มันไม่เปลี่ยนอะไร
| อ็อบเจกต์ | หน้าที่ในร้าน | พร็อพเพอร์ตีหลัก |
|---|---|---|
ScreenGui | เก็บทุกอย่างที่วาดบนหน้าจอ | ResetOnSpawn เป็น false เพื่อให้ร้านอยู่รอดหลังเกิดใหม่ |
Frame | หน้าต่างและการ์ดไอเทมแต่ละใบ | AnchorPoint 0.5, 0.5 และ Position 0.5, 0.5 เพื่อให้หน้าต่างอยู่กลางจอ |
UISizeConstraint | จำกัดขนาดหน้าต่างบนจอใหญ่ | MaxSize 640 x 460 |
ScrollingFrame | เลื่อนได้เมื่อการ์ดมีมากกว่าที่แสดงได้ | CanvasSize 0 และ AutomaticCanvasSize Y เพื่อให้พื้นที่เลื่อนโตตามการ์ด |
UIGridLayout | วางการ์ดเป็นแถวและขึ้นแถวใหม่ | CellSize 180 x 200, CellPadding 12, SortOrder LayoutOrder |
UICorner | ทำมุมให้โค้ง | CornerRadius 8 ถึง 14 พิกเซล |
UIPadding | ระยะขอบด้านใน | 10 ถึง 12 พิกเซลในแต่ละด้าน |
TextButton | ปุ่ม Shop ปุ่มปิด และปุ่ม Buy | อีเวนต์ Activated |
ถ้าอยากวาดหน้าต่างเอง ให้สร้างอ็อบเจกต์เดียวกันใน StarterGui ด้วยพร็อพเพอร์ตีเหล่านี้ ตั้ง ResetOnSpawn ของ ScreenGui เป็น false ที่นั่นด้วย และเก็บการ์ดหนึ่งใบไว้เป็นแม่แบบที่ LocalScript จะโคลนให้ไอเทมแต่ละตัวในแค็ตตาล็อก จากนั้นสคริปต์แค่เติมการ์ดและเชื่อมปุ่ม ตรรกะการซื้อในขั้นตอนถัดไปไม่เปลี่ยน
ถ้าเกมของคุณเริ่มด้วยเมนูหลัก คู่มือนั้นมีบรรทัดเดียวที่ต้องเพิ่มใน ShopClient เพื่อให้ปุ่ม Shop ปรากฏหลังผู้เล่นกด Play เท่านั้น ถ้าอยากให้ร้านเปิดด้วยการคุยกับคนขาย คู่มือบทสนทนากับ NPCแสดงวิธีเพิ่มการกระทำ OpenShop ที่สั่งให้ ShopClient เปิดหน้าต่าง ส่วนการซื้อยังผ่านการตรวจฝั่งเซิร์ฟเวอร์ของร้านเหมือนเดิม
ขั้นตอนที่ 4: การตรวจและการซื้อบนเซิร์ฟเวอร์
Script นี้เป็นที่เดียวที่การซื้อเกิดขึ้นได้ มันรับ id ของไอเทม ตรวจ หาราคา ตรวจ Coins ของผู้เล่น แล้วหักเหรียญและให้ Tool มันตอบปุ่ม Buy ด้วย true หรือ false พร้อมข้อความที่จะแสดง
เอาเมาส์ไปวางที่ ServerScriptService ใส่ Script ชื่อ ShopService แล้ววางโค้ดนี้:
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")
-- สิ่งที่โมดูล ShopCatalog คืน เพื่อให้การตรวจชนิดข้อมูลแบบ strict ตรวจฟิลด์ที่เราใช้
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: ผู้เล่นใช้เครื่องมือได้ทันที
local backpack = player:FindFirstChildOfClass("Backpack")
if backpack then
template:Clone().Parent = backpack
end
-- StarterGear: Roblox ก๊อปมันใส่ Backpack ใหม่ทุกครั้งที่ตัวละครเกิด
local starterGear = player:FindFirstChildOfClass("StarterGear")
if starterGear then
template:Clone().Parent = starterGear
end
end
local function onBuyItem(player: Player, itemId: unknown): (boolean, string)
-- 1. ไคลเอนต์ส่งแค่ id ของไอเทม จึงต้องเป็นสตริง
if type(itemId) ~= "string" then
return false, "That item does not exist."
end
-- 2. ไม่สนการคลิกซ้ำและคำขอรัว ๆ จากสคริปต์
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. หาไอเทมในแค็ตตาล็อกสำเนาของเซิร์ฟเวอร์เอง
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. ราคามาจากแค็ตตาล็อกเสมอ ไม่เคยมาจากไคลเอนต์
if coins.Value < item.price then
return false, `You need {item.price - coins.Value} more coins.`
end
-- 5. หักเหรียญแล้วให้ไอเทม ตรงนี้ไม่มีอะไรหยุดรอ คำขอสองครั้ง
-- จากผู้เล่นคนเดียวจึงผ่านการตรวจด้านบนพร้อมกันไม่ได้ก่อนที่ส่วนนี้จะทำเสร็จ
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)
ความเป็นเจ้าของเก็บเป็นแอตทริบิวต์ของ Player เช่น Owns_sword แอตทริบิวต์ที่เซิร์ฟเวอร์ตั้งจะ replicate ไปยังอุปกรณ์ของผู้เล่น LocalScript จึงเปลี่ยนการ์ดเป็น "Owned" ได้ การเปลี่ยนที่ผู้เล่นทำในสำเนาของตัวเองไม่ไปถึงเซิร์ฟเวอร์
Tool ไปอยู่สองที่ สำเนาใน Backpack ปรากฏในแถบด่วนทันที สำเนาใน StarterGear Roblox จะใส่ลงใน Backpack ใหม่ทุกครั้งที่ตัวละครเกิด ถ้าไม่มีมัน ไอเทมที่ซื้อจะหายไปตั้งแต่ผู้เล่นตายครั้งแรก
ทำไมไคลเอนต์ถึงไม่เคยส่งราคามา
ทุกอย่างที่อยู่บนอุปกรณ์ของผู้เล่น ผู้เล่นคนนั้นเปลี่ยนได้ คนโกงรันโค้ดของตัวเองในสำเนาเกมของตัวเอง: อ่าน LocalScript ของคุณได้ เปลี่ยน GUI ได้ และเรียก BuyItem:InvokeServer() ด้วยอาร์กิวเมนต์อะไรก็ได้กี่ครั้งก็ได้ คู่มือความปลอดภัยของ Roblox บอกให้ตรวจทั้งชนิดและค่าของทุกอย่างที่ remote ได้รับ และใช้ร้านค้าเป็นตัวอย่างพอดี
| คนโกงส่ง | ถ้าเซิร์ฟเวอร์เชื่อ | ShopService ทำอะไร |
|---|---|---|
| ราคา 0 | ทุกไอเทมฟรี | ไม่สนใจ ราคามาจากแค็ตตาล็อก |
| ราคา -1000 | Coins.Value -= -1000 ให้เขา 1,000 เหรียญ | ไม่สนใจ |
NaN แทนราคา | การเปรียบเทียบกับ NaN เป็นเท็จเสมอ การตรวจ "เหรียญไม่พอ" จึงไม่เคยทำงาน | ไม่สนใจ |
| id ที่ไม่มีในแค็ตตาล็อก หรือตารางแทนสตริง | สคริปต์มีข้อผิดพลาด หรือได้ไอเทมที่คุณไม่ได้ตั้งใจขาย | ตอบว่า "That item does not exist." |
| คำขอหลายร้อยครั้งต่อวินาที | เซิร์ฟเวอร์รับภาระหนัก และช่องโหว่ใด ๆ ในการตรวจจะทำงานหลายร้อยครั้ง | จัดการได้ไม่เกินหนึ่งคำขอต่อผู้เล่นทุกครึ่งวินาที |
| Coins ที่แก้บนหน้าจอของตัวเอง | ซื้อด้วยเหรียญที่ไม่มีจริง | ไม่เห็นเลย เซิร์ฟเวอร์อ่านแค่ค่า Coins ของตัวเอง |
กฎนี้ใช้กับทุก remote ที่คุณเขียน: ส่งสิ่งที่ผู้เล่นเลือก เช่น id ของไอเทมหรือหมายเลขช่อง และไม่ส่งว่ามันราคาเท่าไรหรือเขาควรได้อะไร คู่มือ RemoteEventอธิบายการตรวจอาร์กิวเมนต์ของ remote อย่างละเอียด
ขั้นตอนที่ 5: ทดสอบร้านค้า
- กด Play ปุ่ม Shop จะปรากฏทางซ้าย เปิดแล้วซื้อ Flashlight: Coins ลดลง 25 เครื่องมือปรากฏในแถบด่วน และปุ่มของมันเปลี่ยนเป็น Owned
- ลองซื้อ Speed Coil ที่ราคา 300 บรรทัดสถานะจะบอกว่ายังขาดกี่เหรียญ และไม่มีการหักอะไร
- รีเซ็ตตัวละครผ่านเมนูในเกม Flashlight จะกลับมาใน Backpack ใหม่ เพราะมีสำเนาใน StarterGear
- ถ้าจะเพิ่มเหรียญให้ตัวเองระหว่างทดสอบ ให้กดสวิตช์ Client/Server แล้วสลับไปที่ Server หา
Playersชื่อของคุณleaderstatsและCoinsใน Explorer แล้วเปลี่ยน Value ในหน้าต่าง Properties ถ้าทำแบบเดียวกันในโหมด Client จะเปลี่ยนแค่หน้าจอของคุณ ซึ่งเป็นการเปลี่ยนแบบที่เซิร์ฟเวอร์ไม่สนใจพอดี
ถ้าปุ่มตอบว่า "The shop did not answer" ให้เปิดหน้าต่าง Output ผ่านเมนู Window ใน Studio แล้วหาข้อผิดพลาดสีแดงจาก ShopService ถ้าปุ่มค้างที่ "Buying..." แปลว่า ShopService ไม่ได้รัน หรือติดรออ็อบเจกต์อยู่: ดูข้อผิดพลาดที่พบบ่อย
ขายเกมพาสด้วย Robux
เหรียญเป็นสกุลเงินของคุณเอง ร้านค้าด้านบนจึงตัดสินการซื้อทุกครั้งเอง สิ่งที่ผู้เล่นซื้อด้วย Robux ทำงานต่างออกไป: เกมพาสซื้อครั้งเดียวและอยู่ตลอดไป (โบนัส VIP เครื่องมือถาวร) ส่วน developer product ซื้อซ้ำได้เรื่อย ๆ (แพ็กเหรียญ ข้ามด่าน) ทั้งสองผ่าน MarketplaceService ของ Roblox และ Roblox เป็นผู้รับชำระเงิน ไม่ใช่สคริปต์ของคุณ
กฎสองข้อจากคู่มือนี้ใช้ต่อได้: เปิดหน้าต่างซื้อด้วยปุ่มบนไคลเอนต์ และให้โบนัสบนเซิร์ฟเวอร์เท่านั้น เมื่อ Roblox ยืนยันการซื้อแล้ว หรือผู้เล่นมีพาสอยู่แล้ว คู่มือสคริปต์เกมพาสสร้างทั้งหมดนี้: การตรวจความเป็นเจ้าของตอนเข้าเกม หน้าต่างซื้อ โบนัสอย่างประตู VIP และเมื่อไรที่ developer product เหมาะกว่าพาส ถ้าจะเลือกราคา เครื่องคำนวณค่าธรรมเนียม Robuxฟรีจะแสดงว่าพาสหรือ developer product ทำรายได้ให้คุณเท่าไรหลังหักส่วนแบ่งของ Roblox
บันทึกการซื้อของผู้เล่น
ทุกอย่างที่เราทำอยู่ได้แค่เซสชันเดียว: เหรียญและไอเทมที่ซื้อจะรีเซ็ตเมื่อผู้เล่นออก จนกว่าคุณจะบันทึกผ่านที่เก็บข้อมูล เพื่อไม่ต้องเขียนโค้ดบันทึกซ้ำที่นี่ ให้ทำตามบทเรียน DataStore (หรือขั้นตอนที่ 3 ของคู่มือลีดเดอร์บอร์ด ซึ่งเป็นเวอร์ชันสั้นกว่า) และจำกฎของร้านค้าไว้:
- บันทึก id ของไอเทม เช่น
{ "sword", "flashlight" }ในตารางเดียวกับค่า Coins เพื่อให้การบันทึกครั้งเดียวเขียนทั้งเหรียญที่ใช้และไอเทมที่ซื้อ Tool และอินสแตนซ์อื่นใส่ในที่เก็บข้อมูลไม่ได้ - เมื่อโหลดข้อมูลแล้ว ให้ไล่ id ที่บันทึกไว้ ข้ามตัวที่ไม่มีในแค็ตตาล็อกแล้ว ตั้งแอตทริบิวต์
Owns_แต่ละตัว และให้ Tool แบบเดียวกับที่giveToolทำ หน้าต่างร้านจะอัปเดตเอง เพราะมันฟังแอตทริบิวต์เหล่านี้ - ไม่ต้องบันทึกความเป็นเจ้าของพาส:
UserOwnsGamePassAsyncถาม Roblox ทุกครั้งที่ผู้เล่นเข้าเกม - อย่าบันทึกผู้เล่นที่ข้อมูลโหลดไม่สำเร็จเด็ดขาด ไม่อย่างนั้นการโหลดที่ล้มเหลวอาจแทนการซื้อของเขาด้วยรายการว่าง
ข้อผิดพลาดที่พบบ่อยและวิธีแก้
เมื่อร้านค้าทำงานแปลก ๆ ให้ตรวจข้อเหล่านี้ก่อน อย่างแรกเปิดหน้าต่าง Output (เมนู Window แล้ว Output): ข้อผิดพลาดของสคริปต์จะบอกชื่อสคริปต์และบรรทัด
Infinite yield possible on 'ReplicatedStorage:WaitForChild("ShopRemotes")'
สคริปต์รออ็อบเจกต์ที่ไม่มีชื่อนี้ตรงตัว ตรวจการสะกดและตัวพิมพ์ใหญ่ใน ShopRemotes, BuyItem, ShopCatalog และ ShopItems และตรวจว่า ShopItems อยู่ใน ServerStorage ไม่ใช่ ReplicatedStorage คู่มือข้อผิดพลาดของสคริปต์อธิบายคำเตือนนี้อย่างละเอียด
ปุ่ม Buy ค้างที่ "Buying..." และไม่ตอบ
ไม่มีใครตั้ง BuyItem.OnServerInvoke บนเซิร์ฟเวอร์ Roblox จึงถือคำขอไว้จนกว่าจะมี ตรวจว่า ShopService เป็น Script ไม่ใช่ LocalScript และอยู่ใน ServerScriptService และหาคำเตือน Infinite yield possible จาก ShopService ใน Output: มันหมายความว่าสคริปต์ติดรอ ShopCatalog, ShopRemotes หรือ ShopItems
ปุ่ม Buy เขียนว่า "The shop did not answer"
การเรียกเซิร์ฟเวอร์ล้มเหลว ไม่ได้คืนคำตอบ สาเหตุปกติคือข้อผิดพลาดใน ShopService ขณะจัดการคำขอ ให้หาข้อผิดพลาดสีแดงจาก ShopService ใน Output: ในนั้นระบุบรรทัด
ปุ่มเขียนว่า "This item is not available right now"
เซิร์ฟเวอร์หา Tool ที่มี toolName ของไอเทมนี้ใน ServerStorage, ShopItems ไม่เจอ ใน Output มีคำเตือนพร้อมชื่อตรงตัวที่มันค้นหา
ฉันซื้อเครื่องมือแล้ว แต่ตัวละครถือไม่ได้หรือติดอยู่
Tool ต้องมีพาร์ตชื่อ Handle หนึ่งชิ้นพอดีอยู่ข้างในโดยตรง และต้องไม่มีพาร์ตไหนถูก Anchor สำหรับเครื่องมือที่ไม่ต้องถือในมือ ให้เอาเครื่องหมายถูกที่ RequiresHandle ออกแทน
เหรียญลดลงบนหน้าจอของฉัน แต่ไม่ลดสำหรับคนอื่น
การซื้อเกิดใน LocalScript จึงเปลี่ยนแค่อุปกรณ์ของคุณ ย้ายการหักเหรียญและการให้ Tool ไปไว้ใน Script ฝั่งเซิร์ฟเวอร์ เหมือนในขั้นตอนที่ 4
ไอเทมที่ซื้อหายไปหลังเข้าเกมใหม่
ตอนนี้ยังไม่มีอะไรถูกบันทึก ดูการบันทึกการซื้อ
ทำด้วย RoCode
ถ้าไม่อยากประกอบทั้งหมดนี้เอง RoCode ทำให้ใน place ที่คุณเปิดอยู่ได้ มันคือเอเจนต์ AI อิสระสำหรับเขียนโค้ด: คุณอธิบายฟีเจอร์ในเว็บแชตของมัน แล้วปลั๊กอินสำหรับ Roblox Studio จะสร้างสคริปต์ remote และ GUI ใน Explorer ของคุณ จึงไม่ต้องก๊อปโค้ดจากหน้าต่างแชต
เพิ่มร้านค้าที่ใช้เหรียญ: ปุ่ม Shop ที่เปิดตารางเครื่องมือสี่ชิ้นพร้อมราคาเป็น Coins จาก leaderstats ของฉัน เซิร์ฟเวอร์ต้องตรวจราคาและให้เครื่องมือใน Backpack และ StarterGear
- สำรวจ place ของคุณด้วย Search Scripts และ Read Script เพื่อหา leaderstats และโค้ดร้านค้าที่มีอยู่แล้วได้ เพื่อใช้ค่า Coins ของคุณ แทนที่จะเพิ่มอีกตัว
- สร้างโครงหน้าต่างด้วย Build UI ได้: เลย์เอาต์ร้านค้ามาพร้อมการ์ดตัวอย่างและ LocalScript สำหรับเอฟเฟกต์ตอนเอาเมาส์ชี้และปุ่ม Close ตรรกะการซื้อเขียนแยกเป็นสคริปต์อื่น
- สร้าง RemoteFunction ด้วย Create Instance และเขียน ModuleScript ของแค็ตตาล็อก Script ฝั่งเซิร์ฟเวอร์ และ LocalScript ด้วย Create Script
- ตรวจการคอมไพล์ของทุกสคริปต์ใน Studio ด้วย Check Script (ไม่ตรวจชนิดข้อมูลและไม่รันสคริปต์) และทุกชุดการเปลี่ยนแปลงเป็นจุดย้อนกลับใน Studio
คุณยังต้องสร้างพาสใน Creator Hub เอง เพราะ RoCode สร้างพาสและ developer products ไม่ได้ และต้องทดสอบการซื้อเองด้วย: กับปลั๊กอิน 3.9 ขึ้นไป RoCode รันเพลย์เทสต์สั้น ๆ และอ่านข้อผิดพลาดได้ และกับปลั๊กอิน 3.9.15 ขึ้นไป ตัวละครทดสอบของมันกดปุ่ม Shop และ Buy ได้ แต่มันตรวจเฉพาะสิ่งที่เลือกทดสอบเอง ร้านค้ามักมาหลังเกมเพลย์หลักและการบันทึก วงจรการสร้างเกมทีละขั้นกับ RoCodeแสดงว่ามันอยู่ตรงไหน RoCode เชื่อมกับ Studio อย่างไร
คำถามที่พบบ่อย
สำหรับปุ่ม Buy ใน Roblox อะไรดีกว่า: RemoteEvent หรือ RemoteFunction?
ใช้ได้ทั้งสองแบบ ถ้าเซิร์ฟเวอร์เป็นคนตรวจ RemoteFunction ทำให้ปุ่มรอคำตอบจากเซิร์ฟเวอร์และแสดงได้ คู่มือนี้จึงใช้มัน และตัวอย่างร้านค้าในคู่มือความปลอดภัยของ Roblox ก็ใช้ RemoteFunction เรียกมันจากไคลเอนต์เท่านั้น: เซิร์ฟเวอร์ที่เรียก InvokeClient อาจรอไปตลอดถ้าไคลเอนต์ไม่ตอบ คู่มือ RemoteEventเปรียบเทียบทั้งสองแบบ
จะเปิดร้านผ่าน NPC แทนปุ่มได้อย่างไร?
ใส่ ProximityPrompt ในพาร์ตสักชิ้นของ NPC เช่น HumanoidRootPart ฟังอีเวนต์ Triggered ของมันใน Script ฝั่งเซิร์ฟเวอร์ แล้วส่ง RemoteEvent ไปให้ผู้เล่นคนนั้น เพื่อให้ LocalScript แสดงแผง ถ้าซื้อได้เฉพาะตอนอยู่ใกล้ NPC ให้ตรวจระยะห่างจาก NPC ในตัวจัดการ BuyItem ด้วย เพราะไคลเอนต์เรียก remote ได้จากที่ไหนก็ได้
จะขายไอเทมที่ซื้อได้หลายครั้งได้อย่างไร?
สำหรับไอเทมแบบนั้น ให้ข้ามการตรวจ "มีอยู่แล้ว" และให้สิ่งที่นับได้แทน Tool เช่นบวก 1 ให้ IntValue ที่นับยา การหาราคาและการตรวจเหรียญคงไว้เหมือนเดิม
ทำไมร้านหายไปเมื่อตัวละครเกิดใหม่?
ResetOnSpawn ของ ScreenGui เป็น true ซึ่งเป็นค่าเริ่มต้น Roblox จึงลบมันตอนเกิดใหม่ ตั้งเป็น false เหมือนที่สคริปต์ในขั้นตอนที่ 3 ทำ
ใช้เทมเพลต GUI ร้านค้าฟรีได้ไหม?
ได้ เลย์เอาต์ไหนก็ใช้ได้ ถ้าปุ่ม Buy ส่งแค่ id ของไอเทม และการซื้อจริงเกิดใน Script ฝั่งเซิร์ฟเวอร์อย่าง ShopService ก่อนใช้เทมเพลต ให้ตรวจว่ามันไม่ได้หักเหรียญหรือให้ไอเทมใน LocalScript
แหล่งข้อมูลและบทความแนะนำ
- Roblox Creator Docs: Securing the client-server boundary (ภาษาอังกฤษ). การตรวจอาร์กิวเมนต์ของ remote, NaN, การจำกัดความถี่ และตัวอย่างร้านค้าในเกม
- Roblox Creator Docs: Remote events and callbacks (ภาษาอังกฤษ). RemoteFunction, InvokeServer, OnServerInvoke และความเสี่ยงของ InvokeClient
- Roblox Creator Docs: Passes (ภาษาอังกฤษ). การสร้างและขายพาส, UserOwnsGamePassAsync และ PromptGamePassPurchaseFinished
- Roblox Creator Docs: Shop (ภาษาอังกฤษ). Shop ในเกมที่ Roblox สร้างให้อัตโนมัติ
- Roblox Creator Docs: Developer Products (ภาษาอังกฤษ). การซื้อซ้ำด้วย Robux และ ProcessReceipt
- Roblox Creator Docs: StarterGear (ภาษาอังกฤษ). ทำไม Tool ใน StarterGear กลับมาหลังเกิดใหม่
- Roblox Creator Docs: In-game tools (ภาษาอังกฤษ). Handle, การ Anchor และ RequiresHandle
วิธีตรวจโค้ด: ทุกสคริปต์ในหน้านี้ผ่านตัวตรวจชนิดข้อมูลแบบ strict ของ Luau พร้อมคำจำกัดความของ Roblox API (luau-lsp, 20 พฤศจิกายน 2569) การตรวจชนิดข้อมูลจับได้เฉพาะชื่อ API ที่พิมพ์ผิดและชนิดข้อมูลที่ไม่ถูกต้อง ไม่ได้ตรวจตรรกะของเกม ดังนั้นควรทดสอบใน Studio ก่อนเผยแพร่