إضافة Minecraft TitleManager

🔌 حول TitleManager

TitleManager هو إضافة Minecraft تدير عناصر العرض التي يراها اللاعب: العناوين الوسطية المتحركة والعناوين الفرعية، وactionbar، وترويسة وتذييل قائمة التبويب المتحركين، وكذلك scoreboard جانبي قابل للتخصيص. يعمل كطبقة عرض للخوادم التي تريد رسائل دخول وإعلانات وعروض tab/scoreboard أكثر أناقة.

🎯 الهدف

تجمع الإضافة ميزات العرض (titles، actionbar، tab-list، sidebars) في مكان واحد حتى يتمكن مالكو الخوادم من تقديم معلومات متسقة ومتحركة ومبنية على placeholders للاعبين بدون برمجة مخصصة. وهي موجهة لمسؤولي الخوادم الذين يريدون إدارة رسائل join/welcome، والإعلانات الدورية، وواجهة TAB/scoreboard ديناميكية.

⚙️ المميزات

• عناوين join وfirst join وactionbar قابلة للتخصيص مع خيارات توقيت ونسخ مختلفة.
• ترويسة وتذييل tab-list متحركان ويدعمان gradient مع placeholders لعدد المتصلين ووقت العالم/الخادم وقيم ديناميكية أخرى.
• scoreboard جانبي قابل للتخصيص حتى 15 سطرًا متحركًا مدعومًا بنظام scoreboard الخاص بالخادم.
• بث وإعلانات مجدولة تُرسل كـ titles أو actionbar.
• محرك رسوم متحركة مع ملفات قابلة لإعادة الاستخدام ومعاينات للحركة (animation playground متاح في الوثائق الرسمية).
• تكامل placeholders (placeholders المدمجة في TitleManager ودعم أنظمة placeholders الخارجية عند توفرها).
• عمليات reload معاملاتية: يتم تطبيق إعادة تحميل الإعدادات بأمان ويمكن التراجع عنها إذا كان الإعداد الجديد غير صالح.
• API صغيرة موجهة للمطورين لعمليات التكامل الاختيارية واستخدام الإضافة مع إضافات أخرى.

🧩 لمن هذه الإضافة

• خوادم Survival وSMP التي تريد واجهة join/announcement أكثر أناقة.
• الخوادم التي تستخدم placeholders وتكاملات خارجية (للقيم الديناميكية في العرض).
• المسؤولون الذين يحتاجون إلى عروض tab وscoreboard متحركة بدون كتابة إضافات مخصصة.
• المطورون الذين يريدون دمج ميزات العرض في إضافات أخرى عبر API المتوفرة.

🏗️ حالات استخدام مثال

• عرض title ترحيبي وactionbar متحرك عند دخول اللاعبين، مع رسالة مختلفة عند first join.
• إبقاء قائمة اللاعبين في tab نشطة من خلال إظهار وقت الخادم وعدد اللاعبين المتصلين وترويسات/تذييلات gradient.
• تدوير titles أو actionbar للإعلانات المتحركة وفق جدول زمني للتواصل حول الأحداث أو القواعد.
• استخدام sidebar scoreboard لعرض لوحات المتصدرين أو الإحصاءات أو معلومات الخادم الديناميكية.

⌨️ الأوامر

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

⚙️ التثبيت

📥 الإعداد

• حمّل ملف JAR الخاص بالإضافة من إصدار المشروع أو صفحة resource الخاصة بالإضافة.
• ضع ملف JAR في مجلد plugins/ على الخادم.
• أعد تشغيل الخادم.
• عدّل ملفات الإعداد التي تم إنشاؤها في plugins/TitleManager/ لضبط العناوين والرسوم المتحركة وإعدادات قائمة اللاعبين.
• استخدم /tm reload لتطبيق تغييرات الإعدادات؛ فالإضافة تنفذ reload معاملاتية لتجنب تطبيق إعدادات تالفة.

📦 الاعتماديات

• PlaceholderAPI (تكامل اختياري مع placeholders الخارجية).
• Vault (اختياري، يُستخدم لقيم placeholders عند توفره).
• BungeeCord (سلوك مراعي للتكامل عند الاستخدام في إعدادات proxy).

هذه التكاملات اختيارية وتُستخدم عند توفرها؛ تعمل الإضافة بدونها لكنها تستطيع استخدام بياناتها عند وجودها.

🧠 ملاحظات تقنية

• تشمل أهداف runtime الرسمية Minecraft 1.8 حتى 1.21.x (تشير مواد المشروع إلى دعم صريح حتى 1.21.11). يختلف السلوك حسب إصدار الخادم: الإصدارات الأحدث من Minecraft تستخدم واجهات Bukkit/Paper الحديثة، بينما تعتمد الإصدارات القديمة على وحدات توافق خاصة بكل إصدار.
• ينشر TitleManager API صغيرة موجهة إلى Bukkit للتكاملات الاختيارية ويوفر توثيق API مولّدًا تلقائيًا.
• توجد أوامر safe reload وdiagnostics للمساعدة في استكشاف مشاكل الإعداد وruntime.

🤝 متى تكون هذه الإضافة مفيدة

إذا كنت تريد تحكمًا مركزيًا ومتحركًا وقائمًا على placeholders في عناصر العرض (titles، actionbar، tab-list، وsidebars) يُدار من الإعدادات بدلًا من كتابة كود مخصص، فإن TitleManager يوفر إضافة وAPI موثقتين لتقديم عناصر الواجهة هذه بشكل متسق عبر بيئة الخادم لديك.