إضافة Minecraft MarriageMaster

🔌 حول Marriage Master

Marriage Master هو إضافة Bukkit/Spigot لـ Minecraft توفر نظام زواج قابلًا للتخصيص للخوادم. يتيح للاعبين تكوين زيجات (واحدة أو متعددة، إذا تم ضبط ذلك) ويمنح اللاعبين المتزوجين ميزات وأوامر تعاونية. يتضمن المشروع API للمطورين ويدعم التخزين المستمر.

🎯 الهدف

تم تصميم الإضافة لخوادم roleplay والخوادم الاجتماعية التي تريد ميكانيكية زواج داخل اللعبة: لتوفير أدوات مشتركة للأزواج، ودردشة خاصة، وتفاعلات اقتصادية اختيارية، وتأثيرات لعب قابلة للتخصيص عندما يكون الشريكان قريبين من بعضهما.

⚙️ الميزات

• طلبات زواج بين اللاعبين واحتفالات يقودها الكاهن (اختياريًا).
• الانتقال إلى الشريك (teleport to partner) ومنزل مشترك يمكن لكلا الشريكين الانتقال إليه.
• دردشة خاصة للزوجين وخيار لتوجيه كل الرسائل إلى الشريك بدلًا من الدردشة العامة.
• عناصر هدية: يمكن للاعبين إعطاء العنصر الموجود في اليد إلى شريكهم.
• تبديل PvP بين الشريكين (تفعيل/تعطيل PvP مع شريكك).
• أفعال تجميلية مثل kiss مع تأثيرات الجسيمات.
• مكافآت XP والتجدد عندما يكون الشريكان قريبين (ذُكرت تكاملات لـ Minecraft XP وmcMMO وSkillAPI).
• دعم اختياري لحقائب الظهر المشتركة / تكامل Minepacks.
• دعم متعدد اللغات عبر ملفات لغة قابلة للتخصيص.
• خلفيات تخزين قابلة للتخصيص: يتم دعم SQLite وMySQL.
• API لمطوري الإضافات للتفاعل مع بيانات وأحداث Marriage Master.

🧩 لمن هو هذا

• خوادم roleplay والاجتماعية التي تريد ميكانيكيات علاقات داخل اللعبة.
• خوادم SMP أو survival التي تريد مزايا تعاونية اختيارية لأزواج اللاعبين.
• مسؤولو الخوادم الذين يحتاجون إلى صلاحيات وتكاملات قابلة للتخصيص مع الاقتصاد أو إضافات أخرى.

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

• يرسل لاعبان طلب زواج ويحصلان على منزل مشترك وقناة دردشة خاصة.
• يفعّل خادم احتفالات الكاهن للفعاليات ويمنح عناصر أو ألقابًا خاصة عند الزواج عبر برمجة الخادم أو hooks الخاصة بـ API.
• يستخدم الأزواج أمر gift لتبادل العناصر الموجودة في اليد كجزء من roleplay.

⌨️ الأوامر

ملاحظة: المصادر الرسمية تسرد هذه الأوامر لكنها لا توثق permission nodes داخل صفحة المورد؛ تتوفر الصلاحيات في توثيق الإضافة وقائمة الصلاحيات.

⚙️ التثبيت

📥 الإعداد

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

📦 المتطلبات

• يلزم Java 8 أثناء التشغيل.
• منصات التشغيل المؤكدة: Bukkit وSpigot وPaper.
• التكامُلات/المتطلبات الاختيارية الموثقة من المؤلف: Vault (اختياري، لميزات الاقتصاد)، PCGF PluginLib (اختياري)، تكامل Minepacks، ودعم Placeholder.
• دعم بروكسي اختياري: BungeeCord / Waterfall.

🧾 الإعدادات

• توفر الإضافة إعدادات شاملة وموثقة وملفات لغة تسمح بتخصيص معظم السلوكيات والرسائل والميزات.
• يمكن ضبط التخزين لاستخدام SQLite أو MySQL.

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

• برامج الخادم المدعومة: Bukkit وSpigot وPaper (يذكر المؤلف دعم Bukkit/Spigot/Paper ودعم بروكسي BungeeCord/Waterfall الاختياري).
• يتطلب Java 8 أثناء التشغيل.
• يتضمن المشروع API للمطورين ويوفر توثيق JavaDoc للتكامل.
• تدعم الإضافة تغييرات UUID/الاسم ولديها دعم متعدد اللغات عبر ملفات الموارد.

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

إذا كنت تدير خادم roleplay أو اجتماعيًا أو SMP وتريد نظام زواج داخل اللعبة مع مزايا قابلة للتخصيص، وأدوات مشتركة خاصة بالأزواج، وhooks للمطورين، فإن Marriage Master يوفر هذه الميزات مع دعم قاعدة بيانات وتكاملات مع أنظمة الخوادم الشائعة.