Помощь

Ошибки плагинов

Сервер не стартует, плагин красный, stacktrace в логе — разбор типичных сбоев PocketMine-MP, Nukkit и Paper/Spigot.

PMMP Paper Лог
Ошибки плагинов — Minecraft Wiki PocketMine

redstone dust command block hopper chest front book writable iron sword

Плагин ломается не «просто так»: неверное ядро, старый API, конфликт двух плагинов, битый конфиг или нехватка PHP/Java-классов. Ниже — формулировки из логов и что с ними делать без удаления всего сервера.

Правило. Ставьте плагины по одному, после каждого — рестарт и проверка лога. Не мешайте PMMP-phar, Nukkit-jar и Spigot-jar в одной папке — это разные экосистемы.

PocketMine-MP (PHP)

В логе / симптомы Причина Что делать
Incompatible API version Плагин под PM3/PM4, ядро PM5 (или наоборот) Скачать сборку под API 5.x или сменить ядро осознанно
Could not load plugin / invalid plugin.yml Битый phar, неполный zip, ошибка в plugin.yml Качать с проверенного источника, не «добивать» phar руками
Duplicate plugin Два phar с одним name Оставить одну версию в plugins/
Class not found / Undefined Зависимость (Virion/DEVirion) не стоит Поставить required library из описания плагина
Плагин красный в списке Упал при onEnable Читать stacktrace выше по server.log
Permission denied на файлы Права Linux после залива от root Владелец каталога = пользователь, от которого стартует PMMP
Краш при входе игрока Часто чат, scoreboard, auth, form API Отключить последний добавленный плагин

Ядро и PHP: PocketMine-MP 5, установка PHP. Распаковать phar: Unphar.

Paper / Spigot (Java)

В логе Причина Что делать
Unsupported API version Плагин под 1.16, сервер 1.21 (или api-version в plugin.yml) Обновить плагин; иногда помогает, но не всегда
NoClassDefFoundError / ClassNotFoundException Нет зависимости (Vault, ProtocolLib…) Поставить soft/hard depend из страницы плагина
Java.lang.UnsupportedClassVersionError Плагин собран новее, чем ваша Java (или наоборот) Java 21 для Paper 1.21
Duplicate Bukkit plugin Два jar одного плагина Удалить старый jar
WorldEdit / WG version mismatch Связка WE+WG+версии ядра Ставить комплект версий «одной эпохи»
Сервер завис на Done / тикает 0 TPS Тяжёлый плагин, чанк-загрузка timings/spark, отключать по одному
Depends on plugin X that does not exist Нет обязательной зависимости Поставить X или убрать плагин

Ядро: Paper / Spigot. Сборка своих jar: Gradle / Maven.

Nukkit-MOT

  • Плагины только Nukkit API — не PMMP и не Spigot.
  • «Cannot load» — часто Java 8 vs 17 или плагин от мёртвой вилки Nukkit.
  • См. Nukkit-MOT.

Как читать stacktrace

  1. Откройте лог целиком, найдите первое ERROR / CRITICAL по времени старта.
  2. Строка at com.example.Plugin... или namespace PHP — указывает виновный плагин.
  3. Если ошибка в config.yml — YAML: отступы пробелами, не табами; кавычки в строках с :.
  4. Откатите последний плагин/конфиг из бэкапа — быстрее, чем «чинить наугад».

Профилактика

  • Не ставьте 40 плагинов «на всякий случай».
  • После обновления ядра обновляйте плагины тем же днём.
  • Держите staging-копию сервера для тестов.
  • Смотрите ошибки входа — иногда виноват не плагин мира, а auth/антибот.
Команды · PMMP · Paper · Вики

Ошибки плагинов Minecraft

API version, ClassNotFound, duplicate plugin, красный плагин в PMMP, stacktrace Paper. Читайте лог, ставьте зависимости, не мешайте типы ядер.