Minecraft · плагины

Плагин Paper не загрузился: зависимости, дубликаты и неверный JAR

Разберите первую ошибку загрузки плагина Minecraft и исправьте её без выдачи лишних прав и удаления мира.

Если команда нового плагина не работает, сначала проверьте, загрузился ли сам плагин. На Paper в консоли сервера выполните plugins, затем откройте начало logs/latest.log во вкладке «Файлы». Отсутствующий или отключённый плагин нужно чинить на этапе загрузки; права игрока не исправят ошибку чтения JAR.

Объёмная синяя линза над вычислительным модулем — диагностика сервера.

Как проверить загрузку плагина

  1. Сохраните исходную ошибку

    Найдите первое упоминание нужного плагина после запуска. Скопируйте строку ошибки и несколько соседних строк, а также версию Paper. Если дальше идёт длинная цепочка исключений, сохраните её целиком: последняя строка «не удалось включить» часто лишь повторяет последствие.

  2. Определите класс отказа

    UnknownDependencyException указывает на отсутствующую зависимость: установите именно названный компонент совместимой версии. Invalid plugin.yml требует проверить, что скачан настоящий плагин Paper/Bukkit, а не мод Forge или повреждённый файл. Ambiguous plugin name означает, что обнаружены две версии с одним внутренним именем.

  3. Файлы

    Проверьте фактическую загрузку

    JAR должен лежать непосредственно в plugins, а не внутри папки распакованного архива. Сравните имя и размер загруженного файла с оригиналом на компьютере. При дубликате скачайте старый JAR для возврата и уберите его из каталога загрузки, оставив ровно одну выбранную версию.

  4. Перезапустите и проверьте действие

    Перед изменением сохраните бэкап. Остановите сервер, завершите замену файлов и запустите его снова. Дождитесь завершения загрузки, повторите plugins и проверьте именно ту команду или функцию, которая раньше не работала. Успех — отсутствие прежней ошибки плюс работа нужного действия.

Если плагин уже включён, а функция недоступна одному участнику, сравните результат у обычного игрока и у владельца, затем сверьте требуемое разрешение с документацией плагина. Не выдавайте всем операторские права ради проверки. В обращении к автору укажите версию плагина, зависимостей и ядра, приложите воспроизводимые шаги. Удалите из отправляемых конфигов пароли и ключи: для диагностики загрузки они не нужны.

Читайте дальше

Minecraft

Свой сервер Minecraft: шесть шагов до первого входа

Как создать сервер Minecraft за шесть шагов и минут за десять: версия, плагины и адрес, который отправляют друзьям. Скачивать на свой компьютер ничего не нужно.

Minecraft · ядра

Paper, Leaf, Purpur, Forge и Velocity: что выбрать

Какое ядро Minecraft выбрать под свои задачи: три из пяти держат плагины, одно — моды, а пятое вообще не игровой сервер, а прокси для сети серверов.

Minecraft · файлы

Плагины и моды: куда класть файлы

Как поставить плагин или мод на сервер Minecraft: куда положить файл через панель, чем папка plugins отличается от mods и что делать, если ничего не произошло.

Minecraft · тариф

Сколько игроков потянет тариф

Сколько игроков выдержит сервер Minecraft на вашем тарифе: таблица «память — игроки — дальность прорисовки» и объяснение, откуда взялись именно эти числа.

Minecraft · мир

Ад и Край: как выключить и как вернуть обратно

Как отключить Ад на сервере Minecraft и вернуть его обратно: до 1.21.8 это строка в файле, дальше — команда в консоли, а Край выключается вообще в третьем месте.

Minecraft · права

Права игрокам: оператор и LuckPerms

Как выдать права игроку на сервере Minecraft: оператор — это одна команда в консоли и доступ ко всему сразу. Когда столько отдавать не хочется, ставят LuckPerms.

Minecraft · приваты

Приваты: как закрыть постройки от чужих рук

Как сделать приваты на сервере Minecraft: в самой игре защиты нет, кроме квадрата вокруг спавна. Дальше нужен плагин — вот три, которые ставят чаще всего.

Minecraft · настройки

Сложность, PvP, спавн, время и погода: где что менять

Где на сервере Minecraft менять сложность, PvP, точку появления, время и погоду: у каждой настройки своё место — вкладка панели, строка в файле или команда в консоли.

Minecraft · вывеска

Иконка сервера: свой значок в списке

Как поставить свою иконку сервера Minecraft: картинка 64 на 64 пикселя, имя файла server-icon.png и папка, в которую его кладут. Занимает пару минут.

Minecraft · вывеска

Описание сервера (MOTD): строка под адресом

Как изменить описание сервера Minecraft — ту самую строку под названием в списке. Меняется одним полем в панели, файл править бесполезно.

Minecraft · мир

Защита спавна: почему у точки входа не строится

Почему на сервере Minecraft нельзя ломать блоки рядом с точкой появления и как изменить радиус защиты спавна или выключить её совсем.

Minecraft · версии

Какая Java на сервере и почему её не выбирают

Какая версия Java работает на сервере Minecraft, почему поля выбора Java в панели нет и что делать, если нужной версии игры нет в списке.

Minecraft · мир

Свой мир на сервере: загрузить и забрать обратно

Как перенести мир из одиночной игры на сервер Minecraft и как забрать серверный мир себе. Загрузка идёт через панель, выгрузка — через SFTP.

Minecraft · ресурс-пак

Ресурс-пак: как раздать текстуры игрокам

Как сделать, чтобы при входе на сервер Minecraft игрокам сам предлагался ваш ресурс-пак: три строки в настройках и прямая ссылка на архив.

Minecraft · доступ

Белый список: пустить на сервер только своих

Как включить белый список на сервере Minecraft и добавить в него ников: переключатель в панели, команды консоли и порядок, в котором это делают.

Minecraft · доступ

Пиратский сервер: что меняет проверка лицензии

Сервер Minecraft здесь открыт для пиратских клиентов с первого запуска: чем за это платят, где переключатель и что поставить, чтобы ники нельзя было присвоить.

Minecraft · разбор

Ошибка «Failed to verify username»

Что означает «Не удалось проверить имя пользователя» при входе на сервер Minecraft, три её причины и что делать в каждом случае.

Minecraft · моды

Клиентские моды на сервере: почему он падает

Почему сервер Minecraft падает после установки модов, как отличить клиентский мод от серверного и как найти лишний файл в папке mods.

Minecraft · безопасность

Как не потерять сервер: права, плагины, бэкапы

Что защищает сервер Minecraft от погрома и от чужих рук: кому давать оператора, откуда брать плагины и почему бэкап важнее всех остальных мер.

Minecraft · диагностика

Как найти причину лагов Minecraft с помощью spark

Снимите профиль сервера Minecraft на Paper во время лагов, сопоставьте его с действиями игроков и проверьте одну гипотезу повторным замером.

Minecraft · обслуживание

Как обновить плагины Minecraft и сохранить возможность отката

Подготовьте совместимые версии плагинов Minecraft, сохраните настройки вместе с JAR и проверьте обновление на обычных действиях игроков.