پلاگین ها در سرورهای Minecraft. این سیستم مجوز، اقتصاد، حفاظت، بازار، رویداد، ادعا، ضد تقلب و بسیاری از سیستم های خاص را اجرا می کند. اگر یکی از پلاگین ها نصب نشده باشد، ممکن است بخش قابل توجهی از سرور کار نکند.

خطاهای پلاگین معمولاً در کنسول یا logs/latest.log در فایل ظاهر می شود. رایج ترین اشتباهات؛ افزونه بارگیری نشد، نسخه API پشتیبانی نشده، وابستگی ناشناخته، plugin.yml نامعتبر است و ناسازگاری های نسخه جاوا.

1. کجا می توانید خطای پلاگین را ببینید؟

اگر افزونه بارگیری نمی شود، اولین جایی که باید نگاه کنید کنسول سرور و فایل last.log است.

tail -n 200 logs/latest.log

برای پیگیری زنده:

tail -f logs/latest.log

برای جستجو بر اساس نام افزونه:

grep -i "pluginadi" logs/latest.log

2. خطای نسخه API پشتیبانی نشده

این خطا نشان می دهد که نسخه Minecraft API پشتیبانی شده توسط افزونه با نسخه سرور ناسازگار است.

Unsupported API version 1.20

به عنوان مثال، ممکن است افزونه برای 1.20 آماده شده باشد، اما سرور شما ممکن است 1.16.5 را اجرا کند. در این صورت ممکن است افزونه بارگذاری نشده باشد یا اشتباه کار کند.

راه حل:

• نسخه Minecraft پشتیبانی شده توسط افزونه را بررسی کنید.
• نسخه افزونه سازگار با نسخه سرور خود را دانلود کنید.
• انتظار نداشته باشید که افزونه های جدید روی سرورهای بسیار قدیمی کار کنند.
• در صورت لزوم، نسخه مناسب را از آرشیو نسخه قدیمی افزونه پیدا کنید.

3. خطای وابستگی ناشناخته

برخی از افزونه ها به تنهایی کار نمی کنند. ابتدا افزونه دیگری را می خواهد که نصب شود. به این می گویند وابستگی.

Unknown dependency Vault
Could not load plugin because dependency LuckPerms was not found

به عنوان مثال، اغلب پلاگین های اقتصادی طاق می خواهد. افزونه های مجوز یا بازار ممکن است به افزونه های کتابخانه دیگری نیز نیاز داشته باشند.

راه حل:

• الزامات را در صفحه افزونه بخوانید.
• افزونه وابستگی گمشده را دانلود کنید.
• مطمئن شوید که افزونه وابستگی با نسخه سرور شما نیز سازگار است.
• سرور را به طور کامل راه اندازی مجدد کنید.

4. خطای plugin.yml نامعتبر

داخل فایل jar پلاگین plugin.yml اگر فایل خراب، گم شده یا نادرست باشد، افزونه قابل نصب نیست.

Invalid plugin.yml
Plugin does not contain a plugin.yml

این معمولا زمانی اتفاق می افتد که:

• فایل اشتباه دانلود شد
• به جای افزونه، کد منبع فشرده در پوشه افزونه ها قرار داده شده است.
• فایل Jar خراب است.
• این افزونه به اشتباه توسط توسعه دهنده بسته بندی شده است.

به عنوان راه حل، افزونه صحیح است. کوزه فایل باید دانلود شود. منبع-code.zip دانلود شده از GitHub نباید مستقیماً در پوشه افزونه ها قرار گیرد.

5. ناسازگاری نسخه جاوا

نسخه و افزونه های Minecraft به نسخه های جاوا خاصی نیاز دارند. اگر از نسخه جاوا اشتباه استفاده شود، ممکن است افزونه یا سرور اصلا باز نشود.

java -version

خطای رایج:

UnsupportedClassVersionError

این خطا نشان می دهد که افزونه با جاوا جدیدتر کامپایل شده است، اما جاوای قدیمی روی سرور استفاده می شود.

منطق کلی:

• نسخه های قدیمی Minecraft اغلب به جاوای قدیمی نیاز دارند.
• نسخه های جدید Minecraft به جاوا جدیدتری نیاز دارند.
• نیاز جاوا در توضیحات افزونه باید بررسی شود.
• نسخه جاوا انتخاب شده در پنل هاست باید تایید شود.

6. آیا فایل پلاگین در پوشه صحیح است؟

فایل های پلاگین را روی سرورهای Bukkit، Spigot و Paper قرار دهید پلاگین ها داخل پوشه پرتاب می شود.

ls plugins/

فایل افزونه باید به صورت زیر باشد:

plugins/PluginAdi.jar

پلاگین هایی که در zip، rar، کد منبع یا پوشه ها باقی می مانند اغلب کار نمی کنند.

7. تضاد پلاگین

دو افزونه که کار یکسانی را انجام می دهند ممکن است با یکدیگر تضاد داشته باشند. به عنوان مثال، دو افزونه چت متفاوت، دو افزونه اقتصادی متفاوت یا دو سیستم ادعایی متفاوت ممکن است سعی کنند رویدادهای یکسانی را مدیریت کنند.

علائم تعارض:

• افزونه نصب شده است اما دستورات آن کار نمی کند.
• یک افزونه تنظیمات دیگری را تحت تأثیر قرار می دهد.
• یک تداخل یا استثنا رویداد در کنسول رخ می دهد.
• بازیکنان حتی اگر مجوز داشته باشند نمی توانند از دستورات استفاده کنند.
• سرور بعد از راه اندازی مجدد رفتار متفاوتی دارد.

برای یافتن راه حل، پلاگین ها را می توان با غیرفعال کردن یک به یک آزمایش کرد. با این حال، قبل از انجام این کار در سرور زنده، باید یک نسخه پشتیبان تهیه کنید و ساعات پخش کم را ترجیح دهید.

8. خطای پیکربندی ممکن است از باز شدن پلاگین جلوگیری کند

در صورت وجود خطای YAML در فایل پیکربندی، برخی از افزونه ها باز نمی شوند. تورفتگی های فضای خالی به ویژه در فایل های YAML مهم هستند.

اشتباهات رایج:

• استفاده از کاراکتر تب
• بعد از کولون فاصله نگذارید
• نوشتن متنی که نیاز به نقل قول بدون نقل قول دارد
• خرابی فایل به دلیل کاراکتر ترکی یا نماد خاص
• ذخیره فایل پیکربندی گم شده

اگر فایل پیکربندی نادرستی وجود دارد، پوشه پلاگین را می توان به طور موقت تغییر نام داد تا از پوشه افزونه نسخه پشتیبان تهیه شود و پیکربندی دوباره ایجاد شود.

اشتباهات رایج

• نصب افزونه هایی که با نسخه سرور سازگار نیستند
• نصب نکردن افزونه های وابستگی از دست رفته
• اشتباه گرفتن فایل فشرده منبع GitHub به عنوان یک افزونه
• بررسی نکردن نسخه جاوا
• در حال تلاش برای نصب یک افزونه با /reload
• استفاده از تب ها در فایل های پیکربندی YAML

سوالات متداول

افزونه در پوشه افزونه ها هست اما کار نمی کند، چرا؟
این می تواند ناسازگاری نسخه، عدم وابستگی، ناسازگاری جاوا یا خطای پیکربندی باشد. فایل latest.log باید بررسی شود.

UnsupportedClassVersionError به چه معناست؟
این افزونه به تازگی با جاوا کامپایل شده است. نسخه جاوا استفاده شده در سرور قدیمی است.

آیا استفاده از / بارگذاری مجدد بی خطر است؟
برای بسیاری از افزونه ها توصیه نمی شود. راه اندازی مجدد کامل برای نصب، حذف افزونه و تغییرات عمده پیکربندی ایمن تر است.

توصیه های ایمنی و عملیات

• افزونه ها را از منابع معتبر دانلود کنید.
• قبل از افزودن افزونه به سرور زنده، آن را در سرور آزمایشی امتحان کنید.
• قبل از هر به روز رسانی افزونه از پوشه افزونه ها نسخه پشتیبان تهیه کنید.
• با حذف پلاگین های غیر ضروری سطح حمله را کاهش دهید.
• لاگ های افزونه را به طور منظم بررسی کنید.

این مقاله به طور ویژه برای PvPServer تهیه شده است.