Vodič

Kako napraviti Paper plugin

Ažurirano 7. listopada 2026.

Paper je najkorišteniji softver za Minecraft poslužitelje s pluginovima: pokreće Spigot pluginove i dodaje veći, brži API. Paper plugin je Java (ili Kotlin) projekt kompajliran prema paper-api. Evo što mu treba, ručno ili uz AI koji ga builda za tebe.

Primjer za početak.

Generiraj ovo uz Codexe

Korak po korak

  1. 1.Odaberi Minecraft verziju

    Koristi verziju koju pokreće tvoj poslužitelj. Ona određuje Java verziju: Java 17 prije 1.20.5, Java 21 od 1.20.5, Java 25 za 26.x.

  2. 2.Izradi projekt

    Gradle ili Maven projekt s ovisnošću paper-api za tu verziju, iz PaperMC repozitorija, u opsegu provided/compileOnly.

  3. 3.Napiši glavnu klasu

    Klasa koja proširuje JavaPlugin, s onEnable() za registraciju naredbi i listenera.

  4. 4.Opiši plugin poslužitelju

    plugin.yml (name, version, main, api-version, commands, permissions). Paper podržava i paper-plugin.yml, s vlastitim pravilima učitavanja.

  5. 5.Build i testiranje

    Buildaj .jar, stavi ga u mapu plugins/ Paper testnog poslužitelja, pokreni ga i provjeri ima li grešaka u konzoli.

Paper ili Spigot?

Kod napisan za Spigot API radi na Paperu, ali ne i obrnuto: Paper dodaje evente i metode (na primjer Adventure tekstualne komponente i mnoge async API-je) kojih Spigot nema. Piši za Paper ako tvoj poslužitelj pokreće Paper; piši za Spigot ako plugin mora raditi i na Spigot poslužiteljima.

Brži način

Na Codexeu odaberi Bukkit/Spigot/Paper plugin, u zahtjevu navedi „Paper” i verziju te opiši što plugin radi. Codexe postavlja projekt i pravu Java verziju, kompajlira ga, ispravlja greške u buildu i omogućuje ti da uđeš na Paper testni poslužitelj s instaliranim pluginom.

Česti problemi

  • UnsupportedClassVersionError: plugin je kompajliran novijom Java verzijom od one koju pokreće poslužitelj.
  • NoSuchMethodError / NoClassDefFoundError: plugin koristi API koji ne postoji na verziji poslužitelja ili ovisnost nije shadeana u .jar.
  • Plugin se učitava, ali naredbe ništa ne rade: naredba nedostaje u plugin.yml ili executor nije registriran.

Pitanja

Rade li Paper pluginovi na Purpur ili Folia poslužiteljima?

Purpur je fork Papera, pa Paper pluginovi rade i na njemu. Folia mijenja rad s nitima: plugin mora biti napisan za njezin regionalni scheduler da bi radio na Folia poslužitelju.

Mogu li napisati Paper plugin u Kotlinu?

Da. Codexe može generirati Kotlin Gradle projekt s build.gradle.kts za isti Paper API.

Izradi Paper plugin odmah

Ovaj prompt otvara se spreman za slanje:

“Paper 1.21.4 plugin pod nazivom Bounties: /bounty set <player> <amount> preko Vault ekonomije, ubojica dobiva nagradu, /bounty list prikazuje top 10, ucjene se spremaju između restarta, poruke u config.yml.”

Generiraj ovo uz Codexe
Kako napraviti Paper plugin (Minecraft) | Codexe