بوت الديسكورد وتسجيل الدخول

يستطيع فريق الإدارة الدخول إلى لوحة ويب txAdmin وفتح قائمة /tx داخل اللعبة باستخدام رتب الديسكورد، بدون حسابات txAdmin منفصلة.

قبل البدء

• افتح بورت 40120 حتى يمكن الوصول للوحة الويب.
• لنسخ المعرّفات في الديسكورد، فعّل Developer Mode من (Settings ← Advanced)، ثم اضغط كليك يمين على السيرفر أو الرتبة واختر Copy ID.

1. إنشاء البوت

1. اذهب إلى Discord Developer Portal واضغط New Application.
2. افتح تبويب Bot واضغط Reset Token. انسخ التوكن، ستحتاجه في الخطوة 5.

DANGER

لا تشارك توكن البوت أبدًا. أي شخص يملكه يتحكم في البوت.

2. تفعيل الـ Intents

في تبويب Bot، تحت Privileged Gateway Intents، فعّل الثلاثة:

• Presence Intent
• Server Members Intent (مطلوب لقراءة رتب الأعضاء)
• Message Content Intent

TIP

يمكنك إطفاء Public Bot حتى تكون أنت فقط من يستطيع إضافة البوت لأي سيرفر.

3. صلاحيات البوت ودعوته

افتح OAuth2 ← URL Generator، وحدد bot، ثم حدد هذه الصلاحيات:

عامة	النصوص
Manage Roles	Send Messages
Manage Channels	Create Public Threads
Manage Webhooks	Create Private Threads
View Channels	Send Messages in Threads
	Pin Messages
	Embed Links
	Attach Files
	Read Message History
	Mention Everyone
	Bypass Slowmode

افتح الرابط الناتج وأضف البوت إلى سيرفر الديسكورد.

ترتيب الرتب

في سيرفر الديسكورد، من Server Settings ← Roles، اسحب رتبة البوت فوق كل الرتب التي سيعطيها أو يسحبها (رتب الحظر والتحذيرات والوايت ليست). الديسكورد لا يسمح للبوت بإدارة رتب أعلى من رتبته.

4. إضافة رابط تسجيل الدخول

افتح تبويب OAuth2، وتحت Redirects أضف:

http://your_server_ip:40120/login/discord

استبدل your_server_ip بالـ IP العام لسيرفرك، ثم اضغط Save Changes.

INFO

الرابط يجب أن يكون مطابقًا تمامًا، بما في ذلك http:// والبورت. إذا كنت تستخدم دومين لـ txAdmin، فاستخدمه بدل الـ IP.

5. إضافة الـ Convars

أضف هذه الأسطر إلى server.cfg واستبدل القيم:

setr txAdmin-discordRoleAuth true
setr txAdmin-discordRoleAuthOnly true
set txAdmin-discordGuildId "YOUR_GUILD_ID"
set txAdmin-discordBotToken "YOUR_BOT_TOKEN"
setr txAdmin-discordAdminRoles "ROLE_ID_1,ROLE_ID_2"
setr txAdmin-discordAdminPermissions "admin"
set txAdmin-menuActionWebhook "https://discord.com/api/webhooks/YOUR_WEBHOOK"

DANGER

استخدم set (وليس setr) للتوكن والويب هوك، حتى لا يصلا إلى اللاعبين أبدًا.

6. إنشاء رتب بصلاحيات

لمستويات إدارة مختلفة، أنشئ رتبًا في لوحة الويب:

1. اذهب إلى Settings ← Discord ← Discord Auth Roles.
2. أضف رتبة، والصق معرّف رتبة الديسكورد، وحدد صلاحياتها.
3. فعّل Discord Role Web Auth وأدخل معرّف السيرفر.

اللاعبون بدون رتبة ديسكورد مطابقة لا يستطيعون فتح القائمة داخل اللعبة.

ويمكنك أيضًا إعطاء هذه الرتب لحسابات txAdmin الموجودة من Admins ← Edit Admin ← Roles.

رتب الحظر والتحذيرات

أعطِ اللاعبين المحظورين رتبة في الديسكورد تبقى طوال مدة الحظر:

set txAdmin-banRole "YOUR_BANNED_ROLE_ID"

• أثناء الحظر، تُسحب رتب الوايت ليست من العضو.
• تُسحب الرتبة فقط عند انتهاء الحظر أو فكّه.
• الخروج من الديسكورد والرجوع لا يزيلها.

التحذيرات تستخدم ثلاث رتب (خانات Settings ← Discord ← Ban Strike)، أو هذه الـ convars:

set txAdmin-warnRole1 "ROLE_ID"
set txAdmin-warnRole2 "ROLE_ID"
set txAdmin-warnRole3 "ROLE_ID"

أول تحذير نشط يعطي Strike 1، والثاني Strike 2، وثلاثة أو أكثر تعطي Strike 3.