Vodič
Kako napraviti Minecraft plugin s GUI izbornikom
Ažurirano 18. listopada 2026.
Izbornici poslužitelja (warpovi, trgovine, kitovi, postavke) inventari su škrinje koje plugin otvara i kontrolira. Svaki slot drži predmet koji radi kao gumb. Izgledaju jednostavno, ali izbornik koji ne otkazuje svaku vrstu klika dopušta igračima da gumbe odnesu kući. Ovaj vodič pokriva kako izbornici rade i kako ih izraditi i testirati.
Kreni od ovog primjera.
Generiraj ovo uz CodexeKorak po korak
1.Skiciraj izbornik
Izbornik u škrinji ima od 1 do 6 redova po 9 slotova (od 9 do 54). Napiši koji predmet ide u koji slot, što radi svaki klik i koji su slotovi samo ukras, kao što su stakleni paneli.
2.Stvori inventar s holderom
Otvori ga s
Bukkit.createInventory(holder, size, title), koristeći vlastitu klasuInventoryHolder. Po holderu plugin zna da se klik dogodio u njegovu izborniku, a ne u običnoj škrinji.3.Obradi klikove
U
InventoryClickEventprovjeri holder, otkaži event, a zatim pokreni akciju za taj slot. Nakon akcije zatvori izbornik ili ga osvježi.4.Blokiraj svaki drugi način premještanja predmeta
Otkaži i
InventoryDragEventte obradi shift-klikove, brojčane tipke i klikove u igračevu vlastitom inventaru dok je izbornik otvoren.5.Dodaj stranice ako je popis dug
Za warpove ili predmete u trgovini koji ne stanu rezerviraj donji red za gumbe prethodno, sljedeće i zatvori.
6.Otvori ga naredbom
Na primjer
/warps, ili preko predmeta ili NPC-a. Daj naredbi dopuštenje ako izbornik nije za sve.7.Izradi ga i prokliči
Pusti Codexe da kompajlira plugin, uđi na testni poslužitelj i klikni svaki gumb. Testni igrači također mogu umjesto tebe otvoriti izbornik i kliknuti slotove.
Pravila koja izbornik čine sigurnim
- Prepoznaj izbornik po holderu, nikad po naslovu: naslove može kopirati svaka preimenovana škrinja.
- Otkaži klik prije bilo čega drugog, kako greška u akciji nikad ne bi ostavila predmet na igračevu kursoru.
- Otkaži povlačenja i shift-klikove iz igračeva inventara, inače se predmeti mogu ugurati u izbornik.
- Ne vjeruj predmetu u slotu: akciju potraži po broju slota ili po oznaci na predmetu.
- Spori posao (čitanja iz baze, web zahtjevi) pokreći izvan glavne niti i ažuriraj izbornik kad završi.
Izbornici iz konfiguracije
Vlasnici poslužitelja vole mijenjati izbornike bez novog builda. Zatraži da se svaki izbornik definira u konfiguracijskoj datoteci, s veličinom, naslovom i, za svaki gumb, slotom, materijalom, imenom, loreom i akcijom:
| Ključ | Primjer | Što radi |
|---|---|---|
size | 27 | Broj slotova, višekratnik od 9 |
slot | 13 | Gdje ide gumb, brojeći od 0 |
material | ENDER_PEARL | Prikazani predmet |
action | warp:spawn | Što radi klik: warp, naredba, drugi izbornik |
Primjer opisa
„Paper 1.21.4 plugin pod nazivom WarpMenu. /warps otvara izbornik od 6 redova s jednim gumbom po warpu, 45 po stranici, s gumbima prethodno, sljedeće i zatvori u donjem redu. Admini dodaju warpove s /setwarp <name> <material> i uklanjaju ih s /delwarp. Klik na warp teleportira nakon zagrijavanja od 3 sekunde koje se prekida pri kretanju. Igrači ne mogu uzeti ni pomaknuti nijedan predmet u izborniku. Warpovi se spremaju u warps.yml, naslov izbornika, imena gumba i poruke u config.yml.”
Testiranje izbornika s testnim igračima
Codexeovi testni igrači mogu otvoriti izbornik i kliknuti slot, a zatim provjeriti je li se otvorio izbornik, pojavila poruka ili dodijelio predmet. Dodaj test svojim riječima, na primjer „običan igrač pokrene /warps, klikne slot 0 i vidi poruku o teleportu”, i on se ponovno pokreće svaki put kad Codexe isporuči promjenu.
Pitanja
Radi li ovo na 1.8?
Izbornici u škrinji postoje na svakoj verziji od 1.8. API se razlikuje u detaljima (nazivi materijala, naslovi), pa navedi verziju u zahtjevu.
Mogu li umjesto toga izbornike napraviti u Skriptu?
Da, uz dodatak skript-gui, koji je instaliran na Codexeovu Skript testnom poslužitelju. Za velike ili jako korištene izbornike bolji je plugin.
Može li izbornik izgledati kao vlastita tekstura?
Samo uz resource pack koji mijenja predmete ili pozadinu inventara. Na strani plugina sve je isto: slotovi, predmeti i klikovi.
Napravi svoj izbornik
Ovaj prompt otvara se spreman za slanje:
“Paper 1.21.4 plugin pod nazivom WarpMenu: /warps otvara izbornik od 6 redova s jednim gumbom po warpu, 45 po stranici, gumbi prethodno/sljedeće/zatvori u donjem redu, /setwarp s imenom i materijalom te /delwarp za admine, zagrijavanje teleporta od 3 sekunde koje se prekida pri kretanju, nijedan predmet ne može se uzeti ni pomaknuti, warpovi se spremaju u warps.yml, naslovi i poruke u config.yml.”
Generiraj ovo uz Codexe