Guide
Sådan laver du custom items med et plugin
Opdateret 18. oktober 2026
Specialsværd, tryllestave, nøgler og værktøjer er nogle af de mest efterspurgte pluginfunktioner. Et plugin kan ikke tilføje en helt ny genstand til spillet, men det kan tage en vanilla-genstand, give den et navn, lore og et skjult tag og reagere, når en spiller bruger den. Spillerne joiner med det normale spil, ingen mods nødvendige.
Ret genstandene til dine egne.
Generér dette med CodexeTrin for trin
1.Skriv genstandene ned
For hver genstand: grundmaterialet, visningsnavnet, lore-linjerne og hvad den gør. "En blaze rod kaldet Fire Wand, der skyder en ildkugle ved højreklik, 5 sekunders cooldown" er en komplet genstand.
2.Tag dem med PersistentDataContainer
Gem et id som
fire_wandi genstandensPersistentDataContainermed enNamespacedKey. Pluginet genkender genstanden på det tag, ikke på navnet, så at omdøbe den i en ambolt laver ikke en kopi.3.Skriv evnerne
Hver evne er en event listener:
PlayerInteractEventtil højreklik,EntityDamageByEntityEventtil slag,BlockBreakEventtil værktøjer. Tilføj cooldowns pr. spiller og pr. genstand.4.Beslut, hvordan spillerne får dem
En admin-kommando
/give, en crafting-opskrift, en butik, mob-drops eller belønninger fra crates.5.Gør alt konfigurerbart
Navne, lore, skade, cooldowns og opskrifter i
config.yml, så du kan balancere genstandene uden et nyt build.6.Byg og prøv hver genstand
Lad Codexe kompilere pluginet, join testserveren med Prøv det nu, giv dig selv hver genstand, og brug den.
Hvorfor et tag og ikke navnet
At tjekke visningsnavnet eller loren er den klassiske fejl: enhver spiller med en ambolt kan omdøbe en pind til "Fire Wand". PersistentDataContainer (Minecraft 1.14 og nyere) gemmer data på genstanden, som spillerne ikke kan redigere, og de overlever genstarter, kister og handler, fordi de er en del af genstanden.
På 1.8 til 1.13 findes der ingen PersistentDataContainer; plugins bruger NBT via et bibliotek eller en skjult lore-markør. Skriv versionen i anmodningen, så skriver Codexe den løsning, som versionen understøtter.
Evner og eventsene bag dem
| Evne | Hændelse | Noter |
|---|---|---|
| Kraft ved højreklik | PlayerInteractEvent | Tjek hånden, den udløses én gang pr. hånd |
| Ekstra skade eller effekter ved slag | EntityDamageByEntityEvent | Tjek, at angriberen er en spiller, der holder genstanden |
| Værktøj til områdeminering | BlockBreakEvent | Respektér beskyttelsesplugins som WorldGuard |
| Passiv effekt, mens den holdes | En gentagende opgave eller PlayerItemHeldEvent | Fjern effekten, når genstanden lægges væk |
| Bue eller projektil | EntityShootBowEvent, ProjectileHitEvent | Tag projektilet, så du ved, hvor det kom fra |
Teksturer og modeller
Et plugin ændrer, hvad en genstand gør, ikke hvordan den ser ud. Et eget udseende kræver en resource pack, som spillerne downloader: på ældre versioner har genstanden et CustomModelData-tal, som packen kobler til en model, og fra 1.21.2 kan en genstand også pege på sin egen model via komponenten item_model. Uden en pack ligner genstanden sit grundmateriale med et eget navn, hvilket er fint for mange servere.
Eksempel på beskrivelse
"Et Paper 1.21.4-plugin kaldet MagicItems. Tre genstande, hver tagget med et PersistentDataContainer-id: Fire Wand (blaze rod, højreklik skyder en ildkugle, 5 s cooldown), Frost Blade (jernsværd, slag giver Slowness II i 3 s), Miner's Pick (diamanthakke, ødelægger 3x3, men ikke i WorldGuard-regioner, hvor spilleren ikke kan bygge). /mi give <player> <item> for magicitems.admin. Shaped-opskrifter til hver. Navne, lore, cooldowns og opskrifter i config.yml."
Spørgsmål
Plugin eller mod til custom items?
Et plugin, hvis spillerne skal joine med det normale spil: genstandene er vanilla-genstande med ny opførsel. En mod, hvis du har brug for helt nye genstande eller blokke med deres egen rendering, som hver spiller så skal installere. Se plugin vs. mod.
Kan jeg bruge ItemsAdder eller Nexo sammen med det?
Dit plugin kan afhænge af dem, men de er betalte plugins: Codexes testserver kan ikke installere dem, så et plugin, der kræver et af dem, aktiveres ikke der. Gratis afhængigheder angivet i plugin.yml installeres på testserveren for dig.
Holder genstandene op med at virke efter en opdatering?
Genstande tagget med en PersistentDataContainer beholder deres tag på tværs af Minecraft-opdateringer. Evnerne kan kræve et nyt build til den nye API; se opdatering af et plugin.
Lav dine custom items
Denne prompt åbnes klar til at sende:
“Et Paper 1.21.4-plugin kaldet MagicItems med tre genstande tagget med PersistentDataContainer: Fire Wand (blaze rod, højreklik skyder en ildkugle, 5 sekunders cooldown), Frost Blade (jernsværd, Slowness II i 3 sekunder ved slag), Miner's Pick (diamanthakke, der miner 3x3). /mi give for magicitems.admin, en shaped-opskrift til hver, navne, lore, cooldowns og opskrifter i config.yml.”
Generér dette med Codexe