Návod

Jak vytvořit plugin pro Paper

Aktualizováno 7. října 2026

Paper je nejpoužívanější serverový software Minecraftu pro pluginy: spouští pluginy pro Spigot a přidává nad ně větší a rychlejší API. Plugin pro Paper je projekt v Javě (nebo Kotlinu) zkompilovaný proti paper-api. Tady je, co potřebuje, ručně nebo s AI, která ho za tebe sestaví.

Příklad, od kterého můžeš začít.

Vygeneruj to s Codexe

Krok za krokem

  1. 1.Vyber verzi Minecraftu

    Použij verzi, na které běží tvůj server. Určuje verzi Javy: Java 17 před 1.20.5, Java 21 od 1.20.5, Java 25 pro 26.x.

  2. 2.Vytvoř projekt

    Projekt Gradle nebo Maven se závislostí paper-api pro danou verzi z repozitáře PaperMC, s rozsahem provided/compileOnly.

  3. 3.Napiš hlavní třídu

    Třída, která rozšiřuje JavaPlugin, s onEnable() pro registraci příkazů a listenerů.

  4. 4.Popiš plugin serveru

    plugin.yml (name, version, main, api-version, commands, permissions). Paper také podporuje paper-plugin.yml s vlastními pravidly načítání.

  5. 5.Sestav a otestuj

    Sestav .jar, vlož ho do složky plugins/ testovacího serveru Paper, spusť ho a v konzoli zkontroluj chyby.

Paper, nebo Spigot?

Kód napsaný pro API Spigotu běží na Paperu, ale ne naopak: Paper přidává události a metody (například textové komponenty Adventure a mnoho asynchronních API), které Spigot nemá. Piš pro Paper, pokud tvůj server běží na Paperu; piš pro Spigot, pokud plugin musí běžet i na serverech Spigot.

Rychlá cesta

V Codexe vyber plugin pro Bukkit/Spigot/Paper, v zadání napiš „Paper“ a verzi a popiš, co dělá. Codexe připraví projekt a správnou verzi Javy, zkompiluje ho, opraví chyby sestavení a nechá tě připojit se na testovací server Paper s nainstalovaným pluginem.

Běžné problémy

  • UnsupportedClassVersionError: plugin byl zkompilován novější Javou, než jakou server používá.
  • NoSuchMethodError / NoClassDefFoundError: plugin používá API, které ve verzi serveru neexistuje, nebo nebyla závislost přibalena (shaded) do .jar.
  • Plugin se načte, ale příkazy nic nedělají: příkaz chybí v plugin.yml nebo není zaregistrován vykonavatel.

Otázky

Fungují pluginy pro Paper na Purpuru nebo Folia?

Purpur je fork Paperu, takže tam pluginy pro Paper běží. Folia mění vlákna: plugin musí být napsaný pro její regionální plánovač, aby na Folia běžel.

Můžu napsat plugin pro Paper v Kotlinu?

Ano. Codexe umí vygenerovat projekt Gradle v Kotlinu s build.gradle.kts pro stejné API Paperu.

Vytvoř plugin pro Paper hned teď

Toto zadání se otevře připravené k odeslání:

“Plugin pro Paper 1.21.4 s názvem Bounties: /bounty set <player> <amount> s ekonomikou Vault, odměnu dostane zabiják, /bounty list ukáže top 10, odměny se ukládají i po restartech, zprávy v config.yml.”

Vygeneruj to s Codexe
Jak vytvořit plugin pro Paper (Minecraft) | Codexe