Проблемы с зависимостями плагинов и модов

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

Разобраться в причинах подобных сбоев помогут логи сервера — именно там фиксируются ошибки, чаще всего связанные с отсутствием необходимых зависимостей для тех или иных плагинов и модов.

В этой статье мы разберем частые примеры ошибок, как определять «чего хочет мой сервер от меня» и где скачивать отсутствующие зависимости.

Проблема с зависимостями на плагиновых ядрах

На плагиновых ядрах, пожалуй, одна из самых простых и понятных систем оповещения об отсутствии какой-либо зависимости для другого плагина.

Отсутсвие зависящего плагина

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

В нашем случае, отсутствует плагин WorldEdit который не дает запуститься плагину WorldGuard-bukkit-7.0.17.jar. Нас просят установить Worldedit для дальнейшей работы с отключившимся плагином.

Недостающий плагин для работы с каким-либо другим плагином всегда пишется в квадратных скобках, точно также как на скриншоте.

Проблема с зависимостями на модовых ядрах

На модовых ядрах часто проблема описана после или до огромного сообщения об ошибке.

Отсутсвие мода со стактрейсом

На скриншоте приведена обычная ошибка отсутствия мода на ядре NeoForge. После такой ошибки сервер автоматически останавливается.

Среди всего этого текста, в самом начале, выделена проблема. Мод createaddition требует Create версии 6.0.7 или выше, но у нас такого мода нет.

Однако, перед тем как показать большую ошибку, которую мы прикрепили выше, ядро оповестит Вас в виде такой вот короткой и крайне понятной ошибки.

Если переводить дословно: «Мод Create, версии от 6.0.7 до 6.1.0, наличие которого требует мод createaddition, отсуствует.»

Этот формат ошибки более простой для понимания, хоть его тяжелее найти в логах.

Отсутсвие мода без стактрейса

Как исправить эти проблемы

Если вы столкнулись с ошибкой отсутствия зависимостей, действуйте по следующему пошаговому алгоритму:

  1. Скопируйте название проблемного мода или плагина из текста ошибки в консоли или логах.
  2. Составьте поисковый запрос. Лучше всего искать на английском языке, добавляя платформу на которой может быть плагин/мод. Например: [название мода] curseforge, [название плагина] modrinth или [название] spigotmc.
  3. Перейдите на официальную страницу проекта (в результатах поиска это будут проверенные сайты вроде CurseForge, Modrinth, SpigotMC, Hangar или GitHub).
  4. Внимательно изучите описание (Overview или Description). Разработчики всегда указывают там список необходимых библиотек и сопутствующих файлов.

Помните, что CurseForge и Modrinth в основном популярны среди модов для Minecraft. Если вы работаете с плагинами, основными площадками также могут быть SpigotMC, Bukkit, Purpur/Hangar и GitHub — алгоритм поиска везде одинаков.

Как определить зависимости мода/плагина

Чтобы заранее понять, какие дополнительные файлы вам понадобятся, ищите на странице мода или плагина следующие элементы:

  • Строка требований: Часто в описании встречается текст вроде "Requires [Название] (version X.X or above)".
  • Блок зависимостей: Например, на Modrinth на страницах проектов есть специальный визуальный блок (обычно в боковой панели или вверху описания), где явно перечислены все требуемые зависимости (Dependencies) со ссылками на них.
  • Строка "Requires": Блок «требует»

По такой же схеме абсолютное большинство разработчиков плагинов и модов документируют все требования на страницах своих ресурсов.