خوادم Minecraft مع إضافة DeluxeMenus

## 🔌 حول DeluxeMenus DeluxeMenus هو إضافة Minecraft لإنشاء قوائم GUI قابلة للتخصيص تعتمد على الحقيبة. يحدد مديرو الخوادم القوائم وعناصرها بصيغة YAML؛ ويمكن للعناصر عرض بيانات ديناميكية عبر PlaceholderAPI وتشغيل أوامر أو إجراءات عند النقر. تنشئ الإضافة مجلد `gui_menus` لملفات القوائم الخارجية وتستخدم `config.yml` مركزيًا للإعدادات الأساسية. ## 🎯 الغرض تحل DeluxeMenus مشكلة إنشاء قوائم رسومية داخل اللعبة من دون برمجة. فهي تتيح لمالكي الخوادم إنشاء المتاجر، وقوائم اختيار السيرفر، وقوائم الحِزم، ولوحات المعلومات، وغيرها من الواجهات التفاعلية التي تنفذ أوامر أو تعرض بيانات خاصة باللاعب. ## ⚙️ المميزات - إنشاء قوائم GUI للحقيبة عبر YAML (مع دعم ملفات القوائم الخارجية). - يمكن لعناصر القائمة تنفيذ أوامر أو أداء إجراءات عند النقر. - تكامل PlaceholderAPI لأسماء العناصر وlore والشروط الديناميكية. - صلاحيات لكل قائمة ولكل نقرة (وصول القائمة وقيود النقر). - أوامر لفتح القوائم وعرضها وإعادة تحميلها وتنفيذ إجراءاتها. - إنشاء `plugins/DeluxeMenus/gui_menus` وملفات قوائم مثال عند التشغيل الأول. - استخدام bStats لإحصاءات مجهولة (مفعّل افتراضيًا ما لم يتم تعطيله). ## 🧩 لمن هو مخصص - مالكو الخوادم والمديرون الذين يريدون واجهات GUI مخصصة داخل اللعبة (متاجر، قوائم اختيار، حِزم). - خوادم SMP وsurvival التي تستخدم متاجر أو قوائم معلومات تعتمد على GUI. - الشبكات التي تحتاج إلى قوائم قابلة للتخصيص بقيم PlaceholderAPI. ## 🏗️ أمثلة على الاستخدام - قائمة اختيار خادم تنقل اللاعبين أو تشغّل أوامر الاتصال بالخادم. - قائمة متجر تنفذ أوامر الشراء عندما ينقر اللاعب على عنصر. - واجهة اختيار حِزمة تعرض معلومات خاصة باللاعب عبر placeholders. ## ⌨️ الأوامر | **الأمر** | **الوصف** | **الصلاحية** | **الوصول** | |---|---|---|---| | `/dm open <menuName>` | فتح قائمة باسم محدد لنفسك. | `deluxemenus.open` | لاعب | | `/dm open <menuName> <player>` | فتح قائمة باسم محدد للاعب آخر. | `deluxemenus.open.others` | إداري | | `/dm list` | عرض جميع القوائم التي يمكنك الوصول إليها. | `deluxemenus.list` | لاعب | | `/dm reload` | إعادة تحميل إعدادات DeluxeMenus والقوائم. | `deluxemenus.reload` | إداري | | `/dm execute <player> <action>` | تنفيذ إجراء مُعدّ مسبقًا على لاعب مستهدف (مقيّد). | op / console | إداري | ## 🔐 الصلاحيات | **الصلاحية** | **الوصف** | **الافتراضي** | |---|---|---| | `deluxemenus.open` | يسمح بفتح القوائم عبر `/dm open`. | غير محدد | | `deluxemenus.open.others` | يسمح بفتح القوائم للاعبين آخرين. | غير محدد | | `deluxemenus.list` | يسمح بسرد القوائم المتاحة. | غير محدد | | `deluxemenus.reload` | يسمح بإعادة تحميل إعدادات الإضافة. | غير محدد | | `deluxemenus.clickmenu.<menuName>` | عقدة صلاحية تُستخدم لتقييد الوصول إلى قائمة النقر لكل قائمة. | غير محدد | ## ⚙️ التثبيت ### 📥 الإعداد - حمّل ملف DeluxeMenus الرسمي بصيغة `.jar` الخاص بـ Spigot وضعه في مجلد `plugins/` الخاص بخادمك. - تأكد من تثبيت PlaceholderAPI قبل تشغيل DeluxeMenus (فهو مطلوب لكي تعمل placeholders). - شغّل الخادم أو أعد تشغيله؛ ستنشئ DeluxeMenus مجلد `plugins/DeluxeMenus` مع `config.yml` ومجلد `gui_menus`. - تحقق من وحدة تحكم الخادم للتأكد من أن الإضافة تم تحميلها بنجاح، وراقب أي تحذيرات تخص إصدار Java. ### 📦 المتطلبات - PlaceholderAPI (مطلوب لدعم placeholders). ### 🧾 الإعداد - تستخدم DeluxeMenus ملف `config.yml` الرئيسي وتدعم ملفات قوائم YAML الخارجية المحفوظة في `plugins/DeluxeMenus/gui_menus`. - عند إنشاء قائمة جديدة عبر الإضافة، سيتم توليد ملف قائمة خارجي افتراضي يمكن تعديله لتخصيص الخانات والعناصر وplaceholders والإجراءات. ## 🧠 ملاحظات تقنية - PlaceholderAPI مطلوب للـ placeholders الديناميكية في أسماء العناصر وlore والشروط. - يلزم Java 11 أو أعلى للإصدارات الحديثة من الإضافة. - تجمع DeluxeMenus إحصاءات مجهولة عبر bStats (يمكن تعطيلها إذا رغبت). - الإضافة مفتوحة المصدر ولها مستودع عام، وتوفر قوائم مثال ووكي لإرشادات الإعداد. - إصدارات Minecraft المدعومة يحددها المشروع؛ تحقق من التوافق مع إصدار خادمك قبل النشر. ## 🤝 متى تكون هذه الإضافة مفيدة إذا كنت تحتاج إلى واجهات GUI للحقيبة قابلة للتخصيص ومبنية على YAML، تعرض بيانات خاصة باللاعبين وتنفذ أوامر عند النقر، فإن DeluxeMenus خيار عملي لإنشاء المتاجر وقوائم الاختيار والواجهات داخل اللعبة من دون برمجة مخصصة.

الإضافات