شرح · أنظمة اللعبة

كيف تصنع متجرًا في Roblox Studio

المتجر في لعبة Roblox مهمتان: واجهة GUI تعرض العناصر، وسكربت على الخادم يقرر هل يتم الشراء. في هذا الدليل نبني الاثنين لمتجر بالعملات يبيع الأدوات، ونوضح أين مكان المشتريات بالـ Robux.

آخر تحديث ٢٠ نوفمبر ٢٠٢٦القراءة في 11 دبقلم

باختصار

احفظ العناصر والأسعار في ModuleScript داخل ReplicatedStorage، وابنِ النافذة من ScreenGui وScrollingFrame وUIGridLayout، واجعل كل زر Buy يستدعي RemoteFunction ويرسل الـ id الخاص بالعنصر فقط. بعد ذلك يجد Script في ServerScriptService السعر بنفسه، ويتحقق من Coins اللاعب ويخصمها، ويعطيه العنصر.

  • لا تسمح للعميل أبدًا بإرسال السعر. أي شخص يستطيع استدعاء الـ remotes عندك بأي قيم، لذا يأخذ الخادم السعر من نسخته من الكتالوج.
  • أعطِ الـ Tool المشترى باستنساخه من ServerStorage إلى Backpack اللاعب (ليستخدمه فورًا) وإلى StarterGear (ليعود بعد الـ respawn).
  • ما يُباع بالـ Robux هو الـ passes والـ developer products، ويتعامل معها MarketplaceService. ولها ينشئ Roblox أيضًا Shop بنفسه، وهذا ليس هو متجر العملات نفسه.
في هذه الصفحة
  1. كيف يعمل
  2. 1. التحضير
  3. 2. كتالوج العناصر
  4. 3. واجهة المتجر
  5. 4. الشراء على الخادم
  6. لماذا لا سعر من العميل
  7. 5. الاختبار
  8. Game Pass
  9. حفظ المشتريات
  10. Common errors
  11. مع RoCode
  12. الأسئلة الشائعة
  13. المصادر والقراءات

كيف يُبنى متجر يعمل فعلًا

رسم توضيحييفتح اللاعب المتجر ويشتري Flashlight مقابل 25 عملة: تنخفض Coins من 200 إلى 175، ويتحول الزر إلى Owned، وتظهر الأداة في شريط الأدوات.

المتجر الذي يعمل في لعبة حقيقية مقسوم بين جهاز اللاعب والخادم. الجهاز يرسم النافذة ويقول "أريد شراء سيف". والخادم، الطرف الوحيد الذي يمكن الوثوق به، يقرر هل يحدث ذلك. وسكربتات المتاجر التي "لا تعمل" أو التي يكسرها اللاعبون بالغش كثيرًا ما تتخذ هذا القرار في الجانب الخطأ.

أجزاء المتجر الخمسة
الجزءأين يوجدماذا يفعل
ModuleScript ShopCatalogReplicatedStorageمعرّفات العناصر وأسماؤها وأسعارها والـ Tool الذي يعطيه كل منها. يقرؤه الطرفان.
RemoteFunction BuyItemReplicatedStorage، في المجلد ShopRemotesينقل طلب الشراء إلى الخادم والرد عائدًا.
LocalScript ShopClientStarterPlayerScriptsيبني نافذة المتجر ويرسل الـ id الخاص بالعنصر عند الضغط على زر Buy.
Script ShopServiceServerScriptServiceيتحقق من الطلب، ويخصم Coins، ويعطي الـ Tool.
الـ Tools التي تبيعهاServerStorage، في المجلد ShopItemsالأصول التي ينسخها الخادم. لا شيء من ServerStorage يُرسل إلى اللاعبين.
Explorer عندما يكتمل المتجر
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 عملة في البداية حتى تختبر المشتريات فورًا.

Script في ServerScriptService باسم Leaderstats
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 يعطيان كل لاعب مجلدين، وقد يقرأ المتجر المجلد الخطأ.

بعد ذلك أنشئ الكائنات التي تبحث عنها السكربتات. حالة الأحرف في الأسماء مهمة، لذا اكتبها كما هي هنا بالضبط.

  1. في Explorer مرّر المؤشر فوق ReplicatedStorage، واضغط زر + وأدرج Folder باسم ShopRemotes. وداخله أدرج RemoteFunction باسم BuyItem.
  2. مرّر المؤشر فوق ServerStorage وأدرج Folder باسم ShopItems.
  3. ضع في ShopItems أداة Tool لكل عنصر، بالأسماء ClassicSword وFlashlight وGrappleHook وSpeedCoil. للاختبار الأول يكفي في الـ Tool جزء Part واحد غير مثبّت (غير Anchored) باسم Handle. ويصلح أيضًا أي Tool لديك بالفعل: أعطه الاسم المطلوب. والسلاح الذي يُحدث ضررًا فعلًا ابنه وفق دليل السيف أو دليل المسدس؛ وفي كل منهما شرح لربطه بالكتالوج.
  4. حدد كل Tool وألغِ تحديد CanBeDropped في نافذة Properties. عندما يكون مفعّلًا، يُسقط الضغط على Backspace الأداة في Workspace، ويستطيع أي لاعب التقاط ما دفع المشتري ثمنه.

يمكنك البدء بـ Tool واحد فقط. إذا نقص الـ Tool الخاص بعنصر ما، يرفض الخادم بيع هذا العنصر ويكتب تحذيرًا باسمه، فلا يُخصم من اللاعب شيء.

الخطوة 2: العناصر والأسعار في الكتالوج

الكتالوج هو القائمة الوحيدة لكل ما يبيعه المتجر. يقرؤه الـ LocalScript ليرسم البطاقات، ويقرؤه الخادم ليجد الأسعار، لذا فتغيير السعر تعديل واحد في مكان واحد.

مرّر المؤشر فوق ReplicatedStorage، وأدرج ModuleScript، وأعد تسميته إلى ShopCatalog واستبدل محتواه بهذا:

ModuleScript في ReplicatedStorage باسم 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. والجدول بعده يسرد كل كائن إذا أردت ترتيب النافذة يدويًا.

  1. في Explorer وسّع StarterPlayer، ومرّر المؤشر فوق StarterPlayerScripts وأدرج LocalScript باسم ShopClient.
  2. استبدل محتواه بالكود أدناه.
LocalScript في StarterPlayerScripts باسم 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 والصق فيه هذا:

Script في ServerScriptService باسم 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كل العناصر مجانيةيتجاهله. السعر يؤخذ من الكتالوج.
السعر -1000Coins.Value -= -1000 يعطيه 1,000 عملةيتجاهله.
NaN بدل السعركل مقارنة مع NaN خاطئة، فلا يعمل أبدًا فحص "العملات لا تكفي"يتجاهله.
id غير موجود في الكتالوج، أو جدول بدل النصأخطاء في السكربت أو عناصر لم تكن تنوي بيعهايرد بـ "That item does not exist."
مئات الطلبات في الثانيةضغط على الخادم، وأي ثغرة في الفحوص تعمل مئات المراتلا يعالج أكثر من طلب واحد من اللاعب كل نصف ثانية.
Coins معدّلة على شاشتهمشتريات بعملات لا يملكهالا يرى ذلك أصلًا. الخادم يقرأ قيمة Coins الخاصة به فقط.

هذه القاعدة تصلح لكل remote تكتبه: أرسل ما اختاره اللاعب، مثل الـ id الخاص بالعنصر أو رقم الخانة، ولا ترسل أبدًا كم يكلّف أو ماذا يجب أن يحصل عليه. ودليل RemoteEvent يشرح بالتفصيل التحقق من معاملات الـ remote.

الخطوة 5: نختبر المتجر

  1. اضغط Play. سيظهر زر Shop على اليسار. افتحه واشترِ Flashlight: ستنقص Coins بمقدار 25، وتظهر الأداة في شريط الأدوات، ويتحول زرها إلى Owned.
  2. جرّب Speed Coil الذي يكلّف 300. سيكتب سطر الحالة كم عملة ما زالت تنقصك، ولن يُخصم شيء.
  3. أعد تعيين الشخصية من القائمة داخل اللعبة. سيعود Flashlight إلى Backpack الجديد بفضل النسخة في StarterGear.
  4. لتضيف لنفسك عملات أثناء الاختبار، اضغط مفتاح التبديل 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.

ما يفعله RoCode
  • يمكنه تصفح مكانك عبر 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.

المصادر والقراءات

كيف فُحص الكود: كل سكربت في هذه الصفحة يجتاز الفاحص الصارم للأنواع في Luau مع تعريفات واجهة Roblox البرمجية (luau-lsp، ٢٠ نوفمبر ٢٠٢٦). فحص الأنواع يكشف الأخطاء في أسماء الواجهات البرمجية والأنواع الخاطئة، لا منطق اللعبة، فجرّب الكود في Studio قبل النشر.

جرّب RoCode على لعبتك أنت.

رصيد مجاني كل يوم ودون بطاقة. ثبّت الإضافة، وصف الميزة، وراجع ما يظهر في Studio.