Handleiding

Custom items maken met een plugin

Bijgewerkt 18 oktober 2026

Custom zwaarden, toverstaven, sleutels en gereedschap behoren tot de meest gevraagde pluginfuncties. Een plugin kan geen echt nieuw item aan de game toevoegen, maar hij kan een vanilla item een naam, lore en een verborgen tag geven en reageren als een speler het gebruikt. Spelers joinen met de gewone game, geen mods nodig.

Vervang de items door je eigen items.

Genereer dit met Codexe

Stap voor stap

  1. 1.Zet de items op een rij

    Per item: het basismateriaal, de weergavenaam, de lore-regels en wat het doet. "Een blaze rod genaamd Fire Wand die bij rechtsklikken een vuurbal schiet, cooldown van 5 seconden" is een compleet item.

  2. 2.Tag ze met PersistentDataContainer

    Sla een id zoals fire_wand op in de PersistentDataContainer van het item met een NamespacedKey. De plugin herkent het item aan die tag, niet aan zijn naam, dus hernoemen in een aambeeld maakt geen kopie.

  3. 3.Schrijf de vaardigheden

    Elke vaardigheid is een event listener: PlayerInteractEvent voor rechtsklikken, EntityDamageByEntityEvent voor treffers, BlockBreakEvent voor gereedschap. Voeg cooldowns per speler en per item toe.

  4. 4.Bepaal hoe spelers ze krijgen

    Een admincommando /give, een craftingrecept, een winkel, mobdrops of beloningen uit crates.

  5. 5.Maak alles configureerbaar

    Namen, lore, schade, cooldowns en recepten in config.yml, zodat je items kunt balanceren zonder nieuwe build.

  6. 6.Bouw en probeer elk item

    Laat Codexe de plugin compileren, join de testserver met Probeer het nu, geef jezelf elk item en gebruik het.

Waarom een tag en niet de naam

De weergavenaam of lore controleren is de klassieke fout: elke speler met een aambeeld kan een stok hernoemen tot "Fire Wand". De PersistentDataContainer (Minecraft 1.14 en nieuwer) slaat gegevens op het item op die spelers niet kunnen bewerken, en ze overleven herstarts, kisten en ruilhandel omdat ze deel van het item zijn.

Op 1.8 tot 1.13 bestaat er geen PersistentDataContainer; plugins gebruiken NBT via een library of een verborgen markering in de lore. Zet de versie in het verzoek en Codexe schrijft de aanpak die die versie ondersteunt.

Vaardigheden en de events erachter

VaardigheidGebeurtenisOpmerkingen
Kracht bij rechtsklikkenPlayerInteractEventControleer de hand, het event vuurt één keer per hand
Extra schade of effecten bij een trefferEntityDamageByEntityEventControleer of de aanvaller een speler is die het item vasthoudt
Gereedschap dat een gebied mijntBlockBreakEventRespecteer beschermingsplugins zoals WorldGuard
Passief effect zolang het item vastgehouden wordtEen herhalende taak of PlayerItemHeldEventHaal het effect weg als het item wordt weggestopt
Boog of projectielEntityShootBowEvent, ProjectileHitEventTag het projectiel om te weten waar het vandaan kwam

Textures en modellen

Een plugin verandert wat een item doet, niet hoe het eruitziet. Een eigen uiterlijk vereist een resourcepack die spelers downloaden: op oudere versies draagt het item een CustomModelData-getal dat de pack aan een model koppelt, en vanaf 1.21.2 kan een item ook via het component item_model naar een eigen model verwijzen. Zonder pack ziet het item eruit als zijn basismateriaal met een eigen naam, en dat is voor veel servers prima.

Voorbeeldbeschrijving

"Een Paper 1.21.4-plugin genaamd MagicItems. Drie items, elk getagd met een PersistentDataContainer-id: Fire Wand (blaze rod, rechtsklikken schiet een vuurbal, cooldown 5 s), Frost Blade (ijzeren zwaard, treffers geven Slowness II voor 3 s), Miner's Pick (diamanten houweel, breekt 3x3 maar niet in WorldGuard-regio's waar de speler niet mag bouwen). /mi give <player> <item> voor magicitems.admin. Shaped recepten voor elk item. Namen, lore, cooldowns en recepten in config.yml."

Vragen

Plugin of mod voor custom items?

Een plugin als spelers met de gewone game moeten joinen: de items zijn vanilla items met nieuw gedrag. Een mod als je echt nieuwe items of blokken met eigen rendering nodig hebt, die dan elke speler installeert. Zie plugin vs mod.

Kan ik er ItemsAdder of Nexo mee gebruiken?

Je plugin kan ervan afhangen, maar het zijn betaalde plugins: de testserver van Codexe kan ze niet installeren, dus een plugin die er een vereist, wordt daar niet ingeschakeld. Gratis dependencies die in plugin.yml staan, worden voor je op de testserver geïnstalleerd.

Werken de items niet meer na een update?

Items die met een PersistentDataContainer zijn getagd, houden hun tag bij Minecraft-updates. Vaardigheden hebben misschien een nieuwe build nodig voor de nieuwe API; zie een plugin bijwerken.

Maak je custom items

Deze prompt opent klaar om te versturen:

“Een Paper 1.21.4-plugin genaamd MagicItems met drie items getagd via PersistentDataContainer: Fire Wand (blaze rod, rechtsklikken schiet een vuurbal, cooldown van 5 seconden), Frost Blade (ijzeren zwaard, Slowness II voor 3 seconden bij een treffer), Miner's Pick (diamanten houweel dat 3x3 mijnt). /mi give voor magicitems.admin, een shaped recept per item, namen, lore, cooldowns en recepten in config.yml.”

Genereer dit met Codexe
Custom items maken met een Minecraft-plugin | Codexe