رتب التفاعل

لوحة رتب التفاعل رسالة يستخدمها الأعضاء ليمنحوا أنفسهم رتبًا. وكل رتبة على اللوحة تُعرض بطريقة واحدة: زرًّا، أو خيارًا في قائمة الاختيار الخاصة باللوحة، أو تفاعلًا بإيموجي. ويمكن للوحة واحدة أن تجمع الطرق الثلاث. تُبنى اللوحات من صفحة رتب التفاعل في لوحة التحكم أو بالأمر ‎/reactionrole، وكلاهما يعدّل اللوحات نفسها. ويستطيع Epix AI أيضًا إنشاء اللوحات، وإضافة الرتب إليها وإزالتها منها، ونشرها.

#إعداد لوحة

1. 01
   أنشئ اللوحة

   استخدم ‎/reactionrole create name [mode] [title] [description]. الاسم — حتى 100 حرف، وفريد داخل سيرفرك — هو ما تعتمد عليه بقية الأوامر الفرعية للوصول إلى اللوحة؛ ومطابقته لا تفرّق بين الأحرف الكبيرة والصغيرة، ويُكمَل تلقائيًا أثناء الكتابة. أما العنوان والوصف فيصبحان الـEmbed الخاص باللوحة.

2. 02
   أضِف الرتب

   استخدم ‎/reactionrole addbutton أو addoption أو addreaction، مرة لكل رتبة. كلٌّ منها يأخذ اللوحة والرتبة، إضافةً إلى خيارات تحدد شكلها وسلوكها.

3. 03
   انشرها

   الأمر ‎/reactionrole send panel [channel] ينشرها، في القناة الحالية إن لم تحدد قناة. وإرسال لوحة منشورة بالفعل ينقلها: تُنشر النسخة الجديدة وتُحذف القديمة.

4. 04
   عدّل متى شئت

   إضافة رتبة إلى لوحة منشورة أو إزالتها منها تحدّث الرسالة المنشورة في مكانها، وتُضاف إليها إيموجيات التفاعل الجديدة. لا حاجة إلى إرسالها مجددًا.

/reactionrole create name:Notifications mode:add
/reactionrole addbutton panel:Notifications role:@Events style:SUCCESS
/reactionrole addoption panel:Notifications role:@Streams description:Stream alerts
/reactionrole send panel:Notifications channel:#roles

الأمر ‎/reactionrole removerole panel role يزيل رتبة من لوحة، و ‎/reactionrole list يعرض كل لوحات السيرفر، و ‎/reactionrole info panel يعرض إعدادات لوحة واحدة، و ‎/reactionrole delete panel يحذفها. وكل الأوامر الفرعية للأمر ‎/reactionrole تحتاج صلاحية Manage Roles.

#ثلاث طرق لعرض رتبة

الإيموجي يمكن أن يكون إيموجي Unicode، أو إيموجي مخصصًا، أو رمز ثيم مثل ‎#[status.success]. ورمز الثيم يتبع ثيم سيرفرك، فتغيير الثيم يغيّر الإيموجي في كل لوحة تستخدمه.

#الأوضاع

وضع اللوحة قيمة افتراضية، ويمكن لأي رتبة عليها أن تحدد وضعها الخاص بدلًا منه. وهذا يتيح للوحة واحدة أن تعرض ثلاث رتب اختيارية وزرًّا منفصلًا للإزالة فقط. والأمر ‎/reactionrole mode panel mode يغيّر الوضع الافتراضي للوحة: الرتب التي تتبع الافتراضي تتغير معه، والرتب ذات الوضع الخاص تحتفظ به.

التفاعلات تتبع الاتجاه

مع التفاعلات، يتبع وضع «إضافة / إزالة» التفاعلَ نفسه: إضافة التفاعل تمنح الرتبة، وإزالته تنزعها. أما في «إضافة فقط» و«إزالة فقط»، فإزالة التفاعل لا تغيّر شيئًا أبدًا، ويزيل البوت تفاعل العضو بعد التنفيذ حتى يظل الإيموجي يعمل كزر. وهذا التنظيف يحتاج صلاحية Manage Messages؛ وبدونها تظل اللوحة تعمل، وكل ما يحدث أن العدد على الإيموجي يزداد.

خيار إعادة الضبط

ديسكورد يُبقي آخر خيار اختاره العضو ظاهرًا في قائمة الاختيار، فيبدو اختيار الرتبة نفسها مجددًا وكأنه معطّل. الأمر ‎/reactionrole reset panel enabled [label] يضيف خيارًا (اسمه «Reset selection» ما لم تسمّه أنت) يمسح القائمة دون أن يمسّ أي رتبة، فيتصرف الاختيار التالي كأنه الأول. ولا ينطبق إلا على اللوحات التي فيها خيارات قائمة.

#سلوك اللوحة

هذه الإعدادات الخاصة بكل لوحة موجودة في لوحة التحكم، بجانب نص كل رتبة وإيموجيها ولونها ووضعها ومدتها.

#رتب محددة المدة (Premium)

مع Premium، يمكن لأي رتبة على اللوحة أن تُنزع تلقائيًا. حدّد مدة بين دقيقة واحدة و90 يومًا. وفي الأمر، اكتبها بصيغة مثل 30m أو 2h أو 1d12h أو 1w؛ والرقم المجرد يعني دقائق، وأي قيمة خارج النطاق تُرفض ولا تُقرَّب. وتعرض لوحة التحكم مددًا جاهزة.

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

#أي الرتب يمكن عرضها

• يجب أن تكون الرتبة أدنى من أعلى رتبة للبوت، وأن يملك البوت صلاحية Manage Roles.
• حين تضيف رتبة بأمر، يجب أن تكون أيضًا أدنى من أعلى رتبة لديك أنت، فلا يستطيع أحد بناء زر يمنحه أكثر مما يملكه أصلًا.
• الرتب التي تحمل Administrator أو Manage Server أو Manage Roles أو Manage Webhooks لا يمكن أن يمنحها العضو لنفسه أبدًا، وكذلك ‎@everyone وأي رتبة يديرها تكامل أو تعزيز Nitro. ويُعاد هذا الفحص عند كل نقرة، فالرتبة التي تكتسب إحدى هذه الصلاحيات لاحقًا تتوقف عن المنح.

#إعدادات على مستوى السيرفر

شغّل ‎/reactionrole settings دون أي خيارات لترى الإعدادات الحالية وحدود خطتك.

#المجاني و Premium

اللوحات تُحتسب سواء نُشرت أم لا، والرتب تُحتسب عبر الأزرار وخيارات القوائم والتفاعلات مجتمعة.

#ماذا يحدث حين

• تُحذف رتبة من السيرفر: تُزال من كل لوحة، وتتحدث اللوحات المنشورة فيختفي زرها أو خيارها.
• تُحذف رسالة اللوحة: تحتفظ اللوحة بكل إعداداتها. انشرها مجددًا بالأمر ‎/reactionrole send.
• تحذف أنت لوحة: تُحذف رسالتها المنشورة أيضًا. ويحتفظ الأعضاء بالرتب التي حصلوا عليها، والرتب محددة المدة التي منحتها تظل تنتهي في موعدها.
• تُرفض نقرة (الرتبة أعلى مما ينبغي، أو فترة الانتظار سارية، أو اللوحة مطفأة): الأزرار وخيارات القوائم ترد على العضو. أما التفاعلات فلا يمكن الرد عليها، فيرسل البوت رسالة خاصة بدلًا من ذلك، إلا إذا كانت اللوحة مضبوطة على عدم الرد.

#حل المشكلات

• «هذه الرتبة أعلى من أعلى رتبة لديّ»: اسحب رتبة البوت فوقها في إعدادات السيرفر، ثم حاول مجددًا.
• «هذه الرتبة تحمل صلاحيات إدارية»: استخدم رتبة لا تحمل Administrator أو Manage Server أو Manage Roles أو Manage Webhooks.
• العدد على التفاعل يواصل الزيادة: هذا متوقع في وضع «إضافة / إزالة»، لأن تفاعل كل عضو هو حالته. وفي الأوضاع الأخرى، امنح البوت صلاحية Manage Messages.
• «وصل هذا السيرفر إلى حده الأقصى: 3 لوحات رتب»: احذف لوحة لم تعد تستخدمها، أو رقِّ إلى Premium لتحصل على 50.