باختصار
احفظ العناصر والأسعار في ModuleScript داخل ReplicatedStorage، وابنِ النافذة من ScreenGui وScrollingFrame وUIGridLayout، واجعل كل زر Buy يستدعي RemoteFunction ويرسل الـ id الخاص بالعنصر فقط. بعد ذلك يجد Script في ServerScriptService السعر بنفسه، ويتحقق من Coins اللاعب ويخصمها، ويعطيه العنصر.
- لا تسمح للعميل أبدًا بإرسال السعر. أي شخص يستطيع استدعاء الـ remotes عندك بأي قيم، لذا يأخذ الخادم السعر من نسخته من الكتالوج.
- أعطِ الـ Tool المشترى باستنساخه من ServerStorage إلى Backpack اللاعب (ليستخدمه فورًا) وإلى StarterGear (ليعود بعد الـ respawn).
- ما يُباع بالـ Robux هو الـ passes والـ developer products، ويتعامل معها MarketplaceService. ولها ينشئ Roblox أيضًا Shop بنفسه، وهذا ليس هو متجر العملات نفسه.
في هذه الصفحة
كيف يُبنى متجر يعمل فعلًا
المتجر الذي يعمل في لعبة حقيقية مقسوم بين جهاز اللاعب والخادم. الجهاز يرسم النافذة ويقول "أريد شراء سيف". والخادم، الطرف الوحيد الذي يمكن الوثوق به، يقرر هل يحدث ذلك. وسكربتات المتاجر التي "لا تعمل" أو التي يكسرها اللاعبون بالغش كثيرًا ما تتخذ هذا القرار في الجانب الخطأ.
| الجزء | أين يوجد | ماذا يفعل |
|---|---|---|
ModuleScript ShopCatalog | ReplicatedStorage | معرّفات العناصر وأسماؤها وأسعارها والـ 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. - ضع في ShopItems أداة Tool لكل عنصر، بالأسماء
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: نبني واجهة المتجر
هذا الـ LocalScript يبني النافذة كلها بالكود: زر Shop، ولوحة فيها شبكة بطاقات قابلة للتمرير، وزر Buy لكل عنصر في الكتالوج، وعدّاد Coins، وسطر حالة لردود الخادم. وبما أن كل شيء مصنوع بالكود، يمكنك لصقه والضغط على Play. والجدول بعده يسرد كل كائن إذا أردت ترتيب النافذة يدويًا.
- في Explorer وسّع StarterPlayer، ومرّر المؤشر فوق StarterPlayerScripts وأدرج LocalScript باسم
ShopClient. - استبدل محتواه بالكود أدناه.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- ما تُرجعه وحدة ShopCatalog، حتى يفحص التحقق الصارم من الأنواع الحقول التي نستخدمها
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 -- يبقى المتجر عندما تعود الشخصية للظهور (respawn)
-- زر عند الحافة اليسرى يفتح المتجر ويغلقه
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 أو زر X (المتقاطع) على ذراع التحكم.
تعريفات type في الأعلى تصف ما يُرجعه ShopCatalog، حتى يلتقط التحقق الصارم من الأنواع خطأً إملائيًا في حقل، مثل item.prise. وعندما تعمل اللعبة لا تغيّر شيئًا.
| الكائن | مهمته في المتجر | الخصائص الرئيسية |
|---|---|---|
ScreenGui | يحمل كل ما يُرسم على الشاشة | ResetOnSpawn على false حتى يبقى المتجر بعد الـ respawn |
Frame | النافذة وكل بطاقة عنصر | AnchorPoint على 0.5, 0.5 وPosition على 0.5, 0.5 لتكون النافذة في المنتصف |
UISizeConstraint | يحدّ حجم النافذة على الشاشات الكبيرة | MaxSize بمقدار 640 في 460 |
ScrollingFrame | يتمرر عندما تكون البطاقات أكثر مما يتسع | CanvasSize على 0 وAutomaticCanvasSize على Y حتى تكبر منطقة التمرير مع البطاقات |
UIGridLayout | يضع البطاقات في صفوف وينقلها | CellSize بمقدار 180 في 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، حتى يفحص التحقق الصارم من الأنواع الحقول التي نستخدمها
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. نخصم العملات، ثم نعطي العنصر. لا شيء هنا يتوقف منتظرًا (yield)، لذا لا يمكن لطلبين
-- من اللاعب نفسه أن يجتازا كلاهما الفحوص أعلاه قبل أن ينتهي هذا.
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 عندك، وتغيير الواجهة، واستدعاء 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، وابحث في Explorer عن
Playersثم اسمك ثمleaderstatsثمCoinsوغيّر Value في نافذة Properties. والشيء نفسه في وضع Client يغيّر شاشتك فقط، وهذا بالضبط نوع التغيير الذي يتجاهله الخادم.
إذا ردّ الزر بـ "The shop did not answer"، فافتح نافذة Output من قائمة Window في Studio وابحث عن الخطأ الأحمر من ShopService. أما إذا علق الزر على "Buying..."، فإن ShopService لا يعمل أو عالق في انتظار كائن: راجع الأخطاء الشائعة.
بيع Game Pass بالـ Robux
العملات هي عملتك الخاصة، لذا يقرر المتجر أعلاه كل عملية شراء بنفسه. أما ما يشتريه اللاعب بالـ Robux فيعمل بطريقة مختلفة: الـ Game Pass يُشترى مرة واحدة ويبقى إلى الأبد (مزايا VIP، أداة دائمة)، والـ developer product يمكن شراؤه مرارًا (حزمة عملات، تخطي مستوى). وكلاهما يمر عبر MarketplaceService من Roblox، وRoblox هو من يستلم الدفع لا سكربتك.
من هذا الدليل تنتقل قاعدتان: شغّل نافذة الشراء بزر على العميل، وأعطِ الميزة على الخادم فقط، عندما يؤكد Roblox الشراء أو يكون الـ pass لدى اللاعب بالفعل. ودليل سكربت Game Pass يبني ذلك كاملًا: التحقق من الملكية عند الدخول، ونافذة الشراء، والمزايا مثل باب VIP، ومتى يكون الـ developer product أفضل من الـ pass. ولاختيار السعر، تُظهر حاسبة عمولة Robux المجانية كم يدرّ عليك الـ pass أو الـ developer product بعد حصة Roblox.
نحفظ مشتريات اللاعبين
كل ما صنعناه يعيش جلسة واحدة: العملات والعناصر المشتراة تُصفَّر عندما يخرج اللاعب، ما لم تحفظها عبر مخزن البيانات. ولكي لا نكرر كود الحفظ هنا، اتبع شرح DataStore (أو الخطوة 3 من دليل لوحة الصدارة، ففيها نسخة أقصر) وتذكّر قواعد المتجر:
- احفظ معرّفات العناصر، مثل
{ "sword", "flashlight" }، في الجدول نفسه الذي فيه قيمة Coins، حتى يكتب حفظ واحد العملات المنفقة والعنصر المشترى معًا. لا يمكن وضع الـ Tool ولا غيره من الـ instances في مخزن البيانات. - عندما تُحمَّل البيانات، مرّ على المعرّفات المحفوظة، وتخطَّ ما لم يعد موجودًا في الكتالوج، واضبط كل سمة
Owns_وأعطِ الـ Tool بالطريقة نفسها التي يتبعهاgiveTool. وستتحدث نافذة المتجر بنفسها، لأنها تستمع إلى هذه السمات. - لا حاجة لحفظ ملكية الـ pass: فـ
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، وابحث في Output عن تحذير Infinite yield possible من ShopService: فهو يعني أن السكربت عالق في انتظار ShopCatalog أو ShopRemotes أو ShopItems.
زر Buy يكتب "The shop did not answer"
استدعاء الخادم تعطّل بدلًا من أن يُرجع ردًا. السبب المعتاد خطأ داخل ShopService أثناء معالجة الطلب، لذا ابحث في Output عن الخطأ الأحمر من ShopService: فيه رقم السطر.
الزر يكتب "This item is not available right now"
لم يجد الخادم Tool بالاسم toolName لهذا العنصر داخل ServerStorage ثم ShopItems. وفي Output تحذير بالاسم الدقيق الذي بحث عنه.
اشتريت الأداة، لكن الشخصية لا تستطيع حملها أو تعلق
يجب أن يحتوي الـ Tool على جزء واحد بالضبط باسم Handle داخله مباشرة، وألا يكون أي من أجزائه مثبّتًا (Anchored). وللأداة التي لا تحتاج إلى أن تُحمل باليد، ألغِ بدلًا من ذلك تحديد RequiresHandle.
العملات نقصت على شاشتي، لكن ليس عند الآخرين
تم الشراء في LocalScript، لذا تغيّر جهازك فقط. انقل خصم العملات وإعطاء الـ Tool إلى Script على الخادم، كما في الخطوة 4.
العناصر المشتراة تختفي بعد إعادة الدخول
لا شيء يُحفظ حتى الآن. راجع حفظ المشتريات.
اصنعه مع RoCode
إذا لم ترغب في بناء كل هذا يدويًا، يستطيع RoCode فعله في المكان المفتوح عندك. إنه وكيل ذكاء اصطناعي مستقل للبرمجة: تصف الميزة في دردشة الويب، وتنشئ إضافته لـ Roblox Studio السكربتات والـ remote والواجهة في Explorer عندك، فلا حاجة لنسخ الكود من نافذة الدردشة.
أضف متجرًا بالعملات: زر Shop يفتح شبكة من أربع أدوات بأسعار بالـ Coins من leaderstats عندي. يجب أن يتحقق الخادم من السعر ويعطي الأداة في Backpack وStarterGear.
- يمكنه تصفح مكانك عبر Search Scripts وRead Script بحثًا عن leaderstats وكود متجر موجودين، ليستخدم قيمة Coins عندك بدلًا من إضافة قيمة ثانية
- يمكنه بناء هيكل النافذة عبر Build UI: يأتي تصميم المتجر ببطاقات مؤقتة وLocalScript لتأثيرات المرور بالمؤشر وزر Close؛ أما منطق الشراء فيُكتب في سكربتات منفصلة
- ينشئ الـ RemoteFunction عبر Create Instance، ويكتب ModuleScript الكتالوج والـ Script على الخادم والـ LocalScript عبر Create Script
- يفحص ترجمة كل سكربت في Studio عبر Check Script (لا يفحص الأنواع ولا يشغّل السكربتات)، وكل دفعة تغييرات نقطة تراجع في Studio
الـ passes عليك أن تنشئها بنفسك في Creator Hub، لأن RoCode لا يستطيع إنشاء الـ passes والـ 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 عند الـ respawn. اجعلها false، كما يفعل السكربت في الخطوة 3.
هل يمكنني استخدام قالب مجاني لواجهة المتجر؟
نعم، يصلح أي تصميم إذا كانت أزرار Buy فيه ترسل الـ id الخاص بالعنصر فقط، وكان الشراء نفسه يتم في Script على الخادم مثل ShopService. وقبل أن تأخذ قالبًا، تحقق من أنه لا يخصم العملات أو يعطي العناصر داخل LocalScript.
المصادر والقراءات
- Roblox Creator Docs: Securing the client-server boundary (بالإنجليزية). التحقق من معاملات الـ remotes، وNaN، وتحديد المعدّل، ومثال المتجر داخل اللعبة
- Roblox Creator Docs: Remote events and callbacks (بالإنجليزية). RemoteFunction وInvokeServer وOnServerInvoke ومخاطر InvokeClient
- Roblox Creator Docs: Passes (بالإنجليزية). إنشاء الـ passes وبيعها، وUserOwnsGamePassAsync وPromptGamePassPurchaseFinished
- Roblox Creator Docs: Shop (بالإنجليزية). الـ Shop داخل اللعبة الذي ينشئه Roblox تلقائيًا
- Roblox Creator Docs: Developer Products (بالإنجليزية). المشتريات المتكررة بالـ Robux وProcessReceipt
- Roblox Creator Docs: StarterGear (بالإنجليزية). لماذا يعود الـ Tool في StarterGear بعد الـ respawn
- Roblox Creator Docs: In-game tools (بالإنجليزية). Handle والتثبيت (Anchored) وRequiresHandle
كيف فُحص الكود: كل سكربت في هذه الصفحة يجتاز الفاحص الصارم للأنواع في Luau مع تعريفات واجهة Roblox البرمجية (luau-lsp، ٢٠ نوفمبر ٢٠٢٦). فحص الأنواع يكشف الأخطاء في أسماء الواجهات البرمجية والأنواع الخاطئة، لا منطق اللعبة، فجرّب الكود في Studio قبل النشر.