إضافة Minecraft AuctionHouse

🔌 حول AuctionHouse

AuctionHouse هو إضافة Minecraft تضيف دار مزاد داخل اللعبة يمكن الوصول إليها عبر الأمر /ah. يمكن للاعبين عرض العناصر للبيع، وتصفح القوائم والبحث فيها، وشراء العناصر من خلال سوق يعتمد على GUI. تركز الإضافة على التداول بين اللاعبين مع قواعد قابلة للتخصيص لإدراج العناصر والرسوم والإعلانات.

🎯 الهدف

يوفر AuctionHouse سوقًا مركزيًا يعتمد على GUI بحيث يمكن للسيرفرات تقديم نظام مزاد مُدار بدلًا من الاعتماد على المتاجر التي يديرها اللاعبون أو الأسواق القائمة على اللوحات. وهو مخصص للسيرفرات التي تريد سوقًا عامًا قابلًا للبحث مع قيود قابلة للتخصيص وتكامل مع الاقتصاد.

⚙️ الميزات

• دار مزاد بواجهة GUI تُفتح باستخدام /ah.
• إنشاء القوائم وإلغاؤها؛ وجمع العناصر الملغاة أو المنتهية.
• البحث في القوائم وتصفية النتائج حسب الاسم أو النوع أو lore أو enchant أو البائع.
• فرز القوائم حسب الوقت أو السعر.
• عناصر التحكم في الإدراج: تحديد الحد الأدنى/الأقصى للأسعار، ورسوم الإدراج (ثابتة و/أو بنسبة مئوية)، وضريبة البائع مع حد أقصى، وفترة انتظار بين عمليات الإدراج.
• قيود على العناصر حسب الاسم والنوع وlore وenchantments والضرر وعلامة unbreakable وcustom_model_data وأنماط regex.
• خيار إدراج عناصر السيرفر (إدراج مرة واحدة أو إدراج غير محدود).
• مشغلات خاصة لفتح المزاد عبر اللوحات، أو كتل ذات أسماء (chests وshulkers وdispensers وغيرها)، أو كيانات بأسماء مخصصة.
• تلميحات العناصر عند التمرير تُظهر الوقت المتبقي وenchantments.
• إعلانات اختيارية للقوائم الجديدة وتكامل مع Discord.
• دعم الترجمة الدولية ورسائل ومواد وأصوات قابلة للتخصيص.
• تسجيل المعاملات في ملف سجل منفصل والتنظيف التلقائي للعناصر المهملة.

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

• سيرفرات Survival وSMP التي تريد سوقًا مشتركًا بين اللاعبين.
• السيرفرات التي تركز على الاقتصاد وتريد واجهة مزاد GUI قابلة للبحث.
• الإداريون الذين يحتاجون إلى قواعد إدراج ورسوم وقيود على العناصر قابلة للتخصيص.

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

• يدرج اللاعبون الغنائم الزائدة ويعرضونها في المزاد لمجتمع السيرفر بدلًا من استخدام الصناديق أو المتاجر.
• ينشئ طاقم السيرفر قوائم محدودة أو غير محدودة للعناصر التي يوفّرها السيرفر.
• يفرض الإداريون قواعد اقتصاد السيرفر عبر تقييد عناصر معينة أو تطبيق ضرائب على الإدراج.

⌨️ الأوامر

🔐 Permissions

⚙️ التثبيت

📥 الإعداد

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

📦 Dependencies

• Vault (مطلوب، ويوصى بالإصدار 1.7.1+).
• إضافة اقتصاد مناسبة (مثل EssentialsX economy أو أي مزود اقتصاد آخر متوافق مع Vault).
• إضافة صلاحيات مناسبة (إذا كنت تستخدم صلاحيات خارج القيم الافتراضية).

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

• التخزين: تستخدم الإضافة SQLite (لا يوجد توثيق لدعم قاعدة بيانات خارجية).
• تسجل الإضافة المعاملات في ملف سجل منفصل وتدعم الترجمة الدولية.
• تدعم رؤوس HeadDatabase وملمس skull مخصص كأزرار GUI.
• يذكر المؤلف أن الميزات وتوافق الإصدارات موجهان إلى Spigot؛ وقد يختلف السلوك على برامج السيرفر الأخرى.

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

إذا كنت تريد نظام مزاد قابلًا للتخصيص يعتمد على GUI ومتكاملًا مع اقتصاد السيرفر وVault، فإن AuctionHouse يوفر التحكم في القوائم والبحث/التصفية والرسوم/الضرائب وتسجيل المعاملات لتوفير سوق لاعبين يمكن إدارته بسهولة.