要点
アイテムと価格は ReplicatedStorage の ModuleScript に置き、ウィンドウは ScreenGui、ScrollingFrame、UIGridLayout で作ります。各 Buy ボタンは RemoteFunction を呼び出して、アイテムの id だけを渡します。あとは ServerScriptService の Script が自分で価格を調べ、プレイヤーの Coins を確認して差し引き、アイテムを渡します。
- クライアントに価格を送らせてはいけません。誰でも好きな値でリモートを呼び出せるので、サーバーは自分が持っているカタログのコピーから価格を取ります。
- 購入した Tool は ServerStorage から複製し、プレイヤーの Backpack(すぐ使えるように)と StarterGear(リスポーン後に戻るように)に入れます。
- Robux で売るものはパスと developer product で、MarketplaceService で扱います。これらについては Roblox が自動で Shop も作りますが、それはコインのショップとは別物です。
このページの内容
動くショップの仕組み
実際のゲームで動くショップは、プレイヤーのデバイスとサーバーに分かれています。デバイスはウィンドウを描いて「剣を買いたい」と伝えます。信頼できる唯一の側であるサーバーが、それを実行するかどうかを決めます。「動かない」ショップのスクリプトや、チートで壊されるショップのスクリプトは、この判断を間違った側でしていることがよくあります。
| 部品 | 場所 | 役割 |
|---|---|---|
ModuleScript ShopCatalog | ReplicatedStorage | アイテムの id、名前、価格、それぞれが渡す Tool。両方の側がこれを読みます。 |
RemoteFunction BuyItem | ReplicatedStorage の ShopRemotes フォルダ | 購入のリクエストをサーバーに運び、答えを持ち帰ります。 |
LocalScript ShopClient | StarterPlayerScripts | ショップのウィンドウを作り、Buy ボタンが押されたらアイテムの id を送ります。 |
Script ShopService | ServerScriptService | リクエストを確認し、Coins を差し引いて Tool を渡します。 |
| 売る Tool | 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: コインと売るアイテム
ショップは、プレイヤーの leaderstats にある Coins の値を使います。リーダーボードのガイドを済ませているならすでにあるので、このスクリプトは飛ばしてかまいません。まだなら、ServerScriptService に Leaderstats という名前の Script を入れてください。最初に全員に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 のスクリプトは1つだけにしてください。leaderstats フォルダを作るスクリプトが2つあると、プレイヤーごとにフォルダが2つでき、ショップが違うほうを読むことがあります。
次に、スクリプトが探すオブジェクトを作ります。名前は大文字と小文字が区別されるので、ここにあるとおりに書いてください。
- Explorer で ReplicatedStorage にカーソルを合わせ、+ ボタンを押して
ShopRemotesという名前の Folder を入れます。その中にBuyItemという名前の RemoteFunction を入れます。 - ServerStorage にカーソルを合わせ、
ShopItemsという名前の Folder を入れます。 - ShopItems に、アイテムごとに1つずつ Tool を入れ、名前を
ClassicSword、Flashlight、GrappleHook、SpeedCoilにします。最初のテストなら、Tool の中はHandleという名前の Anchored でない Part が1つあれば十分です。手持ちの Tool に正しい名前を付けて使ってもかまいません。実際にダメージを与える武器は、剣のガイドや銃のガイドで作れます。どちらにもカタログとのつなぎ方が書いてあります。 - 各 Tool を選択し、Properties ウィンドウで CanBeDropped のチェックを外します。チェックが入っていると Backspace でツールが Workspace に落ち、買った人がお金を払ったものを誰でも拾えてしまいます。
Tool は1つから始めてもかまいません。アイテムの Tool が見つからない場合、サーバーはそのアイテムを売らずに、その名前を含む警告を出すので、プレイヤーのコインは何も減りません。
ステップ2: カタログのアイテムと価格
カタログは、ショップが売るものすべてを載せた唯一のリストです。LocalScript はカードを描くためにこれを読み、サーバーは価格を調べるためにこれを読むので、価格の変更は1か所を1回直すだけで済みます。
ReplicatedStorage にカーソルを合わせて ModuleScript を入れ、名前を ShopCatalog に変えて、中身を次のコードに置き換えます。
export type ShopItem = {
id: string, -- あとで data store に保存される。プレイヤーが持っているアイテムの id は変えないこと
name: string, -- カードに表示される。変えてもよい
price: number, -- Coins 単位
description: string,
toolName: string, -- プレイヤーが受け取る ServerStorage.ShopItems の Tool
}
-- カードはこの順番で並ぶ
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
-- プレイヤーがアイテムを持っているときにサーバーが true にする Player の属性
function ShopCatalog.ownedAttribute(id: string): string
return "Owns_" .. id
end
return ShopCatalog
アイテムには id と、それとは別に表示用の name があります。プレイヤーが何かを持っていることをサーバーが記録するときは id を使うので、あとで「Classic Sword」の名前を変えても保存済みの購入は壊れません。説明文はカードの文字にすぎず、Tool が何をするかは Tool 自身のスクリプトが決めます。
ReplicatedStorage の ModuleScript はプレイヤーにも読めるので、これらの価格は公開されています。それで問題ありません。どうせカードに書いてあるからです。大事なのは、クライアントとサーバーがそれぞれ自分のモジュールのコピーを実行していることです。プレイヤーが自分のデバイスで価格を書き換えても、サーバー側は何も変わりません。
ステップ3: ショップの GUI を作る
この LocalScript は、ウィンドウ全体をコードで作ります。Shop ボタン、カードがスクロールするグリッドのパネル、カタログのアイテムごとの Buy ボタン、Coins の表示、サーバーの返事を出すステータス行です。すべてコードで作るので、貼り付けて Play を押すだけで動きます。手でウィンドウを配置したい場合は、コードのあとの表にすべてのオブジェクトをまとめています。
- Explorer で StarterPlayer を開き、StarterPlayerScripts にカーソルを合わせて、
ShopClientという名前の LocalScript を入れます。 - 中身を下のコードに置き換えます。
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() -- 0 から始まり、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()
ボタンには MouseButton1Click ではなく Activated を使っています。マウスのクリック、スマートフォンのタップ、ゲームパッドの A ボタンや ✕ ボタンのどれでも反応します。
先頭の type 定義は ShopCatalog が返すものを表していて、item.prise のようなフィールド名の打ち間違いを strict の型チェックで見つけられます。ゲームの実行中には何も変えません。
| オブジェクト | ショップでの役割 | 主なプロパティ |
|---|---|---|
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 に作ります。そちらでも ScreenGui の ResetOnSpawn を false にし、カードを1枚だけテンプレートとして残して、LocalScript がカタログのアイテムごとにそれを複製するようにします。そうすればスクリプトはカードに中身を入れてボタンをつなぐだけになります。次のステップの購入のロジックは変わりません。
ゲームがメインメニューから始まる場合、そのガイドに ShopClient に足す1行が載っていて、プレイヤーが Play を押したあとにだけ Shop ボタンが出るようにできます。店員と話してショップが開くようにしたいなら、NPC の会話のガイドで、ShopClient にウィンドウを開かせる OpenShop アクションの足し方を紹介しています。購入はそれでも、ショップのサーバー側のチェックを通ります。
ステップ4: サーバーでの確認と購入
購入が起こりうる場所は、この Script だけです。アイテムの id を受け取って確認し、価格を調べ、プレイヤーの Coins を確認してから、コインを差し引いて Tool を渡します。Buy ボタンには true か false と、表示用のメッセージを返します。
ServerScriptService にカーソルを合わせて ShopService という名前の Script を入れ、次のコードを貼り付けます。
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. コインを差し引いてからアイテムを渡す。ここでは処理を譲る箇所がないので、同じプレイヤーからの
-- 2つのリクエストが、これが終わる前に両方とも上のチェックを通ることはない。
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)
持っているかどうかは、Owns_sword のような Player の属性として記録します。サーバーが設定した属性はプレイヤーのデバイスに複製されるので、LocalScript はカードを「Owned」に切り替えられます。プレイヤーが自分のコピーで変更しても、サーバーには届きません。
Tool は2か所に入ります。Backpack のコピーはすぐホットバーに出ます。StarterGear のコピーは、キャラクターが出現するたびに Roblox が新しい Backpack に入れます。これがないと、買ったアイテムはプレイヤーが最初に倒れた時点でなくなります。
クライアントに価格を送らせない理由
プレイヤーのデバイスにあるものは、すべてそのプレイヤーが書き換えられます。チーターは自分のゲームのコピーで自分のコードを動かし、LocalScript を読み、GUI を変え、好きな引数で BuyItem:InvokeServer() を何度でも呼び出せます。Roblox のセキュリティのガイドは、リモートが受け取るものはすべて型と値の両方を確認するように言っていて、その例がまさにショップです。
| チーターが送るもの | サーバーがそれを信じた場合 | ShopService の対応 |
|---|---|---|
| 価格 0 | すべてのアイテムが無料になる | 無視します。価格はカタログから取ります。 |
| 価格 -1000 | Coins.Value -= -1000 で1,000コインが手に入る | 無視します。 |
価格の代わりに NaN | NaN との比較はすべて偽になるので、「コインが足りない」のチェックが一度も働かない | 無視します。 |
| カタログにない id、または文字列の代わりのテーブル | スクリプトのエラーや、売るつもりのなかったアイテム | 「That item does not exist.」と返します。 |
| 1秒に数百回のリクエスト | サーバーに負荷がかかり、チェックに穴があればそれが数百回働く | プレイヤーごとに0.5秒に1回までしか処理しません。 |
| 自分の画面で書き換えた Coins | 持っていないコインでの購入 | まったく見ません。サーバーは自分の Coins の値だけを読みます。 |
このルールは、あなたが書くすべてのリモートに当てはまります。アイテムの id やスロット番号のように、プレイヤーが選んだものを送り、それがいくらか、何を受け取るべきかは決して送らないでください。リモートの引数の確認については、RemoteEvent のガイドで詳しく説明しています。
ステップ5: ショップをテストする
- Play を押します。左側に Shop ボタンが出ます。開いて Flashlight を買うと、Coins が25減り、ツールがホットバーに現れ、そのボタンが Owned に変わります。
- 300コインの Speed Coil を試します。ステータス行にあと何コイン足りないかが表示され、何も差し引かれません。
- ゲーム内メニューからキャラクターをリセットします。StarterGear のコピーのおかげで、Flashlight は新しい Backpack に戻ります。
- テスト中に自分のコインを増やすには、Client/Server の切り替えボタンを押して Server にし、Explorer で
Players、自分の名前、leaderstats、Coinsを探して、Properties ウィンドウで Value を変えます。Client モードで同じことをすると自分の画面だけが変わり、それこそサーバーが無視する種類の変更です。
ボタンに「The shop did not answer」と出たら、Studio の Window メニューから Output ウィンドウを開き、ShopService の赤いエラーを探してください。ボタンが「Buying...」のまま止まる場合は、ShopService が動いていないか、オブジェクトを待ったまま止まっています。よくあるエラーを見てください。
ゲームパスを Robux で売る
コインは自分のゲーム独自の通貨なので、上のショップは購入をすべて自分で判断します。プレイヤーが Robux で買うものは仕組みが違います。ゲームパスは1回買えばずっと残り(VIP 特典、永続のツール)、developer product は何度でも買えます(コインの束、レベルのスキップ)。どちらも Roblox の MarketplaceService を通り、支払いを受け取るのはあなたのスクリプトではなく Roblox です。
このガイドから引き継ぐルールは2つです。購入ウィンドウはクライアントのボタンで出し、特典は Roblox が購入を確認したとき、またはプレイヤーがすでにパスを持っているときに、サーバーだけで渡します。ゲームパスのスクリプトのガイドでは、参加時の所有チェック、購入ウィンドウ、VIP ドアのような特典、そしてパスより developer product が向いている場合まで、まとめて作ります。価格を決めるときは、無料の Robux 手数料計算機で、Roblox の取り分を引いたあとにパスや developer product でいくら入るかがわかります。
プレイヤーの購入を保存する
ここまで作ったものは1セッションしか続きません。data store で保存しない限り、プレイヤーが退出するとコインも買ったアイテムもリセットされます。保存のコードをここで繰り返さないように、DataStore のチュートリアル(またはリーダーボードのガイドのステップ3、こちらは短い版)を進めてください。そのうえで、ショップのルールを忘れないでください。
- アイテムの id(たとえば
{ "sword", "flashlight" })を Coins の値と同じテーブルに保存して、1回の保存で使ったコインと買ったアイテムの両方が書き込まれるようにします。Tool などのインスタンスは data store に入れられません。 - データが読み込まれたら、保存した id を順に見て、もうカタログにないものは飛ばし、それぞれの
Owns_属性を設定して、giveToolと同じ方法で Tool を渡します。ショップのウィンドウはこれらの属性を監視しているので、自動で更新されます。 - パスの所有は保存する必要はありません。
UserOwnsGamePassAsyncが、プレイヤーが参加するたびに Roblox に問い合わせます。 - データが読み込めなかったプレイヤーは絶対に保存しないでください。読み込みに失敗したとき、購入が空のリストで上書きされてしまうことがあります。
よくあるエラーと対処法
ショップの動きがおかしいときは、まずこれを確認してください。最初に Output ウィンドウを開きます(Window メニュー、Output)。スクリプトのエラーには、スクリプト名と行番号が出ます。
Infinite yield possible on 'ReplicatedStorage:WaitForChild("ShopRemotes")'
スクリプトが、その名前ちょうどでは存在しないオブジェクトを待っています。ShopRemotes、BuyItem、ShopCatalog、ShopItems のつづりと大文字を確認し、ShopItems が ReplicatedStorage ではなく ServerStorage にあることを確かめてください。この警告についてはスクリプトのエラーのガイドで詳しく説明しています。
Buy ボタンが「Buying...」のまま反応しない
サーバーで BuyItem.OnServerInvoke を誰も設定していないので、Roblox は設定されるまでリクエストを保留しています。ShopService が LocalScript ではなく Script で、ServerScriptService にあることを確かめ、Output で ShopService からの Infinite yield possible の警告を探してください。この警告は、スクリプトが ShopCatalog、ShopRemotes、ShopItems のどれかを待ったまま止まっているという意味です。
Buy ボタンに「The shop did not answer」と出る
サーバーの呼び出しが答えを返さずに失敗しました。よくある原因は、リクエストを処理している最中の ShopService 内のエラーなので、Output で ShopService の赤いエラーを探してください。行番号が書いてあります。
ボタンに「This item is not available right now」と出る
サーバーが、そのアイテムの toolName の Tool を ServerStorage の ShopItems の中で見つけられませんでした。Output に、探していた名前ちょうどを含む警告が出ています。
ツールを買ったのに、キャラクターが持てない、または引っかかる
Tool のすぐ中に Handle という名前のパーツがちょうど1つあり、どのパーツも Anchored になっていない必要があります。手に持つ必要のないツールなら、代わりに RequiresHandle のチェックを外してください。
自分の画面ではコインが減ったのに、他の人には減っていない
購入が LocalScript で行われたので、変わったのは自分のデバイスだけです。ステップ4のように、コインの差し引きと Tool の受け渡しをサーバーの Script に移してください。
買ったアイテムが再参加すると消える
まだ何も保存していません。購入の保存を見てください。
RoCode で作る
これを全部手で作りたくない場合は、RoCode があなたの開いているプレイスで作れます。RoCode はコーディング用の独立した AI エージェントです。ウェブチャットで機能を説明すると、Roblox Studio のプラグインがスクリプト、リモート、GUI を Explorer に作るので、チャット画面からコードをコピーする必要はありません。
コインのショップを追加して。Shop ボタンを押すと、4つのツールがグリッドで並び、価格は leaderstats の Coins で表示される。サーバーで価格を確認して、ツールを Backpack と StarterGear に渡すようにして。
- Search Scripts と Read Script でプレイスを見て、既存の leaderstats やショップのコードを探し、2つ目を足すのではなく、あなたの Coins の値を使えます
- Build UI でウィンドウのひな形を作れます。ショップのレイアウトには仮のカードと、ホバー効果と Close ボタン用の LocalScript が付きます。購入のロジックは別のスクリプトとして書きます
- Create Instance で RemoteFunction を作り、Create Script でカタログの ModuleScript、サーバーの Script、LocalScript を書きます
- Check Script で各スクリプトが Studio でコンパイルできるかを確認し(型はチェックせず、スクリプトも実行しません)、変更のまとまりごとに Studio の取り消しポイントになります
パスは自分で Creator Hub で作る必要があります。RoCode はパスや developer product を作れないからです。購入のテストもあなたが行います。プラグイン 3.9 以降の RoCode は短いプレイテストを実行してエラーを読め、プラグイン 3.9.15 以降ではテスト用キャラクターが Shop ボタンや Buy ボタンを押せますが、確認するのは自分でテストすると決めた部分だけです。ショップはふつう、メインのゲームプレイと保存のあとに作ります。RoCode でゲームを作る手順で、どこに入るかを説明しています。RoCode が Studio につながる仕組み。
よくある質問
Roblox の Buy ボタンには RemoteEvent と RemoteFunction のどちらがいいですか?
サーバーが確認するなら、どちらでもかまいません。RemoteFunction ならボタンがサーバーの答えを待って表示できるので、このガイドではこちらを使っています。Roblox のセキュリティのガイドのショップの例も RemoteFunction です。呼び出すのはクライアントからだけにしてください。InvokeClient を呼ぶサーバーは、クライアントが答えないと永遠に待つことがあります。RemoteEvent のガイドで両方を比べています。
ボタンではなく NPC でショップを開くには?
NPC のどれかのパーツ(たとえば HumanoidRootPart)に ProximityPrompt を入れ、サーバーの Script でその Triggered イベントを受け取り、そのプレイヤーに RemoteEvent を送って LocalScript にパネルを出させます。NPC の近くでしか買えないようにするなら、BuyItem のハンドラーの中で NPC との距離も確認してください。クライアントはどこからでもリモートを呼べるからです。
何回も買えるアイテムを売るには?
そういうアイテムでは「もう持っている」のチェックを省き、Tool ではなく数えられるものを渡します。たとえば、ポーションの数を数える IntValue に1を足します。価格の検索とコインの確認はそのままにしておきます。
キャラクターがリスポーンするとショップが消えるのはなぜですか?
ScreenGui の ResetOnSpawn が true(初期値)になっているので、Roblox がリスポーン時に削除しています。ステップ3のスクリプトのように false にしてください。
無料のショップ GUI のテンプレートを使ってもいいですか?
はい。Buy ボタンがアイテムの id だけを送り、購入そのものは ShopService のようなサーバーの Script で行われるなら、どんなレイアウトでもかまいません。テンプレートを使う前に、LocalScript でコインを差し引いたりアイテムを渡したりしていないか確認してください。
参考資料
- Roblox Creator Docs: Securing the client-server boundary(英語). リモートの引数の確認、NaN、頻度の制限、ゲーム内ショップの例
- Roblox Creator Docs: Remote events and callbacks(英語). RemoteFunction、InvokeServer、OnServerInvoke、InvokeClient のリスク
- Roblox Creator Docs: Passes(英語). パスの作成と販売、UserOwnsGamePassAsync と PromptGamePassPurchaseFinished
- Roblox Creator Docs: Shop(英語). Roblox が自動で作るゲーム内の Shop
- Roblox Creator Docs: Developer Products(英語). 繰り返し買える Robux の購入と ProcessReceipt
- Roblox Creator Docs: StarterGear(英語). StarterGear の Tool がリスポーン後に戻る理由
- Roblox Creator Docs: In-game tools(英語). Handle、Anchored、RequiresHandle
コードの検証方法: このページのスクリプトはすべて、Roblox API の型定義(luau-lsp、2026年11月20日)を使った Luau の strict 型チェックを通っています。型チェックで見つかるのは API 名の誤りや型の不一致であり、ゲームロジックの誤りは見つかりません。公開する前に必ず Studio でテストしてください。