Miten tehdä Minecraft-plugin

Vaihe vaiheelta

1. 1.Valitse palvelinohjelmisto ja versio

   Pluginit toimivat Bukkit-pohjaisilla palvelimilla: Spigot, Paper tai Folia (BungeeCord ja Velocity proxyille). Valitse palvelimesi Minecraft-versio, 1.8-26.x.

2. 2.Kuvaile, mitä plugin tekee

   Kirjoita komennot, käyttöoikeudet, mitä pelissä tapahtuu ja mitä pitäisi olla säädettävissä. Esimerkki: "/sethome, /home ja /delhome, enintään 3 kotia pelaajaa kohti, 3 sekunnin viive, viestit tiedostossa config.yml".

3. 3.Anna Codexen kirjoittaa ja kääntää se

   Codexe kirjoittaa Java-luokat, plugin.yml-, config.yml- ja pom.xml-tiedostot, ajaa oikean koonnin ja korjaa käännösvirheet ennen kuin merkitsee projektin valmiiksi.

4. 4.Testaa se oikealla palvelimella

   Paina Kokeile heti liittyäksesi yksityiselle Minecraft-palvelimelle, jolle plugin on asennettu. Codexen testipelaajat ajavat jokaisen komennon ja tarkistavat pyytämäsi asiat.

5. 5.Lataa ja asenna .jar

   Lataa koottu .jar, laita se palvelimesi plugins/-kansioon ja käynnistä palvelin uudelleen. Asetustiedostot ilmestyvät kansioon plugins/<PluginName>/.

Mikä Minecraft-plugin on

Plugin on .jar-tiedosto, jonka Minecraft-palvelin lataa plugins/-kansiostaan. Se lisää komentoja, pelisääntöjä, talouksia, minipelejä tai mitä tahansa muuta, vain palvelimelle: pelaajat liittyvät tavallisella pelillä, modeja ei tarvita.

Pluginit kirjoitetaan Javalla (tai Kotlinilla) palvelin-API:a vasten: Spigot ja Paper pelipalvelimille, BungeeCord tai Velocity proxyille. Plugin tarvitsee myös plugin.yml-tiedoston, joka kertoo palvelimelle sen nimen, pääluokan, komennot ja käyttöoikeudet.

Käsin tehtävä tapa: Java, Maven ja Spigot- tai Paper-API

Sen oppiminen vie kauemmin, mutta antaa täyden hallinnan. Codexe tuottaa samanlaisen projektin, joten voit aloittaa generoidusta pluginista ja jatkaa käsin.

1. Asenna JDK (Java 21 versioille 1.20.5-1.21.x, Java 25 versioille 26.x) ja IDE, kuten IntelliJ IDEA.
2. Luo Maven- tai Gradle-projekti ja lisää versiotasi vastaava paper-api- tai spigot-api-riippuvuus provided-näkyvyydellä.
3. Kirjoita pääluokka, joka laajentaa luokkaa JavaPlugin, metodeineen onEnable() ja onDisable().
4. Lisää plugin.yml kansioon src/main/resources kentillä name, version, main, api-version ja komentosi.
5. Rekisteröi komennot komennolla getCommand("name").setExecutor(...) ja kuuntelijat komennolla getServer().getPluginManager().registerEvents(...).
6. Kokoa komennolla mvn package, kopioi .jar kansiosta target/ testipalvelimen plugins/-kansioon ja käynnistä uudelleen.

Kysymykset