Guide
Slik lager du egne gjenstander med et plugin
Oppdatert 18. oktober 2026
Egne sverd, staver, nøkler og verktøy er noen av de mest etterspurte pluginfunksjonene. Et plugin kan ikke legge til en helt ny gjenstand i spillet, men det kan ta en vanilla-gjenstand, gi den et navn, lore og en skjult tagg, og reagere når en spiller bruker den. Spillerne kobler til med det vanlige spillet, uten mods.
Bytt ut gjenstandene med dine egne.
Generer dette med CodexeSteg for steg
1.List opp gjenstandene
For hver gjenstand: grunnmaterialet, visningsnavnet, lore-linjene og hva den gjør. «En blaze rod kalt Fire Wand som skyter en ildkule ved høyreklikk, 5 sekunders nedkjøling» er en komplett gjenstand.
2.Merk dem med PersistentDataContainer
Lagre en id som
fire_wandi gjenstandensPersistentDataContainermed enNamespacedKey. Pluginet kjenner igjen gjenstanden på taggen, ikke på navnet, så å gi den nytt navn i en ambolt lager ingen kopi.3.Skriv evnene
Hver evne er en event listener:
PlayerInteractEventfor høyreklikk,EntityDamageByEntityEventfor treff,BlockBreakEventfor verktøy. Legg til nedkjøling per spiller og per gjenstand.4.Bestem hvordan spillerne får dem
En admin-kommando
/give, en crafting-oppskrift, en butikk, mob-drops eller belønninger fra kister.5.Gjør alt konfigurerbart
Navn, lore, skade, nedkjøling og oppskrifter i
config.yml, så du kan balansere gjenstandene uten et nytt bygg.6.Bygg og prøv hver gjenstand
La Codexe kompilere pluginet, koble til testserveren med Prøv nå, gi deg selv hver gjenstand og bruk den.
Hvorfor en tagg og ikke navnet
Å sjekke visningsnavnet eller loren er den klassiske feilen: hvilken som helst spiller med en ambolt kan gi en pinne navnet «Fire Wand». PersistentDataContainer (Minecraft 1.14 og nyere) lagrer data på gjenstanden som spillerne ikke kan redigere, og den overlever omstarter, kister og byttehandler fordi den er en del av gjenstanden.
På 1.8 til 1.13 finnes det ingen PersistentDataContainer; plugins bruker NBT via et bibliotek eller en skjult lore-markør. Skriv versjonen i forespørselen, så skriver Codexe den løsningen versjonen støtter.
Evner og eventene bak dem
| Evne | Hendelse | Merknader |
|---|---|---|
| Kraft ved høyreklikk | PlayerInteractEvent | Sjekk hånden, den utløses én gang per hånd |
| Ekstra skade eller effekter ved treff | EntityDamageByEntityEvent | Sjekk at angriperen er en spiller som holder gjenstanden |
| Verktøy som graver et område | BlockBreakEvent | Respekter beskyttelsesplugins som WorldGuard |
| Passiv effekt mens den holdes | En gjentakende oppgave eller PlayerItemHeldEvent | Fjern effekten når gjenstanden legges bort |
| Bue eller prosjektil | EntityShootBowEvent, ProjectileHitEvent | Merk prosjektilet så du vet hvor det kom fra |
Teksturer og modeller
Et plugin endrer hva en gjenstand gjør, ikke hvordan den ser ut. Et eget utseende krever en ressurspakke som spillerne laster ned: på eldre versjoner har gjenstanden et CustomModelData-tall som pakken knytter til en modell, og fra 1.21.2 kan en gjenstand også peke på sin egen modell via komponenten item_model. Uten pakke ser gjenstanden ut som grunnmaterialet med et eget navn, noe som holder for mange servere.
Eksempelbeskrivelse
«Et Paper 1.21.4-plugin kalt MagicItems. Tre gjenstander, hver merket med en PersistentDataContainer-id: Fire Wand (blaze rod, høyreklikk skyter en ildkule, 5 s nedkjøling), Frost Blade (jernsverd, treff gir Slowness II i 3 s), Miner's Pick (diamanthakke, knuser 3x3, men ikke i WorldGuard-regioner der spilleren ikke kan bygge). /mi give <player> <item> for magicitems.admin. Shaped-oppskrifter for hver. Navn, lore, nedkjøling og oppskrifter i config.yml.»
Spørsmål
Plugin eller mod for egne gjenstander?
Et plugin hvis spillerne skal koble til med det vanlige spillet: gjenstandene er vanilla-gjenstander med ny oppførsel. En mod hvis du trenger helt nye gjenstander eller blokker med egen rendering, som alle spillere da må installere. Se plugin eller mod.
Kan jeg bruke ItemsAdder eller Nexo med det?
Pluginet ditt kan være avhengig av dem, men de er betalte plugins: Codexes testserver kan ikke installere dem, så et plugin som krever ett av dem, blir ikke aktivert der. Gratis avhengigheter som står i plugin.yml, installeres på testserveren for deg.
Slutter gjenstandene å fungere etter en oppdatering?
Gjenstander merket med en PersistentDataContainer beholder taggen sin på tvers av Minecraft-oppdateringer. Evnene kan trenge et nytt bygg for det nye API-et; se oppdatere et plugin.
Lag dine egne gjenstander
Denne prompten åpnes klar til å sendes:
“Et Paper 1.21.4-plugin kalt MagicItems med tre gjenstander merket med PersistentDataContainer: Fire Wand (blaze rod, høyreklikk skyter en ildkule, 5 sekunders nedkjøling), Frost Blade (jernsverd, Slowness II i 3 sekunder ved treff), Miner's Pick (diamanthakke som graver 3x3). /mi give for magicitems.admin, en shaped-oppskrift for hver, navn, lore, nedkjøling og oppskrifter i config.yml.”
Generer dette med Codexe