إضافة Minecraft DiceFurniture

🔌 حول DiceFurniture

DiceFurniture هو إضافة plugin Minecraft لـ FurnitureLib توفر مجموعة كبيرة من نماذج armor stand المُولَّدة مسبقًا وتُستخدم كأثاث وعناصر زخرفية. يتم توزيع المشروع لخوادم Spigot ويصونه المؤلف المذكور في صفحة المورد الرسمية.

🎯 الهدف

يعالج DiceFurniture مشكلة إنشاء أثاث زخرفي مفصل بدون تصميم armor stand يدويًا. بدلًا من بناء ترتيبات armor stand معقدة يدويًا، يمكن لمديري الخوادم إضافة نماذج جاهزة (كراسي، طاولات، مصابيح، رفوف، وزخارف أخرى) تظهر كأثاث قائم على armor stand عبر FurnitureLib.

⚙️ الميزات

• مجموعة من نماذج armor stand المُولَّدة مسبقًا للأثاث والزخارف.
• يتكامل مع FurnitureLib (مطلوب) لإظهار كيانات الأثاث وإدارتها.
• يستخدم تكامل ProtocolLib للتوافق مع الميزات المعتمدة على الحزم.
• تكامل اختياري مع Vault للتفاعلات المتعلقة بالاقتصاد عند الحاجة.
• دعم اختياري لـ LightAPI (مذكور كاعتماد ثانوي) لتحسين الإضاءة لبعض النماذج على إصدارات الخادم المدعومة.
• دعم متعدد اللغات (بما في ذلك الألمانية والإنجليزية وغيرها).
• تصفح النماذج واختيارها عبر موقع النماذج الخاص بالمشروع وحزمة الموارد (تُوفَّر النماذج بشكل منفصل عن نواة FurnitureLib).

🧩 لمن هذا البرنامج

• مالكو الخوادم والمديرون الذين يريدون أثاثًا زخرفيًا جاهزًا بدون إنشاء نماذج armor stand يدويًا.
• خوادم Survival وSMP التي تريد ديكورات داخلية.
• الخوادم التي تستخدم FurnitureLib بالفعل وتريد حزم نماذج إضافية.

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

• إضافة كراسي وطاولات ومصابيح وعناصر زخرفية إلى منازل اللاعبين المبنية بدون إنشاء نماذج مخصصة.
• توفير مكتبة من الأثاث ذي الطابع الخاص للبنّائين على خوادم creative أو roleplay.
• استخدام تكامل Vault الاختياري لتقييد بعض تفاعلات الأثاث عبر الاقتصاد أو الصلاحيات إذا رغبت.

⚙️ التثبيت

📥 الإعداد

• حمّل ملف .jar الخاص بالـ plugin من صفحة المورد الرسمية وضعه في مجلد plugins/ الخاص بالخادم.
• تأكد من تثبيت الاعتماديات المطلوبة (راجع قسم الاعتماديات).
• شغّل الخادم أو أعد تشغيله وراقب رسائل تحميل الإضافة في console للتأكد من نجاح التشغيل.

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

• مطلوب: FurnitureLib (المكتبة الأساسية لإدارة الأثاث).
• مطلوب: ProtocolLib.
• اختياري/تكاملات: Vault (اختياري عند استخدام hooks الاقتصاد/الصلاحيات).
• اختياري (soft-dependency): LightAPI (LightAPI-1.12 / LightAPI-Original مذكوران كاختياريين في صفحة المورد).

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

• المنصة: يتم توزيعه كـ plugin Spigot (ويصف المشروع نفسه بأنه plugin Spigot).
• يسرد المورد الرسمي عدة إصدارات Minecraft تم اختبارها، من 1.12 حتى 1.21، ويذكر إصدارًا رئيسيًا أصليًا؛ ينبغي لمديري الخوادم مطابقة بناء الإضافة مع إصدار خادمهم.
• يوفر المشروع موقع نماذج / model browser منفصلًا حيث يتم سرد نماذج الأثاث المتاحة وتوزيعها كجزء من مجموعة نماذج DiceFurniture.
• يتم نشر الشفرة المصدرية في مستودع عام يديره مؤلف المشروع.

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

إذا كنت تشغّل FurnitureLib بالفعل وتريد حزمة جاهزة ومُدارة من نماذج أثاث armor stand لملء الأبنية والديكورات الداخلية بسرعة، فإن DiceFurniture يوفر مجموعة واسعة من النماذج الجاهزة وتكاملات اختيارية تُسهّل إضافة المحتوى الزخرفي إلى خادم Spigot.