Platformok

Spigot- és Paper-pluginok

A legjobb Bukkit-, Spigot- vagy Paper-plugin a Codexe-től Javában vagy Kotlinban: a kérés tartalma, verziók, plugin.yml, függőségek, build és gyakori hibák.

Frissítve 2026. szeptember 30.

Ezen az oldalon

Mit írj a kérésbe
Mit generál a Codexe
Verziók és Java
Build és ellenőrzés
Telepítés
Gyakori problémák

A Bukkit/Spigot/Paper típusok olyan szerverplugint készítenek, amely Paperen, Spigoton és ezek forkjain fut. Válaszd a Javát (Maven-projekt) vagy a Kotlint (Gradle-projekt build.gradle.kts fájllal).

Ha a játékban szeretnéd kipróbálni a pluginodat, indíts egy privát tesztszervert a Próbáld ki most funkcióval.

Amikor elküldöd a kérést, a Codexe megkérdezi, melyik Minecraft-verzióhoz készüljön a plugin, 1.8.8-tól 26.3-ig. A kód az adott verzió API-jához és Java-szintjéhez készül, és a tesztszerver is azt a verziót futtatja. A 2026. szeptember 30. előtt létrehozott projektek megtartják a build-fájljaikban szereplő verziót.

#Mit írj a kérésbe

Szerverszoftver és verzió: „Paper 1.21.4” vagy „Spigot 1.20.1”. A Paper API-ja bővebb a Spigoténál. A Spigotra írt kód fut Paperen, fordítva viszont nem, ezért ha mindkettő kell, Spigotot kérj.
Parancsok argumentumokkal, hogy ki használhatja őket, és tabulátoros kiegészítés.
Jogosultságok az alapértékeikkel (true, op, false).
A config.yml kulcsai, amelyeket szerkeszthetővé szeretnél tenni.
Tárolás: YAML, SQLite, MySQL vagy memória.
Integrációk: Vault, PlaceholderAPI, LuckPerms, WorldGuard…, kifejezetten megnevezve, hogy függőségként bekerüljenek.

Java-kérésKotlin-kérés

Text

A Paper 1.21.4 plugin (Java) called Bounties.
- /bounty set <player> <amount>: takes money via Vault, adds it to the player's bounty.
- Killing a player with a bounty pays it to the killer.
- /bounty top shows the 10 highest bounties.
- Bounties stored in SQLite. Minimum bounty 100 (config.yml).
- Permission bounties.set (default true).

Text

A Paper 1.21.4 plugin in Kotlin called Bounties, same features as above.
Use Kotlin idioms (data classes, extension functions) but keep the Bukkit API usage standard.

#Mit generál a Codexe

Egy Maven-projektet (Java) vagy Gradle-projektet (Kotlin) a megfelelő API-függőséggel.
A JavaPlugin osztályt kiterjesztő főosztályt, valamint parancs-, listener- és tárolóosztályokat.
A plugin.yml fájlt a főosztállyal, az api-version értékkel, a parancsokkal és a jogosultságokkal, valamint a config.yml fájlt, ha vannak beállítások.

YAML

name: Bounties
version: 1.0.0
main: eu.codexe.bounties.Bounties
api-version: '1.21'
depend: [Vault]
commands:
  bounty:
    description: Manage bounties
permissions:
  bounties.set:
    default: true

#Verziók és Java

A Codexe a build-fájlból olvassa ki a Minecraft-verziót, és Java 17-tel (1.20.5 előtt), Java 21-gyel (1.20.5-től) vagy Java 25-tel (26.x) buildel. Ha nem adsz meg verziót, a Paper/Spigot API 1.20.6 kerül felhasználásra.

#Build és ellenőrzés

A Codexe lefordítja a plugint, mielőtt Késznek nevezné, és ellenőrzi, hogy a JAR tartalmazza az osztályokat és egy plugin.yml (vagy paper-plugin.yml) fájlt. A pluginok buildje általában jóval kevesebb mint egy perc. Lásd: Fordítás.

#Telepítés

Töltsd le a JAR-t, tedd a plugins/ mappába, indítsd újra a szervert (ne használd a /reload parancsot), és nézd meg a konzolban, van-e hiba indításkor.

#Gyakori problémák

Tünet	Valószínű ok
A plugin nem töltődik be, „main class not found”	A `main:` a `plugin.yml` fájlban nem egyezik az osztállyal. Kérd meg a csevegést, hogy javítsa ki, vagy ellenőrizd kézi átnevezések után.
„Unsupported API version” egy régebbi szerveren	A plugin újabb API-t céloz, mint a szervered. Add meg a kérésben a szervered pontos verzióját.
Egy parancs nem csinál semmit	A parancs hiányzik a `plugin.yml` fájlból, vagy a játékosnak nincs meg a jogosultsága.
`NoClassDefFoundError` a Vaultra vagy hasonlóra	A függőségként szükséges plugin nincs telepítve a szerveren.
Lebuildelődik, de egy funkció rosszul működik	Írd le a csevegésben a pontos játékbeli viselkedést. Az ellenőrzés a buildet vizsgálja, nem a játékmenetet.