Ръководство

Как да направиш Paper плъгин

Обновено на 7 октомври 2026 г.

Paper е най-използваният сървърен софтуер за Minecraft плъгини: пуска Spigot плъгини и добавя по-голям и по-бърз API отгоре. Paper плъгинът е Java (или Kotlin) проект, компилиран срещу paper-api. Ето от какво има нужда, на ръка или с AI, който го компилира вместо теб.

Пример, от който да започнеш.

Генерирай това с 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() за регистриране на команди и listeners.

  4. 4.Опиши плъгина за сървъра

    plugin.yml (name, version, main, api-version, commands, permissions). Paper поддържа и paper-plugin.yml, със свои правила за зареждане.

  5. 5.Компилирай и тествай

    Компилирай .jar файла, сложи го в папката plugins/ на тестов Paper сървър, пусни го и провери конзолата за грешки.

Paper или Spigot?

Код, писан за Spigot API, работи на Paper, но не и обратното: Paper добавя събития и методи (например текстовите компоненти на Adventure и много async 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 е fork на Paper, така че Paper плъгините работят там. Folia променя работата с нишките: плъгинът трябва да е писан за неговия регионален планировчик, за да работи на Folia.

Мога ли да напиша Paper плъгин на Kotlin?

Да. Codexe може да генерира Kotlin Gradle проект с 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