Плагин Minecraft лежит в папке plugins/ в виде JAR-файла (архива Java) и всегда собран для определённых версий Minecraft, определённой версии Java и, как правило, для конкретного серверного ПО, например Paper или Spigot. Если что-то из этого не совпадает, плагин вообще не загружается, сам отключается или у него перестают работать отдельные функции. Каждый раздел ниже посвящён конкретному сообщению: как оно выглядит, что за ним стоит и как это исправить.

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

Плагину или серверу нужна более новая версия Java (UnsupportedClassVersionError)

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

[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins'
org.bukkit.plugin.InvalidPluginException: java.lang.UnsupportedClassVersionError: <Class> has been compiled by a more recent version of the Java Runtime (class file version 69.0), this version of the Java Runtime only recognizes class file versions up to 65.0

В чём причина: Java-программы компилируются под определённую версию Java. Файл из сообщения требует более новую версию Java, чем та, которую сейчас использует твой сервер. Числа подсказывают, какую именно: число минус 44 даёт версию Java, то есть 69 означает Java 25, а 65 — Java 21. Если в сообщении указан плагин, то не запускается именно этот плагин. Если оно касается самого серверного JAR-файла, не запускается весь сервер.

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

  1. Посмотри имя файла после Could not load plugin. Это и есть файл, который не подходит.
  2. Скачай на странице плагина сборку, предназначенную для твоей версии Minecraft.
  3. Замени старый файл в разделе Файлы в папке plugins/ и перезапусти сервер.
  4. Если тебе нужна именно эта сборка плагина, переключи сервер в разделе Версия на ту версию Minecraft, которую она требует. Подходящая версия Java устанавливается у нас автоматически для каждой версии Minecraft. Заранее создай резервную копию.

Полезно знать: Папка plugins/.paper-remapped — это рабочая копия Paper. Всегда заменяй файл напрямую в plugins/.

Подробнее: Какая версия Java нужна твоему серверу Minecraft?

Плагин собран для более новой версии Minecraft (Unsupported API version)

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

[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins/.paper-remapped'
org.bukkit.plugin.InvalidPluginException: Unsupported API version 26.1

В чём причина: Каждый плагин содержит небольшой файл-описание — plugin.yml. В нём в параметре api-version указано, для какой версии сервера он написан. Если эта версия новее, чем твой сервер, Paper вообще не загружает плагин, например при Unsupported API version 26.1 на сервере с версией 1.21.11. Сервер запускается, но всё, что должен был делать плагин, полностью отсутствует: команды, правила защиты, меню.

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

  1. Сравни число после Unsupported API version с версией Minecraft твоего сервера в разделе Версия.
  2. На Modrinth или SpigotMC отфильтруй загрузки плагина по своей версии Minecraft и скачай подходящую сборку.
  3. Замени старый файл в разделе Файлы в папке plugins/ и перезапусти сервер.
  4. Если подходящей сборки нет, переключи сервер в разделе Версия на ту версию, которую требует плагин. Заранее создай резервную копию, так как при этом мир переводится на новую версию.

Полезно знать: Не меняй api-version самостоятельно в файле плагина. Тогда плагин, конечно, загрузится, но будет использовать функции, которых нет на твоём сервере, и позже сломается с другими ошибками.

Подробнее: Как безопасно сменить версию Minecraft и загрузчик модов

Старый сервер Paper не может преобразовать новый плагин (Fatal error trying to convert)

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

Fatal error trying to convert Geyser-Spigot <Version>:org/geysermc/geyser/platform/spigot/GeyserSpigotPlugin.class
java.lang.IllegalArgumentException: Unsupported class file major version 65

В чём причина: Paper версии 1.19.4 или старше преобразует плагины при загрузке встроенным конвертером. Этот конвертер не умеет читать классы, скомпилированные для Java 21 или новее (major version 65 означает Java 21, 69 — Java 25). Поэтому плагин не загружается. Чаще всего это затрагивает Geyser: тогда игроки с Bedrock не могут зайти. Сам сервер запускается, а игроки с Java по-прежнему могут заходить.

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

  1. Посмотри имя после trying to convert. Это и есть затронутый плагин.
  2. Если хочешь остаться на своей версии Minecraft, скачай более старую сборку плагина, собранную именно для этой версии, и замени ею файл в разделе Файлы в папке plugins/.
  3. Либо переключи сервер в разделе Версия на Minecraft 1.20.5 или новее. Новые сборки Paper читают классы Java 21. Заранее создай резервную копию.
  4. Перезапусти сервер и проверь в Консоль, загружается ли плагин без ошибок.

Полезно знать: Сообщение часто появляется несколько раз подряд — по разу для каждого класса. Тем не менее затронут только один плагин.

Подробнее: Какая версия Java нужна твоему серверу Minecraft?

Плагин сообщает: эта версия сервера не поддерживается

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

[Essentials] You are running an unsupported server version!
[DecentHolograms] Plugin will now be disabled.
This plugin does not support Paper servers!

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

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

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

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

Paper не может адаптировать старый плагин под версию сервера (PluginRemapper)

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

[PluginRemapper] Encountered exception remapping plugins
java.util.concurrent.CompletionException: java.lang.RuntimeException: Failed to remap plugin jar 'plugins/<Plugin>.jar'

В чём причина: Новые версии Paper при запуске автоматически переписывают старые плагины под внутреннюю структуру текущей версии Minecraft. Это переписывание называется ремаппингом, готовые копии Paper сохраняет в plugins/.paper-remapped. Как минимум у одного плагина это не удалось. Сервер продолжает запускаться, но плагин может не работать вообще или работать лишь частично, часто без каких-либо других сообщений об ошибках.

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

  1. Посмотри имя файла после Failed to remap plugin jar.
  2. Если в имени есть что-то вроде (1), скорее всего, файл лежит в папке дважды. Удали лишнюю копию в разделе Файлы.
  3. Скачай сборку плагина, которая явно собрана для твоей версии Minecraft. Тогда Paper вообще не придётся ничего переписывать. Замени ею старый файл в plugins/.
  4. Перезапусти сервер и проверь, исчезло ли сообщение.

Полезно знать: Если подходящей сборки нет, плагин для твоей версии сервера ещё не готов. Удали его или дождись обновления.

Дубликаты файлов: Файл плагина повреждён, дублируется или это вообще не плагин

Неизвестное название блока или предмета в конфигурации плагина (Unsupported key)

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

Unsupported key: minecraft:bed

В чём причина: Minecraft ведёт каждый блок и каждый предмет под фиксированным названием вида minecraft:<name>, так называемым ключом реестра. Плагин или его конфигурация указывает название, которое твоя версия Minecraft не знает. Типичный пример — minecraft:bed: начиная с версии 1.13 кровати называются по цвету, например red_bed. Эта запись пропускается, сервер и остальная часть плагина продолжают работать.

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

  1. Посмотри в Консоль или в logs/latest.log на строки перед сообщением. Там указано, какой плагин загружается в данный момент.
  2. Открой в разделе Файлы конфигурацию этого плагина в папке plugins/<Plugin>/ и найди указанное название.
  3. Замени его актуальным обозначением, которое можно найти в вики Minecraft. Конфигурации в формате YAML (.yml) чувствительны: не меняй отступы и кавычки.
  4. Перезапусти сервер. Если название указано не в твоей конфигурации, а в самом плагине, поможет только обновление плагина.

Если в файле есть ошибки: Файл конфигурации плагина содержит ошибки

Плагину нужна более новая текстовая библиотека (Adventure), чем установлена на твоём сервере

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

Caused by: java.lang.ExceptionInInitializerError: Exception java.lang.TypeNotPresentException: Type net.kyori.adventure.text.TranslationArgument not present

В чём причина: Adventure — это библиотека, с помощью которой Paper создаёт цветные тексты чата, заголовки и всплывающие подсказки. Она встроена в сервер, поэтому её версия зависит от твоей версии Minecraft. Плагин собран под более новую версию Adventure, и указанного класса на твоём сервере нет. Поэтому части плагина не запускаются. Сервер продолжает работать.

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

  1. Выясни, какой плагин затронут. В стектрейсе, то есть в списке строк at … под сообщением, часто указано имя JAR-файла. Если нет, посмотри на строки выше.
  2. Скачай более старый выпуск плагина, собранный под версию твоего сервера, и замени файл в разделе Файлы в папке plugins/.
  3. Или переключи сервер в разделе Версия на более новую версию Minecraft. Перед этим создай резервную копию.

Полезно знать: Дополнительный файл Adventure в папке plugins/ не поможет, потому что Paper использует свою встроенную версию.

ProtocolLib не подходит к версии сервера

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

[ProtocolLib] INTERNAL ERROR: Cannot load ProtocolLib.
  If this problem hasn't already been reported, please open a ticket
  java.lang.IllegalArgumentException: Unable to find a field that matches …

В чём причина: ProtocolLib — вспомогательная библиотека, через которую другие плагины читают и изменяют сетевые пакеты. Для этого она глубоко обращается к внутренним частям сервера, а они меняются почти с каждой версией Minecraft. Если ProtocolLib не находит ожидаемые поля пакетов, она не загружается. Все плагины, которым нужна ProtocolLib, тогда тоже не работают.

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

  1. Скачай новейшую сборку ProtocolLib для своей текущей версии Minecraft. Для совсем новых версий подходящие сборки часто сначала появляются как предварительные версии на странице проекта.
  2. Замени старый файл в разделе Файлы в папке plugins/. Оставь только один файл ProtocolLib.
  3. Полностью перезапусти сервер, то есть останови и снова запусти его, а не через /reload.
  4. Введи в Консоль команду plugins и проверь, что ProtocolLib и зависимые плагины отображаются зелёным.

Полезно знать: Просьба открыть тикет в ProtocolLib исходит от самого плагина. Чаще всего просто не хватает подходящей сборки.

Зависимые плагины: Плагину нужен другой плагин, которого нет

Citizens отключается: сборка не подходит к версии Minecraft

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

[Citizens] v<Version> (build <Number>) is not compatible with Minecraft <Version> - try upgrading or downgrading Citizens. Disabling.

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

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

  1. Проверь в разделе Версия, какая версия Minecraft стоит на твоём сервере.
  2. Скачай сборку Citizens именно для этой версии. Во многих сборках Citizens в названии есть SNAPSHOT, но решающей является версия Minecraft, указанная на странице загрузки.
  3. Замени старый файл в разделе Файлы в папке plugins/ и перезапусти сервер.
  4. Если подходящей сборки нет, измени версию сервера в разделе Версия. Перед этим создай резервную копию.

Полезно знать: try upgrading or downgrading означает, что Citizens может быть как слишком старым, так и слишком новым. Самый свежий файл не обязательно правильный.

Плагин сообщает: несовместим с твоей версией Minecraft

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

[Citizens] v<Version> (build <Number>) is not compatible with your version of Minecraft. Disabling...
[<Plugin>] Plugin will be disabled!
Your MC version isn't supported

В чём причина: Плагин собран под другую версию Minecraft или другое серверное ПО и сам сообщает об этом. Похожие формулировки: This plugin only supports Spigot-API … или Unable to load Adventure, chat components will not work. В зависимости от плагина он либо полностью отключается, либо перестают работать отдельные функции, например цветные тексты чата. Сервер продолжает работать.

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

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

Полезно знать: При переходе на более новую версию Minecraft мир преобразуется. Надёжно вернуться назад можно только через резервную копию.

Плагину нужна более новая сборка Paper для твоей версии Minecraft

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

[EntrypointUtil] Class io.papermc.paper.plugin.loader.library.impl.MavenLibraryResolver does not have member field 'java.lang.String MAVEN_CENTRAL_DEFAULT_MIRROR'
java.lang.NoSuchFieldError: …

В чём причина: Paper постоянно развивается даже в рамках одной версии Minecraft, каждый выпуск называется сборкой (build). Плагин обращается к полю в API Paper, а именно в той части, которая при запуске загружает дополнительные библиотеки для плагинов. Это поле (MAVEN_CENTRAL_DEFAULT_MIRROR) есть только в более новых сборках. В твоей сборке его нет, поэтому плагин не загружается. Сам сервер продолжает работать.

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

  1. Открой в панели раздел Версия и обнови сервер до новейшей сборки Paper для своей версии Minecraft.
  2. Перезапусти сервер и проверь в Консоли, загружается ли плагин теперь без ошибок.
  3. Если не хочешь менять сборку, используй более старый выпуск плагина и замени файл в разделе Файлы в папке plugins/.

Полезно знать: Переход на более новую сборку той же версии Minecraft — небольшой шаг. Мир при этом остаётся на той же версии Minecraft. Резервная копия перед этим всё равно не повредит.

Плагин не находит внутренние части сервера (Failed to init reflection)

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

Failed to init reflection: Index 3 out of bounds for length 3

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

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

  1. В самом сообщении плагин не указан. Посмотри в Консоли или в logs/latest.log строки непосредственно перед ним. Там указано, какой плагин загружался в этот момент.
  2. Обнови этот плагин до выпуска для версии своего сервера и замени файл в разделе Файлы в папке plugins/.
  3. Перезапусти сервер и проверь, исчезло ли сообщение.

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

Световые эффекты плагина отключены (GlowingEntities)

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

[GlowingEntities] [GlowingEntities] Glowing Entities reflection failed to initialize. The util is disabled. Please ensure your version (<Версия>) is supported.
java.lang.NoSuchFieldException: MARKER

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

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

  1. Найди плагин, в который встроен GlowingEntities. В строках at … под сообщением есть запись вида <Плагин>.jar//….
  2. Скачай этот плагин в сборке для твоей сборки Paper.
  3. Замени старый файл в разделе Файлы в папке plugins/ и перезапусти сервер.

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

Simple_RTP: головы в меню не отображаются

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

[Simple_RTP] Failed to apply GUI head texture: IllegalArgumentException: Can not set net.minecraft.world.item.component.ResolvableProfile field org.bukkit.craftbukkit.inventory.CraftMetaSkull.profile to com.mojang.authlib.GameProfile

В чём причина: Simple_RTP — это плагин для случайной телепортации. Для голов в своём меню он задаёт профиль игрока в старом формате (GameProfile). Но твоя версия Minecraft в этом месте ожидает более новый формат (ResolvableProfile). Одно с другим не совпадает, поэтому головы в меню не работают. Сервер продолжает работать.

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

  1. Проверь в разделе Версия, какая версия Minecraft установлена на твоём сервере.
  2. Скачай Simple_RTP в сборке для этой версии Minecraft.
  3. Замени старый файл в разделе Файлы в папке plugins/ и перезапусти сервер.
  4. Открой меню в игре и проверь, появились ли головы.

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

ZNPCs: сохранённые NPC не подходят к версии плагина

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

io.github.gonalez.znpcs.commands.CommandExecuteException
No enum constant io.github.gonalez.znpcs.npc.<…>.PLAYER

В чём причина: ZNPCs хранит твоих NPC вместе с их типом и действиями в одном файле. В нём указан тип или действие, которое установленная версия ZNPCs не знает, например ActionType.PLAYER. Обычно это происходит, когда NPC были созданы в другой версии ZNPCs. Выполняемая команда прерывается, сервер продолжает работать.

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

  1. Создай резервную копию в разделе Резервные копии.
  2. Установи ту версию ZNPCs, в которой были созданы NPC, и перезапусти сервер.
  3. Если это невозможно, останови сервер, открой в разделе Файлы файл plugins/ZNPCs/data.json и удали запись проблемного NPC. JSON — это текстовый формат со скобками и запятыми: одна пропущенная запятая делает весь файл нечитаемым.
  4. Запусти сервер и снова проверь команду.

Полезно знать: Редактируй файл только при остановленном сервере. Если сервер запущен, ZNPCs может перезаписать твои изменения при завершении работы.

Плагину нужен Paper или более новая версия (failed to register events)

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

Plugin <Плагин> v<Версия> has failed to register events for class <Класс> because io/papermc/paper/event/<Событие> does not exist.

В чём причина: Плагины реагируют на события в игре, например когда игрок ломает блок. Этот плагин хочет отслеживать событие, которое твоё серверное ПО не знает. Чаще всего плагин написан для Paper, а сервер работает на Spigot. Либо это событие появилось только в более новой версии Minecraft. Затронутая часть плагина не работает, сервер продолжает работать.

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

  1. Прочитай название после because. Если оно начинается с io/papermc/paper или com/destroystokyo/paper, плагину нужен Paper.
  2. Если твой сервер работает на Spigot, переключи его на Paper через Сменить ПО / загрузчик. Плагины для Spigot, как правило, работают и на Paper. Сначала создай резервную копию.
  3. Если сервер уже работает на Paper, значит, это событие новее твоей версии. Используй сборку плагина для своей версии Minecraft или смени версию сервера в разделе Версия.
  4. Перезапусти сервер и проверь, пропало ли сообщение.

Подробнее: Как сменить серверное ПО и версию в панели

Файл собран для более новой версии Java (Unsupported class file major version)

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

java.lang.IllegalArgumentException: Unsupported class file major version 69

В чём причина: Плагины, моды и библиотеки компилируются под определённую версию Java. Число после major version подсказывает, под какую: если вычесть 44, получится версия Java, то есть 65 — это Java 21, а 69 — Java 25. Инструменты твоего сервера, которые читают или перезаписывают плагины и моды при загрузке, не понимают эту более новую версию. Затронутая часть не загружается.

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

  1. В строках выше выясни, какой плагин или мод загружался в этот момент.
  2. Скачай для него сборку, рассчитанную на твою версию Minecraft, и замени старый файл в разделе Файлы в папке plugins/ или mods/.
  3. Либо обнови сервер в разделе Версия до более новой версии Minecraft, которая работает на Java 21 или новее. Подходящая версия Java у нас устанавливается автоматически. Сначала создай резервную копию.

Полезно знать: Если прямо перед этим стоит Fatal error trying to convert, смотри раздел про старые серверы Paper выше.

Подробнее: Какая версия Java нужна твоему серверу Minecraft?

Старый плагин ищет удалённую функцию чанков (Legacy-ID)

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

java.lang.NoSuchMethodException: net.minecraft.world.level.chunk.Chunk.k(net.minecraft.core.BlockPosition)

В чём причина: До Minecraft 1.12 у блоков были числовые ID, например у камня это была 1. Некоторые старые плагины внутри себя всё ещё работают с этими Legacy-ID и для этого напрямую обращаются к внутренним функциям игры, то есть к классам в net.minecraft. Нужной функции чанков в твоей версии больше нет. Поэтому функция плагина для Legacy-ID не запускается. В зависимости от плагина перестают работать одна или многие функции.

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

  1. Посмотри в стек вызовов под сообщением, то есть в строки at …. Там указано название плагина или его JAR-файла.
  2. Обнови этот плагин до сборки для твоей версии Minecraft и замени файл в разделе Файлы в папке plugins/.
  3. Если такой сборки нет, плагин больше не поддерживается для современных версий. Подбери актуальный плагин-замену.

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

Плагин использует устаревшую функцию профилей Mojang (головы игроков)

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

java.lang.NoSuchMethodException: com.mojang.authlib.GameProfile.getProperties()

В чём причина: authlib — это библиотека Mojang, через которую сервер управляет профилями игроков с именем и скином. Плагин считывает эти профили с помощью метода (GameProfile.getProperties), которого в твоей версии Minecraft больше нет. Затронутая функция перестаёт работать, чаще всего это головы игроков в меню. Сервер продолжает работать.

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

  1. Найди плагин: его название или название его JAR-файла указано в строках at … под сообщением или в строках перед ним.
  2. Скачай релиз этого плагина для твоей версии Minecraft.
  3. Замени старый файл в разделе Файлы в папке plugins/ и перезапусти сервер.
  4. Открой затронутое меню в игре и проверь, снова ли отображаются головы.

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

Плагин ищет блоки, частицы или атрибуты, которых нет в твоей версии

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

java.lang.IllegalArgumentException: No enum constant org.bukkit.Material.<NAME>
Unknown material '<NAME>' for button
java.lang.NoSuchFieldError: Class org.bukkit.<Class> does not have member field '<Field>'

В чём причина: каждая версия Minecraft добавляет новые блоки, частицы и атрибуты, а некоторые переименовывает. Плагин собран для другой версии и обращается к тому, чего здесь нет или что называется иначе. В зависимости от плагина ошибка появляется при каждом действии, либо отдельные функции перестают работать. Сюда же относится сообщение Could not initialize Brigadier mappings. Brigadier — это система команд Minecraft, которая, среди прочего, отвечает за автодополнение по Tab.

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

  1. Найди название плагина в строках перед сообщением или в строках at … под ним.
  2. Скачай релиз плагина, подходящий к твоей версии Minecraft, и замени файл в разделе Файлы в папке plugins/.
  3. Либо переключи сервер в разделе Версия на ту версию Minecraft, которую требует плагин. Предварительно создай резервную копию.
  4. Если неизвестное название указано в конфигурационном файле плагина, например в кнопках меню, замени его там на актуальное обозначение.

Плагин Marriage не подходит к версии Minecraft

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

[Marriage] Marriage is not compatible with the version of minecraft you are using
Marriage kissing will be disabled!

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

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

  1. Проверь на странице плагина, есть ли релиз Marriage для твоей версии Minecraft. Свою версию ты увидишь в разделе Версия.
  2. Если он есть, замени старый файл в разделе Файлы в папке plugins/ и перезапусти сервер.
  3. Если его нет, замени плагин актуальным с похожими функциями. Учти, что другой плагин не подхватит сохранённые данные Marriage, и заранее создай резервную копию.

Полезно знать: если тебя беспокоит только отсутствие функции поцелуев, а остальное работает, можешь игнорировать это сообщение до выхода обновления.

Античит или пакетный плагин ещё не полностью поддерживает твою версию Minecraft

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

java.lang.IllegalStateException: Unknown entity metadata type id: <Number> version V_<Version>

В чём причина: некоторые плагины считывают сетевые пакеты между игрой и сервером, например античит GrimAC через библиотеку PacketEvents. С новыми версиями Minecraft появляются новые типы данных для существ и объектов, так называемые метаданные сущностей. Плагин пока не знает один из них, чаще всего потому, что он старше версии твоего сервера. Затронутые пакеты обрабатываются неправильно. Это может вызвать ложные срабатывания античита или проблемы с подключением.

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

  1. Обнови плагин и, если PacketEvents установлен как отдельный файл, его тоже до версии, которая явно поддерживает твою версию Minecraft.
  2. Полностью перезапусти сервер.
  3. Если подходящей версии ещё нет, временно отключи плагин: переименуй его файл в разделе Файлы, например в <Plugin>.jar.off. Сервер загружает только файлы с расширением .jar.
  4. Как вариант, выбери в разделе Версия версию Minecraft, которую поддерживает плагин. Предварительно создай резервную копию.

Дополнительный плагин для WorldEdit использует удалённый интерфейс

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

[WorldEdit] Got request to set EditSessionFactory <…> EditSessionFactories have been removed …

В чём причина: WorldEdit удалил старый интерфейс EditSessionFactory. Через него дополнительные плагины могли подключаться к каждому изменению WorldEdit. Какой-то дополнительный плагин, например для журналов блоков или защиты территории, всё ещё пытается его использовать. Сам WorldEdit работает нормально. Однако функция журналирования или защиты дополнительного плагина не срабатывает при изменениях WorldEdit: то, что ты строишь или удаляешь с помощью WorldEdit, плагин ни фиксирует, ни блокирует.

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

  1. Выясни, какой плагин отправляет этот запрос. Название обычно указано в самом сообщении или в строках перед ним.
  2. Обнови этот дополнительный плагин до версии, которая работает с твоим WorldEdit или FastAsyncWorldEdit (FAWE, более быстрый вариант WorldEdit).
  3. Если такой версии нет, отключи интеграцию с WorldEdit в конфигурации дополнительного плагина, если для этого есть настройка.
  4. Перезапусти сервер и проверь, исчезло ли сообщение.

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

Braslety: рецепт не регистрируется

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

[Braslety] … java.lang.IllegalAccessException: class com.example.braslety.BraceletsPlugin cannot access …

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

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

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

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

ViaVersion не может загрузить модуль перевода

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

[ViaVersion] Error during loading of Protocol<Version>To<Version>

В чём причина: ViaVersion переводит между версиями игры, чтобы на сервер могли заходить и игроки с более новыми или более старыми клиентами. Расширения вроде ViaBackwards дополняют это для старых клиентов. Каждый перевод находится в отдельном модуле, имя которого начинается с Protocol. Один из них не удалось загрузить, чаще всего потому, что ViaVersion и его расширения не подходят друг к другу или к версии сервера. Игроки с затронутыми версиями клиента в таком случае не смогут зайти. Тех, кто играет именно на версии сервера, это не касается.

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

  1. Скачай последние версии ViaVersion и всех расширений Via, которые ты используешь.
  2. Замени их все разом в разделе Файлы в папке plugins/. Не смешивай старые и новые файлы Via.
  3. Полностью перезапусти сервер.
  4. Проверь вход с той версией клиента, с которой раньше не получалось.

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

LibreLogin не работает на Spigot

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

[LibreLogin] Detected an unsupported server distribution. Please use Paper or its forks. SPIGOT IS NOT SUPPORTED!

В чём причина: LibreLogin — плагин авторизации: игроки входят с помощью пароля. Это особенно важно на серверах в офлайн-режиме. LibreLogin требует Paper или совместимый форк, то есть ответвление Paper, например Purpur, и на Spigot отключается. Если твой сервер работает в офлайн-режиме, защиты паролем нет: игроки могут подключаться под чужими именами.

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

  1. Создай резервную копию в разделе Резервные копии.
  2. Переключи сервер на Paper или Purpur в разделе Сменить ПО / загрузчик. Плагины для Spigot там, как правило, продолжают работать.
  3. Перезапусти сервер и проверь в Консоль, загружается ли LibreLogin без этого сообщения.
  4. Если хочешь остаться на Spigot, используй плагин авторизации, который явно поддерживает Spigot.

Полезно знать: Если твой сервер работает в офлайн-режиме, устрани это до того, как на сервер начнут заходить игроки.

Подробнее: Как сменить ПО сервера и версию в панели

Для Nova не хватает параметра запуска Java (-javaagent)

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

[Nova] Missing required JVM argument: -javaagent:plugins/Nova-<Version>.jar

В чём причина: Nova — объёмный плагин, который позволяет добавлять собственные блоки и предметы на серверах Paper. Для части его функций Java должна при запуске загрузить так называемый Java-агент. Это дополнение, которое активируется ещё до самого сервера и подключается через параметр запуска. Твой сервер запускается без этого параметра. Поэтому Nova работает не полностью, хотя сам сервер работает.

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

  1. Найди в сообщении точный параметр, включая имя файла JAR плагина Nova.
  2. Команду запуска своего сервера Minecraft ты не можешь изменить в панели самостоятельно. Поэтому открой тикет, скопируй в него параметр из сообщения и укажи время появления сообщения.
  3. Если Nova тебе не обязательна, удали плагин в разделе Плагины и перезапусти сервер. Тогда сообщение исчезнет.

Полезно знать: С каждой новой версией Nova обычно меняется и имя файла в параметре. Поэтому после обновления Nova сообщение часто появляется снова.

Твоего сообщения нет в списке?

Прочитай сообщение целиком в Консоль или в logs/latest.log, включая строки перед ним. Проблемный плагин можно узнать по названию в квадратных скобках в начале строки или в стектрейсе, то есть в списке строк at …: там указаны имена JAR-файлов из plugins/ или mods/ и названия пакетов, которые часто содержат название плагина. Затем сравни на странице плагина поддерживаемые версии с версией твоего сервера. Перед каждой сменой версии создавай резервную копию. Если не получается разобраться, открой тикет и укажи время появления сообщения.