Útmutató

Hogyan készíts Paper-plugint

Frissítve: 2026. október 7.

A Paper a legtöbbet használt Minecraft-szerverszoftver pluginokhoz: futtatja a Spigot-plugineket, és fölé egy nagyobb, gyorsabb API-t ad. A Paper-plugin egy Java (vagy Kotlin) projekt, amelyet a paper-api-ra fordítanak. Itt van, mi kell hozzá, kézzel vagy egy AI-val, amely megépíti neked.

Egy példa, amiből indulhatsz.

Generáld ezt a Codexe-szel

Lépésről lépésre

  1. 1.Válaszd ki a Minecraft-verziót

    Azt a verziót használd, amelyen a szervered fut. Ez dönti el a Java-verziót: Java 17 az 1.20.5 előtt, Java 21 az 1.20.5-től, Java 25 a 26.x-hez.

  2. 2.Hozd létre a projektet

    Gradle- vagy Maven-projekt az adott verzióhoz tartozó paper-api függőséggel, a PaperMC-tárolóból, provided/compileOnly hatókörben.

  3. 3.Írd meg a főosztályt

    Egy osztály, amely kiterjeszti a JavaPlugin-t, az onEnable()-lel a parancsok és listenerek regisztrálására.

  4. 4.Írd le a plugint a szervernek

    plugin.yml (név, verzió, main, api-version, parancsok, jogosultságok). A Paper támogatja a paper-plugin.yml-t is, saját betöltési szabályokkal.

  5. 5.Build és teszt

    Buildeld a .jar-t, tedd egy Paper-tesztszerver plugins/ mappájába, indítsd el, és nézd meg a konzolban a hibákat.

Paper vagy Spigot?

A Spigot API-ra írt kód fut Paperen, de fordítva nem: a Paper olyan eseményeket és metódusokat ad (például az Adventure szövegkomponenseket és sok aszinkron API-t), amelyek a Spigotban nincsenek. Paperre írj, ha a szervered Papert futtat; Spigotra írj, ha a pluginnak Spigot-szervereken is futnia kell.

A gyors út

A Codexe-en válassz Bukkit/Spigot/Paper plugint, írd a kérésbe a „Paper” szót és a verziót, és írd le, mit csináljon. A Codexe beállítja a projektet és a megfelelő Java-verziót, lefordítja, kijavítja a buildhibákat, és lehetővé teszi, hogy csatlakozz egy Paper-tesztszerverre a plugin telepítésével.

Gyakori problémák

  • UnsupportedClassVersionError: a plugint újabb Javával fordították, mint amit a szerver futtat.
  • NoSuchMethodError / NoClassDefFoundError: a plugin olyan API-t használ, amely nem létezik a szerververzión, vagy egy függőség nem került be (shade) a .jar-ba.
  • A plugin betöltődik, de a parancsok nem csinálnak semmit: a parancs hiányzik a plugin.yml-ből, vagy a végrehajtó nincs regisztrálva.

Kérdések

Működnek a Paper-pluginok Purpuron vagy Folián?

A Purpur egy Paper-fork, így a Paper-pluginok futnak rajta. A Folia megváltoztatja a szálkezelést: a pluginnak a regionális ütemezőjére kell íródnia, hogy Folián fusson.

Írhatok Paper-plugint Kotlinban?

Igen. A Codexe tud Kotlin Gradle-projektet generálni build.gradle.kts-sel ugyanahhoz a Paper API-hoz.

Építs most Paper-plugint

Ez a prompt küldésre készen nyílik meg:

“Egy Bounties nevű Paper 1.21.4 plugin: /bounty set <player> <amount> a Vault gazdaságával, a gyilkos kapja a jutalmat, a /bounty list a top 10-et mutatja, a fejpénzek újraindítások között mentve, az üzenetek a config.yml-ben.”

Generáld ezt a Codexe-szel
Hogyan készíts Paper-plugint (Minecraft) | Codexe