Guide

Så gör du ett Paper-plugin

Uppdaterad 7 oktober 2026

Paper är den mest använda Minecraft-serverprogramvaran för plugin: den kör Spigot-plugin och lägger till ett större, snabbare API ovanpå. Ett Paper-plugin är ett Java-projekt (eller Kotlin-projekt) som kompileras mot paper-api. Här är vad det behöver, för hand eller med en AI som bygger det åt dig.

Ett exempel att utgå från.

Generera det här med Codexe

Steg för steg

  1. 1.Välj Minecraft-version

    Använd den version som din server kör. Den avgör Java-versionen: Java 17 före 1.20.5, Java 21 från 1.20.5, Java 25 för 26.x.

  2. 2.Skapa projektet

    Ett Gradle- eller Maven-projekt med beroendet paper-api för den versionen, från PaperMC-repositoryt, med scope provided/compileOnly.

  3. 3.Skriv huvudklassen

    En klass som utökar JavaPlugin, med onEnable() för att registrera kommandon och lyssnare.

  4. 4.Beskriv pluginet för servern

    plugin.yml (name, version, main, api-version, commands, permissions). Paper stöder också paper-plugin.yml, med egna laddningsregler.

  5. 5.Bygg och testa

    Bygg .jar-filen, lägg den i mappen plugins/ på en Paper-testserver, starta den och kontrollera konsolen efter fel.

Paper eller Spigot?

Kod som är skriven för Spigot-API:et körs på Paper, men inte tvärtom: Paper lägger till händelser och metoder (till exempel Adventure-textkomponenter och många asynkrona API:er) som Spigot inte har. Skriv för Paper om din server kör Paper; skriv för Spigot om pluginet också måste köras på Spigot-servrar.

Det snabba sättet

På Codexe väljer du ett Bukkit/Spigot/Paper-plugin, skriver "Paper" och versionen i begäran och beskriver vad det gör. Codexe sätter upp projektet och rätt Java-version, kompilerar det, åtgärdar byggfel och låter dig ansluta till en Paper-testserver med pluginet installerat.

Vanliga problem

  • UnsupportedClassVersionError: pluginet kompilerades med en nyare Java än den servern kör.
  • NoSuchMethodError / NoClassDefFoundError: pluginet använder ett API som inte finns i serverversionen, eller så paketerades inte ett beroende (shade) in i .jar-filen.
  • Pluginet laddas men kommandona gör ingenting: kommandot saknas i plugin.yml eller så är exekveraren inte registrerad.

Frågor

Fungerar Paper-plugin på Purpur eller Folia?

Purpur är en Paper-fork, så Paper-plugin körs där. Folia ändrar trådningen: ett plugin måste skrivas för dess regionala schemaläggare för att köras på Folia.

Kan jag skriva ett Paper-plugin i Kotlin?

Ja. Codexe kan generera ett Kotlin Gradle-projekt med build.gradle.kts för samma Paper-API.

Bygg ett Paper-plugin nu

Den här prompten öppnas färdig att skicka:

“Ett Paper 1.21.4-plugin som heter Bounties: /bounty set <player> <amount> med Vault-ekonomin, mördaren får belöningen, /bounty list visar de 10 främsta, belöningar sparas över omstarter, meddelanden i config.yml.”

Generera det här med Codexe
Så gör du ett Paper-plugin (Minecraft) | Codexe