إضافة Minecraft Shopkeepers

🔌 حول Shopkeepers

Shopkeepers هو إضافة Minecraft لـ Bukkit/Spigot تتيح لمالكي الخوادم وضع بائعين من القرويين يمكن تخصيصهم، يبيعون العناصر المُعدّة بأسعار مُحددة. تدعم الإضافة كلًا من متاجر الإدارة (بمخزون غير محدود) ومتاجر اللاعبين التي تسحب المخزون من حاوية، كما توفر ShopkeepersAPI للتكامل مع الإضافات والتوسعات.

🎯 الهدف

توفر الإضافة نظام متجر داخل اللعبة قائمًا على NPC، بحيث يمكن للخوادم تقديم متاجر دائمة دون إدارة الصناديق يدويًا أو متاجر معقدة تعتمد على الأوامر. وهي مناسبة لاقتصاد الخوادم، ومتاجر لعب الأدوار، وخوادم البقاء/SMP التي تريد تجار NPC. ()

⚙️ المميزات

• إنشاء بائعين من القرويين مخصصين بتجارات وأسعار محددة.
• متاجر إدارة بمخزون غير محدود.
• متاجر لاعبين تسحب العناصر من حاوية متصلة (chest) لتوفير المخزون.
• ShopkeepersAPI لمطوري الإضافات للاستعلام عن البائعين وإدارتهم برمجيًا.
• تخصيص العناصر/بيانات العناصر داخل اللعبة ودعم ملفات اللغة عبر ويكي المشروع وملفات اللغة. ()

🧩 لمن هذه الإضافة

• خوادم Survival وSMP التي تريد متاجر يديرها NPC.
• خوادم لعب الأدوار أو الاقتصاد التي تستخدم قرويي NPC كتجار.
• مطورو الإضافات الذين يحتاجون إلى API لدمج سلوك المتاجر في أنظمة أخرى. ()

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

• ينشئ مدير متجرًا إداريًا غير محدود يبيع سلعًا يوفرها الخادم.
• يفتح لاعب متجرًا يبيع تلقائيًا العناصر من chest مرتبط.
• يبني مطور addon يعرض أو يعدل shopkeepers باستخدام ShopkeepersAPI. ()

⌨️ الأوامر

(ملاحظة: تم إدراج الأوامر الموثقة صراحةً من المصادر الرسمية فقط في الأعلى.) ()

⚙️ التثبيت

📥 الإعداد

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

(هذه هي خطوات التثبيت القياسية لإضافات Bukkit/Spigot وهي مدعومة بوثائق المشروع.) ()

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

• تم إصدار Shopkeepers تحت رخصة GPL-3.0 ويشمل مستودع المشروع وحدة API (ShopkeepersAPI) وتعليمات البناء. ()
• يوفر المشروع artifacts لـ Maven وAPI منشورًا لمطوري الإضافات؛ ويشرح README استخدام المستودع وإحداثيات اعتماد الـ API. ()
• التوزيع الرسمي والدعم المجتمعي متاحان عبر صفحة Spigot resource وخادم Discord الخاص بالإضافة. ()

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

إذا كنت تحتاج إلى تجار NPC دائمين وقابلين للتخصيص مع دعم كلٍ من المتاجر الإدارية ومتاجر اللاعبين، وتريد API لدمج المتاجر في إضافات أخرى، فإن Shopkeepers تقدم تطبيقًا موثوقًا لخوادم Bukkit/Spigot. ()