باختصار
في Script داخل ServerScriptService أنشئ TextChatCommand لكل أمر، وحدّد له PrimaryAlias (مثل "/kick") وضعه داخل TextChatService. الحدث Triggered الخاص به يمرّر TextSource المرسِل والنص الكامل للرسالة. اعثر على اللاعب عبر Players:GetPlayerByUserId(textSource.UserId)، وتحقّق من وجود user ID الخاص به في قائمة الأدمن عندك، ثم قسّم الرسالة إلى كلمات ونفّذ الإجراء.
- تحقّق من قائمة الأدمن على الخادم. التحقق داخل LocalScript يستطيع المستغل (exploiter) تجاوزه.
- تحقّق من user ID وليس من الأسماء: يمكن للاعبين تغيير أسمائهم، أما الـ ID فلا يتغيّر أبدًا.
- الرسالة التي تطابق أمرًا لا تظهر في الدردشة، لذلك لا تملأ الأوامر الدردشة على اللاعبين الآخرين.
في هذه الصفحة
كيف تعمل أوامر الدردشة
الكائن TextChatCommand داخل TextChatService يراقب رسائل الدردشة. عندما تبدأ رسالة بـ PrimaryAlias أو SecondaryAlias الخاص به، ويليه مسافة أو لا شيء، لا يرسل Roblox الرسالة إلى اللاعبين الآخرين ويستدعي بدلًا من ذلك Triggered. المقارنة مع الاسم المستعار لا تهتم بالأحرف الكبيرة. مثال الأوامر المخصصة من Roblox يربط Triggered في Script على الخادم، وهناك تمامًا مكان التحقق من الأدمن.
| ما تكتبه في الدردشة | ما يحدث |
|---|---|
/kick Name | يزيل هذا اللاعب من الخادم. |
/tp Name | ينقلك إليه. /tp Name1 Name2 يرسل Name1 إلى Name2. |
/speed Name 50 | يضبط WalkSpeed الخاص به (من 0 إلى 200). بدون رقم يعيده إلى 16. |
/heal Name | يعيد له الصحة كاملة. |
/kill Name | يقتل شخصيته. |
بدلًا من الاسم يمكنك كتابة me أو all أو others، ويكفي بداية الاسم: /heal ro يعالج كل اللاعبين الذين يبدأ اسمهم أو اسم العرض لديهم بـ «ro».
الخطوة 1: أضف الأوامر
- تأكّد أن اللعبة تستخدم TextChatService: حدّد TextChatService في Explorer وانظر إلى ChatVersion في نافذة Properties. إذا كان المكان قديمًا وما زالت القيمة LegacyChatService، ففي صفحة Roblox عن الدردشة النصية داخل التجربة قسم عن الانتقال.
- أدرج Script في ServerScriptService باسم
AdminCommandsوالصق الكود أدناه. - استبدل
123456فيADMINSبالـ user ID الخاص بك.
-- Script في ServerScriptService باسم AdminCommands.
-- أوامر دردشة لأصحاب user ID في ADMINS: /kick و/tp و/speed و/heal و/kill.
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local TextChatService = game:GetService("TextChatService")
-- الـ user ID الخاص بك هو الرقم في رابط ملفك الشخصي: roblox.com/users/123456/profile
local ADMINS: { [number]: boolean } = {
[123456] = true,
}
local function isAdmin(userId: number): boolean
-- في اختبار اللعب في Studio داخل مكان تملكه بحسابك الشخصي، تُعدّ أدمن أيضًا
local ownerInStudio = RunService:IsStudio() and game.CreatorType == Enum.CreatorType.User and userId == game.CreatorId
return ADMINS[userId] == true or ownerInStudio
end
-- يبحث عن اللاعبين ببداية الاسم أو اسم العرض، أو "me" أو "all" أو "others"
local function findPlayers(text: string?, caller: Player): { Player }
local found: { Player } = {}
if not text or text == "" or text == "me" then
table.insert(found, caller)
return found
end
local lower = string.lower(text)
for _, player in Players:GetPlayers() do
local name = string.lower(player.Name)
local display = string.lower(player.DisplayName)
if lower == "all"
or (lower == "others" and player ~= caller)
or string.sub(name, 1, #lower) == lower
or string.sub(display, 1, #lower) == lower
then
table.insert(found, player)
end
end
return found
end
local function getHumanoid(player: Player): Humanoid?
local character = player.Character
return character and character:FindFirstChildOfClass("Humanoid")
end
type Handler = (caller: Player, args: { string }) -> ()
local commands: { [string]: Handler } = {
kick = function(caller, args)
for _, target in findPlayers(args[2], caller) do
if target ~= caller then
target:Kick("Kicked by an admin")
end
end
end,
tp = function(caller, args)
-- /tp name: إليه. /tp name1 name2: إرسال name1 إلى name2.
local destination = if args[3] then findPlayers(args[3], caller)[1] else findPlayers(args[2], caller)[1]
local movers: { Player } = if args[3] then findPlayers(args[2], caller) else { caller }
local destCharacter = destination and destination.Character
if not destCharacter then
return
end
for _, mover in movers do
local character = mover.Character
if character and mover ~= destination then
character:PivotTo(destCharacter:GetPivot() * CFrame.new(0, 0, 4))
end
end
end,
speed = function(caller, args)
-- /speed name 50
local speed = tonumber(args[3]) or 16
for _, target in findPlayers(args[2], caller) do
local humanoid = getHumanoid(target)
if humanoid then
humanoid.WalkSpeed = math.clamp(speed, 0, 200)
end
end
end,
heal = function(caller, args)
for _, target in findPlayers(args[2], caller) do
local humanoid = getHumanoid(target)
if humanoid then
humanoid.Health = humanoid.MaxHealth
end
end
end,
kill = function(caller, args)
for _, target in findPlayers(args[2], caller) do
local humanoid = getHumanoid(target)
if humanoid then
humanoid.Health = 0
end
end
end,
}
-- ينشئ TextChatCommand واحدًا لكل أمر. النتيجة للأدمن فقط؛ أما للبقية
-- فالأمر لا يفعل شيئًا، والرسالة أيضًا لا تظهر في الدردشة.
for name, handler in commands do
local command = Instance.new("TextChatCommand")
command.Name = "Admin_" .. name
command.PrimaryAlias = "/" .. name
command.AutocompleteVisible = false -- الأوامر لا تظهر في اقتراحات بقية اللاعبين
command.Parent = TextChatService
command.Triggered:Connect(function(textSource: TextSource, unfilteredText: string)
local caller = Players:GetPlayerByUserId(textSource.UserId)
if not caller or not isAdmin(caller.UserId) then
return
end
handler(caller, string.split(unfilteredText, " "))
end)
end
الجدول commands يربط كل اسم بدالة. الحلقة في الأسفل تحوّل كل إدخال إلى TextChatCommand، لذلك الأمر الجديد مجرد إدخال واحد في الجدول. string.split(unfilteredText, " ") يقسّم الرسالة إلى كلمات: args[1] هو الأمر، وargs[2] الهدف، وargs[3] الرقم أو الهدف الثاني.
AutocompleteVisible = false يزيل الأوامر من الاقتراحات التي يراها كل لاعب عندما يكتب الشرطة المائلة. وإذا كتب الأدمن الأمر كاملًا فسيعمل على أي حال.
الخطوة 2: أضف أمرك الخاص
أضف إدخالًا إلى الجدول commands. مثلًا الأمر /jump Name 100 الذي يضبط قوة القفز:
- انسخ الإدخال
speedوأعد تسميته إلىjump. - بداخله اضبط
humanoid.UseJumpPower = trueوhumanoid.JumpPower = math.clamp(power, 0, 300).
لرسالة موجّهة للجميع، كإعلان مثلًا، أرسلها عبر RemoteEvent يعرضه كل عميل على الشاشة. كل ما يمكن للاعبين قراءته وجاء من نص مكتوب يجب أن يمرّ أولًا بتصفية النص في Roblox، لذلك استخدم رسائل ثابتة للإعلانات أو صفّها عبر TextService:FilterStringAsync.
اختبر
- اضغط Play في مكان تملكه. اكتب في الدردشة
/speed me 60: ستركض أسرع، ولن تظهر الرسالة في الدردشة. - بعد أن تسقط، اكتب
/heal meلتتأكّد أن الصحة تعود. - شغّل اختبارًا للاعبَين (تبويب Test، ثم Clients and Servers). من Player1 اكتب
/tp Player2. ومن Player2، وهو ليس أدمن، اكتب/kill Player1: لن يحدث شيء.
الأخطاء الشائعة وحلولها
إذا لم يفعل الأمر شيئًا، فافحص أولًا نافذة Output وهذه النقاط.
الأمر يظهر في الدردشة ولا يحدث شيء
TextChatCommand يتبع TextChatService. افحص الخاصية ChatVersion في TextChatService، وتأكّد أن السكربت من نوع Script داخل ServerScriptService وأنه لا يوجد خطأ أحمر في Output.
في اللعبة المنشورة لا يفعل الأمر شيئًا عندي
الـ user ID الخاص بك غير موجود في ADMINS. استثناء Studio يعمل داخل Studio فقط، ولمكان يملكه حسابك الشخصي فقط، وليس مجموعة.
الأمر /tp لا يفعل شيئًا
يجب أن تكون لكلا اللاعبين شخصية في العالم. افحص اسم الهدف: تكفي بداية الاسم أو اسم العرض، لكن مع خطأ إملائي لن يُعثر على أحد.
أريد رتبًا، مثل مشرف ومالك
غيّر ADMINS بحيث يرتبط كل user ID برقم رتبة، وحدّد لكل أمر أدنى رتبة يُسمح لها بتشغيله.
ابنِه باستخدام RoCode
إذا لم ترغب في إعداد هذا يدويًا، يستطيع RoCode بناءه في المكان المفتوح عندك. RoCode وكيل ذكاء اصطناعي مستقل لـ Roblox Studio، وليس من Roblox: تصف التغيير في دردشة الويب، وإضافته لـ Studio تنشئ السكربتات في Explorer عندك.
أضف أوامر أدمن لي ولصديقي (user ID 111 و222): /kick و/tp و/speed و/heal و/kill و/fly، مع التحقق على الخادم.
- يكتب سكربت الأوامر مع IDs الأدمن الخاصة بك وأي أوامر إضافية تصفها
- يمكنه قراءة مكانك أولًا ليستخدم ما هو موجود، مثل إعداد الدردشة الحالي
- مطلوب منه التحقق من تجميع كل سكربت عبر Check Script، ويضع نقاط تراجع حول كل مجموعة تغييرات
يبقى عليك اختبار الأوامر في اختبار اللعب، والتحقق من الأدمن يحتاج إلى لاعب ثانٍ. كيف يتصل RoCode بـ Studio.
الأسئلة الشائعة
كيف أضيف أوامر أدمن إلى لعبتي في Roblox؟
أنشئ TextChatCommand في Script على الخادم، وفي كل معالج Triggered تحقّق من user ID المرسِل مقابل قائمة الأدمن عندك قبل فعل أي شيء. السكربت الكامل في الخطوة 1.
هل أحتاج إلى HD Admin أو Adonis؟
لا. أنظمة الأدمن من Creator Store تضيف أوامر كثيرة ولوحة تحكم، لكنها كود كبير لم تكتبه أنت. سكربت قصير خاص بك يفعل بالضبط ما تحتاجه ولا شيء غيره.
كيف أعرف الـ user ID الخاص بي في Roblox؟
افتح ملفك الشخصي على roblox.com: الرقم في الرابط بين /users/ و/profile هو الـ user ID الخاص بك.
هل يرى اللاعبون أوامر الأدمن في الدردشة؟
لا. الرسالة التي تطابق TextChatCommand لا تُرسَل إلى اللاعبين الآخرين.
المصادر والقراءات
- Roblox Creator Docs: TextChatCommand (بالإنجليزية). الأسماء المستعارة وAutocompleteVisible وTriggered
- Roblox Creator Docs: Custom text chat commands (بالإنجليزية). Script على الخادم يعالج الأمر
- Roblox Creator Docs: Player:Kick (بالإنجليزية). إزالة لاعب مع رسالة
- Roblox Creator Docs: Text filtering (بالإنجليزية). متى يجب تصفية النص المكتوب
كيف فُحص الكود: كل سكربت في هذه الصفحة يجتاز الفاحص الصارم للأنواع في Luau مع تعريفات واجهة Roblox البرمجية (luau-lsp، ٢٠ نوفمبر ٢٠٢٦). فحص الأنواع يكشف الأخطاء في أسماء الواجهات البرمجية والأنواع الخاطئة، لا منطق اللعبة، فجرّب الكود في Studio قبل النشر.