Vodič

Kako napraviti Spigot plugin

Ažurirano 7. listopada 2026.

Spigot plugin koristi Bukkit/Spigot API, pa radi na Spigotu i na svakom njegovom forku, uključujući Paper. Zato je to najširi izbor kad ne znaš gdje će plugin raditi. Ovaj vodič pokriva projekt, kod i build.

Prilagodi primjer svom poslužitelju.

Generiraj ovo uz Codexe

Korak po korak

  1. 1.Postavi Java okruženje i alat za build

    Instaliraj JDK koji odgovara tvojoj Minecraft verziji (17, 21 ili 25) i koristi Maven ili Gradle.

  2. 2.Dodaj Spigot API

    Dodaj spigot-api za svoju verziju iz Spigot repozitorija s opsegom provided. Potreban je samo za kompajliranje; pri izvođenju ga daje poslužitelj.

  3. 3.Napiši naredbe i listenere

    Registriraj CommandExecutor s getCommand("name").setExecutor(...), a event listenere s registerEvents.

  4. 4.Napiši plugin.yml

    Naziv, verzija, glavna klasa, api-version (od 1.13), naredbe i dozvole.

  5. 5.Build i instalacija

    mvn package, zatim kopiraj .jar iz target/ u mapu plugins/ poslužitelja i ponovno ga pokreni.

Stare verzije (1.8 do 1.12)

Mnogi minigame poslužitelji još uvijek rade na 1.8. API je stariji (nema api-version, drugačiji nazivi materijala), pa plugin mora biti napisan za tu verziju, a ne prepisan iz tutoriala za 1.21. Codexe pita za verziju i piše kod za taj API.

S Codexeom

Opiši plugin i navedi „Spigot” s verzijom. Codexe generira Maven projekt, kompajlira ga, ispravlja greške i omogućuje ti da ga testiraš na testnom poslužitelju te verzije prije preuzimanja.

Pitanja

Trebam li BuildTools?

Samo za pokretanje Spigot poslužitelja ili za korištenje NMS-a (internog koda poslužitelja). Za kompajliranje prema običnom API-ju dovoljna je ovisnost spigot-api.

Spigot plugin ili Paper plugin?

Spigot ako mora raditi svugdje; Paper ako tvoj poslužitelj pokreće Paper i želiš njegov dodatni API. Pogledaj kako napraviti Paper plugin.

Napravi Spigot plugin

Ovaj prompt otvara se spreman za slanje:

“Spigot 1.8.8 plugin pod nazivom Kits: /kit <name> daje podesiv skup itema s cooldownom po kitu, kitovi definirani u config.yml, dozvola kits.<name> po kitu, cooldowni spremljeni između restarta.”

Generiraj ovo uz Codexe
Kako napraviti Spigot plugin: postavljanje, kod, build | Codexe