Platforme

Spigot i Paper pluginovi

Kako iz Codexea dobiti najbolji Bukkit, Spigot ili Paper plugin, u Javi ili Kotlinu. Što napisati u zahtjevu, verzije, plugin.yml, ovisnosti, build i česti problemi.

Ažurirano 30. rujna 2026.

Na ovoj stranici

Što napisati u zahtjevu
Što Codexe generira
Verzije i Java
Build i provjera
Instalacija
Česti problemi

Vrste Bukkit/Spigot/Paper daju plugin za poslužitelj koji radi na Paperu, Spigotu i njihovim forkovima. Odaberi Javu (Maven projekt) ili Kotlin (Gradle projekt s build.gradle.kts).

Da bi svoj plugin igrao u igri, pokreni privatni testni poslužitelj pomoću Isprobaj odmah.

Kad pošalješ zahtjev, Codexe te pita za koju verziju Minecrafta je plugin, od 1.8.8 do 26.3. Kod se piše za API i razinu Jave te verzije, a testni poslužitelj pokreće upravo tu verziju. Projekti izrađeni prije 30. rujna 2026. zadržavaju verziju zapisanu u svojim datotekama za build.

#Što napisati u zahtjevu

Softver i verziju poslužitelja: „Paper 1.21.4“ ili „Spigot 1.20.1“. Paper ima veći API od Spigota. Kod napisan za Spigot radi na Paperu, ali ne i obrnuto, pa ako trebaš oboje, traži Spigot.
Naredbe s argumentima, tko ih smije koristiti i dovršavanje tipkom Tab.
Dozvole sa zadanim vrijednostima (true, op, false).
Ključeve u config.yml koje želiš moći uređivati.
Pohranu: YAML, SQLite, MySQL ili u memoriji.
Integracije: Vault, PlaceholderAPI, LuckPerms, WorldGuard…, navedene izričito kako bi se dodale kao ovisnosti.

Zahtjev u JaviZahtjev u Kotlinu

Text

A Paper 1.21.4 plugin (Java) called Bounties.
- /bounty set <player> <amount>: takes money via Vault, adds it to the player's bounty.
- Killing a player with a bounty pays it to the killer.
- /bounty top shows the 10 highest bounties.
- Bounties stored in SQLite. Minimum bounty 100 (config.yml).
- Permission bounties.set (default true).

Text

A Paper 1.21.4 plugin in Kotlin called Bounties, same features as above.
Use Kotlin idioms (data classes, extension functions) but keep the Bukkit API usage standard.

#Što Codexe generira

Maven projekt (Java) ili Gradle projekt (Kotlin) s ispravnom ovisnošću o API-ju.
Glavnu klasu koja nasljeđuje JavaPlugin, plus klase za naredbe, listenere i pohranu.
plugin.yml s glavnom klasom, api-version, naredbama i dozvolama te config.yml kad postoje postavke.

YAML

name: Bounties
version: 1.0.0
main: eu.codexe.bounties.Bounties
api-version: '1.21'
depend: [Vault]
commands:
  bounty:
    description: Manage bounties
permissions:
  bounties.set:
    default: true

#Verzije i Java

Codexe čita verziju Minecrafta iz datoteke za build i gradi s Javom 17 (prije 1.20.5), Javom 21 (1.20.5 i novije) ili Javom 25 (26.x). Ako ne navedeš verziju, koristi se Paper/Spigot API 1.20.6.

#Build i provjera

Codexe kompajlira plugin prije nego što ga proglasi spremnim i provjerava sadrži li JAR klase i plugin.yml (ili paper-plugin.yml). Buildovi pluginova obično traju znatno manje od minute. Pogledaj Kompajliranje.

#Instalacija

Preuzmi JAR, stavi ga u plugins/, ponovno pokreni poslužitelj (ne koristi /reload) i u konzoli provjeri ima li grešaka pri pokretanju.

#Česti problemi

Simptom	Vjerojatni uzrok
Plugin se ne učitava, „main class not found“	`main:` u `plugin.yml` ne odgovara klasi. Zamoli chat da to popravi ili provjeri nakon ručnih preimenovanja.
„Unsupported API version“ na starijem poslužitelju	Plugin cilja noviji API od tvog poslužitelja. Navedi točnu verziju poslužitelja u zahtjevu.
Naredba ne radi ništa	Naredba nedostaje u `plugin.yml` ili igrač nema dozvolu.
`NoClassDefFoundError` za Vault ili slično	Plugin o kojem ovisi nije instaliran na poslužitelju.
Izgradi se, ali neka funkcija se ne ponaša ispravno	Opiši točno ponašanje u igri u chatu. Provjera provjerava build, a ne igru.