LibertyBans

جدول المحتويات

• مقدمة
  • تصميم
  • سمات
• معلومات أساسية
• واجهة برمجة تطبيقات المطور

مقدمة

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

تصميم

• فعالة وخفيفة الوزن. لا يوجد تركيب معقد ويتجنب الميزات غير الضرورية.
• خيار استخدام قاعدة البيانات المحلية المستندة إلى الملفات (HyperSQL)، أو قاعدة البيانات البعيدة (MariaDB، MySQL، PostgreSQL).
• أداء محسّن موجه نحو قاعدة البيانات مع التركيز على العمليات الحسابية في SQL. انخفاض استخدام الذاكرة لأنه يتم تخزين العقوبات بشكل كامل تقريبًا في قاعدة البيانات. يتم تخزين البيانات في شكل بسيط كبايتات أولية بدلاً من السلاسل.
• يتم اتباع أفضل الممارسات للحسابات غير المتزامنة. يتم فهم تكلفة أداء تبديل السياق وتجنبها؛ لا يقوم البرنامج المساعد بإطلاق المهام غير المتزامنة بشكل أعمى.
• مصممة للتوافر العالي والتزامن. يتم استخدام الحد الأدنى من القفل مع الحفاظ على اتساق الحالة؛ يتم تحقيق ذلك في الغالب من خلال حقيقة أن معظم حالات البرنامج المساعد يتم الحفاظ عليها في قاعدة البيانات نفسها.
• توفر واجهة برمجة التطبيقات (API) جيدة التنظيم إطار عمل للمكونات الإضافية الأخرى للعمل مع البرنامج الإضافي.

سمات

• إضافة وإزالة العقوبات:
  • /ban، /ipban، /unban، /unbanip - يحظر أو يرفع الحظر عن لاعب أو عنوان IP
  • /mute، /ipmute، /unmute، /unmuteip - لكتم صوت المشغل أو عنوان IP أو إلغاء كتمه
  • /warn، /ipwarn، /unwarn، /unwarnip - يحذر أو لا يحذر اللاعب أو عنوان IP
  • /kick، /ipkick - يركل اللاعب أو عنوان IP
• الإصدارات المؤقتة للحظر والكتم والتحذير
• يتم تخزين كافة بيانات اللاعب باستخدام UUIDs. هذا ليس مكونًا إضافيًا سخيفًا يقوم بتخزين البيانات حسب اسم اللاعب.
• قائمة العقوبات:
  • /banlist - يعرض جميع حالات الحظر
  • /mutelist - يظهر كافة كتم الصوت
  • /history - يظهر كافة العقوبات للاعب
  • /warns - يعرض كافة التحذيرات الخاصة باللاعب
  • / إلقاء اللوم - يعرض كافة العقوبات التي فرضها الموظف
• وسائل متعددة لحظر الحسابات البديلة:
  • التنفيذ التلقائي لحظر الحسابات البديلة. افتراضيًا، عند استخدام حظر IP، يتم حظر alts تلقائيًا من الانضمام إذا تم حظر الحساب الرئيسي. هذا السلوك قابل للتكوين، ويمكنك حتى زيادة صرامة التحقق من البديل.
  • الأمر اليدوي /alts - يعرض الحسابات البديلة المشتبه بها للاعب.
  • إشعار Alts عند الانضمام - يخبر أعضاء فريق العمل عندما يتم حظر أو كتم صوت اللاعب الذي يشتبه في بديله.
• الإعفاء. على سبيل المثال، لا يمكن للمتدربين حظر المسؤولين؛ لا يمكن للمسؤولين حظر المالكين.
• الخيارات والسلوك قابلة للتكوين بالكامل. يمكنك أيضًا تعديل إعدادات تجمع الاتصال وذاكرة التخزين المؤقت للبيانات لتحسين الأداء.
• دعم كامل للوكيل المتعدد ومتعدد المثيلات. يمكنك وضع LibertyBans على الوكيل إذا كنت تستخدم وكيلًا واحدًا، أو على خوادم خلفية متعددة.
• يتم تنزيل جميع التبعيات تلقائيًا باستخدام تجزئة SHA-512 الآمنة المستخدمة للتحقق من صحة التنزيلات. بالإضافة إلى ذلك، يمكن إعادة إنتاج إصدارات LibertyBans من الكود المصدري، مما يعني أنه يمكن التحقق من المجاميع الاختبارية شخصيًا.

معلومات أساسية

متطلبات

• جافا 17

المنصات المدعومة:

• حنفية / ورق (+ورقة)
• بنجيكورد / الشلال
• اسفنجة
• سرعة

التوافق مع أسماء مستخدمي Geyser/Floodgate.

تثبيت

ستعمل LibertyBans خارج الصندوق بالنسبة لمعظم المستخدمين.

• عند استخدام وكيل واحد، يوصى، ولكن ليس مطلوبًا، بتثبيت LibertyBans على الوكيل نفسه.
• يمكن أيضًا تثبيت LibertyBans على خوادم الواجهة الخلفية إذا كنت ترغب في تكوين مزامنة متعددة المثيلات.

للتثبيت على خوادم الواجهة الخلفية ومزامنة العقوبات، راجع wiki للحصول على معلومات إضافية.

واجهة برمجة تطبيقات المطور

واجهة برمجة تطبيقات المطور واسعة النطاق. لا توصي LibertyBans المطورين بالعبث بقاعدة البيانات كملاذ أول. مزيد من المعلومات هنا

رخصة

تم ترخيص LibertyBans بموجب GNU AGPL v3. راجع ملف الترخيص لمزيد من المعلومات.