Príručka

Ako vytvoriť plugin pre Spigot

Aktualizované 7. októbra 2026

Plugin pre Spigot používa API Bukkit/Spigot, takže beží na Spigot aj na každom jeho forku, vrátane Paper. Preto je to najširšia voľba, keď nevieš, kde bude plugin bežať. Táto príručka pokrýva projekt, kód a build.

Uprav príklad podľa svojho servera.

Vygeneruj to v Codexe

Krok za krokom

  1. 1.Nastav Javu a build nástroj

    Nainštaluj JDK zodpovedajúce tvojej verzii Minecraftu (17, 21 alebo 25) a použi Maven alebo Gradle.

  2. 2.Pridaj API Spigot

    Pridaj spigot-api pre svoju verziu z repozitára Spigot s rozsahom provided. Je potrebné iba na kompiláciu; za behu ho poskytuje server.

  3. 3.Napíš príkazy a listenery

    Zaregistruj CommandExecutor cez getCommand("name").setExecutor(...) a listenery udalostí cez registerEvents.

  4. 4.Napíš plugin.yml

    Názov, verzia, hlavná trieda, api-version (od 1.13), príkazy a oprávnenia.

  5. 5.Zostav a nainštaluj

    mvn package, potom skopíruj .jar z target/ do priečinka plugins/ servera a reštartuj.

Staré verzie (1.8 až 1.12)

Mnohé minihrové servery stále bežia na 1.8. API je staršie (bez api-version, iné názvy materiálov), takže plugin musí byť napísaný pre túto verziu a nesmie sa kopírovať z návodu pre 1.21. Codexe sa opýta na verziu a napíše kód pre toto API.

S Codexe

Opíš plugin a uveď „Spigot“ s verziou. Codexe vygeneruje projekt Maven, skompiluje ho, opraví chyby a umožní ti otestovať ho na testovacom serveri danej verzie, než ho stiahneš.

Otázky

Potrebujem BuildTools?

Iba na spustenie servera Spigot alebo na použitie NMS (interný kód servera). Na kompiláciu voči bežnému API stačí závislosť spigot-api.

Plugin pre Spigot alebo pre Paper?

Spigot, ak má bežať všade; Paper, ak tvoj server beží na Paper a chceš jeho rozšírené API. Pozri ako vytvoriť plugin pre Paper.

Vytvor plugin pre Spigot

Toto zadanie sa otvorí pripravené na odoslanie:

“Plugin pre Spigot 1.8.8 s názvom Kits: /kit <name> dá nastaviteľnú sadu predmetov s cooldownom pre každý kit, kity definované v config.yml, oprávnenie kits.<name> pre každý kit, cooldowny uložené aj po reštarte.”

Vygeneruj to v Codexe
Ako vytvoriť plugin pre Spigot: nastavenie, kód, build | Codexe