Посібник

Як створити плагін Spigot

Оновлено 7 жовтня 2026 р.

Плагін Spigot використовує API Bukkit/Spigot, тож працює на Spigot і на кожному його відгалуженні, зокрема Paper. Це робить його найширшим вибором, коли ви не знаєте, де працюватиме плагін. Цей посібник охоплює проєкт, код і збірку.

Змініть приклад під свій сервер.

Згенерувати це в Codexe

Крок за кроком

  1. 1.Налаштуйте Java і інструмент збірки

    Встановіть JDK, що відповідає вашій версії Minecraft (17, 21 або 25), і використовуйте Maven чи Gradle.

  2. 2.Додайте API Spigot

    Додайте spigot-api для вашої версії з репозиторію Spigot зі scope provided. Він потрібен лише для компіляції; під час роботи його надає сервер.

  3. 3.Напишіть команди й слухачі

    Зареєструйте CommandExecutor через getCommand("name").setExecutor(...) і слухачів подій через registerEvents.

  4. 4.Напишіть plugin.yml

    Name, version, головний клас, api-version (з 1.13), команди й права.

  5. 5.Зберіть і встановіть

    mvn package, потім скопіюйте .jar із target/ у теку plugins/ сервера й перезапустіть.

Старі версії (від 1.8 до 1.12)

Багато серверів міні-ігор досі працюють на 1.8. API там старіше (немає api-version, інші назви матеріалів), тож плагін треба писати саме під цю версію, а не копіювати з посібника для 1.21. Codexe питає версію й пише код під відповідний API.

З Codexe

Опишіть плагін і напишіть «Spigot» з версією. Codexe згенерує проєкт Maven, скомпілює його, виправить помилки й дозволить протестувати на тестовому сервері цієї версії, перш ніж ви його завантажите.

Запитання

Чи потрібен мені BuildTools?

Лише щоб запустити сервер Spigot або використовувати NMS (внутрішній серверний код). Для компіляції зі звичайним API достатньо залежності spigot-api.

Плагін Spigot чи плагін Paper?

Spigot, якщо він має працювати скрізь; Paper, якщо ваш сервер працює на Paper і вам потрібен його додатковий API. Дивіться як створити плагін Paper.

Створіть плагін Spigot

Цей запит відкривається готовим до надсилання:

“Плагін для Spigot 1.8.8 під назвою Kits: /kit <name> видає налаштовуваний набір предметів із затримкою для кожного набору, набори визначені в config.yml, право kits.<name> для кожного набору, затримки зберігаються після перезапусків.”

Згенерувати це в Codexe
Як створити плагін Spigot: налаштування, код, збірка | Codexe