Посібник
Як встановити плагін Minecraft
Оновлено 18 жовтня 2026 р.
Встановлення плагіна займає хвилину: ви кладете файл .jar у теку plugins/ сервера й перезапускаєте його. Більшість проблем виникає на кроках навколо: сервер, який не може запускати плагіни, плагін для іншої версії або відсутня залежність. У цьому посібнику розглянуто їх усі.
Спершу спробуйте його на тестовому сервері, потім встановіть .jar.
Згенерувати це в CodexeКрок за кроком
1.Переконайтеся, що ваш сервер може запускати плагіни
Плагінам потрібне серверне ПЗ на основі Bukkit: Paper, Spigot, Purpur або Folia для ігрових серверів, BungeeCord або Velocity для проксі. Ванільний сервер або сервер Fabric чи Forge плагіни не завантажує.
2.Перевірте версію плагіна
На сторінці плагіна або у файлі вказано, які версії Minecraft він підтримує. Плагін, зібраний для новішої версії, ніж ваш сервер, зазвичай відмовляється завантажуватися.
3.Зупиніть сервер і скопіюйте .jar
Покладіть файл .jar у теку
plugins/поруч із .jar сервера. На хостинг-панелі завантажте його через файловий менеджер або SFTP. Не розпаковуйте його.4.Встановіть його залежності
Якщо плагіну потрібні інші плагіни (Vault, PlaceholderAPI, ProtocolLib, LuckPerms), покладіть їхні файли .jar теж у
plugins/.5.Запустіть сервер і прочитайте консоль
Знайдіть назву плагіна в журналі запуску. «Enabling <Plugin>» без помилки після нього означає, що плагін завантажився.
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 на власний сервер потрібен план або пакет завантажень.
Запитання
Чи можна встановити плагіни на ванільний сервер?
Ні. Замініть .jar сервера на Paper (або Spigot) тієї самої версії Minecraft; ваш світ продовжить працювати. Для ванільних серверів альтернатива - датапак.
Чи можна встановити плагіни в одиночній грі?
Ні, плагіни працюють лише на серверах. Ви можете запустити локальний сервер Paper на своєму комп'ютері й зайти на нього за адресою localhost.
Чи потрібно гравцям щось встановлювати?
Ні. Плагіни працюють лише на сервері: гравці заходять зі звичайною грою. Лише плагіни, що використовують пакет ресурсів, просять гравців його прийняти.
Чому мій плагін червоний у /plugins?
Його знайдено, але не вдалося ввімкнути. Причина в консолі трохи вище: див. як виправити помилки плагінів.
Створіть плагін, який можна встановити вже сьогодні
Цей запит відкривається готовим до надсилання:
“Плагін для Paper 1.21.4 під назвою JoinMessages: власні повідомлення про вхід і вихід з іменем гравця й кількістю гравців онлайн, окреме повідомлення під час першого входу, вітальний титр, а всі повідомлення й звуки в config.yml.”
Згенерувати це в Codexe