إضافة Minecraft ChestShop

🔌 حول ChestShop

ChestShop هو إضافة Minecraft لإنشاء متاجر يديرها اللاعبون باستخدام الصناديق واللافتات. يربط الإضافة عمليات المتجر باقتصاد الخادم (عبر Vault أو Reserve) حتى يتمكن اللاعبون من شراء العناصر وبيعها باستخدام عملة الخادم. يُدار المشروع على GitHub ويُوزّع الإصدارات عبر منصات الإضافات الشائعة.

🎯 الهدف

توفير سوق داخل العالم بسيط ودائم، حيث ينشئ اللاعبون متاجرهم بوضع لافتة على صندوق. يتولى ChestShop معالجة المعاملات بين مخزونات اللاعبين واقتصاد الخادم، كما يتضمن وسائل حماية وواجهات توافق لتقليل التخريب وتسهيل التكامل.

⚙️ المميزات

• إنشاء متاجر شراء/بيع عبر وضع لافتة مُنسقة على صندوق.
• تكامل مع Vault أو Reserve وغيرها من إضافات الاقتصاد المتوافقة لإدارة المال.
• خيارات حماية المتجر والتوافق مع إضافات حماية الصناديق الشائعة.
• إجراءات مضادة للتأخير / لضمان أمان المعاملات موثقة من قبل المطورين.
• قابل للتوسعة عبر الإضافات المجتمعية وإضافات التوافق (قائمة الإضافات يديرها المشروع).
• تمت إضافة أوامر إدارية وإعلامية في الإصدارات الحديثة (مثل: /shopinfo، /iteminfo).

🧩 لمن هو مخصص

• خوادم Survival وSMP التي تستخدم اقتصادًا قائمًا على العملة.
• الخوادم التي تريد متاجر لاعبين بسيطة تعتمد على اللافتات بدل واجهات GUI.
• المسؤولون الذين يفضلون متاجر تحتفظ بالعناصر داخل صناديق Vanilla (من دون قاعدة بيانات إلزامية للتخزين الأساسي للمتجر).

🏗️ حالات استخدام مثالّية

• يضع اللاعب صندوقًا، يملأه بالعنصر المراد بيعه، ثم ينشئ لافتة لتحديد أسعار الشراء/البيع؛ وينقر لاعبو آخرون على اللافتة لإجراء التجارة.
• ينشئ مسؤولو الخادم متاجر إدارية لبيع عناصر يديرها الخادم.
• تضيف المجتمع إضافة توافق لدمج ChestShop مع إضافة حماية أو عرض.

⌨️ الأوامر

(الأوامر المدرجة مأخوذة من ملاحظات إصدار المشروع ووثائقه. يتم عرض الأوامر الموثقة صراحةً من قبل المشروع فقط.)

🔐 الأذونات

(تُدرج عُقد الأذونات فقط حيث تظهر في الموارد الرسمية للمشروع وملاحظات الإصدار.)

⚙️ التثبيت

📥 الإعداد

• حمّل ملف ChestShop الرسمي بصيغة .jar وضعه في مجلد plugins/ الخاص بالخادم.
• ثبّت Vault أو Reserve وإضافة اقتصاد متوافقة توفر واجهة API للمال.
• أعد تشغيل الخادم وتحقق من سجل الكونسول للتأكد من تفعيل ChestShop بنجاح.

📦 المتطلبات

• Vault (التكامل مدعوم) أو Reserve (التكامل مدعوم)
• إضافة اقتصاد متوافقة توفر واجهة API للمال (مثبتة إلى جانب Vault/Reserve)

🧾 الإعدادات

تنشئ الإضافة ملفات الإعدادات/yml عند التشغيل الأول؛ وتتوفر خيارات الإعدادات ومفاتيح التوافق داخل تلك الملفات وعبر توثيق المشروع.

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

• يستضاف الشيفرة المصدرية وتتبع المشكلات على GitHub تحت رخصة LGPL-2.1.
• يدرج المشروع الإصدارات وملفات الإصدار على مواقع الإضافات الشائعة؛ كما ينشر المشرفون إصدارات التطوير على خادم CI.
• صُمم ChestShop لأنواع الخوادم Bukkit/Spigot/Paper (وهذا مذكور صراحةً في وثائق المشروع والمستودع).

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

إذا كنت تريد سوقًا داخل العالم مباشرًا تبقى فيه العناصر داخل صناديق عادية وتستخدم المعاملات عملة خادمك، فإن ChestShop يوفر نظام متاجر متينًا وقابلًا للتوسعة يعتمد على الصناديق واللافتات، مع تكامل اقتصادي وتوافق مع الإضافات.