درس · أسلوب اللعب

كيف تصنع أوامر الأدمن في Roblox Studio

تتيح لك أوامر الأدمن التحكم في لعبتك مباشرة من الدردشة: طرد لاعب مخالف، أو الانتقال إلى صديق، أو اختبار السرعة. في دردشة Roblox الحالية، TextChatService، الأوامر مدمجة عبر TextChatCommand. في هذا الدليل ستضيف مجموعة أوامر أدمن مبنية عليها، وكل أمر يُتحقَّق منه على الخادم مقابل قائمة user ID، فلا يستطيع أحد غيرك استخدامها.

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

باختصار

في Script داخل ServerScriptService أنشئ TextChatCommand لكل أمر، وحدّد له PrimaryAlias (مثل "/kick") وضعه داخل TextChatService. الحدث Triggered الخاص به يمرّر TextSource المرسِل والنص الكامل للرسالة. اعثر على اللاعب عبر Players:GetPlayerByUserId(textSource.UserId)، وتحقّق من وجود user ID الخاص به في قائمة الأدمن عندك، ثم قسّم الرسالة إلى كلمات ونفّذ الإجراء.

  • تحقّق من قائمة الأدمن على الخادم. التحقق داخل LocalScript يستطيع المستغل (exploiter) تجاوزه.
  • تحقّق من user ID وليس من الأسماء: يمكن للاعبين تغيير أسمائهم، أما الـ ID فلا يتغيّر أبدًا.
  • الرسالة التي تطابق أمرًا لا تظهر في الدردشة، لذلك لا تملأ الأوامر الدردشة على اللاعبين الآخرين.
في هذه الصفحة
  1. طريقة العمل
  2. 1. السكربت
  3. 2. أمرك الخاص
  4. Common errors
  5. With RoCode
  6. الأسئلة الشائعة
  7. المصادر والقراءات

كيف تعمل أوامر الدردشة

الكائن 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: أضف الأوامر

  1. تأكّد أن اللعبة تستخدم TextChatService: حدّد TextChatService في Explorer وانظر إلى ChatVersion في نافذة Properties. إذا كان المكان قديمًا وما زالت القيمة LegacyChatService، ففي صفحة Roblox عن الدردشة النصية داخل التجربة قسم عن الانتقال.
  2. أدرج Script في ServerScriptService باسم AdminCommands والصق الكود أدناه.
  3. استبدل 123456 في ADMINS بالـ user ID الخاص بك.
Script في ServerScriptService باسم AdminCommands
-- 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.

اختبر

  1. اضغط Play في مكان تملكه. اكتب في الدردشة /speed me 60: ستركض أسرع، ولن تظهر الرسالة في الدردشة.
  2. بعد أن تسقط، اكتب /heal me لتتأكّد أن الصحة تعود.
  3. شغّل اختبارًا للاعبَين (تبويب 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، مع التحقق على الخادم.

ما يفعله RoCode
  • يكتب سكربت الأوامر مع 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 لا تُرسَل إلى اللاعبين الآخرين.

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

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

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

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