Príručka

Ako vytvoriť plugin pre Paper

Aktualizované 7. októbra 2026

Paper je najpoužívanejší serverový softvér pre pluginy do Minecraftu: spúšťa pluginy pre Spigot a pridáva väčšie a rýchlejšie API. Plugin pre Paper je projekt v Jave (alebo Kotline) skompilovaný voči paper-api. Tu je, čo potrebuje, ručne alebo s AI, ktorá ho za teba zostaví.

Príklad, od ktorého môžeš začať.

Vygeneruj to v Codexe

Krok za krokom

  1. 1.Vyber verziu Minecraftu

    Použi verziu, na ktorej beží tvoj server. Určuje verziu Javy: Java 17 pred 1.20.5, Java 21 od 1.20.5, Java 25 pre 26.x.

  2. 2.Vytvor projekt

    Projekt Gradle alebo Maven so závislosťou paper-api pre danú verziu z repozitára PaperMC v rozsahu provided/compileOnly.

  3. 3.Napíš hlavnú triedu

    Trieda, ktorá rozširuje JavaPlugin, s onEnable() na registráciu príkazov a listenerov.

  4. 4.Opíš plugin serveru

    plugin.yml (name, version, main, api-version, commands, permissions). Paper podporuje aj paper-plugin.yml s vlastnými pravidlami načítania.

  5. 5.Zostav a otestuj

    Zostav .jar, vlož ho do priečinka plugins/ testovacieho servera Paper, spusti ho a v konzole skontroluj chyby.

Paper alebo Spigot?

Kód napísaný pre API Spigot beží na Paper, ale naopak nie: Paper pridáva udalosti a metódy (napríklad textové komponenty Adventure a mnohé asynchrónne API), ktoré Spigot nemá. Píš pre Paper, ak tvoj server beží na Paper; píš pre Spigot, ak má plugin bežať aj na serveroch Spigot.

Rýchla cesta

V Codexe vyber plugin Bukkit/Spigot/Paper, v zadaní uveď „Paper“ a verziu a opíš, čo robí. Codexe nastaví projekt a správnu verziu Javy, skompiluje ho, opraví chyby buildu a umožní ti pripojiť sa na testovací server Paper s nainštalovaným pluginom.

Časté problémy

  • UnsupportedClassVersionError: plugin bol skompilovaný novšou Javou, než akú používa server.
  • NoSuchMethodError / NoClassDefFoundError: plugin používa API, ktoré vo verzii servera neexistuje, alebo závislosť nebola zabalená do .jar.
  • Plugin sa načíta, ale príkazy nič nerobia: príkaz chýba v plugin.yml alebo nie je zaregistrovaný vykonávač.

Otázky

Fungujú pluginy pre Paper na Purpur alebo Folia?

Purpur je fork Paper, takže pluginy pre Paper tam bežia. Folia mení vláknovanie: plugin musí byť napísaný pre jej regionálny plánovač, aby bežal na Folia.

Môžem napísať plugin pre Paper v Kotline?

Áno. Codexe vie vygenerovať projekt Kotlin Gradle s build.gradle.kts pre rovnaké API Paper.

Vytvor plugin pre Paper hneď

Toto zadanie sa otvorí pripravené na odoslanie:

“Plugin pre Paper 1.21.4 s názvom Bounties: /bounty set <player> <amount> s ekonomikou Vault, odmenu dostane zabijak, /bounty list zobrazí top 10, odmeny sa ukladajú aj po reštarte, správy v config.yml.”

Vygeneruj to v Codexe
Ako vytvoriť plugin pre Paper (Minecraft) | Codexe