إضافة Minecraft PhoenixCrates

🔌 نبذة عن Phoenix Crates

Phoenix Crates هو إضافة Minecraft لتشغيل أنظمة الصناديق/المكافآت على الخادم. يوفّر أنواع صناديق، ومفاتيح (مادية وافتراضية)، وتسلسلات فتح متحركة، ومحررًا داخل اللعبة لإنشاء الصناديق والمكافآت وإدارتها دون الحاجة إلى تعديل الملفات الخام. ينشر المشروع Phoenix Plugins وهو متاح بإصدار مجاني بالإضافة إلى نسخة premium مدفوعة تحتوي على ميزات إضافية.

🎯 الهدف

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

⚙️ الميزات

• عدة أوضاع لمحرك الصناديق (كتلة vanilla، نموذج vanilla، تكامل Model Engine).
• تسلسلات فتح متحركة ورسوم خمول مع مراحل وتركيبات قابلة للتخصيص.
• مفاتيح مادية وإدارة مفاتيح افتراضية (قوائم المفاتيح الافتراضية، الدفع/التحويل، أوامر give/take/set).
• محرر داخل اللعبة لإنشاء/تعديل الصناديق والمفاتيح والمكافآت والرسوم المتحركة.
• أنواع مكافآت تشمل المكافآت العشوائية والانتقائية (يختار اللاعب)، وإعادة السحب، والمكافآت المضمونة.
• إضافات وميزات premium إضافية (رسوم متحركة إضافية، دعم MySQL، واجهة API، وتثبيت الإضافات في الخطة المدفوعة).
• دعم أساسي لعرض Bedrock/Geyser لبعض الرسوم المتحركة والنماذج.
• أدوات معاينة وإدارة المكافآت على جانب الخادم (حدود الفوز العامة/لكل لاعب، وإعادة ضبط فترات التبريد).

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

• خوادم Survival/SMP وخوادم الاقتصاد التي تعرض صناديق أو أنظمة مكافآت.
• الخوادم التي تريد فتح صناديق بصريًا/بأنيميشن مع دعم النماذج (Model Engine).
• المديرون الذين يفضّلون محررًا داخل اللعبة لإعداد الصناديق بدلًا من تعديل الملفات يدويًا.

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

• منح اللاعبين مفاتيح افتراضية يمكنهم إنفاقها في واجهة GUI لفتح صناديق تجميلية أو صناديق عناصر.
• إنشاء صناديق بطابع الأعياد مع رسوم متحركة مخصصة عند الفتح ومكافآت محدودة.
• استخدام المحرر داخل اللعبة لنقل إعدادات الصناديق أو إعادة بنائها دون تعديل YAML يدويًا.

⌨️ الأوامر

(الأوامر أعلاه مأخوذة من الوثائق الرسمية لـ Phoenix Crates ومن مرجع الأوامر.)

🔐 الصلاحيات

(تم إدراج عقد الصلاحيات الموثقة صراحةً فقط من قبل المشروع.)

⚙️ التثبيت

📥 الإعداد

• نزّل ملف JAR الرسمي لإضافة Phoenix Crates أو احصل عليه من قناة التوزيع الرسمية.
• ضع ملف JAR في مجلد plugins/ الخاص بالخادم لديك على خادم مدعوم (راجع الملاحظات التقنية).
• شغّل الخادم أو أعد تشغيله وتحقق من وحدة التحكم للتأكد من تحميل الإضافة.
• استخدم المحرر داخل اللعبة أو الأوامر المتوفرة لإنشاء الصناديق والمفاتيح؛ كما توفّر الإضافة أوامر reload وeditor.

📦 المتطلبات

• لا توجد تبعيات من طرف ثالث مطلوبة افتراضيًا. تتكامل الإضافة مع أنظمة اختيارية مثل Model Engine للنماذج المخصصة، وتوفّر placeholders مذكورة في سجلات التحديث.

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

• برامج الخادم المدعومة (حسب ما صرّح به المطوّر): Spigot وتفرعات Spigot، وPaper وتفرعات Paper، وFolia.
• إصدارات Minecraft المدعومة: وفقًا للتوثيق، يدعم Phoenix Crates (حتى سطر الإصدار المذكور) Minecraft 1.20.4+ (وقد تم إيقاف دعم الإصدارات الأقدم ابتداءً من الإصدار الرئيسي المذكور).
• عمليات التكامل الاختيارية: Model Engine (نماذج متحركة مخصصة)، وملاحظات التوافق مع GeyserMC لعرض Bedrock، وPlaceholders الخاصة بـ PlaceholderAPI المذكورة في التحديثات.
• يُقدَّم المشروع بمستويين: مجاني وpremium؛ وتضيف النسخة premium ميزات مثل دعم MySQL، والوصول إلى API عامة، وصناديق غير محدودة، ورسوم متحركة إضافية، وإضافات.

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

إذا كنت تحتاج إلى نظام صناديق قابلًا للتخصيص، يعتمد على الرسوم المتحركة، مع محرر داخل اللعبة ودعم اختياري للنماذج/Bedrock، فإن Phoenix Crates يوفّر كلاً من العناصر المرئية للاعبين وأدوات الإدارة للتحكم في المكافآت والمفاتيح من الخادم.