Как установить плагин на сервер Minecraft

Установка плагина на сервер Paper — четыре действия: скачать `.jar` с официальной страницы проекта, положить его в `plugins/`, перезапустить сервер и проверить командой `/plugins`, что он загрузился. Настройки появятся в plugins/<Имя плагина>/config.yml после первого запуска.

Всё остальное — детали, на которых чаще всего спотыкаются: не та версия, не та Java, забытая зависимость или /reload вместо перезапуска. Какие плагины ставить в первую очередь — в статье плагины для сервера.

Перед установкой: ядро и версия#

• Плагины, а не моды. Плагины для Bukkit, Spigot и Paper работают на Paper и его форках — Leaf, Purpur. Моды для Forge и Fabric на Paper не запустятся; если нужны моды — см. сервер с модами.
• Версия Minecraft. На странице плагина указано, какие версии он поддерживает. На Modrinth и Hangar это видно у каждого файла; после перехода сервера на новую версию проверяйте каждый плагин заново.
• Платформа. Плагины для прокси (Velocity, BungeeCord) на Paper не встанут, и наоборот. На странице плагина видно, под какие платформы есть файлы.
• Java. Paper 1.20–1.21.11 требует Java 21, а 26.1 и новее — Java 25. Плагин, собранный под Java новее вашей, сервер не загрузит.

Установка по шагам#

1. 1

   Скачайте плагин с официальной страницы

   Hangar (репозиторий плагинов Paper), Modrinth, SpigotMC, GitHub самого проекта или его сайт. Файл должен заканчиваться на .jar; если скачался .zip, распакуйте его и возьмите .jar для своей платформы — обычно с пометкой bukkit или paper.

2. 2

   Положите .jar в папку plugins/

   Папка plugins/ лежит рядом с ядром сервера. Файл кладите прямо в неё: вложенные папки сервер не проверяет. Держите одну версию каждого плагина — старый файл удалите.

3. 3

   Перезапустите сервер

   Остановите сервер командой stop и запустите снова — или кнопкой перезапуска в панели хостинга. Плагин загрузится при старте.

4. 4

   Проверьте, что плагин работает

   Введите /plugins в игре (или plugins в консоли): включённые плагины — зелёные, не включённые — красные. /version <Плагин> покажет его версию и авторов.

5. 5

   Настройте конфиг

   После первого запуска плагин создаёт папку plugins/<Имя плагина>/ с config.yml. Отредактируйте его и примените изменения командой перезагрузки самого плагина, если она есть, или перезапуском сервера.

Почему не /reload#

Paper сам отговаривает от /reload: команда просит подтверждения и предупреждает, что перезагрузка может вызвать баги и утечки памяти, что лучше перезапустить сервер и что команду скоро уберут. Перезагрузка не выгружает плагины начисто: часть старого состояния остаётся в памяти, отсюда утечки и баги, которые потом трудно связать с причиной.

Больше всего страдают плагины, которые встраиваются в сетевой слой: PacketEvents, ViaVersion, античиты. Разработчики ViaVersion прямо пишут, что перезапуск намного лучше перезагрузки, а с менеджерами плагинов их плагин корректно работать не будет. Правило простое: новый плагин или новая версия — перезапуск, изменённый конфиг — команда перезагрузки самого плагина (/co reload, /dguard reload и т. п.).

Зависимости#

Многие плагины опираются на другие и без них не включатся. Сервер пишет об этом в консоль при старте — например, Unknown/missing dependency plugins: [Vault] значит, что сначала нужно поставить Vault. Частые пары:

Пример: устанавливаем античит DGuard#

Разберём на живом примере с зависимостью и ключом лицензии. DGuard работает на Paper и Leaf версий 1.21–26.3, основная — 1.21.11: на ней DGuard тестируется и стоит на боевых серверах, остальные поддерживаются, но на боевых серверах ещё не проверялись. Java — 21 или новее для 1.21.x и 25 или новее для 26.x: этого требует сам Paper.

1. 1

   Получите ключ

   Зарегистрируйтесь и добавьте сервер в панели — она выдаст лицензионный ключ dg_…. Бесплатно: один сервер до 30 игроков онлайн. Ключ показывается один раз — сразу скопируйте его.

2. 2

   Поставьте PacketEvents

   DGuard читает пакеты через плагин PacketEvents и работает только на его последнем релизе. Скачайте его с Modrinth и положите в plugins/. Сборки для разработчиков (dev, SNAPSHOT) не подходят.

3. 3

   Положите DGuard.jar и вставьте ключ

   DGuard.jar — тоже в plugins/. Ключ вставьте в plugins/DGuard/config.yml, в поле license.key. Файла ещё нет — запустите сервер один раз, и DGuard создаст его сам.

4. 4

   Перезапустите сервер

   DGuard проверит ключ и подключится к сайту — в панели сервер станет «Онлайн». Проверить из консоли: /dguard license.

license:
  key: "dg_…"

Дальше DGuard обновляется сам: новая версия скачивается в фоне и встаёт при следующем перезапуске, проверить сразу можно командой /dguard update. На сети с BungeeCord или Velocity DGuard ставится на каждый игровой сервер, у каждого — свой ключ. Требования и решения проблем — на странице установки DGuard.

Как обновить плагин#

1. 1Прочитайте список изменений на странице плагина: крупные версии иногда меняют конфиг или требуют новую версию сервера.
2. 2Сделайте бэкап хотя бы папки плагина — особенно если в ней лежит база (как у LuckPerms или CoreProtect).
3. 3Остановите сервер, удалите старый .jar и положите новый. Две версии одного плагина в plugins/ — частая причина ошибок.
4. 4Запустите сервер и проверьте консоль и /plugins.

Некоторые плагины обновляются сами — как DGuard. Для остальных удобно раз в месяц проходить по списку и сверять версии с официальными страницами.

Как удалить плагин#

Остановите сервер и удалите .jar из plugins/. Папка plugins/<Имя плагина>/ с конфигом и данными останется — удалите её, если плагин больше не нужен, или оставьте, если можете вернуться. Перед удалением проверьте, не зависит ли от него что-то ещё: плагин, которому он нужен, при следующем старте не включится.

Плагин не загружается#

Ответ почти всегда в консоли или в файле logs/latest.log. Найдите строки с именем плагина: обычно хватает первых одной-двух строк ошибки.

Частые вопросы#