ItemsAdder: eigene Items und Blöcke auf deinem Server

Was ItemsAdder ist

ItemsAdder ist ein kostenpflichtiges Premium-Plugin eines Entwicklers, der sich LoneDev nennt. Es soll Minecraft-Serveradmins ermöglichen, eigene Inhalte (Items, Blöcke, Möbel, Mobs, Animationen und Interface-Overlays) hinzuzufügen, ohne dass Spieler Mods installieren müssen.

Der ganze Mechanismus ruht auf zwei Säulen: einem Ressourcenpaket, das beim Betreten des Servers automatisch an den Spieler geschickt wird, und YAML-Konfigurationsdateien, in denen der Admin alle eigenen Elemente definiert. Für den Spieler fühlt sich alles an wie Vanilla-Minecraft: Er muss nur das Ressourcenpaket annehmen.

Das Plugin gibt es auf SpigotMC für etwa 25 EUR. Die Investition lohnt sich für RPG-Server, Survival-Server mit einzigartigen Inhalten oder Server mit eigenem Thema, auf denen es darauf ankommt, sich abzuheben.

ItemsAdder wird seit 2019 aktiv entwickelt und hat eine der größten Communities unter den Premium-Plugins. Auf SpigotMC hat das Plugin Tausende positive Bewertungen gesammelt und wird regelmäßig für neue Minecraft-Versionen aktualisiert.

So funktioniert das Ressourcenpaket

Das Herzstück von ItemsAdder ist ein eigenes Ressourcenpaket, das das Plugin automatisch aus deinen Konfigurationsdateien erzeugt. Betritt ein Spieler den Server, fragt Minecraft, ob er das Ressourcenpaket herunterladen möchte. Sobald er zustimmt, sieht er alle eigenen Items, Blöcke und Modelle.

ItemsAdder unterstützt drei Methoden, das Ressourcenpaket zu hosten:

• Eingebauter HTTP-Server - das Plugin stellt die Datei selbst über einen Port bereit (standardmäßig 8163). Die einfachste Lösung auf einem VPS mit eigener IP. Dafür musst du den Port in der Firewall öffnen.
• Selbst gehostet über FTP/SFTP - du lädst das erzeugte Paket auf deinen eigenen Webserver oder ein CDN hoch. Mehr Kontrolle, aber auch mehr Konfigurationsaufwand.
• Externes Hosting - zum Beispiel GitHub Releases, Dropbox oder spezielle Hosting-Dienste für Ressourcenpakete. Praktisch, wenn dein Hoster zusätzliche Ports sperrt.

Der entscheidende Punkt: ItemsAdder nutzt CustomModelData, eine Zahl, die einem bestehenden Vanilla-Item zugewiesen wird (zum Beispiel zeigt PAPER mit CustomModelData 1001 das Modell eines eigenen Schwerts an). Diese Einschränkung ergibt sich aus der Architektur von Minecraft: Bis Version 1.21.3 gibt es keine offizielle API, um neue Item-IDs zu erstellen. Ab Version 1.21.4 unterstützt Minecraft die Komponente item_model, die ItemsAdder bereits verwendet.

Nach jeder Änderung an der Konfiguration musst du das Ressourcenpaket mit dem Befehl /iazip oder /iareload neu bauen. Das Plugin komprimiert die Dateien automatisch und aktualisiert die URL, sodass Spieler beim nächsten Beitritt die neue Version bekommen.

Items erstellen

Jedes eigene Item definierst du in einer YAML-Datei im Ordner plugins/ItemsAdder/contents/. Die Ordnerstruktur ist dir komplett freigestellt, du kannst Items also nach Paket oder Thema gruppieren.

Ein Beispiel für die Definition eines eigenen Schwerts:

info:
  namespace: moj_serwer
items:
  miecz_ognia:
    display_name: "Feuerschwert"
    permission: moj_serwer.miecz_ognia
    resource:
      material: DIAMOND_SWORD
      generate: true
      textures:
        - item/miecz_ognia.png
    durability:
      max_custom_durability: 1024
    attribute_modifiers:
      mainhand:
        attackDamage: 8
    lore:
      - "&7Geschmiedet in den Flammen des Nethers."
    events:
      interact:
        right:
          set_on_fire:
            duration: 5

Das Feld namespace ist eine eindeutige Kennung für dein Inhaltspaket, damit sich Items aus verschiedenen Paketen nicht in die Quere kommen. Das Feld resource.material verweist auf das Vanilla-Item, das dein Modell „vortäuscht“. Die Texturen legst du im Ordner contents/moj_serwer/textures/item/ ab.

ItemsAdder unterstützt:

• 3D-Modelle im JSON-Format (kompatibel mit Blockbench)
• Animierte Texturen (mcmeta)
• Eigene Haltbarkeit und Reparatur
• Partikeleffekte bei der Benutzung
• Sounds, die an Aktionen gekoppelt sind
• Events, zum Beispiel einen Spieler beim Treffer in Brand setzen oder beim Verzehr heilen
• Anbindung an Skill-Systeme (MMOItems, AureliumSkills)

Fertige Item-Pakete kannst du im offiziellen Wiki und auf Polymart herunterladen, wo die Community kostenlose und kostenpflichtige Sets teilt.

Blöcke erstellen

Eigene Blöcke zu erstellen ist einer der technisch schwierigsten Teile beim Modden eines Minecraft-Servers. ItemsAdder löst das geschickt: Es nutzt Zustände des Notenblocks oder Zustände des Pilzblocks als „Behälter“ für eigene Blöcke.

In Minecraft hat ein Notenblock 800 verschiedene Zustände. ItemsAdder reserviert diese Zustände für deine Blöcke: Der Spieler sieht das Modell aus dem Ressourcenpaket, und die Server-Engine sieht einen Notenblock in einem bestimmten Zustand. Dadurch verhalten sich die Blöcke wie echte Blöcke: Man kann sie aufsammeln, platzieren und mit der passenden Geschwindigkeit abbauen.

Ein Beispiel für die Definition eines Blocks:

items:
  rubin_ore:
    display_name: "Rubinerz"
    resource:
      material: PAPER
      generate: false
      model_path: block/rubin_ore
    specific_properties:
      block:
        placed_model:
          type: REAL_NOTE
          break_particles_material: DIAMOND_ORE
        hardness: 5
        blast_resistance: 6
        drop_exp:
          min: 2
          max: 5

Der Typ REAL_NOTE bedeutet, dass ein Zustand des Notenblocks genutzt wird: Der Block ist „echt“, hat eine Kollisionsbox, man kann auf ihm stehen und ihn abbauen. Alternativen sind REAL_TRANSPARENT (unterstützt Transparenz) und REAL_WIRE (basiert auf dem Stolperdraht, für dünne Elemente).

Blöcke unterstützen auch eigene Drops. Du kannst dein Erz so konfigurieren, dass es nur auf einer bestimmten Abbaustufe oder mit einem bestimmten Item etwas fallen lässt, was gut zu RPG-Systemen passt.

Eigene Mobs

Mit ItemsAdder kannst du eigene Mobs mit eigenen 3D-Modellen und Animationen erstellen. Mobs werden ähnlich wie Items in YAML-Dateien definiert, die auf ein Blockbench-Modell verweisen.

Mob-Modelle für ItemsAdder entstehen in Blockbench mit dem ItemsAdder-Plugin. Das Plugin unterstützt ein komplettes Set an Animationen: Gehen, Rennen, Angreifen, Sterben, Fressen und eigene Animationen, die der Ersteller festlegt.

Seine größte Stärke entfaltet es mit der Anbindung an MythicMobs. Du kannst einem MythicMobs-Mob ein ItemsAdder-Modell zuweisen und bekommst ein Monster mit einzigartigem Aussehen und fortgeschrittener KI-Logik, Kampfphasen, Spezialangriffen und Belohnungen. Diese Kombination läuft auf Dutzenden RPG-Servern.

Ein Beispiel für die Konfiguration eines eigenen Mobs in ItemsAdder:

info:
  namespace: moj_serwer
entity_models:
  smok_ognia:
    display_name: "Feuerdrache"
    model: entity/smok_ognia
    animations:
      walk:
        speed_multiplier: 1.0
      attack:
        duration: 1.2

In MythicMobs verweist du dann mit der Option Options.ItemsAdder: moj_serwer:smok_ognia auf dieses Modell. Der Spieler sieht ein schönes 3D-Modell, und MythicMobs steuert die gesamte Verhaltenslogik.

Möbel und Dekoration

Eine der meistgeschätzten Funktionen von ItemsAdder ist das Möbelsystem. Möbel sind dekorative Strukturen aus mehreren Blöcken (Stühle, Tische, Betten, Lampen, Truhen), die du in der Spielwelt platzieren kannst.

Technisch werden Möbel aus unsichtbaren Rüstungsständern gebaut, an die Modelle aus dem Ressourcenpaket gehängt werden. So können sie eigene Maße haben, über einen einzelnen Block hinausragen und in verschiedenen Winkeln platziert werden.

ItemsAdder bringt gleich mehrere Möbelsets mit, aber der eigentliche Wert liegt darin, eigene zu erstellen. Du exportierst ein Modell aus Blockbench, konfigurierst die Hitboxen, und fertig. Möbel unterstützen:

• Sitzen (Spieler können sich auf einen Stuhl oder eine Bank setzen)
• Kollision mit Spielern (sie blockieren die Bewegung)
• Interaktionen (Schränke öffnen, Mechanismen aktivieren)
• Platzierung an Wänden und Decken (zum Beispiel Bilder und Lampen)
• Drehung in 8 oder 16 Richtungen

Die Plugins FurnitureLib und FurnitureEngine sind Alternativen für das Möbelsystem, aber ItemsAdder bringt alles in einem Ökosystem unter, was Kompatibilitätsprobleme zwischen Plugins vermeidet.

Emotes

ItemsAdder unterstützt animierte Spieler-Emotes: komplette Charakteranimationen, die andere Spieler in Echtzeit sehen. Ein Spieler kann winken, tanzen, lachen oder jede Animation ausführen, die der Admin festgelegt hat.

Emotes funktionieren, indem das Spielermodell im Ressourcenpaket überschrieben und die Animation auf dem Client abgespielt wird. Damit andere ein Emote sehen, nutzt ItemsAdder Protokolltricks mit Entity-Metadaten.

Beispiele, wofür Emotes eingesetzt werden:

• VIP-Begrüßungen am Spawn (eine besondere Animation für Unterstützer)
• Animationen für Charakterklassen in RPGs (ein Magier, der Zauber wirkt)
• Tänze und Gesten in sozialen Bereichen
• Todesanimationen statt des normalen Umfallens der Figur

Emotes lassen sich über LuckPerms an Ränge koppeln, sodass zum Beispiel nur Spieler mit dem VIP-Rang Zugriff auf seltene Animationen haben. Das ist ein beliebter Teil des Monetarisierungsangebots auf Servern.

GUI und HUD

ItemsAdder enthält ein fortgeschrittenes System, um Overlays auf der Spieleroberfläche (HUD) zu erstellen. Du kannst eigene Leisten, Symbole, Zähler und Informationen direkt auf dem Bildschirm des Spielers anzeigen, ohne zusätzliche Plugins.

Das HUD in ItemsAdder funktioniert, indem es die Bossbar oder Actionbar überschreibt, und zwar mit einer eigenen Bitmap-Schrift aus dem Ressourcenpaket. Das Ergebnis: Der Spieler sieht ein Pixelart-Overlay auf dem Bildschirm, das wie ein Teil der Spieloberfläche aussieht.

Typische Einsatzfälle für das HUD:

• Mana-/Energieleiste - eine Zauberressource, die neben der Lebensleiste angezeigt wird
• Währungsanzeige - Kontostand oder Erfahrungspunkte in der Bildschirmecke
• Anzeige für Temperatur/Hunger/Verschmutzung - für Survival-Server mit Überlebensmechaniken
• Mini-Kompass - Richtung und Koordinaten am oberen Bildschirmrand
• Erfolgsmeldungen - animierte Banner, wenn etwas freigeschaltet wird

Ein HUD baust du mit dem im Plugin integrierten Editor oder mit externen Tools wie HMCCosmetics. ItemsAdder stellt außerdem eine API für Entwickler bereit, damit andere Plugins eigene HUD-Elemente registrieren können.

Preis und Lizenz

ItemsAdder ist ein kostenpflichtiges Premium-Plugin, das es nur auf der Plattform SpigotMC gibt. Der aktuelle Preis liegt bei etwa 25 EUR pro Lizenz. Prüfe den aktuellen Preis auf der SpigotMC-Seite, da er sich ändern kann.

Mit dem Kauf bekommst du:

• Eine Lizenz für einen Server (eine IP oder ein Proxy-Netzwerk)
• Zugriff auf alle Updates ohne zeitliche Begrenzung
• Zugang zum offiziellen Support-Kanal auf Discord
• Zugang zum offiziellen Wiki mit Dokumentation

Wichtige Hinweise zur Lizenz:

• Jeder Server braucht eine eigene Lizenz, denn eine Lizenz deckt keine ganze Serverfarm ab
• BungeeCord-/Velocity-Netzwerke können unter Umständen als eine Lizenz gelten, das solltest du aber mit dem Autor klären
• Das Plugin lädst du nach dem Kauf über das SpigotMC-Panel herunter, denn die .jar-Datei ist nicht öffentlich verfügbar
• Es gibt keine „Testversion“. Vor dem Kauf kannst du nur in einer lokalen Umgebung testen, mit einigen Einschränkungen

Der Preis wirkt neben kostenlosen Alternativen wie Oraxen CE (Community Edition) vielleicht hoch, aber ItemsAdder bietet deutlich mehr Funktionen, eine bessere Dokumentation und aktiven Support. Für Server mit Budget ist es eine solide Investition, die sich durch ein besseres Spielerlebnis schnell auszahlt.

Vergleich mit Oraxen

Der größte Konkurrent von ItemsAdder ist Oraxen. Jahrelang lautete die Wahl „kostenlose Alternative gegen bezahltes Premium“, doch die Lage ist komplizierter geworden: Oraxen hat einen kostenpflichtigen Premium-Tarif eingeführt (Oraxen Pro), während ItemsAdder beim festen Preis geblieben ist.

Wann du ItemsAdder wählen solltest: Du hast ein Budget, brauchst Emotes und ein umfangreiches HUD, willst die native MythicMobs-Anbindung und legst Wert auf professionellen Support und eine große Community mit vielen Ressourcen.

Wann du Oraxen CE wählen solltest: Du hast null Budget für Plugins, brauchst nur eigene Items und Blöcke und schätzt Open Source und die Möglichkeit, den Code zu ändern.

Kompatibilität

ItemsAdder ist kompatibel mit:

• Minecraft-Versionen: 1.14 - 1.21.x (laufend aktualisiert)
• Server-Software: Paper (empfohlen), Spigot, Purpur, Pufferfish
• Netzwerke: BungeeCord, Velocity (das Plugin wird auf jedem Backend-Server einzeln installiert)
• MythicMobs - native Anbindung von Modellen und Mobs
• MMOItems - eigene Werte, die an IA-Items gebunden sind
• AureliumSkills / AuraSkills - ein Skill-System mit IA-Items
• LuckPerms - Berechtigungen für Items, Emotes und Ränge
• EssentialsX - Kits und Shops mit IA-Items
• PlaceholderAPI - eigene Platzhalter für HUDs und Chats
• WorldGuard - Regionsschutz, der IA-Blöcke berücksichtigt

Bekannte Einschränkungen:

• Es funktioniert nicht in der Bedrock Edition (nur Java)
• Der Spieler muss das Ressourcenpaket annehmen; wer es deaktiviert hat, sieht nur Vanilla-Items
• Große Ressourcenpakete können den Beitritt zum Server verlangsamen (Downloadzeit)
• Die Grenzen bei den Zuständen von Notenblock/Pilzblock begrenzen die Zahl der einzigartigen Blöcke (etwa 800 Notenblock + 54 Pilzblock)
• Es ist nicht kompatibel mit anderen Plugins, die dieselben Notenblock-Zustände nutzen, solange keine eigene Anbindung existiert

Mehr zu Server-Plugins findest du im Plugin-Katalog. Wenn du einen RPG-Server aufbaust, schau dir auch MythicMobs an: Die Kombination beider Plugins eröffnet tolle Möglichkeiten, einzigartige Bosse und Abenteuer zu erschaffen.