Vodič

Kako napraviti vlastite predmete s pluginom

Ažurirano 18. listopada 2026.

Vlastiti mačevi, štapići, ključevi i alati neke su od najtraženijih značajki pluginova. Plugin ne može dodati stvarno novi predmet u igru, ali može uzeti vanilla predmet, dati mu ime, lore i skrivenu oznaku te reagirati kad ga igrač koristi. Igrači ulaze s običnom igrom, bez modova.

Promijeni predmete u svoje.

Generiraj ovo uz Codexe

Korak po korak

  1. 1.Popiši predmete

    Za svaki predmet: osnovni materijal, prikazano ime, retci lorea i što radi. „Blaze rod pod nazivom Fire Wand koji na desni klik ispaljuje vatrenu kuglu, cooldown 5 sekundi” cjelovit je predmet.

  2. 2.Označi ih s PersistentDataContainerom

    Spremi id kao što je fire_wand u PersistentDataContainer predmeta pomoću NamespacedKey. Plugin prepoznaje predmet po toj oznaci, a ne po imenu, pa preimenovanje na nakovnju ne stvara kopiju.

  3. 3.Napiši sposobnosti

    Svaka sposobnost je event listener: PlayerInteractEvent za desne klikove, EntityDamageByEntityEvent za udarce, BlockBreakEvent za alate. Dodaj cooldowne po igraču i po predmetu.

  4. 4.Odluči kako ih igrači dobivaju

    Admin naredba /give, crafting recept, trgovina, dropovi mobova ili nagrade iz crateova.

  5. 5.Učini sve podesivim

    Imena, lore, šteta, cooldowni i recepti u config.yml, kako bi mogao balansirati predmete bez novog builda.

  6. 6.Izradi i isprobaj svaki predmet

    Pusti Codexe da kompajlira plugin, uđi na testni poslužitelj uz Isprobaj odmah, daj si svaki predmet i iskoristi ga.

Zašto oznaka, a ne ime

Provjeravanje prikazanog imena ili lorea klasična je greška: svaki igrač s nakovnjem može preimenovati štap u „Fire Wand”. PersistentDataContainer (Minecraft 1.14 i noviji) sprema podatke na predmet koje igrači ne mogu mijenjati, a oni preživljavaju ponovna pokretanja, škrinje i razmjene jer su dio predmeta.

Na verzijama od 1.8 do 1.13 nema PersistentDataContainera; pluginovi koriste NBT preko biblioteke ili skrivenu oznaku u loreu. Navedi verziju u zahtjevu i Codexe će napisati pristup koji ta verzija podržava.

Sposobnosti i eventi iza njih

SposobnostDogađajNapomene
Moć na desni klikPlayerInteractEventProvjeri ruku, okida se jednom po ruci
Dodatna šteta ili efekti pri udarcuEntityDamageByEntityEventProvjeri je li napadač igrač koji drži predmet
Alat za rudarenje područjaBlockBreakEventPoštuj zaštitne pluginove kao što je WorldGuard
Pasivni efekt dok se držiPonavljajući task ili PlayerItemHeldEventUkloni efekt kad se predmet odloži
Luk ili projektilEntityShootBowEvent, ProjectileHitEventOznači projektil da znaš odakle je došao

Teksture i modeli

Plugin mijenja ono što predmet radi, a ne kako izgleda. Za vlastiti izgled treba resource pack koji igrači preuzimaju: na starijim verzijama predmet nosi broj CustomModelData koji pack povezuje s modelom, a od 1.21.2 predmet može upućivati i na vlastiti model preko komponente item_model. Bez packa predmet izgleda kao njegov osnovni materijal s vlastitim imenom, što je mnogim poslužiteljima sasvim dovoljno.

Primjer opisa

„Paper 1.21.4 plugin pod nazivom MagicItems. Tri predmeta, svaki označen PersistentDataContainer id-om: Fire Wand (blaze rod, desni klik ispaljuje vatrenu kuglu, cooldown 5 s), Frost Blade (željezni mač, udarci daju Slowness II na 3 s), Miner's Pick (dijamantni pijuk, ruši 3x3, ali ne u WorldGuard regijama u kojima igrač ne smije graditi). /mi give <player> <item> za magicitems.admin. Oblikovani recepti za svaki. Imena, lore, cooldowni i recepti u config.yml.”

Pitanja

Plugin ili mod za vlastite predmete?

Plugin ako igrači trebaju ulaziti s običnom igrom: predmeti su vanilla predmeti s novim ponašanjem. Mod ako trebaš stvarno nove predmete ili blokove s vlastitim prikazom, koji onda svaki igrač instalira. Pogledaj plugin ili mod.

Mogu li uz to koristiti ItemsAdder ili Nexo?

Tvoj plugin može ovisiti o njima, ali to su plaćeni pluginovi: Codexeov testni poslužitelj ne može ih instalirati, pa se plugin koji traži neki od njih ondje neće uključiti. Besplatne ovisnosti navedene u plugin.yml instaliraju se na testni poslužitelj umjesto tebe.

Prestaju li predmeti raditi nakon ažuriranja?

Predmeti označeni PersistentDataContainerom zadržavaju oznaku kroz Minecraft ažuriranja. Sposobnostima možda treba novi build za novi API; pogledaj ažuriranje plugina.

Napravi svoje vlastite predmete

Ovaj prompt otvara se spreman za slanje:

“Paper 1.21.4 plugin pod nazivom MagicItems s tri predmeta označena PersistentDataContainerom: Fire Wand (blaze rod, desni klik ispaljuje vatrenu kuglu, cooldown 5 sekundi), Frost Blade (željezni mač, Slowness II na 3 sekunde pri udarcu), Miner's Pick (dijamantni pijuk koji kopa 3x3). /mi give za magicitems.admin, oblikovani recept za svaki, imena, lore, cooldowni i recepti u config.yml.”

Generiraj ovo uz Codexe
Kako napraviti vlastite predmete s Minecraft pluginom | Codexe