Hogyan készíts Minecraft-plugint

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

1. 1.Válaszd ki a szerverszoftvert és a verziót

   A pluginok Bukkit-alapú szervereken futnak: Spigot, Paper vagy Folia (proxykhoz BungeeCord és Velocity). Válaszd ki a szervered Minecraft-verzióját, 1.8-tól 26.x-ig.

2. 2.Írd le, mit csinál a plugin

   Írd le a parancsokat, a jogosultságokat, mi történik a játékban, és mi legyen beállítható. Példa: „/sethome, /home és /delhome, játékosonként legfeljebb 3 otthon, 3 másodperces előkészítés, üzenetek a config.yml-ben”.

3. 3.Hagyd, hogy a Codexe megírja és lefordítsa

   A Codexe megírja a Java-osztályokat, a plugin.yml-t, a config.yml-t és a pom.xml-t, valódi buildet futtat, és kijavítja a fordítási hibákat, mielőtt Késznek jelölné a projektet.

4. 4.Teszteld valódi szerveren

   Nyomd meg a Próbáld ki most gombot, hogy csatlakozz egy privát Minecraft-szerverre, amelyen a plugin telepítve van. A Codexe tesztjátékosai minden parancsot lefuttatnak, és ellenőrzik, amit kértél.

5. 5.Töltsd le és telepítsd a .jar-t

   Töltsd le a lebuildelt .jar-t, tedd a szervered plugins/ mappájába, és indítsd újra a szervert. A konfigurációs fájlok a plugins/<PluginName>/ mappában jelennek meg.

Mi az a Minecraft-plugin

A plugin egy .jar fájl, amelyet a Minecraft-szerver a plugins/ mappájából tölt be. Parancsokat, játékszabályokat, gazdaságokat, minijátékokat vagy bármi mást ad hozzá, csak a szerveren: a játékosok a normál játékkal csatlakoznak, modok nem kellenek.

A pluginokat Javában (vagy Kotlinban) írják a szerver-API-ra: Spigot és Paper játékszerverekhez, BungeeCord vagy Velocity proxykhoz. A pluginnak szüksége van egy plugin.yml-re is, amely megmondja a szervernek a nevét, főosztályát, parancsait és jogosultságait.

A kézi út: Java, Maven és a Spigot vagy Paper API

Hosszabb megtanulni, de teljes kontrollt ad. A Codexe ugyanilyen projektet állít elő, így indulhatsz egy generált pluginból, és kézzel folytathatod.

1. Telepíts egy JDK-t (Java 21 az 1.20.5-től az 1.21.x-ig, Java 25 a 26.x-hez) és egy IDE-t, például az IntelliJ IDEA-t.
2. Hozz létre egy Maven- vagy Gradle-projektet, és add hozzá a verziódhoz tartozó paper-api vagy spigot-api függőséget provided hatókörrel.
3. Írj egy főosztályt, amely kiterjeszti a JavaPlugin-t, onEnable()-lel és onDisable()-lel.
4. Add hozzá a plugin.yml-t a src/main/resources mappában a name, version, main, api-version és a parancsaid megadásával.
5. Regisztrálj parancsokat a getCommand("name").setExecutor(...)-gal és listenereket a getServer().getPluginManager().registerEvents(...)-tel.
6. Buildelj a mvn package paranccsal, másold a .jar-t a target/ mappából egy tesztszerver plugins/ mappájába, és indítsd újra.

Kérdések