باختصار
RemoteEvent كائن يوضع عادةً في ReplicatedStorage وينقل الرسائل عبر الحد الفاصل بين العميل والخادم. يستدعي LocalScript الدالة FireServer، فيستلم الخادم الرسالة في OnServerEvent، حيث يُضاف Player الذي أرسلها كأول وسيط. ويستدعي الخادم FireClient(player, ...) أو FireAllClients(...)، فتستلم سكربتات LocalScript الرسالة في OnClientEvent.
- استخدم RemoteFunction (
InvokeServerوOnServerInvoke) فقط عندما يحتاج العميل إلى رد. وتجنّبInvokeClient: فالعميل الذي حدث عنده خطأ، أو خرج، أو لم يُعِد قيمة أبدًا، يُفسد الاستدعاء على الخادم. - لا تثق أبدًا بما يرسله العميل. افحص على الخادم نوع كل وسيط ونطاقه وملكيته، والمسافة إلى اللاعب، وكم مرة يستدعي الـ remote.
- الدوال والجداول الوصفية (metatables) والكائنات التي لا يراها الطرف الآخر لا تنجو من النقل. وقد يفقد UnreliableRemoteEvent الرسائل أو يغيّر ترتيبها، ويُسقط أي بيانات أكبر من 1000 بايت.
في هذه الصفحة
لماذا نحتاج إلى RemoteEvent
كل لعبة Roblox تعمل كخادم واحد مع عميل واحد لكل لاعب. الخادم هنا هو صاحب القرار: الكائن الجديد أو تغيير الخاصية لا يصل إلى كل اللاعبين إلا عندما يجريه الخادم. أما التغيير الذي يجريه LocalScript فيبقى على جهاز واحد، باستثناءات قليلة مثل شخصية اللاعب نفسه التي يتحكم عميله بحركتها. لذلك عندما يجب أن تغيّر نقرة أو ضغطة زر العالم المشترك، يجب على العميل أن يطلب ذلك من الخادم، وعندما يريد الخادم أن تتفاعل شاشة لاعب واحد، يجب أن يُبلغ العميل بذلك. إذا كان الفرق بين Script وLocalScript جديدًا عليك فاقرأ أولًا Script vs LocalScript vs ModuleScript (بالإنجليزية). وإذا كانت كتابة السكربتات نفسها جديدة عليك فابدأ بـ كيف تكتب السكربتات في Roblox Studio.
لعبور هذا الحد يعطيك Roblox ثلاثة كائنات:
- RemoteEvent: رسالة في اتجاه واحد. يتابع المرسل عمله فورًا.
- RemoteFunction: طلب ينتظر ردًّا. يتوقف الكود المستدعي حتى يُعيد الطرف الآخر قيمة.
- UnreliableRemoteEvent: رسالة في اتجاه واحد قد تضيع أو تصل بغير ترتيب، لكنها تُثقل الشبكة أقل. مناسبة للبيانات التي تتغير باستمرار.
| الاتجاه | المرسل يستدعي | المستقبل يتصل بـ | المستقبل يستلم |
|---|---|---|---|
| من العميل إلى الخادم | remote:FireServer(...) في LocalScript | remote.OnServerEvent في Script | Player الذي أرسل الرسالة، ثم وسائطك |
| من الخادم إلى عميل واحد | remote:FireClient(player, ...) في Script | remote.OnClientEvent في LocalScript | وسائطك فقط |
| من الخادم إلى كل العملاء | remote:FireAllClients(...) في Script | remote.OnClientEvent في LocalScript | وسائطك فقط |
| العميل يسأل والخادم يجيب | remoteFunction:InvokeServer(...) | remoteFunction.OnServerInvoke = function(player, ...) | Player، ثم وسائطك. ويستلم المستدعي ما أعادته الدالة |
لا يستطيع العملاء إرسال الرسائل بعضهم إلى بعض مباشرة. لتنقل شيئًا من لاعب إلى الباقين، أرسله إلى الخادم وافحصه هناك، ودع الخادم يمرّره عبر FireClient أو FireAllClients. وبحسب توصيات Roblox للأمان يعمل الخادم هنا حارسًا للبوابة، لا مجرد ناقل.
أين تحفظ الـ remotes
يجب أن يوضع الـ remote حيث يراه الخادم والعملاء معًا. المكان المعتاد هو ReplicatedStorage، ويذكر توثيق Roblox أن Workspace أو Tool يصلحان أيضًا في بعض الحالات. أما ServerStorage وServerScriptService فلا يصل إليهما إلا الخادم، لذلك فإن LocalScript الذي ينتظر remote من هناك سينتظر إلى الأبد.
- في Explorer مرّر المؤشر فوق ReplicatedStorage، واضغط زر + وأدرج Folder. سمِّ المجلد
Remotes. - مرّر المؤشر فوق
Remotes، واضغط + وأدرج RemoteEvent. أعد تسميته باسم يصف غرضه، مثلPaintRequest. - كرّر ذلك لكل remote. يستخدم هذا الدليل اثنين من RemoteEvent (
PaintRequestوNotify) وRemoteFunction واحدة (RedeemCode).
ReplicatedStorage
Remotes Folder new
PaintRequest RemoteEvent new
Notify RemoteEvent new
RedeemCode RemoteFunction new
ServerScriptService
PaintServer Script new
WelcomeServer Script new
FinishAnnouncer Script new
RedeemServer Script new
RemoteGuard ModuleScript new
StarterPlayer
StarterPlayerScripts
PaintClient LocalScript new
NotifyClient LocalScript new
StarterGui
CodeGui ScreenGui new
CodeBox TextBox new
RedeemClient LocalScript new
Workspace
Paintable Folder new
FinishLine Part new
تجد السكربتات في هذا الدليل الـ remotes عبر WaitForChild. فهو يُعيد النتيجة فورًا إذا كان الـ remote موجودًا، وينتظر إذا لم يكن موجودًا بعد، مثلًا عندما ينشئ سكربت على الخادم الـ remotes أثناء اللعب. خصّص remote منفصلًا لكل نوع من الطلبات: عندها يفحص كل معالج على الخادم شكلًا واحدًا من الوسائط، وفعل ذلك بشكل صحيح أسهل بكثير من remote واحد لكل الحالات.
النمط 1: من العميل إلى الخادم، مع فحص على الخادم
المهمة الأكثر شيوعًا: يفعل اللاعب شيئًا على شاشته، والخادم يقرر ما سيحدث. هنا يضغط اللاعب Q ليختار واحدًا من أربعة ألوان، وينقر أو يلمس قطعة ليلوّنها. يرى الجميع اللون الجديد لأن الخادم هو من يلوّن.
يرسل العميل شيئين: أي قطعة، ورقم اللون. أما اللون نفسه فلا يرسله أبدًا، وبالطريقة نفسها في الألعاب الأخرى يجب ألا يرسل السعر أو الجائزة أو مقدار الضرر. العميل المعدَّل يستطيع أن يرسل أي شيء، لذلك يحتفظ الخادم بالبيانات الحقيقية (وهي هنا لوحة الألوان)، ويتعامل مع الوسائط كطلب يجب فحصه.
- في Workspace أدرج Folder باسم
Paintableوضع فيه عدة قطع Part مثبتة (Anchored). - تأكد من وجود RemoteEvent باسم
PaintRequestفيReplicatedStorage.Remotes. - أدرج Script باسم
PaintServerفي ServerScriptService وLocalScript باسمPaintClientفي StarterPlayer، ثم StarterPlayerScripts، بالكود أدناه.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local remotes = ReplicatedStorage:WaitForChild("Remotes")
local paintRequest = remotes:WaitForChild("PaintRequest") :: RemoteEvent
local paintable = workspace:WaitForChild("Paintable")
-- الألوان ملك للخادم. العميل يرسل رقمًا فقط يختار واحدًا منها.
local PALETTE = {
Color3.fromRGB(231, 76, 60),
Color3.fromRGB(46, 204, 113),
Color3.fromRGB(52, 152, 219),
Color3.fromRGB(241, 196, 15),
}
local MAX_DISTANCE = 30 -- عدد الـ studs بين الشخصية والقطعة
local COOLDOWN_SECONDS = 0.25
local lastPaint: { [Player]: number } = {}
-- الوسيط الأول هو دائمًا اللاعب الذي استدعى الـ remote. يضعه Roblox بنفسه،
-- لذلك يمكن الوثوق به. كل ما بعده جاء من العميل، ولا يمكن الوثوق به.
paintRequest.OnServerEvent:Connect(function(player: Player, part: unknown, colourIndex: unknown)
-- 1. النوع: قطعة حقيقية، لا جدول يتظاهر بأنه قطعة
if typeof(part) ~= "Instance" or not part:IsA("BasePart") then
return
end
-- 2. النطاق: عدد صحيح من 1 إلى 4. وتُستبعد هنا أيضًا NaN واللانهاية.
if type(colourIndex) ~= "number" or not math.isfinite(colourIndex) then
return
end
if colourIndex % 1 ~= 0 or colourIndex < 1 or colourIndex > #PALETTE then
return
end
-- 3. هدف مسموح: القطع في مجلد Paintable فقط، ولا شيء آخر في اللعبة
if not part:IsDescendantOf(paintable) then
return
end
-- 4. المسافة: يجب أن تكون شخصية اللاعب قريبة من القطعة
local character = player.Character
local root = character and character:FindFirstChild("HumanoidRootPart")
if not (root and root:IsA("BasePart")) then
return
end
if (root.Position - part.Position).Magnitude > MAX_DISTANCE then
return
end
-- 5. حد التكرار: تلوين واحد لكل لاعب كل ربع ثانية
local now = os.clock()
local last = lastPaint[player]
if last and now - last < COOLDOWN_SECONDS then
return
end
lastPaint[player] = now
part.Color = PALETTE[colourIndex]
end)
Players.PlayerRemoving:Connect(function(player: Player)
lastPaint[player] = nil
end)
كل فحص لا ينجح ينفّذ return فقط. لا داعي لأن تشرح للعميل الغشاش لماذا رُفض طلبه.
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local UserInputService = game:GetService("UserInputService")
local remotes = ReplicatedStorage:WaitForChild("Remotes")
local paintRequest = remotes:WaitForChild("PaintRequest") :: RemoteEvent
local paintable = workspace:WaitForChild("Paintable")
local COLOUR_COUNT = 4 -- الألوان الحقيقية يحتفظ بها الخادم
local selectedColour = 1
-- لا يصيب الشعاع إلا القطع داخل مجلد Paintable
local rayParams = RaycastParams.new()
rayParams.FilterType = Enum.RaycastFilterType.Include
rayParams.FilterDescendantsInstances = { paintable }
UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
if gameProcessed then
return -- الزر أو النقرة ذهبا إلى الدردشة أو إلى زر في الواجهة
end
if input.KeyCode == Enum.KeyCode.Q then
selectedColour = selectedColour % COLOUR_COUNT + 1
return
end
local isClick = input.UserInputType == Enum.UserInputType.MouseButton1
local isTap = input.UserInputType == Enum.UserInputType.Touch
if isClick or isTap then
local camera = workspace.CurrentCamera
local ray = camera:ScreenPointToRay(input.Position.X, input.Position.Y)
local result = workspace:Raycast(ray.Origin, ray.Direction * 500, rayParams)
if result then
-- نطلب ولا نأمر: الخادم هو من يقرر هل يلوّن أم لا
paintRequest:FireServer(result.Instance, selectedColour)
end
end
end)
تكون gameProcessed قيمتها true عندما يكون المحرك قد عالج هذا الإدخال بالفعل، وغالبًا في الواجهة: نقرة على زر أو أحرف تُكتب في حقل نصي مثل سطر الدردشة. وبفضل هذا الفحص لا يغيّر حرف Q المكتوب في رسالة اللونَ.
النمط 2: من الخادم إلى عميل واحد
يرسل الخادم رسالة إلى لاعب واحد عبر FireClient. الوسيط الأول هو Player الموجّهة إليه الرسالة، ولا يستلم المعالج على العميل إلا الوسائط التي بعده. استخدم هذا لكل ما هو شخصي: إشعار، نافذة جائزة، صوت يجب أن يسمعه هذا اللاعب وحده. دليل المشاهد السينمائية (cutscenes) مثال أكبر مشروح: يقرر الخادم متى يرى اللاعب المشهد، ويرسل لقطاته إلى هذا اللاعب وحده عبر FireClient، بينما يحرّك جهازه الكاميرا.
يعرض هذا الزوج من السكربتات رسالة ترحيب عندما يدخل اللاعب. يبني LocalScript لافتة صغيرة بنفسه، لذلك لا حاجة لإعداد GUI.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local notify = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("Notify") :: RemoteEvent
local function welcome(player: Player)
-- الوسيط الأول يحدد أي عميل يستلم الرسالة. لن يراها أحد غيره.
notify:FireClient(player, `Welcome, {player.DisplayName}! Press Q to change colour.`)
end
Players.PlayerAdded:Connect(welcome)
-- في Studio قد تدخل قبل أن يتصل هذا السكربت، لذلك نرحّب بكل من هو موجود أصلًا
for _, player in Players:GetPlayers() do
welcome(player)
end
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local notify = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("Notify") :: RemoteEvent
local player = Players.LocalPlayer
-- لافتة صغيرة أعلى الشاشة، مبنية بالكود
local gui = Instance.new("ScreenGui")
gui.Name = "Notifications"
gui.ResetOnSpawn = false
gui.Parent = player:WaitForChild("PlayerGui")
local label = Instance.new("TextLabel")
label.AnchorPoint = Vector2.new(0.5, 0)
label.Position = UDim2.new(0.5, 0, 0, 16)
label.Size = UDim2.fromOffset(420, 44)
label.BackgroundColor3 = Color3.fromRGB(18, 11, 31)
label.TextColor3 = Color3.new(1, 1, 1)
label.TextScaled = true
label.Visible = false
label.Parent = gui
local messageCount = 0
-- لا يوجد هنا وسيط player: الخادم اختار بالفعل من يستلم الرسالة
notify.OnClientEvent:Connect(function(message: string)
messageCount += 1
local thisMessage = messageCount
label.Text = message
label.Visible = true
task.delay(4, function()
if messageCount == thisMessage then -- نخفيها إذا لم تحلّ محلها رسالة أحدث
label.Visible = false
end
end)
end)
يرسل الخادم الرسالة عند PlayerAdded، وقد يحدث ذلك قبل أن يوصل هذا LocalScript معالجه. لا بأس بذلك: يضع Roblox في طابور رسائل RemoteEvent التي تصل قبل وجود المعالج، ويسلّمها بالترتيب بمجرد أن يتصل المعالج.
لا يحتاج العميل إلى حماية نفسه من الخادم: لا يستطيع إطلاق OnClientEvent إلا كود الخادم. والتعليق التوضيحي message: string موجود لفاحص الأنواع، وليس فحصًا أثناء التشغيل.
النمط 3: من الخادم إلى كل العملاء
يرسل FireAllClients الرسالة نفسها إلى كل لاعب متصل. ليس فيه وسيط Player، ويستلم كل عميل الرسالة في OnClientEvent نفسه كما سبق، لذلك فإن سكربت NotifyClient من النمط 2 يعرضها أصلًا.
يُعلن هذا الـ Script للجميع عندما يلمس لاعب خط النهاية لأول مرة. أضف إلى Workspace قطعة Part مثبتة باسم FinishLine، ثم أضف Script إلى ServerScriptService.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local notify = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("Notify") :: RemoteEvent
local finishLine = workspace:WaitForChild("FinishLine") :: BasePart
local finished: { [Player]: boolean } = {}
finishLine.Touched:Connect(function(hit: BasePart)
local character = hit:FindFirstAncestorOfClass("Model")
local player = character and Players:GetPlayerFromCharacter(character)
if not player or finished[player] then
return -- ليس لاعبًا أو أُعلن عنه مسبقًا
end
finished[player] = true
-- كل عميل متصل يشغّل معالج OnClientEvent الخاص به مع هذا النص
notify:FireAllClients(`{player.DisplayName} reached the finish!`)
end)
Players.PlayerRemoving:Connect(function(player: Player)
finished[player] = nil
end)
يستطيع المستغل (exploiter) أن يُطلق Touched لشخصيته من أي مسافة، لكن هذا غير مؤذٍ لإعلان يظهر مرة واحدة لكل لاعب. وإذا صرت لاحقًا تمنح جائزة على الوصول إلى النهاية، فأضف فحوصًا على الخادم قبل المنح، مثل حد أدنى من الوقت منذ بداية الجولة.
لا يصل FireAllClients إلا إلى اللاعبين المتصلين في تلك اللحظة. من يدخل بعد ثانية لن يرى الرسالة. هذا مناسب للحظات التي تحدث مرة واحدة، مثل إعلان أو تأثير انفجار أو صوت، لكنه غير مناسب للحالة، مثل مؤقت الجولة أو المرحلة الحالية من اللعبة. للحالة اضبط على الخادم سمة (attribute)، مثل ReplicatedStorage:SetAttribute("TimeLeft", 30)، واقرأها على العميل عبر GetAttribute وGetAttributeChangedSignal("TimeLeft"). السمات تتكرر إلى كل عميل، بمن فيهم اللاعبون الذين دخلوا لاحقًا.
RemoteFunction: عندما يحتاج العميل إلى رد
يعمل RemoteEvent على مبدأ «أرسِل وانسَ». أما RemoteFunction فتجعل المستدعي ينتظر: يوقف InvokeServer الكود الذي استدعاه حتى تُعيد دالة الخادم OnServerInvoke قيمة، ثم يسلّمه ما أعادته. استخدمها عندما لا يستطيع العميل المتابعة دون رد، مثل «هل كان هذا الكود صحيحًا؟». وعندما لا تحتاج إلى رد يوصي Roblox بـ RemoteEvent، لأنه لا ينتظر.
مثال: حقل يكتب فيه اللاعبون كودًا ترويجيًا. يحتفظ الخادم بالأكواد، ويفحص النص، ويُعيد قيمتين: هل نجح، والرسالة التي يجب عرضها.
- في
ReplicatedStorage.Remotesأدرج RemoteFunction باسمRedeemCode. - في StarterGui أدرج ScreenGui باسم
CodeGui، وداخله TextBox باسمCodeBox. اختر الحجم والمكان كما تحب. - أضف الـ Script أدناه إلى ServerScriptService، والـ LocalScript داخل
CodeBox.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local redeemCode = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("RedeemCode") :: RemoteFunction
-- الأكواد تعيش على الخادم، حيث لا يستطيع أي لاعب قراءتها
local CODES: { [string]: number } = {
LAUNCH = 100,
THANKYOU = 50,
}
local MAX_LENGTH = 20
local COOLDOWN_SECONDS = 2
local usedCodes: { [Player]: { [string]: boolean } } = {}
local lastTry: { [Player]: number } = {}
-- نُسند عبر =. OnServerInvoke دالة رد نداء (callback)، وليست حدثًا يُستخدم معه Connect.
redeemCode.OnServerInvoke = function(player: Player, code: unknown): (boolean, string)
local now = os.clock()
local last = lastTry[player]
if last and now - last < COOLDOWN_SECONDS then
return false, "Wait a moment before trying again"
end
lastTry[player] = now
if type(code) ~= "string" or #code == 0 or #code > MAX_LENGTH then
return false, "Type a code first"
end
local key = string.upper(code)
local reward = CODES[key]
if not reward then
return false, "That code doesn't exist"
end
local used = usedCodes[player]
if not used then
used = {}
usedCodes[player] = used
end
if used[key] then
return false, "You already used that code"
end
local leaderstats = player:FindFirstChild("leaderstats")
local coins = leaderstats and leaderstats:FindFirstChild("Coins")
if not (coins and coins:IsA("IntValue")) then
return false, "Coins aren't set up in this game yet"
end
used[key] = true
coins.Value += reward
return true, `Code accepted: +{reward} coins`
end
Players.PlayerRemoving:Connect(function(player: Player)
usedCodes[player] = nil
lastTry[player] = nil
end)
يضيف إلى قيمة Coins من دليل لوحة الصدارة. الأكواد المستخدمة تُحفظ فقط حتى يخرج اللاعب، لذلك يستطيع اللاعب بهذا الشكل أن يعيد الدخول ويكتب الكود نفسه مرة أخرى. وإذا كانت العملات تُحفظ، فهذه عملات مجانية مع كل إعادة دخول: قبل استخدام هذا في لعبة حية، احفظ الأكواد المستخدمة لكل لاعب مع بياناته المحفوظة في مخزن البيانات.
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local redeemCode = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("RedeemCode") :: RemoteFunction
local box = script.Parent :: TextBox
local GREEN = Color3.fromRGB(46, 204, 113)
local RED = Color3.fromRGB(231, 76, 60)
box.FocusLost:Connect(function(enterPressed: boolean)
local code = box.Text
if not enterPressed or code == "" then
return
end
box.Text = ""
box.PlaceholderText = "Checking..."
-- يوقف InvokeServer هذه الدالة حتى تُعيد دالة الخادم قيمة.
-- ويمنع pcall توقف LocalScript إذا فشل الاستدعاء.
local ok, accepted, message = pcall(function()
return redeemCode:InvokeServer(code)
end)
if ok and type(message) == "string" then
box.PlaceholderText = message
box.PlaceholderColor3 = if accepted == true then GREEN else RED
else
box.PlaceholderText = "Something went wrong, try again"
box.PlaceholderColor3 = RED
end
end)
لدى RemoteFunction دالة رد نداء واحدة بالضبط على الخادم. إذا ضبط سكربتان OnServerInvoke للـ RemoteFunction نفسها، فلا يعمل إلا الأخير.
لماذا InvokeClient خطير
تعمل RemoteFunction في الاتجاه المعاكس أيضًا، مع InvokeClient على الخادم وOnClientInvoke على العميل. يذكر توثيق Roblox ثلاثة مخاطر جدية:
- إذا أطلقت دالة العميل خطأ، يُطلق الخادم خطأ أيضًا.
- إذا خرج اللاعب أثناء الاستدعاء، يُطلق
InvokeClientخطأ. - إذا لم يُعِد العميل قيمة أبدًا، سينتظر سكربت الخادم إلى الأبد.
العميل المعدَّل يتحكم في دالته، لذلك يستطيع الغشاش أن يتعمّد الحالة الثالثة ويُبقي خيط الخادم هذا معلّقًا قدر ما يشاء. لتحديث شاشة اللاعب استخدم FireClient. وإذا كان الخادم يحتاج فعلًا إلى معلومة من العميل، فأرسل RemoteEvent، ودع العميل يرد عبر RemoteEvent آخر، واعتبر غياب الرد على الخادم حالة عادية.
افحص كل وسيط على الخادم
يستطيع المستغل أن يستدعي أي RemoteEvent أو أي RemoteFunction بقدر ما يشاء من المرات وبأي وسائط. الشيء الوحيد الذي لا يستطيع تزويره هو الوسيط الأول: يضع Roblox بنفسه Player الذي أرسل الرسالة. كل ما يأتي بعده يجب فحصه قبل أن يبدأ الخادم بالتصرف. إخفاء الـ remote أو الفحص في LocalScript لا فائدة منه، لأن الغشاش يتحكم في عميله.
| الفحص | السؤال الذي يطرحه الخادم | مثال |
|---|---|---|
| النوع | هل هذا هو النوع الذي أنتظره؟ Instance، لا جدولًا مبنيًا ليشبهه؟ | typeof(part) == "Instance" and part:IsA("BasePart") |
| النطاق | هل الرقم محدود ويقع ضمن الحدود المسموحة؟ هل طول النص معقول؟ | math.isfinite(n)، n >= 1 and n <= 4، #text <= 20 |
| الملكية | هل يملك هذا اللاعب العنصر، وهل يكفيه المال، وهل يحق له التصرف بهذا الكائن؟ | العنصر موجود في مخزونه، والقطعة داخل Paintable |
| المسافة | هل شخصية اللاعب قريبة بما يكفي في نسخة العالم على الخادم؟ اترك هامشًا صغيرًا للتأخير (lag). | لا تبعد أكثر من 30 stud عن القطعة |
| التكرار | هل يرسل هذا اللاعب بكثرة زائدة؟ | فترة انتظار (cooldown) لكل لاعب أو حد يتجمّع فيه رصيد الاستدعاءات |
تستحق NaN تحذيرًا خاصًا. إنها رقم، لذلك تنجح type(x) == "number"، لكن أي مقارنة معها تُعطي false، وفحص مثل x < 0 or x > 100 يمرّرها دون اعتراض. أما math.isfinite(x) فترفض NaN واللانهايتين كلتيهما.
تذكّر حدود فحص المسافة. كل عميل يتحكم في فيزياء شخصيته، لذلك يستطيع المستغل أن ينقل الشخصية إلى الهدف قبل الاستدعاء. ومع ذلك يوقف الفحص أبسط إساءة، وهي التصرف في الخريطة كلها من مكان واحد. أبقِ القطع المستهدفة مثبتة: يذكر توثيق Roblox للأمان أن المستغل يستطيع الحصول على ملكية الشبكة (network ownership) للقطع غير المثبتة القريبة منه وسحبها نحوه، وهذا يتجاوز فحص المسافة.
هذه الفحوص نفسها على شكل ModuleScript يمكنك استخدامه في كل معالج remote.
local Players = game:GetService("Players")
local RemoteGuard = {}
-- رقم حقيقي بين min وmax. يرفض NaN واللانهاية اللتين تنجحان
-- في الفحص العادي type(x) == "number".
function RemoteGuard.number(value: unknown, min: number, max: number): number?
if type(value) ~= "number" or not math.isfinite(value) then
return nil
end
if value < min or value > max then
return nil
end
return value
end
-- عدد صحيح بين min وmax، للكميات والفهارس والعدّادات
function RemoteGuard.integer(value: unknown, min: number, max: number): number?
local n = RemoteGuard.number(value, min, max)
if n and n % 1 == 0 then
return n
end
return nil
end
-- نص بحد أقصى للطول. تُعيد utf8.len قيمة nil لنص UTF-8 غير صالح، وهو ما
-- ترفضه مخازن البيانات.
function RemoteGuard.text(value: unknown, maxLength: number): string?
if type(value) ~= "string" or #value > maxLength or utf8.len(value) == nil then
return nil
end
return value
end
-- Instance من الصنف المتوقع داخل حاوية سمحت بها أنت.
-- الجدول المبني ليشبه Instance لا ينجح في فحص typeof.
function RemoteGuard.instanceIn(value: unknown, className: string, container: Instance): Instance?
if typeof(value) ~= "Instance" then
return nil
end
if not value:IsA(className) or not value:IsDescendantOf(container) then
return nil
end
return value
end
-- True عندما لا تبعد شخصية اللاعب أكثر من maxDistance stud عن position
function RemoteGuard.isNear(player: Player, position: Vector3, maxDistance: number): boolean
local character = player.Character
local root = character and character:FindFirstChild("HumanoidRootPart")
if not (root and root:IsA("BasePart")) then
return false
end
return (root.Position - position).Magnitude <= maxDistance
end
-- حد تكرار لكل لاعب. يستطيع كل لاعب إجراء `burst` استدعاء دفعة واحدة،
-- ويستعيد `perSecond` استدعاء كل ثانية. يُعيد دالة تُستدعى
-- قبل العمل: تجيب بـ true (مسموح) أو false (متكرر أكثر من اللازم).
function RemoteGuard.limiter(burst: number, perSecond: number): (Player) -> boolean
local buckets: { [Player]: { tokens: number, updated: number } } = {}
Players.PlayerRemoving:Connect(function(player: Player)
buckets[player] = nil
end)
return function(player: Player): boolean
local now = os.clock()
local bucket = buckets[player]
if not bucket then
bucket = { tokens = burst, updated = now }
buckets[player] = bucket
end
bucket.tokens = math.min(burst, bucket.tokens + (now - bucket.updated) * perSecond)
bucket.updated = now
if bucket.tokens < 1 then
return false
end
bucket.tokens -= 1
return true
end
end
return RemoteGuard
احفظه في ServerScriptService. الكود الموجود هناك لا يصل أبدًا إلى العملاء، لذلك لن يقرأ أحد فحوصك.
وهذا هو المعالج من النمط 1 بعد إعادة كتابته باستخدامه. استبدل محتوى PaintServer:
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerScriptService = game:GetService("ServerScriptService")
-- ":: any" مهم فقط لفحص الأنواع الصارم في Luau، ولا يغيّر شيئًا أثناء التشغيل
local RemoteGuard = require(ServerScriptService:WaitForChild("RemoteGuard")) :: any
local paintRequest = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("PaintRequest") :: RemoteEvent
local paintable = workspace:WaitForChild("Paintable")
local PALETTE = {
Color3.fromRGB(231, 76, 60),
Color3.fromRGB(46, 204, 113),
Color3.fromRGB(52, 152, 219),
Color3.fromRGB(241, 196, 15),
}
local canPaint = RemoteGuard.limiter(4, 4) -- دفعة من 4، ثم 4 في الثانية
paintRequest.OnServerEvent:Connect(function(player: Player, partArg: unknown, colourArg: unknown)
local part = RemoteGuard.instanceIn(partArg, "BasePart", paintable) :: BasePart?
local colourIndex = RemoteGuard.integer(colourArg, 1, #PALETTE) :: number?
if not part or not colourIndex then
return
end
if not RemoteGuard.isNear(player, part.Position, 30) or not canPaint(player) then
return
end
part.Color = PALETTE[colourIndex]
end)
يحذف المحدِّد سجل اللاعب عند خروجه، لذلك لا يكبر جدوله طوال عمر الخادم.
في الأسلحة تكون هذه الفحوص أهم من أي مكان آخر: لا تسمح أبدًا للعميل بأن يخبرك بمن أصاب. الـ remote في دليل السيف لا يحمل أي وسائط أصلًا، والخادم يجد الأهداف بنفسه. أما دليل السلاح الناري فيرسل نقطة التصويب فقط، ويفحصها الخادم من حيث النوع وNaN والمسافة قبل أن يطلق شعاعه الخاص.
القوائم تخضع للقاعدة نفسها: أرسل الاختيار، لا النتيجة. في دليل حوار NPC يرسل العميل رقم الزر المضغوط فقط، والخادم ينظر بنفسه ماذا يعطي هذا الجواب. وقائمة دليل الانتقال الفوري ترسل اسم النقطة لا موقعها، والخادم يجد النقطة في مجلده ويفحص كم Wins تحتاجه.
ما يمكن إرساله وما لا يمكن
يمكنك تمرير الأرقام والنصوص والقيم المنطقية (boolean)، وأنواع Roblox مثل Vector3 وCFrame وColor3 وعناصر Enum، وكائنات Instance التي يراها الطرفان، والجداول المؤلفة من كل ذلك. بعض القيم تتغير أو تختفي في الطريق:
| ما ترسله | ما يحدث |
|---|---|
| دالة | يستلم الطرف الآخر nil |
| جدولًا له metatable | يضيع الـ metatable مع كل ما كان الجدول يملكه عبره فقط |
| جدولًا يخلط بين مفاتيح رقمية ونصية | ينصح Roblox بعدم فعل ذلك: أرسل مصفوفة خالصة أو قاموسًا خالصًا |
جدولًا فيه قيم nil | تجنّبه: لا ينصح Roblox بـ nil في أي فهرس |
| جدولًا مفاتيحه من نوع Instance أو userdata أو function | تتحول هذه المفاتيح إلى نصوص |
| Instance لا يراه المستقبل، مثلًا من ServerStorage أو أُنشئ في LocalScript | يستلم الطرف الآخر nil |
| أي جدول | يستلم المستقبل نسخة، لا الجدول نفسه |
عادة جيدة: أرسل المعرّفات لا الكائنات أو القيم. اسم العنصر، رقم الخيار، قطعة يستطيع الخادم أن يجدها ويفحصها. بعد ذلك يعمل الخادم ببياناته هو.
لماذا تُعيد RemoteFunction قيمة nil
إذا أعطاك InvokeServer القيمة nil، فراجع هذه النقاط بالترتيب:
- مسار بلا قيمة معادة. كل خروج من
OnServerInvokeيجب أن يُعيد شيئًا. والـreturnالفارغ في فحص مبكر يُرجعnil. - return داخل دالة متداخلة. الـ
returnداخلpcall(function() ... end)أو داخل معالج:Connectأوtask.spawnيخرج من تلك الدالة الداخلية فقط. احفظ النتيجة، مثلlocal ok, data = pcall(...)، ثم أعِدdataمن دالة الرد نفسها. - قيمة لا تستطيع عبور الحد. الدالة أو Instance لا يراه العميل (مثل أي شيء في ServerStorage) تصل على شكل
nil. ومع تفعيل instance streaming، قد لا تكون القطعة التي أنشأها الخادم للتو قد وصلت إلى العميل لحظة العودة من الدالة. - سكربت آخر ضبط دالة الرد. لا يعمل إلا آخر إسناد لـ
OnServerInvoke. ابحث عن اسم الـ remote في سكربتاتك.
إذا لم يرجع الاستدعاء أبدًا، فهذا يعني أنه لم يضبط أي سكربت OnServerInvoke بعد (يُبقي Roblox الاستدعاءات في طابور حتى يُضبط)، أو أن دالة الرد علقت، مثلًا عند WaitForChild لشيء لن يظهر أبدًا.
UnreliableRemoteEvent: للتحديثات المستمرة التي تُرسل مرة واحدة
لدى UnreliableRemoteEvent الدوال والأحداث نفسها التي لدى RemoteEvent: FireServer وFireClient وFireAllClients وOnServerEvent وOnClientEvent. الفرق أن Roblox لا يضمن التسليم ولا الترتيب. قد تُسقط الرسالة دون إعادة إرسال عندما:
- تضيع في الطريق أو تنتظر طويلًا في شبكة مزدحمة
- تكون بياناتها أكبر من 1000 بايت
- يرسل العميل أكثر من الحد (الزائد يُسقط ولا يؤجَّل)
- لا يكون أي معالج متصلًا لحظة وصولها (تُرمى ولا توضع في طابور)
وقد تصل الرسائل بغير ترتيب أيضًا، ولا علاقة لترتيبها بترتيب RemoteEvent أو RemoteFunction لديك. استخدمه عندما لا تهمك إلا أحدث قيمة، والتحديث التالي سيصل خلال جزء من الثانية: أين يصوّب اللاعب، موقع تأثير شكلي، قيمة تتغير كل إطار. وإذا كان الترتيب مهمًا فضع في كل رسالة رقمًا تسلسليًا أو طابعًا زمنيًا وتجاهل كل ما هو أقدم من آخر ما عالجته.
لا تستخدمه أبدًا لما يجب أن يحدث مرة واحدة بالضبط، مثل الشراء أو الضرر أو الجائزة أو بدء الجولة. وافحص وسائطه على الخادم تمامًا كما تفعل مع RemoteEvent.
ترتيب التسليم وحدود التكرار
ضمانات التسليم في Roblox تخص اتصالًا واحدًا في اتجاه واحد: من الخادم إلى عميل واحد أو من عميل واحد إلى الخادم.
- RemoteEvent موثوقة ومرتبة. الرسائل الضائعة يُعاد إرسالها ما دام المستقبل متصلًا، والرسائل تصل بالترتيب الذي أرسلتها به، حتى عبر RemoteEvent مختلفة. إذا أرسل الخادم إلى لاعب A ثم B ثم A، فإن هذا اللاعب يستلم A ثم B ثم A.
- الترتيب يخص لحظة تشغيل المعالجات. إذا تخلّى المعالج عن التحكم، مثلًا عبر
task.waitأوWaitForChild، فقد تبدأ معالجة الرسالة التالية قبل أن تنتهي الأولى. - RemoteFunction وRemoteEvent غير مرتبة إحداهما بالنسبة إلى الأخرى. إذا كان كودك يعتمد على ترتيب صارم، فأرسل الرسائل المترابطة عبر نوع واحد من الـ remotes أو أضف رقمك التسلسلي الخاص.
- تغييرات الخصائص والسمات غير مرتبة بالنسبة إلى الـ remotes. إذا غيّر الخادم خاصية ثم استدعى remote، فقد يرى العميل أيًّا منهما أولًا. استمع إلى التغيير نفسه، مثلًا عبر
GetPropertyChangedSignal، ولا تفترض أنه وصل بالفعل. - المعالج غير موجود بعد. رسائل RemoteEvent تبقى في طابور حتى يتصل المعالج. للطابور حدود: عندما يمتلئ تُسقط الرسائل التالية، ويظهر في Output الخطأ
Remote event invocation discarded. - اللاعب الذي يخرج يفقد كل الرسائل التي لم تصل إليه بعد.
حد التكرار. رسائل RemoteEvent وUnreliableRemoteEvent من العميل إلى الخادم محدودة بنحو 500 طلب في الثانية لكل عميل، بحسب التوثيق في 30 سبتمبر 2026. الحد مشترك بين كل الـ remotes من النوع نفسه، لذلك لا يرفعه تقسيم remote واحد مزدحم إلى عشرة. وفوق الحد تُعالج رسائل RemoteEvent لاحقًا مع الحفاظ على ترتيبها، أما رسائل UnreliableRemoteEvent فتُسقط. حد المحرك لا يمنع لاعبًا واحدًا من استدعاء الـ remote الخاص بك 50 مرة في الثانية، لذلك يحتاج كل معالج يغيّر شيئًا إلى حدّه الخاص لكل لاعب على أي حال.
RemoteEvent أم RemoteFunction أم UnreliableRemoteEvent أم سمة؟
| استخدم | لأي غرض | مثال | ما يجب الانتباه إليه |
|---|---|---|---|
| RemoteEvent | رسائل في اتجاه واحد يجب أن تصل، وبالترتيب | العميل: «لوّن هذه القطعة». الخادم: «اعرض هذا الإشعار» | افحص كل وسيط على الخادم |
RemoteFunction مع InvokeServer | يحتاج العميل إلى رد قبل أن يستطيع المتابعة | إدخال كود ترويجي، تأكيد شراء | المستدعي ينتظر، وكل مسار يجب أن يُعيد قيمة |
RemoteFunction مع InvokeClient | تقريبًا أبدًا | استخدم FireClient بدلًا منه | العميل الذي حدث عنده خطأ أو خرج أو لم يرد يُفسد الاستدعاء على الخادم أو يعلّقه |
| UnreliableRemoteEvent | تحديثات متكررة لا يهم فيها إلا الأخير | اتجاه التصويب، التأثيرات الشكلية | الرسائل تضيع أو يتغير ترتيبها، وحد البيانات 1000 بايت |
| سمة أو كائن قيمة (value object) يضبطه الخادم | حالة مشتركة يجب أن تكون مرئية دائمًا، بما في ذلك للاعبين الذين دخلوا لاحقًا | مؤقت الجولة، مرحلة اللعبة، هل الباب مفتوح | لا يصل إلى الجميع إلا ما يغيّره الخادم، والعملاء يستمعون عبر GetAttributeChangedSignal أو Changed |
| BindableEvent | تواصل السكربتات على الجانب نفسه | سكربت على الخادم يُبلغ سكربتًا آخر بأن الجولة انتهت | لا يعبر بين الخادم والعميل |
لمثال كامل عن عمل RemoteFunction والفحوص معًا حيث يدفع اللاعبون، اقرأ دليل كيف تصنع متجر GUI. أما بخصوص سطر السمات، فسكربت الخادم في دليل الأبواب يضبط السمة Open على كل باب عند كل حركة له، فيستطيع أي LocalScript أن يتفاعل معها.
الأخطاء الشائعة وحلولها
معظم مشكلات الـ remotes تظهر في نافذة Output (افتحها من قائمة Window أو من تبويب Script). انظر هناك أولًا، ثم ابحث عن العَرَض الذي تواجهه أدناه. يشرح دليل أخطاء السكربتات رسائل الأخطاء العامة بتفصيل أكبر.
Infinite yield possible عند WaitForChild لـ remote
السكربت ينتظر remote لن يظهر أبدًا. تأكد من أن الاسم وحالة الأحرف متطابقان تمامًا، وأن الـ remote موجود في ReplicatedStorage، لا في ServerStorage أو ServerScriptService اللذين لا يراهما العملاء.
يستلم الخادم قيمًا خاطئة، مزاحة بمقدار واحد
مرّر LocalScript اللاعب نفسه، كما في remote:FireServer(player, 5). يضيف Roblox المرسل كأول وسيط أصلًا، لذلك يرى الخادم (player, player, 5). استدعِ remote:FireServer(5).
لا يحدث شيء عندما أستدعي الـ remote
تأكد من أن كل استدعاء يأتي من الجانب الصحيح: FireServer وInvokeServer لا يعملان إلا من كود العميل، وFireClient وFireAllClients وInvokeClient لا تعمل إلا من Script على الخادم. لا يعمل LocalScript أبدًا في ServerScriptService أو ServerStorage أو مباشرة في Workspace، فضعه في StarterPlayerScripts أو StarterGui أو StarterCharacterScripts أو StarterPack. ثم ابحث في Output عن خطأ داخل المعالج.
Remote event invocation discarded
وصلت رسائل إلى RemoteEvent لم يكن له معالج متصل، فامتلأ الطابور. عادةً يتعطل السكربت الذي فيه المعالج بخطأ قبل السطر الذي فيه :Connect، أو يكون معطّلًا، أو عالقًا في انتظار شيء لن يُحمَّل أبدًا. صِل المعالجات قرب بداية السكربت.
يعمل عندي، لكن اللاعبين الآخرين لا يرون التغيير
التغيير أُجري على العميل، في LocalScript أو في معالج OnClientEvent. أجرِه في معالج OnServerEvent على الخادم.
InvokeServer لا يرجع أبدًا
إما أن أي سكربت لم يضبط OnServerInvoke (يُبقي Roblox الاستدعاءات في طابور حتى يُضبط)، وإما أن دالة الرد علقت عند شيء يتخلى عن التحكم، مثل WaitForChild أو طلب إلى مخزن البيانات. أضف print في بداية دالة الرد ونهايتها لترى أين تتوقف.
اصنعه مع RoCode
يستطيع RoCode أيضًا إعداد هذا، مباشرة في المكان المفتوح عندك. RoCode وكيل ذكاء اصطناعي يعمل عبر إضافة لـ Roblox Studio، لذلك ينشئ الـ remotes والسكربتات في Explorer عندك، بدلًا من أن يعطيك كودًا عليك لصقه.
اجعل اللاعبين يلوّنون القطع في مجلد Paintable بالنقر. استخدم RemoteEvent وأبقِ الفحوص على الخادم: القطع من هذا المجلد فقط، وعلى مسافة لا تزيد على 30 stud، وبضع عمليات تلوين في الثانية كحد أقصى.
- عادةً يتصفح المكان أولًا عبر Search Game وSearch Scripts بحثًا عن مجلد Remotes أو معالج موجود، ويستخدم مجلداتك إن وُجدت
- ينشئ RemoteEvent في ReplicatedStorage عبر Create Instance، ويكتب Script للخادم وLocalScript عبر Create Script
- قبل الإنهاء يفحص تجميع كل سكربت عبر Check Script داخل Studio. هذا يكشف أخطاء التجميع لا أخطاء المنطق: فهو لا يفحص الأنواع ولا يشغّل أداة lint ولا ينفّذ كودك
- يرسل التغييرات على دفعات، وكل دفعة نقطة تراجع في سجل Studio
مع الإضافة 3.9 أو أحدث يستطيع RoCode تشغيل اختبار لعب قصير وقراءة الأخطاء، ومع الإضافة 3.9.11 أو أحدث يستطيع التحكم في شخصية اختبار، لكنه لا ينقر على القطع في نافذة العرض ثلاثية الأبعاد. اضغط Play بنفسك وحاول كسر الفحوص، مثلًا بتلوين قطعة من الطرف الآخر للخريطة. وإذا ظهر خطأ، يستطيع Check Output قراءة سطور Server وClient من آخر اختبار لعب أجريته. معظم أنظمة الألعاب تتواصل عبر remotes كهذه، لذلك ستقابلها مجددًا عندما تبني لعبة نظامًا بعد نظام مع RoCode. كيف يتصل RoCode بـ Studio.
الأسئلة الشائعة
ماذا يعني securing the client-server boundary في Roblox؟
هذا اسم صفحة في توثيق Roblox عن أمان الـ remotes، والفكرة بسيطة: كل ما يرسله العميل عبر RemoteEvent أو RemoteFunction قد يأتي من مستغل، لذلك يفحصه الخادم قبل أن يتصرف. افحص نوع كل وسيط، وأبقِ الأرقام ضمن حدود معقولة، وتأكد من أن اللاعب مسموح له بفعل ذلك الآن، وحدّد كم مرة يستطيع كل لاعب استدعاء الـ remote. تُظهر قائمة الفحوص أعلاه كل واحد منها في الكود.
هل استخدام RemoteFunction آمن؟
InvokeServer آمن بقدر أمان دالة الرد على الخادم: افحص وسائطها وحدّد تكرارها كما تفعل مع أي RemoteEvent. الاتجاه الخطِر هو InvokeClient، لأن العميل الذي حدث عنده خطأ، أو خرج، أو لم يُعِد قيمة أبدًا، يُفسد الاستدعاء على الخادم أو يعلّقه.
هل يستطيع المستغلون رؤية الـ remotes الخاصة بي واستدعاءها؟
نعم. كل ما في ReplicatedStorage يصل إلى كل عميل، والعميل المعدَّل يستطيع استدعاء أي remote بأي وسائط. إعادة تسمية الـ remotes أو إخفاؤها لا يجعلها آمنة، ما يجعلها آمنة هو فحص كل وسيط على الخادم.
هل يستطيع عميل أن يرسل RemoteEvent إلى عميل آخر؟
ليس مباشرة. أرسله إلى الخادم، وافحصه هناك، ثم استخدم FireClient أو FireAllClients.
كم مرة يمكنني استدعاء RemoteEvent؟
يذكر توثيق Roblox حدًّا يقارب 500 طلب في الثانية لكل عميل لرسائل RemoteEvent وUnreliableRemoteEvent المرسلة إلى الخادم، مشتركًا بين كل الـ remotes من النوع نفسه. ابقَ أدنى منه بكثير، وأعطِ كل معالج حدّه الخاص لكل لاعب.
هل يصل FireAllClients إلى اللاعبين الذين دخلوا لاحقًا؟
لا. يصل إلى اللاعبين المتصلين في تلك اللحظة. للحالة التي يحتاجها المتأخرون، اضبط على الخادم سمة أو كائن قيمة.
ما الفرق بين RemoteEvent وBindableEvent؟
يعبر RemoteEvent بين الخادم والعميل. أما BindableEvent فيربط السكربتات على الجانب نفسه، مثل سكربتين على الخادم.
المصادر والقراءات
- Roblox Creator Docs: Remote events and callbacks (بالإنجليزية). FireServer وFireClient وInvokeServer ومخاطر InvokeClient وقيود الوسائط وضمانات التسليم
- Roblox Creator Docs: Securing the client-server boundary (بالإنجليزية). مستويات الفحص وNaN وحدود التكرار والتمرير من عميل إلى عميل
- Roblox Creator Docs: Security and cheat mitigation tactics (بالإنجليزية). ما يستطيعه العميل المعدَّل وسلطة الخادم
- Roblox Creator Docs: Network ownership, movement validation, and physics (بالإنجليزية). لماذا يتحكم العميل في شخصيته، وحدود فحوص المسافة
- Roblox Engine API: RemoteEvent (بالإنجليزية). حد التكرار وخطأ invocation discarded
- Roblox Engine API: RemoteFunction (بالإنجليزية). OnServerInvoke وتحذيرات InvokeClient والاحتياطات مع streaming
- Roblox Engine API: UnreliableRemoteEvent (بالإنجليزية). حد البيانات البالغ 1000 بايت
- Roblox Creator Docs: Properties and attributes (بالإنجليزية). ترتيب التكرار بين تغييرات الخصائص والـ remote events
كيف فُحص الكود: كل سكربت في هذه الصفحة يجتاز الفاحص الصارم للأنواع في Luau مع تعريفات واجهة Roblox البرمجية (luau-lsp، ٢٠ نوفمبر ٢٠٢٦). فحص الأنواع يكشف الأخطاء في أسماء الواجهات البرمجية والأنواع الخاطئة، لا منطق اللعبة، فجرّب الكود في Studio قبل النشر.