Як встановити плагіни на сервер Minecraft (Paper і Spigot)

Плагіни й моди: у чому різниця?

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

Плагіни підключаються до Bukkit API, який надають Paper і Spigot. Вони повністю працюють на сервері, тож ваші гравці підключаються зі стандартним клієнтом Minecraft і ніколи не завантажують жодних файлів — саме тому сервери з плагінами так легко запускати й розвивати.

Моди — це зовсім інший світ: вони змінюють сам клієнт гри, тож сервер і абсолютно кожен гравець мають використовувати один і той самий завантажувач та однаковий список модів, зазвичай постачаються разом як модпак. Якщо вам потрібно саме це, ви потрапили не до того гіда — переходьте до як створити модовий сервер Minecraft. Повне порівняння завантажувачів і того, де який підходить, дивіться в найкраще програмне забезпечення для сервера Minecraft.

Перед початком: запустіть Paper або Spigot

Плагіни завантажуються лише на сервері, який "розуміє" Bukkit API. Ванільний server.jar від Mojang цього не вміє — покладіть плагін поруч із ним, і нічого не станеться. Вам потрібен один із таких варіантів:

• Paper — стандартний вибір. Найшвидший у родині, активно підтримується і сумісний з величезною екосистемою плагінів Bukkit/Spigot. Почніть із нього.
• Spigot — старіша база, на яку досі орієнтується й тестується більшість плагінів. Paper є повним надмножиною Spigot, тож плагін із позначкою "for Spigot" працюватиме і на Paper.
• Purpur — форк Paper із додатковими ігровими налаштуваннями. Ті самі плагіни, трохи більше перемикачів.

Якщо ви все ще на ванілі, перехід швидкий. На тарифі HytHost Minecraft панель GameCP має вбудований перемикач версій: оберіть Paper (або Spigot/Purpur) і версію Minecraft, натисніть один раз — і потрібна збірка встановиться сама, ваш світ залишиться недоторканим. Хостите самостійно? Завантажте jar-файл Paper і запустіть його замість ванільного. За допомогою у виборі між ваніллю, Paper, Forge і Fabric читайте найкраще програмне забезпечення для сервера Minecraft; якщо ви ще не створили сервер, почніть із як створити сервер Minecraft.

Як встановити плагін: покрокова інструкція

Якщо у вас уже запущено Paper або Spigot, встановлення плагіна займає кілька коротких кроків. Весь процес триває пару хвилин.

1. Завантажте JAR-файл плагіна з надійного джерела. Перевіреними майданчиками для плагінів є SpigotMC, Modrinth і Hangar (PaperMC). Завантажте файл .jar і переконайтеся, що на сторінці зазначена підтримка вашої версії Minecraft — плагін, зібраний для 1.20, зазвичай відмовиться завантажуватися на 1.21.
2. Завантажте його в папку plugins. Відкрийте вкладку Files у панелі, зайдіть у директорію plugins і завантажте JAR — працює перетягування. Встановлюєте одразу багато плагінів? Підключіться через SFTP з даними доступу з панелі та скопіюйте їх прямо в plugins. Хостите самостійно? Папка plugins знаходиться поруч із вашим server.jar.
3. Перезапустіть сервер. Плагіни завантажуються лише під час запуску, тож натисніть Restart у панелі — звичайне перезавантаження не підхопить новий плагін. Спостерігайте за консоллю під час завантаження: кожен плагін оголошує про себе під час активації.
4. Перевірте, що він завантажився. У командному рядку консолі введіть /plugins (або коротку форму /pl). Ваш новий плагін має з'явитися в списку, виділений зеленим. Зелений означає завантажено й працює; червоний означає збій — за такого результату переходьте до усунення неполадок.
5. Налаштуйте його. Перший успішний запуск створює plugins/<PluginName>/config.yml. Відредагуйте цей файл у файловому менеджері, щоб налаштувати плагін, потім виконайте його команду перезавантаження або перезапустіть сервер. YAML вибагливий до відступів — використовуйте пробіли, ніколи табуляцію, інакше файл не розпарситься.

Обов'язкові плагіни, які варто встановити першими

Можна витратити цілі вихідні, вивчаючи плагіни, але майже будь-який добре налаштований сервер виживання чи SMP будується на тому самому короткому списку. Встановіть їх першими:

• EssentialsX — швейцарський ніж: /home, /spawn, /tpa, набори, варпи, стартова економіка й десятки повсякденних команд. Якщо встановлюєте лише один плагін, встановіть цей.
• LuckPerms — менеджер прав. Визначає, хто може виконувати які команди, і дає вам ранги та групи. Більшість інших плагінів підключаються до нього, тож він фактично обов'язковий, щойно у вас з'явиться більше одного адміністратора.
• WorldEdit + WorldGuard — WorldEdit дозволяє швидко будувати й редагувати рельєф; WorldGuard захищає регіони (спавн, магазини, арени) від грифу та контролює зони PvP. Йдуть у парі.
• Vault — тихий плагін-міст, що дозволяє плагінам економіки, прав і чату спілкуватися один з одним. Багато плагінів вказують його як залежність; встановіть і забудьте про нього.
• CoreProtect — логування блоків і відкат змін. Коли грифер пошкодить ваш спавн, CoreProtect точно покаже, хто що зробив, і відкотить це за секунди. Встановіть його до того, як він знадобиться.

Примітка щодо прав: одразу після встановлення більшість командних плагінів відповідають лише операторам сервера. Щоб звичайний ранг міг використовувати щось на кшталт /home, ви надаєте відповідний вузол прав (тут essentials.home) їхній групі в LuckPerms. Це ловить майже всіх хоча б раз — коли команда "нічого не робить" для звичайного гравця, майже завжди справа у відсутньому праві, а не в зламаному плагіні.

Кожен доданий плагін використовує трохи пам'яті, тож завантаженому плагінами серверу потрібен більший запас, ніж чистій ванілі — плануйте 4-6 ГБ для сервера Paper із зазначеними вище обов'язковими плагінами. Якщо не впевнені, скільки виділити, наш гід про скільки ОЗП потрібно серверу Minecraft розбирає це за кількістю гравців і конфігурацією.

Оновлення та видалення плагінів

Плагіни — це просто файли в одній папці, що робить обслуговування простим.

Оновлення плагіна

Завантажте нову версію, видаліть старий JAR із папки plugins (не чіпайте папку конфігурації плагіна, щоб ваші налаштування збереглися), завантажте новий JAR і перезапустіть сервер. Підтримання плагінів в актуальному стані важливе: застарілий плагін зазвичай виявляється винуватцем, коли сервер ламається одразу після оновлення версії Minecraft, тож оновлюйте плагіни щоразу, коли змінюєте версію Minecraft.

Видалення плагіна

Перезапустіть або зупиніть сервер, видаліть JAR плагіна з plugins, і він зникне під час наступного запуску. Його папка конфігурації під plugins/<PluginName> залишиться, якщо ви не видалите і її теж — залишити її нешкідливо, але охайніше очистити, якщо ви закінчили з плагіном назавжди.

Плагін не завантажується? Як це виправити

Коли плагін відображається червоним у /plugins або взагалі нічого не робить, причина майже завжди одна з кількох. Пройдіться по них по порядку:

1. Невідповідність версій. Причина номер один. Звірте сторінку плагіна з версією Minecraft вашого сервера — JAR, зібраний для 1.20, часто не активується на 1.21, і навпаки теж правда. Завантажте відповідну збірку або змініть версію свого сервера, щоб вона збігалася з плагіном.
2. Відсутня залежність. Багатьом плагінам потрібен помічник, встановлений поруч із ними — Vault для плагінів економіки, плагін економіки для магазину, конкретна бібліотека. Консоль називає її за вас: шукайте рядок на кшталт Unknown/missing dependency plugins: [Vault]. Встановіть те, що потрібно, і перезапустіть сервер.
3. Неправильний тип сервера. Якщо взагалі нічого не завантажується, переконайтеся, що ви справді на Paper або Spigot, а не на ванілі — плагінам потрібен Bukkit API. Перемикач версій показує, що у вас запущено.
4. Зламана конфігурація. Всього один неправильно відступлений рядок у config.yml може повністю зупинити плагін. Помилка в консолі зазвичай вказує на рядок і стовпець. Виправте YAML (пробіли, ніколи табуляцію) або видаліть файл конфігурації і дайте плагіну заново створити чистий під час наступного перезапуску.

Консоль — ваш найкращий друг у цій справі. Що б не зламалося, сервер друкує причину під час запуску — червоний рядок ERROR або WARN із зазначенням плагіна й проблеми. Читайте зверху вниз; перша помилка зазвичай і є справжньою.