Как установить плагины на Paper, Spigot и Purpur

Плагины добавляют серверу функции, например дома, привилегии, ранги или мини-игры, и работают только на сервере. Игроки заходят с обычной игрой и ничего не устанавливают. Плагины работают на Paper, Purpur, Spigot и, для немногих, которые это поддерживают, на Folia. Если на вашем сервере Fabric, Forge или NeoForge, вам нужны моды. См. Как установить моды на Forge, Fabric и NeoForge. Чтобы сравнить эти два вида, прочитайте Типы серверов Minecraft.

У плагинов полный доступ к вашему серверу. Устанавливайте плагины только из источников, которым доверяете, и сначала делайте бэкап. См. Как сделать бэкап, восстановить и сбросить мир Minecraft.

Установите плагин через вкладку «Моддинг»

Вкладка «Моддинг» ищет сразу в нескольких каталогах плагинов и сама кладёт файл в нужную папку.

1. Откройте сервер в панели и нажмите Моддинг.
2. Нажмите вкладку Плагины. Если вы её не видите, ваш тип сервера не запускает плагины. На вкладке это объясняется и названы типы, которые их запускают.
3. Введите название плагина в Поиск плагинов и нажмите Enter. Меню Сортировка может упорядочить результаты по Самые скачиваемые или Недавно обновлённые.
4. При необходимости используйте фильтры слева. Источник может быть Все источники, Modrinth, CurseForge, Hangar, SpigotMC или Polymart. Версия Minecraft по умолчанию совпадает с версией вашего сервера.
5. Нажмите Установить в нужной строке. Панель устанавливает самую новую сборку для версии, указанной в фильтре Версия Minecraft, который по умолчанию стоит на версии вашего сервера. Чтобы получить более старую сборку, измените этот фильтр или скачайте jar-файл сами и загрузите его, как описано ниже. Выбирайте только ту версию, которую ваш сервер может загрузить.
6. Если для работы плагина нужны другие плагины, откроется окно с их списком, а на кнопке будет написано Установить 2 файла или что-то подобное. Нажмите её, чтобы установить плагин вместе с тем, что ему нужно.
7. Перезапустите сервер, чтобы он загрузил плагин. После одиночной установки панель сама его не перезапускает. См. Как запустить, остановить, перезапустить и принудительно остановить сервер.

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

Что означают значки

Плагин, в описании которого не названа ваша версия Minecraft, просто устанавливается без предупреждения. Часто он всё равно работает, но проверьте Console после перезапуска.

Сервер Paper принимает плагины, указанные для Paper, Spigot или Bukkit. Сервер Purpur принимает и их, и плагины, указанные для Purpur. Сервер Spigot принимает плагины, указанные для Spigot или Bukkit, поэтому плагин, созданный только для Paper, на нём не установится.

Установите плагин загрузкой файла

Используйте это для плагина, который вы скачали сами, например если его нет в каталогах.

1. Скачайте файл .jar плагина с его официальной страницы. Hangar, собственный сайт плагинов Paper, это то место, которое рекомендует документация Paper. Modrinth тоже хороший вариант.
2. Откройте свой сервер и нажмите Files.
3. Откройте папку plugins.
4. Нажмите Загрузить и выберите файл .jar. Для большого числа файлов используйте SFTP. См. Как подключиться к файлам сервера по SFTP.
5. Перезапустите сервер.

Кладите jar прямо в plugins. В документации Paper сказано, что плагины в подпапках папки plugins не загружаются. Некоторые плагины продаются на сайтах, которые не разрешают автоматическую загрузку. Их нужно скачать в браузере и загрузить самому.

Проверьте, что плагин загрузился

1. Откройте вкладку Console и понаблюдайте за запуском. Найдите название плагина и строки, помеченные как ошибки. Фильтр Ошибки показывает только их.
2. Когда сервер Онлайн, введите в Console plugins и нажмите Enter. Он выведет плагины, которые знает сервер. См. Как пользоваться консолью и выполнять команды.

Если плагина нет в списке или Console показывает ошибку с его названием, скорее всего, плагин создан для другой версии Minecraft или ему сначала нужен другой плагин. Прочитайте на странице плагина, что ему требуется.

Измените настройки плагина

Большинство плагинов при первом запуске создают в plugins папку со своим именем, обычно с файлом config.yml. Откройте её в Files, отредактируйте, сохраните и перезапустите сервер. Страница панели Настройки не перечисляет файлы плагинов. Она перечисляет собственные файлы сервера, такие как Bukkit Settings, Spigot Settings и Purpur Settings, если они существуют.

Обновление и удаление плагинов

1. Откройте Моддинг, затем Плагины, затем вид Установленные.
2. У плагина с более новой сборкой показаны обе версии, например 2.9.1 → 2.12.1, и кнопка Обновить. Полоса вверху предлагает обновить их все сразу. Обновление заменяет только файл плагина и не трогает его настройки. Старый файл удаляется, когда новый на месте.
3. Чтобы удалить плагин, откройте его меню ... и нажмите Удалить. Отмечайте Также удалить его конфигурацию и данные только в том случае, если плагин вам больше не понадобится. Это удаляет собственную папку плагина, в которой лежат его настройки и то, что он сохранил, например дома или привилегии.
4. Перезапустите сервер, чтобы изменение вступило в силу.

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

Если сервер не запускается после плагина

1. Откройте Files, затем plugins и удалите самый новый добавленный плагин. Папку с его настройками не трогайте на случай, если плагин понадобится снова.
2. Запустите сервер. Если он запустился, причиной был плагин.
3. Если сбой остался, восстановите бэкап, который вы сделали заранее. См. Как создавать, скачивать и восстанавливать бэкапы.

Полный чек-лист см. в статье Как исправить сервер, который не запускается. О плагинах и лагах рассказано в Как уменьшить лаги на сервере Minecraft.

Хорошие плагины для начала

Это давно существующие и широко используемые плагины, у каждого своя страница на Modrinth или Hangar:

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

Перед установкой прочитайте на странице каждого плагина, какие версии Minecraft он поддерживает.