Многие плагины и моды строятся на основе других: плагину магазина нужны Vault и экономический плагин, плагину меню нужен PlaceholderAPI, моду Fabric нужен Fabric API. Если этой основы нет, она слишком старая или сама не запускается, зависимый плагин полностью или частично отключается. В большинстве случаев сервер продолжает работать, просто функции затронутого плагина недоступны.

Каждый раздел ниже посвящён одному сообщению. Полное сообщение ты найдёшь в Консоль или в разделе Файлы в logs/latest.log. Читай также строки перед ним: там часто указано, какой плагин не загрузился первым. Прежде чем заменять плагины или менять файлы конфигурации, создай резервную копию в разделе Резервные копии. После каждого изменения полностью перезапускай сервер, а не используй /reload, чтобы все плагины загружались в правильном порядке.

NoClassDefFoundError и ClassNotFoundException: не хватает класса

Как выглядит сообщение:

java.lang.NoClassDefFoundError: org/geysermc/geyser/network/bedrock/nethernet/NetherNetServer
java.lang.NoClassDefFoundError: org/cloudburstmc/protocol/bedrock/data/MovementEffectType
Error loading class: org/jetbrains/annotations/ApiStatus$ScheduledForRemoval (java.lang.ClassNotFoundException: org.jetbrains.annotations.ApiStatus$ScheduledForRemoval)

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

Как это исправить:

  1. Найди в строках вокруг сообщения плагин или мод, которого это касается. Определить его помогает имя файла перед .jar// в стектрейсе, то есть в списке вызовов под ошибкой; для модов также помогают предыдущие строки загрузки.
  2. Сравни на странице проекта требуемые зависимости и версии с установленными у тебя Плагины или Моды.
  3. Останови сервер, установи недостающие зависимости или замени затронутые файлы на подходящие друг другу версии.
  4. Выполни полный перезапуск и снова проверь Консоль.

Полезно знать: заменяй файлы плагинов и модов только при остановленном сервере. Если файлы были заменены во время работы, перезагрузи их полным перезапуском.

«Cannot execute command … plugin is disabled»: команда плагина отключена

Так выглядит сообщение:

Unexpected exception while parsing console command "<Command>"
org.bukkit.command.CommandException: Cannot execute command '<Command>' in plugin <Plugin> v<Version> - plugin is disabled.
[Essentials] Cannot execute command '<Command>' in plugin <Plugin> v<Version> - plugin is disabled.

В чём причина: Команда принадлежит плагину, который не удалось активировать при запуске сервера. Настоящая причина указана выше в логе запуска, часто это «unsupported server version»: версия плагина не подходит к версии сервера. Решающее значение имеет название после «in plugin», даже если в начале стоит «Essentials». Если отключённый плагин заменяет базовые команды, например list, то и они перестают работать. Сам сервер продолжает работать.

Как это исправить:

  1. Открой в разделе Файлы файл logs/latest.log и найди название плагина после «in plugin». Прочитай сообщения при запуске, например «Error occurred while enabling …».
  2. Введи в Консоль команду plugins. Отключённые плагины отображаются там красным цветом.
  3. Устрани ошибку запуска. Проверь в разделе Версия версию сервера и установи в разделе Плагины подходящую версию плагина. Перед заменой останови сервер. Подробнее: Плагин не подходит к версии сервера.
  4. Перезапусти сервер и проверь командой plugins, что плагин отображается зелёным. Затем протестируй команду.

Полезно знать: Сообщение о команде является следствием ошибки запуска. Оно исчезнет, как только плагин снова запустится.

„Vault economy not found“: отсутствует связь Vault с плагином экономики

Так выглядит сообщение:

[<Plugin>] Vault economy not found! Disabling plugin...
[<Plugin>] - Disabled due to no Vault dependency found!
[<Plugin>] java.lang.IllegalStateException: Found Vault but no economy, please check whether your economy plugin supports Vault.

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

Как это исправить:

  1. Проверь в разделе Плагины, установлен ли Vault.
  2. Проверь, установлен ли плагин экономики с поддержкой Vault, например EssentialsX с его встроенной экономикой, CMI или XConomy.
  3. Установи то, чего не хватает, в версии для твоей версии сервера.
  4. Полностью перезапусти сервер. Команда /reload или подгрузка отдельных плагинов легко нарушает порядок загрузки.
  5. Введи в Консоль команду vault-info. Рядом с «Economy» теперь должен отображаться твой плагин экономики.

Полезно знать: Сообщение появляется и тогда, когда Vault есть, но сам плагин экономики не запускается при старте. В этом случае поищи его название в logs/latest.log.

«Failed to register events»: не хватает нужного плагина или части серверной программы

Как выглядит сообщение:

[<Plugin>] Failed to register events for class <Class> because com/vexsoftware/votifier/model/VotifierEvent does not exist.
[<Plugin>] Failed to register events for class <Class> because com/projectkorra/projectkorra/event/BendingPlayerCreationEvent does not exist.
[<Plugin>] Failed to register events for class <Class> because io/papermc/paper/event/player/AsyncPlayerSpawnLocationEvent does not exist.

В чём причина: плагин не может зарегистрировать листенеры, то есть функции для игровых событий, потому что отсутствует нужный класс. Классы — это части программы, которые здесь обычно предоставляет другой плагин. Затронутые функции не работают; остальные функции сервера могут продолжать работать. Путь после because поможет определить, чего не хватает:

  • me/clip/placeholderapi: PlaceholderAPI; net/milkbowl/vault: Vault.
  • com/ghostchu/quickshop: QuickShop-Hikari; net/ess3: EssentialsX.
  • com/vexsoftware/votifier: Votifier; com/projectkorra: ProjectKorra.

Как это исправить:

  1. Сопоставь указанный путь с нужным плагином и проверь его требования.
  2. Если плагина нет, установи его в разделе Плагины в выпуске, подходящем к версии сервера. Если он уже установлен, поищи в logs/latest.log собственные ошибки запуска этого плагина и сначала устрани их.
  3. Если в пути указано io/papermc или org/bukkit, проверь, какое серверное ПО и какую версию поддерживает плагин, выдающий сообщение. Выбери подходящую комбинацию.
  4. Перезапусти сервер и проверь Консоль.

Полезно знать: отсутствующие классы сервера могут указывать на другую или неподходящую версию серверного ПО. Плагин не подходит к версии сервера.

«Could not hook into …»: нужный плагин отсутствует или не загружен

Как выглядит сообщение:

[<Plugin>] Could not hook into PlaceholderAPI!
<Plugin> will now disable!

В чём причина: «Hook» здесь означает привязку. Плагин, выдавший сообщение, хотел при запуске подключиться к другому плагину, который нужен ему для работы. Но тот отсутствовал или к этому моменту ещё не был загружен. Многие плагины после этого сами отключаются. Сервер продолжает работать как обычно, но функции этого плагина полностью недоступны — например, у плагина меню не работают все меню.

Как это исправить:

  1. Определи оба названия по сообщению: в квадратных скобках — плагин, выдавший сообщение, после «hook into» — недостающий.
  2. Если недостающего плагина нет в разделе Плагины, установи его в версии для твоей версии сервера. Очень часто это PlaceholderAPI.
  3. Если он уже установлен, поищи его название в logs/latest.log. Если при запуске он сам выдаёт ошибку, это и есть настоящая причина. Сначала устрани её.
  4. Полностью перезапусти сервер.

Полезно знать: плагин, выдавший сообщение, переустанавливать не нужно. Он снова заработает, как только зависимость будет доступна при запуске.

ViaBackwards отключается, потому что ViaVersion слишком старый

Так выглядит сообщение:

[ViaBackwards] YOUR VIAVERSION IS OUTDATED
[ViaBackwards] VIABACKWARDS WILL NOW DISABLE

Что за этим стоит: ViaVersion пускает на твой сервер игроков с более новыми версиями Minecraft, а ViaBackwards дополняет это для более старых версий. ViaBackwards — расширение для ViaVersion и требует подходящей, достаточно новой сборки ViaVersion. Если ViaVersion старше, ViaBackwards отключается. Сервер продолжает работать, но игроки со старыми клиентами больше не смогут зайти.

Как это исправить:

  1. Посмотри в разделе Плагины, какие версии ViaVersion и ViaBackwards установлены.
  2. Обнови оба плагина вместе до актуальных сборок, подходящих друг к другу. Само сообщение указывает официальную страницу загрузки. Если ты дополнительно используешь ViaRewind, обнови его на том же шаге.
  3. Перезапусти сервер и с помощью plugins в Консоль проверь, отображается ли ViaBackwards зелёным.

Полезно знать: Всегда обновляй плагины Via вместе. Тот, кто обновляет только ViaBackwards, получает именно это сообщение.

Подробнее: Настройка ViaVersion: подключение старых и новых клиентов

UltimateDonutSmp отключается без PlaceholderAPI

Так выглядит сообщение:

[UltimateDonutSmp] UltimateDonutSmp requires PlaceholderAPI
[UltimateDonutSmp] UltimateDonutSmp is disabling itself to prevent broken sidebar output.

В чём причина: UltimateDonutSmp показывает значения в сайдбаре — панели у правого края экрана. Эти значения поступают через плейсхолдеры — небольшие переменные вроде %player_name%, которые PlaceholderAPI заменяет реальными значениями. Если PlaceholderAPI отсутствует или отключён, UltimateDonutSmp намеренно отключается, чтобы игроки не видели сломанные плейсхолдеры. Сам сервер продолжает работать как обычно.

Как это исправить:

  1. Установи PlaceholderAPI в разделе Плагины в версии, подходящей для твоей версии сервера.
  2. Если он уже установлен, проверь в logs/latest.log, нет ли ошибки при запуске, и сначала устрани её.
  3. Останови сервер и затем снова запусти его. Перезагрузки командой здесь недостаточно.

Полезно знать: Если после этого в сайдбаре вместо чисел отображается текст вроде %vault_eco_balance%, не хватает расширения для PlaceholderAPI. Загрузи его в Консоли командой papi ecloud download <Расширение> и примени командой papi reload.

Необходимый плагин не установлен

Так выглядит сообщение:

[<Plugin>] <Dependency> is required but was not found
[<Plugin>] <Dependency> plugin not found! Disabling
[<Plugin>] Download <Dependency> from https://<Address>

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

Как это исправить:

  1. Запиши название недостающей основы из сообщения.
  2. Проверь в разделе Плагины, установлена ли она. Если нет, установи её в версии, подходящей для твоей версии сервера. Как это сделать: Установка плагинов и управление ими.
  3. Если она установлена, поищи её название в logs/latest.log. Ошибка при запуске тогда и есть настоящая причина.
  4. Перезапусти сервер.

Полезно знать: Если плагин, выдающий сообщение, тебе больше не нужен, можешь вместо этого удалить его. Тогда сообщение тоже исчезнет.

Плагин не находит экономическую систему

Так выглядит сообщение:

[<Plugin>] Vault economy provider not found!
[<Plugin>] Vault is not found or no economy plugin found

В чём причина: Для работы с деньгами, ценами и наградами плагину нужны два партнёра: Vault или VaultUnlocked в роли интерфейса и экономический плагин вроде EssentialsX, который ведёт балансы. Если он находит не оба, он отключается или не выдаёт денежные награды. Типичные последствия: плагин магазина вроде QuickShop запускается некорректно, плагин квестов сообщает, что не может выплатить награду.

Как это исправить:

  1. Проверь в разделе Плагины, установлен ли Vault или VaultUnlocked.
  2. Проверь, работает ли экономический плагин, например EssentialsX. Без него Vault нечего передавать дальше.
  3. Установи недостающее в версиях для твоей версии сервера и перезапусти сервер.
  4. Для Vault выполни в Консоли команду vault-info и проверь, указан ли рядом с «Economy» экономический плагин.

Полезно знать: Как настроить EssentialsX, описано в статье Настройка EssentialsX.

Плагин наград за голову Bountys не находит Vault

Так выглядит сообщение:

[Bountys] Vault Plugin wasn't detected!

В чём причина: Bountys выплачивает награды за голову через Vault и для этого, как правило, дополнительно требует экономический плагин, который ведёт балансы. При запуске Vault не был найден. Поэтому денежные функции Bountys не работают, и награды за голову выплатить нельзя. Сам сервер и другие плагины это не затрагивает.

Как это исправить:

  1. Реши, нужен ли тебе Bountys. Если нет, удали его в разделе Плагины, и сообщение исчезнет.
  2. Если хочешь его оставить, положи Vault и совместимый экономический плагин вроде EssentialsX в папку плагинов, проще всего через раздел Плагины.
  3. Если Vault уже там, проверь в logs/latest.log, не сообщает ли сам Vault об ошибке при запуске.
  4. Перезапусти сервер и проверь командой vault-info в Консоли, нашёл ли Vault экономический плагин.

Полезно знать: Если другие плагины сообщают, что Vault или экономика отсутствуют, все сообщения устраняются тем же способом.

AuthMe не находит через Vault плагин прав

Так выглядит сообщение:

[AuthMe] Error while hooking into Vault [PermissionHandlerException]: Could not load permissions provider service

В чём причина: AuthMe — это плагин авторизации, в котором игроки входят с помощью пароля. Для функций групп и прав он запрашивает через Vault службу разрешений, то есть плагин прав. Vault установлен, но не предоставляет AuthMe такую службу. Поэтому функции групп и разрешений в AuthMe не работают. Сообщение касается только этих дополнительных функций.

Как это исправить:

  1. Установи в разделе Плагины LuckPerms или другой плагин прав с поддержкой Vault.
  2. Обнови Vault и AuthMe до версий для твоей версии сервера.
  3. Перезапусти сервер.
  4. Введи в Консоли команду vault-info. Рядом с «Permission» теперь должен быть указан твой плагин прав.

Полезно знать: Как создавать группы и права, показано в статье Настройка LuckPerms.

StackSpawners требует DecentHolograms

Так выглядит сообщение:

[StackSpawners] DecentHolograms was not found. The plugin will not work

В чём причина: StackSpawners объединяет спавнеры и для своих парящих надписей, так называемых голограмм, использует плагин DecentHolograms. Самого этого функционала в нём нет. Если StackSpawners не находит DecentHolograms при запуске, он не может работать. Сервер продолжает работать, но функций StackSpawners не будет.

Как это исправить:

  1. Установи DecentHolograms в разделе Плагины в версии, подходящей для твоей версии сервера и для StackSpawners. Поддерживаемые версии указаны на странице плагина StackSpawners.
  2. Если DecentHolograms уже установлен, поищи в logs/latest.log ошибку запуска DecentHolograms и сначала устрани её.
  3. Полностью останови сервер и запусти его снова. Так оба плагина загрузятся в правильном порядке.

Полезно знать: Если StackSpawners тебе больше не нужен, удали его. Тогда отпадёт и зависимость.

LightAntiCheat-Plus не находит PacketEvents

Как выглядит сообщение:

(LightAntiCheat-Plus) Failed to start listener-mode … com/github/retrooper/packetevents/event/PacketListenerCommon

В чём причина: LightAntiCheat-Plus — это плагин античита. Он отслеживает сетевой трафик игроков через PacketEvents — отдельный плагин, который подготавливает сетевые пакеты для других плагинов. Если PacketEvents отсутствует или установлена версия, которую LightAntiCheat-Plus не ожидает, его мониторинг не запускается. Сервер продолжает работать, но защита от читов полностью или частично отключена.

Как это исправить:

  1. Загляни на страницу LightAntiCheat-Plus и узнай, какая версия PacketEvents ему нужна.
  2. Установи или обнови PacketEvents в разделе Плагины до этой версии, подходящей к версии твоего сервера.
  3. При необходимости обнови и LightAntiCheat-Plus, чтобы оба плагина подходили друг к другу.
  4. Полностью останови сервер и запусти его заново.

Полезно знать: Другие плагины часто тоже используют PacketEvents. После смены версии проверь в logs/latest.log, запускаются ли они по-прежнему без ошибок.

«The plugin is disabling itself»: плагин отключился после ошибки

Так выглядит сообщение:

[<Plugin>] The plugin is disabling itself.
[<Plugin>] [<Plugin>] Disabling plugin...
[<Plugin>] [PacketEvents] Nie udało się uruchomić systemu pakietowego kostiumów po <Count> próbach.

В чём причина: если плагин сообщает, что отключается после ошибки, его функции недоступны до следующего успешного запуска. Сервер Minecraft при этом продолжает работать. Польская строка PacketEvents указывает на систему костюмов, которую не удалось запустить после нескольких попыток; дополнительные сообщения об отключении показывают, выходит ли из строя весь плагин. Настоящая причина обычно указана в предыдущих строках, иногда на другом языке.

Как это исправить:

  1. Открой в разделе Файлы logs/latest.log и прочитай строки перед сообщением. Проверь, нет ли указаний на отсутствующие зависимости, неподходящие версии или ошибки конфигурации.
  2. Обнови затронутый плагин и проверь на его странице, подходит ли он к версии твоего сервера и нужны ли ему другие плагины.
  3. Перезапусти сервер и проверь в Консоль, запускаются ли плагин и затронутая функция.
  4. Если ошибка остаётся, сделай резервную копию папки плагинов, ради теста удали плагин и перезапусти сервер. Сообщи об ошибке автору плагина, приложив анонимизированные строки лога.

Полезно знать: ошибки во время работы ты можешь разобрать с помощью Плагин выдаёт ошибки во время работы.

AuthMeBia не подходит к твоей версии AuthMe

Как выглядит сообщение:

[AuthMeBia] AuthMe DataSource reflection unavailable; premium skip and session autologin both disabled

В чём причина: AuthMeBia — это расширение для плагина авторизации AuthMe. Оно обращается к функции внутри AuthMe, которой в твоей версии AuthMe в таком виде нет. Поэтому AuthMeBia отключает две функции: Premium-Skip, благодаря которому игроки с купленным аккаунтом Minecraft заходят без пароля, и Session-Autologin — автоматический вход, когда игрок снова заходит вскоре после выхода. Сам AuthMe продолжает работать, а игроки входят, как обычно, с паролем.

Как это исправить:

  1. Посмотри в разделе Плагины, какие версии AuthMe и AuthMeBia установлены.
  2. Проверь на странице AuthMeBia, для какой версии AuthMe она собрана.
  3. Обнови оба плагина до подходящих друг к другу версий и перезапусти сервер.
  4. Проверь с купленным аккаунтом, снова ли работает вход без пароля.

Расширение ProjectKorra не подходит к основной версии

Как выглядит сообщение:

java.lang.NoSuchMethodError: 'void com.projectkorra.projectkorra.<Class>.<Method>()'
com.jedk1.jedcore.ability.<Ability>@<Identifier>[…]

В чём причина: ProjectKorra добавляет на сервер способности бендинга, а расширения вроде JedCore добавляют новые. Каждое расширение собрано для определённой версии ProjectKorra. Если оно вызывает метод, то есть функцию, которой нет в твоей версии ProjectKorra, оно завершается с ошибкой «NoSuchMethodError». Иногда при этом оно записывает состояние способности в лог одной длинной строкой. Затронутые способности тогда не работают, остальной сервер продолжает работу.

Как это исправить:

  1. Запиши в разделе Плагины версию ProjectKorra и версии всех расширений.
  2. Открой страницу загрузки каждого расширения. Там указано, какая версия ProjectKorra ему нужна.
  3. Установи ProjectKorra и все расширения в версиях, которые подходят друг к другу и к версии твоего сервера.
  4. Перезапусти сервер и проверь одну из способностей расширения.

Полезно знать: Если для твоей версии ProjectKorra нет подходящего расширения, лучше удали его, а не смешивай старые и новые версии.

AppleSkin не запускается, потому что отсутствует Fabric API

Как выглядит сообщение:

Mod 'AppleSkin' (appleskin) <Версия> requires any version of fabric-api, which is missing!

В чём причина: Большинству модов Fabric нужна библиотека Fabric API — набор общих компонентов, которых нет в самом Fabric Loader. AppleSkin установлен, а Fabric API нет. Fabric Loader проверяет это при запуске и прерывает его. Поэтому твой сервер снова запустится только после того, как ты добавишь Fabric API или отключишь AppleSkin.

Как это исправить:

  1. Установи в разделе Моды Fabric API в версии для твоей версии Minecraft.
  2. Если AppleSkin тебе не нужен, воспользуйся кнопкой исправления у сообщения в разделе Состояние сервера. Она отключает AppleSkin (файл сохраняется) и перезапускает сервер.
  3. Проверь в Консоли, полностью ли запускается сервер.

Полезно знать: Fabric API должен подходить к твоей версии Minecraft. В сообщении сказано «any version», то есть AppleSkin сам не предъявляет особых требований.

Подробнее: Fabric Loader и Fabric API: как точечно устранить ошибки версий

Запрос баланса не удаётся, потому что EssentialsX ещё не готов

Так выглядит сообщение:

[ajLeaderboards] Placeholder <Placeholder> for player <Player> threw an error:
Essentials API is called before Essentials is loaded.

В чём причина: плейсхолдер — это текстовое сокращение, которое заменяется значением, например балансом счёта. Здесь запрос к EssentialsX не удаётся: его экономический интерфейс сейчас недоступен. Из-за этого значение в рейтинге не обновляется. Сервер продолжает работать.

Как это исправить:

  1. Проверь в Консоль, появляется ли сообщение при запуске, при остановке или во время работы.
  2. Прочитай более ранние ошибки запуска EssentialsX. Если плагин не загрузился успешно, сначала устрани их.
  3. Проверь в разделе Плагины EssentialsX, Vault, PlaceholderAPI и ajLeaderboards, а также установленное расширение для Vault. Используй совместимые друг с другом версии.
  4. Останови сервер перед заменой файлов, а затем полностью перезапусти его. После завершения запуска проверь рейтинг ещё раз.

Твоего сообщения здесь нет?

Прочитай сообщение целиком в logs/latest.log, включая строки перед ним. Обычно сервер сначала называет плагин, который не загрузился, и только потом выводит сопутствующие ошибки других плагинов. В стектрейсе имена файлов перед .jar и названия папок в пути классов, например me/clip/placeholderapi, подскажут, какой плагин или мод участвует в ошибке. Затем сравни зависимости на странице проекта с установленными плагинами. Перед любыми изменениями создавай резервную копию. Если не получается разобраться, открой тикет и укажи время появления сообщения.