إضافة Minecraft QuickShop-Hikari

🔌 حول QuickShop-Hikari

QuickShop-Hikari هو إضافة Minecraft تنفّذ متاجر شراء/بيع تعتمد على الصناديق (ChestShops). ينشئ اللاعبون المتاجر ويستخدمونها عبر التفاعل مع الصناديق؛ ومعظم أسلوب اللعب لا يتطلب أي أوامر. يُدار المشروع بواسطة QuickShop-Community ويركّز على التوافق الحديث، وأمان البيانات، والتكاملات القابلة للتوسعة.

🎯 الهدف

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

⚙️ المميزات

• إنشاء متاجر شراء وبيع باستخدام الصناديق واللافتات (متاجر قائمة على الصناديق).
• دعم بيانات NBT، والتعويذات، وتلف العنصر، وبيانات الجرعات، وبيض الكائنات.
• عنصر عرض افتراضي يمكن تشغيله أو إيقافه فوق المتاجر (مدعوم عبر ProtocolLib أو PacketEvents).
• دعم صناديق غير محدودة وسلوك شراء/بيع مختلط في الصندوق المزدوج.
• دعم القائمة السوداء مع خيارات إذن للتجاوز.
• إدارة الصلاحيات لكل متجر ومزايا المتجر بين المالكين واللاعبين الآخرين.
• دعم i18n لأسماء العناصر والتعويذات وصيغة MiniMessage للرسائل.
• دعم مصدر البيانات H2 (محلي) وMySQL (عن بُعد).
• خطاطيف تكامل مع إضافات الحماية والأدوات الشائعة (تتوفر وحدات توافقية).
• واجهة برمجة للمطورين (تتوفر إحداثيات Maven/Gradle) للاستعلام عن المتاجر ودمج الميزات.
• قياس bStats مع خيار إلغاء الاشتراك عبر الإعدادات.

🧩 لمن هذا؟

لأصحاب الخوادم والمديرين الذين يشغّلون خوادم Survival/SMP أو الخوادم التي تركز على الاقتصاد ويريدون سوقًا ماديًا يعتمد على الصناديق. يناسب الخوادم الصغيرة والكبيرة التي تستخدم إضافات اقتصاد متوافقة مع Vault وتحتاج إلى تحكم لكل متجر وتخزين يعتمد على قاعدة بيانات.

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

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

⌨️ الأوامر

ملاحظة: توضح وثائق المشروع أن أسلوب لعب اللاعب العادي لا يتطلب أوامر؛ والأوامر مخصصة أساسًا للإدارة.

🔐 الصلاحيات

⚙️ التثبيت

📥 الإعداد

• حمّل ملف jar الرسمي لـ QuickShop-Hikari من توزيع المشروع (إصدارات Modrinth/Spigot/GitHub).
• ضع ملف jar داخل مجلد plugins/ في الخادم.
• ابدأ الخادم وتحقق من أن الإضافة قد تم تحميلها (تُظهر الوثائق تشغيل الأمر qs في الكونسول لعرض المساعدة/نتيجة الاختبار).

📦 الاعتمادات

التكاملات المؤكدة المطلوبة/الاختيارية كما يذكرها المشروع:

• Vault (مطلوب لربط الاقتصاد)
• إضافة اقتصاد متوافقة مع Vault (توجد أمثلة في المشروع)
• ProtocolLib أو PacketEvents (مطلوبان لعناصر العرض الافتراضية / الترجمة لكل لاعب)
• LuckPerms (موصى به لإدارة الصلاحيات)

🧾 الإعدادات

• تنشئ الإضافة ملف config.yml وتستخدمه (تشير الوثائق إلى مفاتيح config.yml الخاصة ببروتوكول العرض وإعدادات الخصوصية).
• يدعم تخزين البيانات H2 المحلي أو MySQL البعيد؛ وتتوفر خيارات التهيئة داخل ملفات إعدادات الإضافة.

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

• توصي الوثائق الرسمية بتشغيلها على خادم قائم على Paper وتذكر متطلب Java 21.
• يوفر المشروع واجهة مطورين وإحداثيات Maven/Gradle للاستخدام أثناء الترجمة.
• تأتي QuickShop-Hikari مع وحدات توافق لإضافات خارجية (مثل WorldGuard وWorldEdit وOpenInv) كتنزيلات اختيارية.
• القياس: يستخدم bStats؛ ويمكن إلغاء الاشتراك عبر إعدادات config.

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

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