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

Шаг за шагом

1. 1.Убедитесь, что ваш сервер умеет запускать плагины

   Плагинам нужно серверное ПО на основе Bukkit: Paper, Spigot, Purpur или Folia для игровых серверов, BungeeCord или Velocity для прокси. Ванильный сервер или сервер Fabric или Forge плагины не загружает.

2. 2.Проверьте версию плагина

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

3. 3.Остановите сервер и скопируйте .jar

   Положите файл .jar в папку plugins/ рядом с .jar сервера. На панели хостинга загрузите его через файловый менеджер или SFTP. Не распаковывайте его.

4. 4.Установите зависимости

   Если плагину нужны другие плагины (Vault, PlaceholderAPI, ProtocolLib, LuckPerms), положите их файлы .jar тоже в plugins/.

5. 5.Запустите сервер и прочитайте консоль

   Найдите название плагина в журнале запуска. «Enabling <Plugin>» без ошибки после этой строки означает, что плагин загрузился.

6. 6.Проверьте его в игре и настройте

   Выполните /plugins: загруженные плагины зелёные, плагины, которые не удалось включить, красные. Его настройки появляются в plugins/<PluginName>/config.yml; отредактируйте их и перезапустите сервер.

Куда кладутся файлы

Обычная папка сервера после первого запуска с плагином выглядит так:

• paper.jar (или spigot.jar): сам сервер.
• plugins/MyPlugin.jar: добавленный вами плагин.
• plugins/MyPlugin/: папка, которую создаёт плагин, с config.yml, сообщениями и сохранёнными данными.
• logs/latest.log: журнал текущего запуска, куда записываются ошибки загрузки.

Перезапускайте, а не делайте /reload

/reload выгружает и заново загружает все плагины без перезапуска сервера. Многие плагины это не поддерживают: обработчики регистрируются дважды, данные теряются или утекает память. Всегда перезапускайте сервер после добавления, удаления или обновления плагина. У некоторых плагинов есть своя команда перезагрузки (например, /myplugin reload) только для их конфига: ей пользоваться безопасно.

Перед установкой на рабочий сервер

• Сделайте резервную копию папки сервера или хотя бы plugins/ и миров.
• Сначала попробуйте на копии: то же ПО, та же версия и те же другие плагины, что и на настоящем сервере. См. как протестировать плагин.
• По одному плагину за раз: если что-то сломается, вы будете знать, какой виноват.
• Скачивайте со страницы автора (SpigotMC, Hangar, Modrinth, GitHub), а не из перезаливов.

Плагины, сделанные в Codexe

Плагин, сделанный в Codexe, приходит собранным .jar с названием проекта и проверяется до того, как вы его получите: в нём должны быть скомпилированные классы и plugin.yml. Вы можете попробовать его на приватном тестовом сервере, прежде чем где-либо устанавливать, бесплатно на любом тарифе; тестовый сервер сам устанавливает плагины, указанные как зависимости. Для скачивания .jar на свой сервер нужен тариф или пакет скачиваний.

Вопросы