Водич

Како направити 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 репозиторијума, у опсегу provided/compileOnly.

  3. 3.Напиши главну класу

    Класа која наслеђује JavaPlugin, са onEnable() за регистрацију команди и listener-а.

  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 или executor није регистрован.

Питања

Да ли Paper плагини раде на Purpur-у или Folia-и?

Purpur је fork Paper-а, па Paper плагини раде и на њему. Folia мења рад са нитима: плагин мора да буде написан за њен region scheduler да би радио на 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