Руководство

Как сделать плагин для 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, в области 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 может сгенерировать проект Gradle на Kotlin с build.gradle.kts для того же Paper API.

Сделайте плагин для Paper прямо сейчас

Этот промпт откроется уже готовым к отправке:

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

Сгенерировать это в Codexe
Как сделать плагин для Paper (Minecraft) | Codexe