Как решить проблему с ошибкой загрузки плагина Minecraft?
Подробное руководство по ошибкам Bukkit, Spigot, Paper, зависимостей и неподдерживаемых версий API.
Плагины на серверах Minecraft; Здесь работает система авторизации, экономика, защита, рынок, события, претензии, античит и множество специальных систем. Если один из плагинов не установлен, значительная часть сервера может не работать.
Ошибки плагина обычно возникают в консоли или журналы/latest.log появляется в файле. Самые распространенные ошибки; Не удалось загрузить плагин, Неподдерживаемая версия API, неизвестная зависимость, Неверный плагин.yml и несовместимость версий Java.
1. Где можно увидеть ошибку плагина?
Если плагин не загружается, в первую очередь нужно посмотреть консоль сервера и файл последний.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. Неверная ошибка плагина.yml.
Внутри файла jar плагина плагин.yml Если файл поврежден, отсутствует или неверен, плагин невозможно установить.
Invalid plugin.yml Plugin does not contain a plugin.yml
Обычно это происходит, когда:
- Был скачан не тот файл.
- Вместо плагина в папку плагинов был помещен zip-архив с исходным кодом.
- Jar-файл поврежден.
- Плагин был неправильно упакован разработчиком.
Как решение плагин правильный. .банка Файл должен быть загружен. Исходный код.zip, загруженный с GitHub, не следует помещать непосредственно в папку плагинов.
5. Несовместимость версий Java.
Версия Minecraft и плагины требуют определенных версий Java. Если используется неправильная версия Java, плагин или сервер могут вообще не открыться.
java -version
Распространенная ошибка:
UnsupportedClassVersionError
Эта ошибка указывает на то, что плагин был скомпилирован с более новой версией Java, но на сервере используется более старая версия Java.
Общая логика:
- Более старые версии Minecraft часто требуют более старой версии Java.
- Для новых версий Minecraft требуется более новая версия Java.
- Необходимо проверить требование Java в описании плагина.
- Выбранную версию Java в панели хостинга необходимо проверить.
6. Находится ли файл плагина в правильной папке?
Файлы плагинов на серверах Bukkit, Spigot и Paper. плагины кидается в папку.
ls plugins/
Файл плагина должен быть таким:
plugins/PluginAdi.jar
Плагины, оставленные в zip, rar, исходном коде или папках, часто не работают.
7. Конфликты плагинов
Два плагина, выполняющие одну и ту же работу, могут конфликтовать друг с другом. Например, два разных плагина чата, два разных плагина экономики или две разные системы претензий могут пытаться управлять одними и теми же событиями.
Симптомы конфликта:
- Плагин установлен, но его команды не работают.
- Один плагин подавляет настройки другого.
- В консоли возникает конфликт событий или исключение.
- Игроки не могут использовать команды, даже если у них есть разрешение.
- Сервер ведет себя по-другому после перезапуска.
Чтобы найти решение, плагины можно протестировать, отключив их один за другим. Однако, прежде чем делать это на основном сервере, необходимо сделать резервную копию и отдать предпочтение небольшому количеству игровых часов.
8. Ошибка конфигурации может помешать открытию плагина
Некоторые плагины не откроются, если в файле конфигурации есть ошибка YAML. Отступы пробелов особенно важны в файлах YAML.
Распространенные ошибки:
- Использование символа табуляции
- Не оставляйте пробел после двоеточия
- Написание текста, требующего кавычек, без кавычек
- Файл поврежден из-за турецкого символа или специального символа.
- Сохранение отсутствующего файла конфигурации
Если существует неправильный файл конфигурации, папку плагина можно временно переименовать, чтобы создать резервную копию папки плагина и воссоздать конфигурацию.
Распространенные ошибки
- Установка плагинов, несовместимых с версией сервера
- Не устанавливать отсутствующие плагины зависимостей
- Принятие исходного zip-файла GitHub за плагин
- Не проверять версию Java
- Пытаюсь установить плагин с /reload
- Использование вкладок в файлах конфигурации YAML
Часто задаваемые вопросы
Плагин лежит в папке с плагинами, но не работает, почему?
Это может быть несовместимость версий, отсутствие зависимости, несовместимость Java или ошибка конфигурации. Необходимо проверить последний файл журнала.
Что означает UnsupportedClassVersionError?
Плагин только что был скомпилирован с Java. Версия Java, используемая на сервере, устарела.
Безопасно ли использовать /перезагрузить?
Не рекомендуется для многих плагинов. Полный перезапуск безопаснее при установке, удалении плагина и серьезных изменениях конфигурации.
Рекомендации по безопасности и эксплуатации
- Скачивайте плагины из надежных источников.
- Прежде чем добавлять плагин на рабочий сервер, попробуйте его на тестовом сервере.
- Создавайте резервную копию папки плагинов перед каждым обновлением плагина.
- Уменьшите поверхность атаки, удалив ненужные плагины.
- Регулярно проверяйте журналы плагинов.
Эта статья специально подготовлена для PvPServer.