إضافة Minecraft UltraCosmetics

🔌 حول UltraCosmetics

UltraCosmetics هو إضافة Minecraft لـ Spigot/Paper تضيف مجموعة واسعة من الزينة البصرية والمؤثرات المرئية إلى الخادم. يوفّر قائمة تعتمد على GUI وأنظمة للحيوانات الأليفة، والركوبات، والأدوات، وتأثيرات الجزيئات، وتأثيرات المقذوفات، وتأثيرات الموت، والإيماءات، والقبعات، والتحولات، والبدلات، وصناديق الكنوز. المشروع مفتوح المصدر وتتم صيانته على GitHub.

🎯 الهدف

تم تصميم UltraCosmetics ليمنح مالكي الخوادم نظام زينة معياريًا يتيح للاعبين الوصول إلى العناصر والتأثيرات التجميلية وتجهيزها عبر قائمة داخل اللعبة. وهو يحل الحاجة إلى تخصيص تجميلي لا يؤثر في أسلوب اللعب ومحتوى تجميلي قابل لتحقيق الدخل، مع إبقاء الوظائف منفصلة عن آليات اللعب الأساسية.

⚙️ الميزات

• قائمة GUI لتصفح الزينة وتجهيزها.
• فئات زينة تشمل Pets وMounts وGadgets وHats وParticle Effects وProjectile Effects وDeath Effects وEmotes وMorphs وSuits.
• وظيفة treasure chest لمنح فتحات تجميلية.
• تخزين قابل للضبط للزينة المفتوحة (ملفات بيانات اللاعب أو SQL backend كما يدعمه المشروع).
• دعم الترجمة (تُدار عدة لغات عبر المشروع).

🧩 لمن هذا مناسب

لمالكي الخوادم والمديرين الذين يرغبون في إضافة محتوى تجميلي إلى خوادم Spigot أو Paper الخاصة بهم: خوادم minigame/lobby العامة، وشبكات SMP التي تقدم متاجر زينة، وأي خادم يريد تخصيصًا تجميليًا ظاهرًا للاعبين دون تغيير أسلوب اللعب الأساسي.

🏗️ أمثلة على الاستخدام

• توفير قائمة زينة للّوبي حتى يجهز اللاعبون pets وparticle effects.
• منح staff أو اللاعبين وصولًا إلى gadgets أو emotes خاصة عبر الأوامر أو GUI.
• استخدام treasure chests لمنح مكافآت تجميلية عشوائية للاعبين.
• تخزين فتحات الزينة الخاصة باللاعبين في ملفات بيانات الخادم أو في قاعدة بيانات SQL متصلة عند الإعداد.

⌨️ الأوامر

(ملاحظة: صيغة هذا الأمر مأخوذة من توثيق المشروع الذي يصف استخدام treasure chest.)

🔐 الصلاحيات

⚙️ التثبيت

📥 الإعداد

• حمّل ملف JAR الرسمي للإضافة من صفحات التوزيع الرسمية للمشروع.
• ضع ملف JAR في مجلد plugins/ الخاص بالخادم على خادم Spigot أو Paper.
• أعد تشغيل الخادم وتحقق من سجلات console للتأكد من تحميل الإضافة.

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

• لا توجد اعتماديات طرف ثالث مطلوبة بشكل افتراضي في README الخاص بالمشروع. (أضف الاعتماديات الخارجية فقط إذا تم ضبطها صراحةً.)

🧾 الإعدادات

• تستخدم الإضافة ملفات إعدادات وبيانات؛ وبشكل افتراضي تُخزن الزينة المفتوحة في ملفات بيانات اللاعبين أو في قاعدة بيانات SQL متصلة عند الإعداد.
• توفر wiki المشروع ودليل البدء السريع خيارات الإعداد وتفاصيل الضبط.

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

• تدعم رسميًا برمجيات الخوادم Spigot وPaper.
• يوفر المشروع ملاحظات توافق لإصدارات المشروع المختلفة؛ راجع توثيق المشروع لمعرفة نطاقات Minecraft المدعومة بدقة لكل إصدار.
• تم نشر الشيفرة المصدرية بموجب GNU Affero General Public License v3.0.
• يتم التعامل مع الإبلاغ عن المشكلات والتطوير عبر مستودع المشروع.

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

إذا كنت بحاجة إلى نظام زينة مُدار ومبني على GUI لخادم Spigot أو Paper يدعم العديد من فئات الزينة وتخزينًا قابلًا للضبط للعناصر المفتوحة، فإن UltraCosmetics يقدم خيارًا مفتوح المصدر مع توثيق داخل المستودع ودعم مجتمعي.