Opas

Miten tehdä Spigot-plugin

Päivitetty 7. lokakuuta 2026

Spigot-plugin käyttää Bukkit/Spigot-API:a, joten se toimii Spigotilla ja jokaisella sen haarukalla, Paper mukaan lukien. Se tekee siitä laajimman valinnan, kun et tiedä, missä plugin tulee toimimaan. Tämä opas kattaa projektin, koodin ja koonnin.

Muuta esimerkki palvelimellesi sopivaksi.

Generoi tämä Codexella

Vaihe vaiheelta

  1. 1.Pystytä Java ja koontityökalu

    Asenna Minecraft-versiotasi vastaava JDK (17, 21 tai 25) ja käytä Mavenia tai Gradlea.

  2. 2.Lisää Spigot-API

    Lisää versiotasi vastaava spigot-api Spigot-repositoriosta provided-näkyvyydellä. Sitä tarvitaan vain kääntämiseen; palvelin tarjoaa sen ajon aikana.

  3. 3.Kirjoita komennot ja kuuntelijat

    Rekisteröi CommandExecutor komennolla getCommand("name").setExecutor(...) ja tapahtumankuuntelijat komennolla registerEvents.

  4. 4.Kirjoita plugin.yml

    Nimi, versio, pääluokka, api-version (versiosta 1.13), komennot ja käyttöoikeudet.

  5. 5.Kokoa ja asenna

    mvn package, sitten kopioi .jar kansiosta target/ palvelimen plugins/-kansioon ja käynnistä uudelleen.

Vanhat versiot (1.8-1.12)

Monet minipalvelimet ajavat yhä versiota 1.8. API on vanhempi (ei api-version-kenttää, eri materiaalinimet), joten plugin on kirjoitettava kyseiselle versiolle, ei kopioitava 1.21-oppaasta. Codexe kysyy version ja kirjoittaa koodin kyseiselle API:lle.

Codexella

Kuvaile plugin ja sano "Spigot" sekä versio. Codexe generoi Maven-projektin, kääntää sen, korjaa virheet ja antaa sinun testata sitä kyseisen version testipalvelimella ennen lataamista.

Kysymykset

Tarvitsenko BuildToolsia?

Vain Spigot-palvelimen ajamiseen tai NMS:n (palvelimen sisäinen koodi) käyttöön. Tavallista API:a vasten kääntämiseen riittää spigot-api-riippuvuus.

Spigot-plugin vai Paper-plugin?

Spigot, jos sen pitää toimia kaikkialla; Paper, jos palvelimesi ajaa Paperia ja haluat sen lisä-API:n. Katso miten tehdä Paper-plugin.

Tee Spigot-plugin

Tämä kehote aukeaa valmiina lähetettäväksi:

“Spigot 1.8.8 -plugin nimeltä Kits: /kit <name> antaa säädettävän esinesarjan kitkohtaisella jäähtymisajalla, kitit määritelty tiedostossa config.yml, käyttöoikeus kits.<name> kitkohtaisesti, jäähtymisajat tallennettuna uudelleenkäynnistysten yli.”

Generoi tämä Codexella
Miten tehdä Spigot-plugin: pystytys, koodi, koonti | Codexe