Anleitung
So erstellst du eigene Items mit einem Plugin
Aktualisiert am 18. Oktober 2026
Eigene Schwerter, Zauberstäbe, Schlüssel und Werkzeuge gehören zu den meistgewünschten Plugin-Funktionen. Ein Plugin kann dem Spiel kein wirklich neues Item hinzufügen, aber es kann ein Vanilla-Item nehmen, ihm einen Namen, eine Lore und einen versteckten Tag geben und reagieren, wenn ein Spieler es benutzt. Spieler betreten den Server mit dem normalen Spiel, ganz ohne Mods.
Ersetze die Items durch deine eigenen.
Mit Codexe erstellenSchritt für Schritt
1.Liste die Items auf
Für jedes Item: das Grundmaterial, der Anzeigename, die Lore-Zeilen und was es tut. „Eine Lohenrute namens Fire Wand, die bei Rechtsklick einen Feuerball schießt, 5 Sekunden Cooldown“ ist ein vollständiges Item.
2.Markiere sie mit PersistentDataContainer
Speichere eine ID wie
fire_wandimPersistentDataContainerdes Items mit einemNamespacedKey. Das Plugin erkennt das Item an diesem Tag, nicht an seinem Namen, sodass Umbenennen im Amboss keine Kopie erzeugt.3.Schreibe die Fähigkeiten
Jede Fähigkeit ist ein Event-Listener:
PlayerInteractEventfür Rechtsklicks,EntityDamageByEntityEventfür Treffer,BlockBreakEventfür Werkzeuge. Ergänze Cooldowns pro Spieler und pro Item.4.Entscheide, wie Spieler sie bekommen
Ein Admin-Befehl
/give, ein Crafting-Rezept, ein Shop, Mob-Drops oder Belohnungen aus Kisten.5.Mach alles konfigurierbar
Namen, Lore, Schaden, Cooldowns und Rezepte in der
config.yml, damit du die Items ohne neuen Build ausbalancieren kannst.6.Bauen und jedes Item ausprobieren
Lass Codexe das Plugin kompilieren, tritt mit Jetzt testen dem Testserver bei, gib dir jedes Item und benutze es.
Warum ein Tag und nicht der Name
Den Anzeigenamen oder die Lore zu prüfen ist der klassische Fehler: Jeder Spieler mit einem Amboss kann einen Stock in „Fire Wand“ umbenennen. Der PersistentDataContainer (Minecraft 1.14 und neuer) speichert Daten am Item, die Spieler nicht bearbeiten können, und sie überstehen Neustarts, Truhen und Handel, weil sie Teil des Items sind.
Unter 1.8 bis 1.13 gibt es keinen PersistentDataContainer; Plugins nutzen NBT über eine Bibliothek oder eine versteckte Lore-Markierung. Gib die Version in der Anfrage an, dann schreibt Codexe den Ansatz, den diese Version unterstützt.
Fähigkeiten und die Events dahinter
| Fähigkeit | Ereignis | Hinweise |
|---|---|---|
| Kraft per Rechtsklick | PlayerInteractEvent | Prüfe die Hand, das Event wird einmal pro Hand ausgelöst |
| Extraschaden oder Effekte bei Treffern | EntityDamageByEntityEvent | Prüfe, ob der Angreifer ein Spieler ist, der das Item hält |
| Werkzeug für Flächenabbau | BlockBreakEvent | Schutz-Plugins wie WorldGuard respektieren |
| Passiver Effekt beim Halten | Ein wiederholter Task oder PlayerItemHeldEvent | Entferne den Effekt, wenn das Item weggesteckt wird |
| Bogen oder Projektil | EntityShootBowEvent, ProjectileHitEvent | Markiere das Projektil, um zu wissen, woher es kam |
Texturen und Modelle
Ein Plugin ändert, was ein Item tut, nicht wie es aussieht. Ein eigenes Aussehen braucht ein Resource Pack, das Spieler herunterladen: In älteren Versionen trägt das Item eine CustomModelData-Zahl, die das Pack einem Modell zuordnet, und ab 1.21.2 kann ein Item über die Komponente item_model auch auf ein eigenes Modell verweisen. Ohne Pack sieht das Item aus wie sein Grundmaterial mit eigenem Namen, was für viele Server völlig reicht.
Beispielbeschreibung
„Ein Plugin für Paper 1.21.4 namens MagicItems. Drei Items, jedes mit einer PersistentDataContainer-ID markiert: Fire Wand (Lohenrute, Rechtsklick schießt einen Feuerball, 5 s Cooldown), Frost Blade (Eisenschwert, Treffer geben 3 s lang Langsamkeit II), Miner's Pick (Diamantspitzhacke, baut 3x3 ab, aber nicht in WorldGuard-Regionen, in denen der Spieler nicht bauen darf). /mi give <player> <item> für magicitems.admin. Geformte Rezepte für jedes Item. Namen, Lore, Cooldowns und Rezepte in der config.yml.“
Fragen
Plugin oder Mod für eigene Items?
Ein Plugin, wenn Spieler mit dem normalen Spiel beitreten sollen: Die Items sind Vanilla-Items mit neuem Verhalten. Eine Mod, wenn du wirklich neue Items oder Blöcke mit eigener Darstellung brauchst, die dann jeder Spieler installiert. Siehe Plugin oder Mod.
Kann ich ItemsAdder oder Nexo damit nutzen?
Dein Plugin kann davon abhängen, aber es sind kostenpflichtige Plugins: Der Codexe-Testserver kann sie nicht installieren, daher wird ein Plugin, das eines davon voraussetzt, dort nicht aktiviert. Kostenlose Abhängigkeiten aus der plugin.yml werden auf dem Testserver für dich installiert.
Funktionieren die Items nach einem Update nicht mehr?
Items mit einem PersistentDataContainer-Tag behalten ihren Tag über Minecraft-Updates hinweg. Die Fähigkeiten brauchen für die neue API eventuell einen neuen Build; siehe ein Plugin aktualisieren.
Erstelle deine eigenen Items
Dieser Prompt öffnet sich versandfertig:
“Ein Plugin für Paper 1.21.4 namens MagicItems mit drei per PersistentDataContainer markierten Items: Fire Wand (Lohenrute, Rechtsklick schießt einen Feuerball, 5 Sekunden Cooldown), Frost Blade (Eisenschwert, Langsamkeit II für 3 Sekunden bei Treffer), Miner's Pick (Diamantspitzhacke, die 3x3 abbaut). /mi give für magicitems.admin, ein geformtes Rezept für jedes Item, Namen, Lore, Cooldowns und Rezepte in der config.yml.”
Mit Codexe erstellen