Jak vytvořit plugin pro Minecraft

Krok za krokem

1. 1.Vyber serverový software a verzi

   Pluginy běží na serverech založených na Bukkitu: Spigot, Paper nebo Folia (BungeeCord a Velocity pro proxy). Vyber verzi Minecraftu, na které tvůj server běží, od 1.8 do 26.x.

2. 2.Popiš, co plugin dělá

   Napiš příkazy, oprávnění, co se děje ve hře a co má být konfigurovatelné. Příklad: „/sethome, /home a /delhome, max. 3 domovy na hráče, 3sekundový odpočet, zprávy v config.yml“.

3. 3.Nech Codexe napsat a zkompilovat ho

   Codexe napíše třídy v Javě, plugin.yml, config.yml a pom.xml, spustí skutečné sestavení a opraví chyby kompilace, než projekt označí jako Ready.

4. 4.Otestuj ho na skutečném serveru

   Stiskni Vyzkoušet hned a připoj se na soukromý server Minecraftu s nainstalovaným pluginem. Testovací hráči Codexe spustí každý příkaz a zkontrolují, o co jsi žádal/a.

5. 5.Stáhni a nainstaluj .jar

   Stáhni sestavený .jar, vlož ho do složky plugins/ svého serveru a restartuj server. Konfigurační soubory se objeví v plugins/<PluginName>/.

Co je plugin pro Minecraft

Plugin je soubor .jar, který server Minecraftu načte ze své složky plugins/. Přidává příkazy, herní pravidla, ekonomiky, minihry nebo cokoli jiného, a to jen na serveru: hráči se připojují normální hrou, žádné módy nejsou potřeba.

Pluginy se píšou v Javě (nebo Kotlinu) proti API serveru: Spigot a Paper pro herní servery, BungeeCord nebo Velocity pro proxy. Plugin také potřebuje plugin.yml, který serveru říká jeho název, hlavní třídu, příkazy a oprávnění.

Ruční cesta: Java, Maven a API Spigotu nebo Paperu

Učení trvá déle, ale dává plnou kontrolu. Codexe vytváří stejný druh projektu, takže můžeš začít od vygenerovaného pluginu a pokračovat ručně.

1. Nainstaluj JDK (Java 21 pro 1.20.5 až 1.21.x, Java 25 pro 26.x) a IDE jako IntelliJ IDEA.
2. Vytvoř projekt Maven nebo Gradle a přidej závislost paper-api nebo spigot-api pro svoji verzi s rozsahem provided.
3. Napiš hlavní třídu, která rozšiřuje JavaPlugin, s onEnable() a onDisable().
4. Přidej plugin.yml do src/main/resources s name, version, main, api-version a svými příkazy.
5. Zaregistruj příkazy pomocí getCommand("name").setExecutor(...) a listenery pomocí getServer().getPluginManager().registerEvents(...).
6. Sestav pomocí mvn package, zkopíruj .jar z target/ do složky plugins/ testovacího serveru a restartuj.

Otázky