إضافة Minecraft BreweryX

🔌 حول BreweryX

BreweryX هو بلجن Minecraft يعيد تصميم نظام التخمير إلى نظام متعدد الخطوات (التخمير، التقطير، التعتيق) لإنتاج مشروبات وجرعات مخصصة. يمكن للمشروبات أن تُسبب تأثيرات السُكر (تعثّر الحركة، تشويه الدردشة، الصداع)، كما يتضمن البلجن أدوات لتعريف الوصفات، وتحسين الجودة، وإدارة نقاط الاستيقاظ للاعبين الثملين.

🎯 الغرض

يوفر BreweryX نظام تخمير بديلًا وأكثر تعقيدًا للسيرفرات التي تريد مشروبات قابلة للاستهلاك مع تأثيرات دائمة ومراحل في دورة الحياة (ferment → distill → age). وهو يحل مشكلة آليات الجرعات المحدودة في Minecraft الأصلي من خلال منح مالكي السيرفرات وصفات قابلة للتخصيص، ومراحل جودة، ولعبًا اجتماعيًا حول التخمير.

⚙️ الميزات

• دورة تخمير متعددة الخطوات: التخمير، التقطير، والتعتيق في البراميل.
• مشروبات كحولية تسبب تأثيرات السُكر: حركة متعثرة، تأثير على الدردشة، الصداع، وسلوك الاستيقاظ.
• وصفات قابلة للتخصيص: حدّد المكونات، المراحل، الخصائص، وعمليات التصنيع المخصصة.
• آليات تحسين الجودة: يمكن تحسين المشروبات أو إنتاج تأثيرات سلبية عند انخفاض الجودة.
• دعم العناصر المخصصة عبر CustomModelData والتكامل مع ItemsAdder وOraxen.
• دعم PlaceholderAPI للـ placeholders.
• دعم RGB كامل لإصدارات Minecraft الحديثة (1.16+ حيث يكون RGB مهمًا).
• دعم الإضافات (addons) مع منظومة صغيرة منها (مثل: إضافات للوصفات، وإضافات للهولوجرام).

🧩 لمن هو مناسب

• سيرفرات Survival / SMP التي تريد عناصر قابلة للصنع مع عناصر لعب تمثيلي.
• سيرفرات roleplay أو السيرفرات التي تركز على الحانات وتبحث عن آليات مشروبات وتفاعلات اجتماعية أعمق.
• السيرفرات التي تستخدم حزم عناصر مخصصة (ItemsAdder/Oraxen) وتريد أن تعمل تلك العناصر كمكونات للتخمير.

🏗️ حالات استخدام مثالّية

• ينشئ المشرفون مجموعة من الوصفات السرية التي يجب على اللاعبين اكتشافها بالتجربة.
• منطقة حانة يقوم فيها اللاعبون بتخمير المشروبات وتعتيقها وبيعها مع تأثيرات داخل اللعبة.
• السيرفرات التي تستخدم عناصر مخصصة تدمج أصول ItemsAdder/Oraxen كمكونات لمشروبات خاصة.

⌨️ الأوامر

(ملاحظة: أوصاف الأوامر وارتباطات الصلاحيات المحددة أعلاه مأخوذة من التوثيق الرسمي للبلجن؛ وبعض تمييزات admin/mod تكون سياقية في الوثائق.)

🔐 الصلاحيات

⚙️ التثبيت

📥 الإعداد

• حمّل ملف BreweryX الرسمي بصيغة .jar (تُنشر الإصدارات الرسمية على مورد Spigot الخاص بالمشروع وعلى GitHub releases).
• ضع ملف .jar داخل مجلد plugins/ على سيرفرك.
• شغّل السيرفر أو أعد تشغيله وراقب الكونسول للتأكد من أن BreweryX تم تحميله.

📦 المتطلبات

• PlaceholderAPI (التكامل مدعوم).
• ItemsAdder (التكامل مدعوم، اختياري).
• Oraxen (التكامل مدعوم، اختياري).

ثبّت فقط عمليات التكامل التي تحتاجها؛ يعمل BreweryX كبلجن Bukkit/Spigot عادي.

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

• برامج السيرفر المدعومة المؤكدة: Spigot وPaper وFolia (تذكر مصادر المشروع دعم Spigot/Paper/Folia).
• إصدارات Minecraft المدعومة المؤكدة (المدى المقدم من المشروع): من 1.8.9 إلى 1.21.8 (راجع بيانات المشروع الرسمية لمعرفة الإصدارات التي تم اختبارها).
• المشروع مفتوح المصدر ومرخّص تحت GPL-3.0.
• ينشئ البلجن ملفات إعدادات وملفات لغة (وتوضع ملفات اللغة في plugins/brewery/languages/ حسب التوثيق).
• يوفر المشروع واجهة API، ويوجد مستودع BreweryX API منفصل تشير إليه الفريق.

❓ الأسئلة الشائعة (مختصر)

• س: هل يمكنني إنشاء وصفاتي الخاصة؟
  ج: نعم — يدعم BreweryX وصفات مخصصة قابلة للتخصيص، بما في ذلك المكونات والمراحل والخصائص.
• س: هل يعمل BreweryX مع حزم العناصر المخصصة؟
  ج: نعم — يذكر المشروع دعم تكامل ItemsAdder وOraxen.

🤝 متى يكون هذا البلجن مفيدًا

إذا كنت تريد إضافة نظام تخمير دائم وقابل للتخصيص مع عناصر roleplay (السُكر، التعتيق، التقطير) ودعم العناصر المخصصة، فإن BreweryX يوفر أدوات الوصفات والتكاملات اللازمة لتشغيل هذا النظام على سيرفر مبني على Spigot/Paper.