إضافة Minecraft MyCommand

🔌 حول MyCommand

MyCommand هو إضافة Minecraft لإنشاء أوامر مخصصة، وبدائل للأوامر، وواجهات تفاعلية تعتمد على الأوامر بدون كتابة Java. يوفّر نظامًا قائمًا على YAML لتعريف أوامر تُشغّل أوامر أخرى، وترسل نصًا منسقًا، وتفتح GUI، وتفعّل سكربتات، وتتفاعل مع الأحداث.

🎯 الهدف

MyCommand موجّه لمديري الخوادم الذين يحتاجون إلى أوامر مخصصة مرنة، واختصارات، وواجهات للإدارة/اللاعبين. يحل مشكلة إضافة سلوك أوامر مخصص (التأخير، warmups، cooldowns، tab-completion، placeholders) وتفاعلات GUI خفيفة بدون تطوير إضافة كاملة.

⚙️ الميزات

• إنشاء أوامر وبدائل جديدة، مع إمكانية تسجيلها لإكمال التبويب.
• تشغيل عدة أوامر من أمر مخصص واحد (تنفيذ من console أو من اللاعب).
• تأخيرات وwarmups وcooldowns للأوامر.
• استبدال أوامر أخرى أو توفير اختصارات/بدائل.
• مشغلات أوامر من العناصر، والبلوكات، واللافتات، والكتب، وNPCs، وitem frames.
• عناصر GUI: IconMenu المعتمد على chest، وActionBar، وBossBar، وTitle، وScoreboard، وAnvil GUI، وSign GUI.
• دعم placeholders وconditional شبيهة بالسكربت للسلوك الديناميكي.
• تكامل اقتصادي (اختياري عبر Vault) وبعض ميزات الاقتصاد المستقلة.
• دعم أحداث اللاعبين (join/quit/death) والمهام المجدولة.
• قاعدة بيانات مخصصة للاعبين عبر SQL بشكل اختياري ودعم عدة ملفات لأوامر غير محدودة.
• ميزات متعلقة بـ BungeeCord وإصدار منفصل للجانب Bungee لأوامر جهة البروكسي.
• طلبات HTTP (GET/POST) ودعم تنسيق MiniMessage حيثما كان متاحًا.
• يستخدم bStats لتقارير المقاييس.

🧩 لمن هو مناسب

• خوادم Survival وSMP التي تريد أوامر وقوائم مخصصة بدون برمجة.
• الخوادم التي تعتمد على الإدارة أو الاقتصاد وتحتاج مسارات shop/command مخصصة.
• شبكات البروكسي التي تحتاج سلوك أوامر مركزيًا أو على جانب البروكسي.
• مشغلو الخوادم الذين يحتاجون conditional وplaceholders مبنية على السكربت لإخراج ديناميكي.

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

• تعريف أمر واحد يشغّل سلسلة من أوامر console لفتح متجر، ومنح العناصر، وتسجيل عملية الشراء.
• إنشاء قوائم GUI للعقاب/الانتقال باستخدام إدخالات chest GUI وطلبات anvil/sign.
• توفير بدائل قصيرة تُطابق أوامر تبديل السيرفر الأطول في BungeeCord مع tab completion.

⌨️ الأوامر

تسرد الوثائق الرسمية أوامر إدارية لإدارة الإضافة. وتتضمن أمثلة موثقة من المشروع:

(راجع وثائق الأوامر الرسمية للإضافة للحصول على القائمة الكاملة والصياغة الدقيقة.)

🔐 الصلاحيات

توثّق المشروع node صلاحيات للإجراءات الإدارية. وتشمل أمثلة من قائمة الصلاحيات الرسمية:

(راجع وثائق الصلاحيات الخاصة بالإضافة للحصول على خريطة الصلاحيات الكاملة.)

⚙️ التثبيت

📥 الإعداد

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

📦 Dependencies

• ProtocolLib — مذكور كعنصر مهم إذا لم يتم تحميل الإضافة أو لبعض الميزات.
• Vault — اختياري، مطلوب لتكامل الاقتصاد.
• PlaceholderAPI — اختياري، لتوسيع دعم placeholders.

قم بتثبيت الاعتماديات المؤكدة فقط للميزات التي تريدها؛ فالكثير من التكاملات اختيارية.

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

• يتم إعداد الإضافة عبر ملفات YAML وتدعم عدة ملفات أوامر لتجنب حدود الأوامر.
• يتوفر التخزين عبر SQL لقاعدة بيانات اللاعبين المخصصة (اختياري) كما يتم دعم إعدادات عدة ملفات.
• يوجد مكوّن BungeeCord منفصل لمعالجة الأوامر على جانب البروكسي.
• يرسل المشروع المقاييس عبر bStats.
• يتوفر تنسيق MiniMessage ودعم tab-completion في البيئات المدعومة.

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

إذا كنت تحتاج إلى أوامر مخصصة مرنة تعتمد على الملفات، وسكربتات شرطية، ومسارات أوامر قائمة على GUI بدون كتابة Java، فإن MyCommand يوفر منصة قابلة للتخصيص لهذه الاحتياجات ويضيف تكاملات البروكسي والاقتصاد عند الحاجة.