الإحالات
روابط دعوة شخصية، ومن دعا من، ومؤقت للبقاء يمنع الدعوة ثم المغادرة، ورتب مكافآت عند عدد معيّن من الإحالات.
كيف يعمل
لا يخبر Discord بالدعوة التي استخدمها العضو، لذلك يحتفظ البوت بعدد استخدامات كل دعوة، وعند انضمام أحد يُنسب الانضمام إلى الدعوة التي زاد عدادها. ينشئ الأمر /referrals link دعوة شخصية يصنعها البوت للعضو الذي يشغّله، فتُنسب انضماماته إليه دون المساس بنافذة الدعوات في Discord.
يُعلَن عن كل إحالة: Embed في قناة سجلات، أو تذكرة خاصة للفريق تحتوي زري «Approve» و«Reject». وعندما يصل العضو إلى حدّ المكافأة يحصل على الرتبة تلقائيًا.
الإعداد
- /referrals setup enabled:true
- يفعّل التتبع. الخيارات: mode (log أو ticket)، وlog_channel، وticket_category، وstaff_role، وhold، وhold_hours (من 1 إلى 720)، وmin_account_age (من 0 إلى 365 يومًا).
- /referrals reward-add count:<n> role:@role
- يمنح رتبة مرة واحدة عندما يصل أحد إلى n من الإحالات المحتسبة. أضِف عدة رتب للمستويات؛ والأمر /referrals reward-remove count:<n> يحذف إحداها.
- /referrals settings
- الإعداد الحالي والإجمالي المحتسب حتى الآن.
- صفحة الإحالات (لوحة التحكم)
- المجتمع → الإحالات: الإعدادات نفسها في نموذج، مع مستويات المكافآت.
أوامر الأعضاء
- /referrals link
- رابط دعوتك الشخصي لهذا السيرفر.
- /referrals me
- عدد الأشخاص الذين جلبتهم، وعدد من ما زالوا ينتظرون مؤقت البقاء.
- /referrals top
- الأعضاء الأكثر إحالات.
- /referrals user member:@someone
- للفريق فقط: الإجمالي لعضو واحد.
ما الذي لا يُحتسب
- إعادة الانضمام
- إحالة واحدة لكل عضو في كل سيرفر، إلى الأبد. المغادرة والانضمام عبر رابط آخر لا يُحتسبان مرة أخرى.
- الدعوات الذاتية والبوتات
- لا يُحتسب أبدًا.
- الحسابات الحديثة
- تُرفض الحسابات الأصغر من min_account_age يومًا.
- الدعوة ثم المغادرة
- عند تفعيل hold تنتظر الإحالة مدة hold_hours، ولا تُحتسب إلا إذا كان العضو لا يزال في السيرفر.
يحتاج البوت صلاحية إدارة السيرفر (Manage Server) لقراءة الدعوات. بدونها لا تُنسب الانضمامات، ولا يتعطّل شيء آخر. وانضمامات الروابط المخصصة (Vanity URL) لا تُربط بعضو.