ZMN Bot التوثيق

وُجدت وحدة إدارة الرتب لتسهيل مهمة واحدة: منح الرتب وسحبها. تجمع الرتب التي تريد إدارتها في لوحة، وتحدّد من يُسمح له بالتعامل مع تلك اللوحة، ثم يتولى فريقك الباقي من ديسكورد عبر /roles. لا يُنشر أي شيء في سيرفرك — هذه الوحدة تعمل بالأوامر من أولها إلى آخرها.

1. فعّل الوحدة واختر قناة سجلات عامة.
2. أضف رتب المشرفين التي ينبغي أن تستخدم كل اللوحات.
3. أنشئ لوحة، وسمّها، وضع فيها الرتب التي يُسمح لها بمنحها.
4. اختياريًا: امنح اللوحة رتب مشرفين خاصة بها وقناة سجلات خاصة بها.

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

/roles give <panel> <user> <roles...>
/roles remove <panel> <user> <roles...>
/roles giveall <panel> <voice channel> <roles...>
/roles removeall <panel> <voice channel> <roles...>
/roles cancel

مع تحديد بادئة، يعمل الأمر نفسه كنص. ويمكن كتابة أسماء اللوحات متعددة الكلمات بدون مسافات:

.roles give teamalpha @Someone @Moderator @Helper

يستهدف giveall و removeall قناة صوتية دائمًا — لا يوجد خيار يشمل السيرفر كله، وهو ما يبقي كل عملية محدودة ومتوقّعة.

• تُؤخذ قائمة الأعضاء لحظة بدء العملية، فمن ينضم أثناءها لا يُشمل.
• يُتخطّى الأعضاء الذين يمتلكون الرتب مسبقًا دون أي طلب إلى ديسكورد.
• تتحدّث رسالة التقدّم كل بضع ثوانٍ بعدّاد ووقت متبقٍ وزر إلغاء.
• تعمل عملية جماعية واحدة فقط لكل سيرفر في الوقت نفسه. استخدم /roles cancel إذا اختفت رسالة التقدّم.