إضافة Minecraft zAuctionHouse

🔌 نبذة عن zAuctionHouse

zAuctionHouse هو إضافة Minecraft تنفّذ سوق مزادات متكاملًا للاعبين لعرض العناصر وتصفحها وشرائها. يركّز على سهولة التخصيص، والواجهات المعتمدة على GUI، ودعم عدة أنواع من الاقتصاد. تتم صيانة المشروع بواسطة GroupeZ-dev، وتُظهر المستودعات والوثائق وجود إعادة كتابة V4 تستهدف Java الحديثة وبُنى الخوادم الحديثة.

🎯 الهدف

يعالج zAuctionHouse مشكلة تداول العناصر داخل اللعبة من خلال توفير سوق مركزي يمكن للاعبين فيه إنشاء قوائم "اشترِ الآن"، وإجراء مبيعات بالجملة، وتصفح المخزونات المصنفة حسب الفئات. وهو موجه للخوادم التي تريد سوقًا مدمجًا مع تدقيق إداري ومزامنة شبكية اختيارية.

⚙️ المميزات

• قوائم الشراء الفوري (buy-it-now) وسير عمل على نمط المزايدة عند توفره.
• مبيعات بالجملة: بيع عدة عناصر في قائمة واحدة.
• معاينة Shulker Box حتى يتمكن المشترون من فحص المحتويات قبل الشراء.
• تصفية حسب الفئة، وفرز متقدم، وتعدد الصفحات لمجموعات القوائم الكبيرة.
• دعم متعدد للاقتصاد (Vault وPlayerPoints وCoinsEngine والعملات القائمة على العناصر وXP/المستويات).
• نظام ضرائب قابل للتخصيص مع تخفيضات ضريبية مبنية على الصلاحيات.
• تسليم الأموال عبر المطالبة التلقائية أو اليدوية، وإشعارات المبيعات أثناء عدم الاتصال.
• تكامل zMenu لواجهات GUI وقوالب المخزون القابلة للتخصيص بالكامل.
• دعم PlaceholderAPI وMiniMessage للرسائل المنسقة والـ placeholders.
• أدوات الإدارة: لوحة إدارة، وسجلات الإجراءات، وسجل المعاملات، واسترجاع العناصر، وأوامر إدارة التخزين المؤقت.
• مزامنة متعددة الخوادم عبر إضافة Redis مع القفل الموزع وpub/sub.
• التحكم في العناصر الممنوعة/المسموح بها، وقيود العوالم، وحدود القوائم والأسعار، وقفل المعاملات لمنع تعارضات السباق.
• دعم webhook في Discord لإشعارات المبيعات مع محتوى embed قابل للتخصيص.

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

• خوادم Survival وSMP التي تريد سوقًا يقوده اللاعبون.
• خوادم Skyblock وFactions والخوادم المعتمدة على الاقتصاد والتي تحتاج أنظمة تداول.
• الشبكات التي تتطلب أسواقًا متزامنة عبر عدة خوادم backend.
• مسؤولو الخوادم الذين يحتاجون إلى سجلات تدقيق وأدوات استعادة إدارية.

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

• يضع اللاعبون إسقاطات نادرة أو عناصر مصنوعة بسعر ثابت ليشتريها اللاعبون الآخرون فورًا.
• يفرض مشغّل الخادم قواعد الضرائب وتخفيضات ضرائب VIP عبر الصلاحيات.
• تقوم شبكة متعددة الخوادم بمزامنة القوائم والمبيعات بين خوادم hub وbackend باستخدام إضافة Redis.

⌨️ الأوامر

(الأوامر أعلاه مأخوذة من الوثائق الرسمية للمشروع ومواد البدء السريع في المستودع.)

🔐 الصلاحيات

(فقط عقد الصلاحيات المذكورة صراحةً في الإعدادات والوثائق الرسمية هي المدرجة.)

⚙️ التثبيت

📥 الإعداد

• احصل على ملف jar الرسمي لـ zAuctionHouse من توزيع المشروع (صفحة البيع الرسمية أو الكتالوج).
• ضع ملف jar الخاص بـ zAuctionHouse (والإضافات المطلوبة) في مجلد الخادم plugins/.
• أعد تشغيل الخادم وتحقق من أن الإضافة قد تهيأت بنجاح في وحدة تحكم الخادم.
• قم بتهيئة الإضافة باستخدام plugins/zAuctionHouse/config.yml وخصص مخزونات GUI في plugins/zAuctionHouse/inventories/.

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

• مطلوب: zMenu وPlaceholderAPI.
• تكاملات اختيارية / مدعومة: Vault وLuckPerms وإضافة zAuctionHouse Redis للمزامنة متعددة الخوادم.

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

• يستهدف المشروع Java الحديثة (إعادة كتابة V4 تستهدف Java 21) ويستخدم نمط repository / ORM في بنيته.
• يشمل البرنامج الموصى به للخوادم Paper وتفرعات Paper؛ كما تُدرج Folia وبعض التفرعات المبنية على Paper كخوادم مدعومة.
• تُظهر الوثائق الرسمية والتوزيع دعمًا لـ Minecraft 1.20 حتى 1.21+ (تحقق من وثائق المشروع لمعرفة توافق build الدقيق قبل النشر في الإنتاج).

❓ الأسئلة الشائعة

• هل توجد نسخة مجانية؟
  يتوفر build تجريبي مجاني (يوفر المشروع إصدارًا مجانيًا/تجريبيًا على بعض المنصات)، بينما تُوزع الإصدارات الكاملة والمدعومة عبر القنوات المميزة الخاصة بالمشروع.

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

إذا كنت تحتاج إلى سوق قابل للتخصيص، ومعتمد على GUI، مع دعم متعدد للاقتصاد ومزامنة متعددة الخوادم اختيارية، فإن zAuctionHouse يوفر تنفيذًا مُدارًا لسوق المزاد إلى جانب تدقيق إداري وتخصيص GUI عبر zMenu.