Guide

Sådan laver du et Paper-plugin

Opdateret 7. oktober 2026

Paper er den mest brugte Minecraft-serversoftware til plugins: den kører Spigot-plugins og tilføjer en større, hurtigere API ovenpå. Et Paper-plugin er et Java- (eller Kotlin-)projekt kompileret mod paper-api. Her er, hvad det kræver, i hånden eller med en AI, der bygger det for dig.

Et eksempel at starte fra.

Generér dette med Codexe

Trin for trin

  1. 1.Vælg Minecraft-versionen

    Brug den version, din server kører. Den afgør Java-versionen: Java 17 før 1.20.5, Java 21 fra 1.20.5, Java 25 til 26.x.

  2. 2.Opret projektet

    Et Gradle- eller Maven-projekt med afhængigheden paper-api til den version, fra PaperMC-repositoryet, i scopet provided/compileOnly.

  3. 3.Skriv hovedklassen

    En klasse, der udvider JavaPlugin, med onEnable() til at registrere kommandoer og listeners.

  4. 4.Beskriv pluginet for serveren

    plugin.yml (name, version, main, api-version, commands, permissions). Paper understøtter også paper-plugin.yml med egne indlæsningsregler.

  5. 5.Byg og test

    Byg .jar-filen, læg den i plugins/-mappen på en Paper-testserver, start den, og tjek konsollen for fejl.

Paper eller Spigot?

Kode skrevet til Spigot-API'en kører på Paper, men ikke omvendt: Paper tilføjer events og metoder (for eksempel Adventure-tekstkomponenterne og mange asynkrone API'er), som Spigot ikke har. Skriv til Paper, hvis din server kører Paper; skriv til Spigot, hvis pluginet også skal køre på Spigot-servere.

Den hurtige vej

På Codexe vælger du et Bukkit/Spigot/Paper-plugin, skriver "Paper" og versionen i anmodningen og beskriver, hvad det gør. Codexe sætter projektet og den rigtige Java-version op, kompilerer det, retter buildfejl og lader dig joine en Paper-testserver med pluginet installeret.

Almindelige problemer

  • UnsupportedClassVersionError: pluginet blev kompileret med en nyere Java, end serveren kører.
  • NoSuchMethodError / NoClassDefFoundError: pluginet bruger en API, der ikke findes på serverversionen, eller en afhængighed blev ikke shaded ind i .jar-filen.
  • Pluginet indlæses, men kommandoer gør ingenting: kommandoen mangler i plugin.yml, eller executoren er ikke registreret.

Spørgsmål

Virker Paper-plugins på Purpur eller Folia?

Purpur er en Paper-fork, så Paper-plugins kører dér. Folia ændrer trådning: et plugin skal være skrevet til dets region-scheduler for at køre på Folia.

Kan jeg skrive et Paper-plugin i Kotlin?

Ja. Codexe kan generere et Kotlin Gradle-projekt med build.gradle.kts til den samme Paper-API.

Byg et Paper-plugin nu

Denne prompt åbnes klar til at sende:

“Et Paper 1.21.4-plugin kaldet Bounties: /bounty set <player> <amount> med Vault-økonomien, dræberen får belønningen, /bounty list viser de 10 bedste, dusører gemmes på tværs af genstarter, beskeder i config.yml.”

Generér dette med Codexe
Sådan laver du et Paper-plugin (Minecraft) | Codexe