Установка плагинов

💼 Подготовка

Для работы плагинов требуются специальные ядра, которые их поддерживают.

Предупреждение.

Важно отметить, что ядра Vanilla, Fabric* и Forge** плагины не поддерживают.

* Для Fabric есть мод, добавляющий поддержку плагинов Bukkit, но он крайне нестабилен и не работает с большой частью других модов.

** Использовать моды Forge и плагины Bukkit можно, но для этого нужно гибридное ядро.

Где можно скачать нужное ядро?

Самые популярные ядра присутствуют во вкладке Автоустановка. Исключением являются менее популярные или стабильные ядра. Такие ядра можно установить вручную.

Ниже мы приведём основную информацию о популярных ядрах.

 Ядра для плагинов Bukkit (Spigot/Paper)

Название	Версия	Страница ядра	Наличие в автоустановке
Paper	1.8.8 - 1.20.6	papermc.io	✅
Purpur	1.16.5 - 1.20.6	purpurmc.org	❌

 Ядра для модов Forge и плагинов Bukkit (Spigot/Paper)

Внимание!

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

Перед установкой такого ядра попробуйте найти аналог плагина в виде мода, например EssentialsX может заменить мод FTB Essentials.

Название	Версия	Страница ядра	Наличие в автоустановке
Arclight	1.14.4 - 1.20.4	Github	❌
Magma	1.12.2 - 1.20.1	magmafoundation.org	❌
Mohist	1.7.10 - 1.20.2	mohistmc.com	❌

Где скачать плагины?

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

1. SpigotMC Ссылка

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

2. Modrinth Ссылка

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

3. Hangar Ссылка

   • Официальный сайт для плагинов Paper. Сайт ещё в разработке, но на него уже перенесли большое количество поддерживаемых плагинов с сайтов SpigotMC или Bukkit.org.
   • Позволяет фильтровать плагины по платформам, типам и категориям.

Также, есть такие сайты как например CurseForge и Bukkit.org. Это тоже доверенные источники, но обновления некоторых плагинов до них могут доходить с некоторой задержкой.

Заметка.

Многие плагины можно также скачать с их официальных страниц на Github или других похожих сайтов.

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

---

🧩 Установка плагинов

Плагины устанавливаются просто - после первого запуска ядра, поддерживающего плагины, появится папка plugins.

Загружаете .jar-файл плагина в папку plugins и перезагружаете сервер.

• Перезагрузка не потребуется, если используется плагин PlugMan или использована команда /reload, но ни первый, ни второй вариант не гарантирует работоспособность плагинов после перезагрузки.

---

🧰 Устранение ошибок

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

В первую очередь следует обратиться к статье «Устранение ошибок», если вы не уверены.

Загрузил плагин, а он не работает! Что делать?

1. Плагин устарел или, наоборот, сделан для более новой версии.
   • Решение - обновить сервер, установить более старую версию плагина или, наоборот, более новую, если плагин слишком старый.
     
     
2. Плагин попросту не работает из-за плохого кода.
   • В таком случае следует избавиться от плагина или сообщить разработчику об ошибке.
     
     
3. Плагин загружен в неверную папку или не является плагином вовсе.
   • Плагины обязательно должны быть загружены в папку plugins. Не в файлы сервера, не в папку mods. Также - не все .jar-файлы являются плагинами.
     Это может быть мод или что-либо другое. Об этом обычно говорит ошибка InvalidDescriptionException: Invalid plugin.yml в консоли.

Загрузил плагин, а часть функционала не работает!

1. Скорее всего, какие-то функции не были включены в конфигурации плагина. Конфигурационные файлы плагина обычно находятся в папке с названием плагина, находящейся в папке plugins.
   • Файл с настройками обычно именуется config.yml.
     
     
2. Также проблема может быть в том, что плагин попросту конфликтует с каким-то другим плагином.
   В таком случае следует узнать, какой плагин может быть причиной, и удалить его или обновить, если установлена устаревшая версия.