Ghid

Cum faci un plugin Paper

Actualizat 7 octombrie 2026

Paper este cel mai folosit software de server Minecraft pentru plugin-uri: rulează plugin-uri Spigot și adaugă deasupra un API mai mare și mai rapid. Un plugin Paper este un proiect Java (sau Kotlin) compilat pe paper-api. Iată ce are nevoie, de mână sau cu un AI care îl compilează pentru tine.

Un exemplu de la care poți porni.

Generează asta cu Codexe

Pas cu pas

  1. 1.Alege versiunea Minecraft

    Folosește versiunea pe care rulează serverul tău. Ea decide versiunea Java: Java 17 înainte de 1.20.5, Java 21 de la 1.20.5, Java 25 pentru 26.x.

  2. 2.Creează proiectul

    Un proiect Gradle sau Maven cu dependența paper-api pentru acea versiune, din repository-ul PaperMC, cu scope-ul provided/compileOnly.

  3. 3.Scrie clasa principală

    O clasă care extinde JavaPlugin, cu onEnable() pentru a înregistra comenzile și listener-ele.

  4. 4.Descrie pluginul pentru server

    plugin.yml (name, version, main, api-version, commands, permissions). Paper suportă și paper-plugin.yml, cu propriile reguli de încărcare.

  5. 5.Compilează și testează

    Compilează .jar-ul, pune-l în folderul plugins/ al unui server de testare Paper, pornește-l și verifică în consolă dacă există erori.

Paper sau Spigot?

Codul scris pentru API-ul Spigot rulează pe Paper, dar invers nu: Paper adaugă evenimente și metode (de exemplu componentele de text Adventure și multe API-uri async) pe care Spigot nu le are. Scrie pentru Paper dacă serverul tău rulează Paper; scrie pentru Spigot dacă pluginul trebuie să ruleze și pe servere Spigot.

Calea rapidă

Pe Codexe, alege un plugin Bukkit/Spigot/Paper, scrie „Paper” și versiunea în cerere și descrie ce face. Codexe pregătește proiectul și versiunea Java potrivită, îl compilează, repară erorile de build și te lasă să intri pe un server de testare Paper cu pluginul instalat.

Probleme frecvente

  • UnsupportedClassVersionError: pluginul a fost compilat cu o versiune Java mai nouă decât cea pe care rulează serverul.
  • NoSuchMethodError / NoClassDefFoundError: pluginul folosește un API care nu există în versiunea serverului sau o dependență nu a fost inclusă (shaded) în .jar.
  • Pluginul se încarcă, dar comenzile nu fac nimic: comanda lipsește din plugin.yml sau executorul nu este înregistrat.

Întrebări

Funcționează plugin-urile Paper pe Purpur sau Folia?

Purpur este un fork Paper, deci plugin-urile Paper rulează acolo. Folia schimbă threading-ul: un plugin trebuie scris pentru planificatorul lui regional ca să ruleze pe Folia.

Pot scrie un plugin Paper în Kotlin?

Da. Codexe poate genera un proiect Gradle Kotlin cu build.gradle.kts pentru același API Paper.

Creează acum un plugin Paper

Acest prompt se deschide gata de trimis:

“Un plugin Paper 1.21.4 numit Bounties: /bounty set <player> <amount> folosind economia Vault, ucigașul primește recompensa, /bounty list arată primele 10, recompensele se păstrează după restart, mesajele în config.yml.”

Generează asta cu Codexe
Cum faci un plugin Paper (Minecraft) | Codexe