كيف تثبّت plugin لـ Minecraft

خطوة بخطوة

1. 1.تأكد أن خادمك يستطيع تشغيل الـ plugins

   تحتاج الـ plugins إلى برنامج خادم مبني على Bukkit: Paper أو Spigot أو Purpur أو Folia لخوادم اللعب، وBungeeCord أو Velocity للبروكسي. الخادم الأصلي (vanilla)، أو خادم Fabric أو Forge، لا يحمّل الـ plugins.

2. 2.تحقق من إصدار الـ plugin

   تذكر صفحة الـ plugin أو ملفه إصدارات Minecraft التي يدعمها. الـ plugin المبني لإصدار أحدث من خادمك يرفض التحميل عادةً.

3. 3.أوقف الخادم وانسخ ملف .jar

   ضع ملف .jar في مجلد plugins/ بجانب ملف .jar الخاص بالخادم. في لوحة الاستضافة، ارفعه بمدير الملفات أو عبر SFTP. لا تفك ضغطه.

4. 4.ثبّت اعتمادياته

   إذا كان الـ plugin يحتاج إلى plugins أخرى (Vault أو PlaceholderAPI أو ProtocolLib أو LuckPerms)، فضع ملفات .jar الخاصة بها في plugins/ أيضاً.

5. 5.شغّل الخادم واقرأ وحدة التحكم

   ابحث عن اسم الـ plugin في سجل الإقلاع. "Enabling <Plugin>" دون خطأ بعدها يعني أنه حُمّل.

6. 6.تحقق منه داخل اللعبة واضبط إعداداته

   نفّذ /plugins: الـ plugins المحمّلة خضراء، والتي فشل تفعيلها حمراء. تظهر إعداداته في plugins/<PluginName>/config.yml؛ عدّلها وأعد التشغيل.

أين توضع الملفات

يبدو مجلد الخادم المعتاد هكذا بعد أول تشغيل مع plugin:

• paper.jar (أو spigot.jar): الخادم نفسه.
• plugins/MyPlugin.jar: الـ plugin الذي أضفته.
• plugins/MyPlugin/: مجلد ينشئه الـ plugin، فيه config.yml والرسائل وبياناته المحفوظة.
• logs/latest.log: سجل التشغيل الحالي، حيث تُكتب أخطاء التحميل.

أعد التشغيل، لا تستخدم /reload

يزيل /reload تحميل كل الـ plugins ويعيد تحميلها دون إعادة تشغيل الخادم. كثير من الـ plugins لا تدعمه: تُسجَّل المستمعات مرتين، أو تضيع البيانات أو تتسرب الذاكرة. أعد تشغيل الخادم دائماً بعد إضافة plugin أو حذفه أو تحديثه. لبعض الـ plugins أمر إعادة تحميل خاص بها (مثل /myplugin reload) لإعداداتها فقط: وهذا آمن للاستخدام.

قبل التثبيت على الخادم الحي

• خذ نسخة احتياطية من مجلد الخادم، أو على الأقل من plugins/ والعوالم.
• جرّبه على نسخة أولاً: بالبرنامج والإصدار والـ plugins الأخرى نفسها كما في الخادم الحقيقي. راجع كيف تختبر plugin.
• plugin واحد في كل مرة: إذا تعطّل شيء، تعرف أيّها السبب.
• نزّل من صفحة المؤلف (SpigotMC أو Hangar أو Modrinth أو GitHub)، لا من إعادات الرفع.

plugins مصنوعة بـ Codexe

يأتي الـ plugin المصنوع على Codexe كملف .jar مبني يحمل اسم المشروع، ومفحوص قبل أن تحصل عليه: يجب أن يحتوي على الفئات المجمَّعة وعلى plugin.yml. يمكنك تجربته على خادم تجريبي خاص قبل تثبيته في أي مكان، مجاناً في كل الخطط؛ ويثبّت لك الخادم التجريبي الـ plugins المذكورة كاعتماديات. أما تنزيل ملف .jar لخادمك الخاص فيتطلب خطة أو حزمة تنزيل.

أسئلة