ZMN Bot Logo
    التوثيق

    ZMN Bot التوثيق

    أدلة الإعداد ومرجع الضبط لكل وحدات زمن — الحماية، الإشراف، الأدوار، المستويات، والتحكم بالوصول.

    تنقل سريع

    الأساسيات
    الوحدات

    نظام المستويات

    نظام مستويات مبني على XP مع مسارين مزدوجين، مكافآت قابلة للتخصيص، وبطاقات رتب

    نظرة عامة

    وحدة نظام المستويات في ZMN Bot تفاعل مجتمعك من خلال نظام XP والمستويات. يكسب الأعضاء XP من خلال مسارين مستقلين — نصي وصوتي — ويمكنهم فتح مكافآت الرتب مع ارتفاع مستواهم. يدعم النظام بطاقات الرتب القابلة للتخصيص، إعلانات المستويات، وإعدادات دقيقة لمعدلات XP.

    ما هو متضمن

    • • مسارات XP مزدوجة — XP نصي وصوتي يتتبعان بشكل مستقل
    • • 4 أوامر مستويات — رتب، لوحة المتصدرين، إعطاء XP، إزالة XP
    • • رتب المكافآت — تعيين رتب تلقائي عند ارتفاع المستوى مع إدارة الرتب
    • • إعلانات المستويات — 4 أوضاع إعلان مع متغيرات القوالب
    • • بطاقات رتب مخصصة — لون مميز قابل للتخصيص، تراكب، وخلفية صورة
    • • مضاعفات XP — مضاعفات عالمية وبالرتب للنص والصوت

    نظام XP

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

    XP النصي

    يكسب الأعضاء XP نصي بإرسال الرسائل في قنوات السيرفر. يستخدم النظام فترة انتظار لمنع استغلال الرسائل المزعجة لكسب XP.

    • • XP أساسي: 1–3 لكل رسالة (عشوائي)
    • • فترة الانتظار: 3 ثوانٍ بين مكاسب XP
    • • مضاعف الرتبة: مضاعف XP إضافي لرتب محددة
    • • يتتبع: XP نصي، مستوى نصي، وعدد الرسائل

    XP الصوتي

    يكسب الأعضاء XP صوتي بقضاء الوقت في القنوات الصوتية. يتطلب النظام عضوين مؤهلين على الأقل في القناة لمنع كسب XP بالخمول.

    • • XP أساسي: 1–3 لكل فترة 10 ثوانٍ (عشوائي)
    • • المتطلب: ≥2 أعضاء غير مكتومين وغير بوت في القناة
    • • قنوات AFK والأعضاء المكتومون مستبعدون
    • • مضاعف الرتبة: مضاعف XP إضافي لرتب محددة
    • • يتتبع: XP صوتي، مستوى صوتي، ودقائق الصوت
    كلا XP النصي والصوتي يساهمان في مجموع XP المستخدم للوحة المتصدرين. إجمالي XP = XP نصي + XP صوتي.

    معادلة المستوى

    XP المطلوب للانتقال من المستوى N إلى المستوى N+1 يتبع معادلة تربيعية تتدرج تدريجياً:

    XP للمستوى التالي = 5L² + 50L + 100حيث L هو المستوى الحالي
    عند المستوى 4468، تصل المعادلة إلى ~100 مليون XP لكل مستوى. بعد ذلك، يتم تحديد XP لكل مستوى بـ 100,000,000.
    الحد الأقصى للمستوى: 9,999

    أمثلة على عتبات المستوى

    0 → 1100 XP
    1 → 2155 XP
    5 → 6425 XP
    10 → 111,100 XP
    25 → 264,350 XP
    50 → 5115,350 XP
    يتم حساب المستوى من إجمالي XP باستخدام البحث الثنائي — 14 تكرار على الأكثر للمستويات 0–9999. هذا يعني حتى لو أضفت XP يدوياً، المستوى يكون دائماً متسقاً.

    أوامر المستويات

    جميع أوامر المستويات مجمعة تحت أمر /levels المائل. الأوامر الإدارية تتطلب صلاحية إدارة السيرفر.

    أوامر المستخدم

    /levels rankSlash Command

    عرض بطاقة رتبتك أو رتبة مستخدم آخر

    Usage: /levels rank [user]
    /levels leaderboardSlash Command

    عرض لوحة متصدرين السيرفر

    Usage: /levels leaderboard [type] [page]
    الأنواع: إجمالي (افتراضي)، نصي، صوتي

    أوامر المسؤولين

    /levels give-xpSlash Command

    إعطاء XP لمستخدم

    Usage: /levels give-xp <user> <amount> <type>
    يتطلب صلاحية إدارة السيرفر
    /levels remove-xpSlash Command

    إزالة XP من مستخدم

    Usage: /levels remove-xp <user> <amount> <type>
    يتطلب صلاحية إدارة السيرفر
    أنواع XP: نصي، صوتي

    إعلانات المستويات

    عند ارتفاع مستوى عضو، يمكن للبوت إرسال إعلان. اختر من 4 أوضاع إعلان:

    معطل

    لا يتم إرسال إعلان عند ارتفاع مستوى عضو.

    القناة الحالية

    يرسل الإعلان في نفس القناة حيث أرسل المستخدم الرسالة التي تسببت في ارتفاع المستوى. ينطبق فقط على XP النصي.

    رسالة خاصة

    يرسل الإعلان كرسالة مباشرة للعضو الذي ارتفع مستواه.

    قناة مخصصة

    يرسل الإعلان إلى قناة محددة تم تكوينها.

    متغيرات القالب

    استخدم هذه المتغيرات في رسالة ارتفاع المستوى. كلا التنسيقين [var] و {var} مدعومان.

    [user][user] — يذكر المستخدم
    [user.username][user.username] — يعرض اسم المستخدم بدون ذكر
    [level][level] — يعرض المستوى الجديد
    [oldlevel][oldlevel] — يعرض المستوى السابق
    template
    🎉 Congratulations {user}! You've reached level {level}!
    وضع القناة الحالية يعمل فقط لـ XP النصي لأن XP الصوتي لا يملك سياق قناة نصية محددة.

    رتب المكافآت

    تكوين رتب مكافآت يتم تعيينها تلقائياً عند وصول عضو إلى مستوى محدد. يمكن تعيين المكافآت لكل من المستويات النصية والصوتية بشكل مستقل.

    كيف يعمل

    1

    يصل العضو إلى مستوى مكافأة مكوّن

    2

    يقوم البوت بتعيين الرتبة المكوّنة للعضو

    3

    إذا تم تفعيل 'إزالة مع المكافأة الأعلى'، تتم إزالة رتب المكافآت الأقل

    4

    إذا تم تفعيل 'رسالة خاصة للعضو'، يتلقى العضو رسالة تهنئة مباشرة

    إزالة مع المكافأة الأعلى

    عند التفعيل، الوصول إلى مستوى مكافأة أعلى يزيل جميع رتب المكافآت الأقل. هذا ينشئ نظام رتب تقدمي حيث يحمل الأعضاء فقط أعلى رتبة مكتسبة.

    رسالة خاصة للعضو

    عند التفعيل، يرسل البوت رسالة مباشرة للعضو عند تلقيه رتبة مكافأة. تتضمن الرسالة اسم الرتبة والمستوى الذي تم الوصول إليه.

    المكافآت الفورية (المستوى 0)

    تعيين مكافأة عند المستوى 0 يمنح الرتبة فوراً عندما يكسب عضو أول XP له. هذا مفيد لإعطاء رتبة 'موثق' أو 'نشط' بمجرد بدء شخص ما بالمشاركة.

    يجب أن يملك البوت صلاحية إدارة الرتب وأن تكون رتبته الأعلى فوق رتب المكافآت في التسلسل الهرمي للسيرفر.

    بطاقة الرتبة

    أمر /levels rank ينشئ صورة بطاقة رتبة مرئية تعرض مستوى العضو، تقدم XP، وموضع الرتبة. البطاقة قابلة للتخصيص بالكامل.

    خيارات التخصيص

    اللون المميز — لون شريط التقدم ونص المستوى

    شفافية التراكب — تتحكم في ظلمة تراكب الخلفية (0–100%)

    خلفية مخصصة — رفع صورة مخصصة كخلفية لبطاقة الرتبة

    إذا فشلت صورة بطاقة الرتبة في الإنشاء، يتراجع البوت إلى استجابة نصية تعرض رتبة العضو ومستواه وXP.

    التكوين

    إعدادات عامة

    مفعّل

    toggle

    تفعيل أو تعطيل نظام المستويات

    إعلان ارتفاع المستوى

    select

    اختر كيف وأين يتم إرسال رسائل ارتفاع المستوى

    قناة ارتفاع المستوى

    channel

    قناة لإعلانات ارتفاع المستوى (عند استخدام وضع القناة المخصصة)

    رسالة ارتفاع المستوى

    text

    قالب رسالة مخصص مع متغيرات ديناميكية

    رتب مستثناة

    roles

    الأعضاء بهذه الرتب لن يكسبوا أي XP

    قنوات مستثناة

    channels

    لن يتم كسب XP في هذه القنوات

    إعدادات معدل XP

    مضاعف XP النصي

    number

    مضاعف عالمي لكسب XP النصي (افتراضي: 1.0)

    مضاعف XP النصي بالرتب

    roles

    مضاعف إضافي للأعضاء برتب محددة في القنوات النصية

    مضاعف XP الصوتي

    number

    مضاعف عالمي لكسب XP الصوتي (افتراضي: 1.0)

    مضاعف XP الصوتي بالرتب

    roles

    مضاعف إضافي للأعضاء برتب محددة في القنوات الصوتية

    إعدادات بطاقة الرتبة

    اللون المميز

    color

    لون شريط التقدم ونص المستوى على بطاقة الرتبة

    شفافية التراكب

    number

    تتحكم في ظلمة تراكب خلفية بطاقة الرتبة

    خلفية مخصصة

    image

    رفع صورة مخصصة كخلفية لبطاقة الرتبة

    إعدادات المكافآت

    المستوى النصي

    number

    المستوى النصي الذي تُمنح عنده هذه المكافأة

    المستوى الصوتي

    number

    المستوى الصوتي الذي تُمنح عنده هذه المكافأة

    رتبة المكافأة

    role

    الرتبة الممنوحة عند وصول العضو للمستوى المحدد

    إزالة مع الأعلى

    toggle

    إزالة رتب المكافآت الأقل عند الوصول لرتبة أعلى

    رسالة خاصة للعضو

    toggle

    إرسال رسالة مباشرة للعضو عند تلقيه رتبة مكافأة

    أفضل الممارسات

    ✓ الإعداد الموصى به

    • • ابدأ بمعدلات XP الافتراضية (1.0x) وعدّل بناءً على نشاط مجتمعك
    • • استخدم القنوات المستثناة لأوامر البوت والرسائل المزعجة لمنع استغلال XP
    • • قم بإعداد رتب مكافآت تقدمية مع 'إزالة مع الأعلى' لنظام رتب نظيف
    • • فعّل إعلانات ارتفاع المستوى في قناة مخصصة للاحتفال بالإنجازات
    • • استخدم مضاعفات XP بالرتب لمكافأة المعززين أو الأعضاء المميزين
    • • قم بتعيين مكافآت فورية عند المستوى 0 لإعطاء الأعضاء الجدد رتبة عند أول نشاط

    ✗ أخطاء شائعة

    • • تعيين مضاعفات XP عالية جداً (الأعضاء يصلون للحد الأقصى بسرعة، يفقدون التفاعل)
    • • عدم تجاهل قنوات أوامر البوت (الأعضاء يكسبون XP بتشغيل الأوامر)
    • • إنشاء الكثير من مستويات المكافآت عند مستويات منخفضة (فوضى الرتب)
    • • نسيان وضع رتبة البوت فوق رتب المكافآت (تعيين الرتبة يفشل بصمت)
    • • استخدام XP الصوتي بدون متطلب العضوين (استغلال الخمول الفردي)
    • • عدم اختبار رسائل ارتفاع المستوى مع المتغيرات قبل تفعيل الإعلانات
    متطلب رتبة البوت: يحتاج البوت صلاحية إدارة الرتب لتعيين رتب المكافآت. يجب أن تكون رتبة البوت الأعلى فوق جميع رتب المكافآت في التسلسل الهرمي للسيرفر.