Посібник

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

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

Paper — найпоширеніше серверне ПЗ Minecraft для плагінів: воно запускає плагіни Spigot і додає зверху більший та швидший API. Плагін Paper — це проєкт на Java (або Kotlin), скомпільований із paper-api. Ось що для цього потрібно — вручну чи з ШІ, що збирає його за вас.

Приклад, з якого можна почати.

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

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

  1. 1.Виберіть версію Minecraft

    Використовуйте версію, на якій працює ваш сервер. Вона визначає версію Java: Java 17 до 1.20.5, Java 21 з 1.20.5, Java 25 для 26.x.

  2. 2.Створіть проєкт

    Проєкт Gradle або Maven із залежністю paper-api для цієї версії з репозиторію PaperMC, у scope provided/compileOnly.

  3. 3.Напишіть головний клас

    Клас, що розширює JavaPlugin, з onEnable() для реєстрації команд і слухачів.

  4. 4.Опишіть плагін серверу

    plugin.yml (name, version, main, api-version, commands, permissions). Paper також підтримує paper-plugin.yml із власними правилами завантаження.

  5. 5.Зберіть і протестуйте

    Зберіть .jar, покладіть у теку plugins/ тестового сервера Paper, запустіть його й перевірте консоль на помилки.

Paper чи Spigot?

Код, написаний для API Spigot, працює на Paper, але не навпаки: Paper додає події та методи (наприклад, текстові компоненти Adventure і багато асинхронних API), яких немає в Spigot. Пишіть для Paper, якщо ваш сервер працює на Paper; пишіть для Spigot, якщо плагін має працювати й на серверах Spigot.

Швидкий шлях

У Codexe виберіть плагін Bukkit/Spigot/Paper, напишіть у запиті «Paper» і версію та опишіть, що він робить. Codexe налаштує проєкт і правильну версію Java, скомпілює його, виправить помилки збірки й дозволить зайти на тестовий сервер Paper зі встановленим плагіном.

Типові проблеми

  • UnsupportedClassVersionError: плагін скомпільовано новішою Java, ніж та, на якій працює сервер.
  • NoSuchMethodError / NoClassDefFoundError: плагін використовує API, якого немає у версії сервера, або залежність не було вбудовано (shade) в .jar.
  • Плагін завантажується, але команди нічого не роблять: команди немає в plugin.yml або виконавця не зареєстровано.

Запитання

Чи працюють плагіни Paper на Purpur або Folia?

Purpur — відгалуження Paper, тож плагіни Paper там працюють. Folia змінює роботу з потоками: щоб працювати на Folia, плагін має бути написаний під його регіональний планувальник.

Чи можна написати плагін Paper на Kotlin?

Так. Codexe може згенерувати проєкт Kotlin Gradle з build.gradle.kts для того ж API Paper.

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

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

“Плагін для Paper 1.21.4 під назвою Bounties: /bounty set <player> <amount> з економікою Vault, вбивця отримує нагороду, /bounty list показує топ-10, нагороди зберігаються після перезапусків, повідомлення в config.yml.”

Згенерувати це в Codexe
Як створити плагін Paper (Minecraft) | Codexe