Was Oraxen ist

Oraxen ist ein Plugin, mit dem du auf Minecraft-Servern eigene Items, Blöcke, Möbel und Ausrüstung erstellst. Es braucht keine Mods auf dem Client: Stattdessen erzeugt es ein Resource Pack und schickt es Spielern automatisch beim Verbinden.

Das Plugin stützt sich auf CustomModelData (seit Minecraft 1.14) und Item-Komponenten (ab 1.20.5), damit vorhandene Vanilla-Items wie völlig neue aussehen. Serverseitig bleibt jedes eigene Item ein normales Minecraft-Item (zum Beispiel ein Holzschwert mit CustomModelData 1001), aber der Client zeigt es mit einer eigenen Textur und einem eigenen 3D-Modell an.

Oraxen findest du auf GitHub. Herunterladen kannst du es bei SpigotMC oder Modrinth.

So funktioniert es im Hintergrund

Oraxen kombiniert drei Minecraft-Mechanismen:

CustomModelData / Item-Komponenten - weisen einem vorhandenen Item ein eigenes 3D-Modell zu. Der Client zeigt das Modell aus dem Resource Pack statt des Standardmodells
Resource Pack - Oraxen erzeugt automatisch ein Resource Pack mit den Texturen und Modellen. Der Server hostet es und erzwingt den Download, sobald sich ein Spieler verbindet
Zustände von Notenblöcken / Pilzblöcken - eigene Blöcke nutzen ungenutzte Zustände von Notenblöcken oder Pilzblöcken, um einzigartige Texturen anzuzeigen

Dadurch müssen Spieler keine Mods installieren. Sie müssen nur das Resource Pack des Servers akzeptieren. Das Plugin ist voll kompatibel mit dem Vanilla-Client von Minecraft.

Items erstellen

Eigene Items definierst du in YAML-Dateien unter plugins/Oraxen/items/:

# ruby_sword.yml
ruby_sword:
  displayname: "&cRuby Sword"
  material: DIAMOND_SWORD
  Pack:
    generate_model: true
    parent_model: item/handheld
    textures:
      - ruby_sword.png
  Mechanics:
    durability:
      value: 2000
  AttributeModifiers:
    attack_damage:
      amount: 12
      slot: MAINHAND
    attack_speed:
      amount: 1.6
      slot: MAINHAND

Du legst die Textur ruby_sword.png in plugins/Oraxen/pack/textures/ ab, und Oraxen erledigt automatisch Folgendes:

Es erstellt aus deiner Textur ein JSON-Modell
Es weist eine eindeutige CustomModelData zu
Es erzeugt ein Resource Pack mit dem Modell
Es registriert das Item im System

Items an Spieler vergibst du mit /oraxen give [player] ruby_sword. Über die Oraxen-API oder Platzhalter kannst du sie auch in Kits, Shops und Loot-Tabellen einbauen.

Eigene Blöcke und Möbel

Oraxen unterstützt vier Arten von eigenen Blöcken und Möbeln:

NoteBlock - Vollblöcke mit eigenen Texturen (sie nutzen Zustände des Notenblocks). Sie können Härte, einen Drop und ein vorgeschriebenes Werkzeug zum Abbauen haben
StringBlock - durchsichtige Blöcke (zum Beispiel Blumen, Gras, Deko), die den Stolperdraht verwenden
Furniture - 3D-Möbel auf Basis von Anzeige-Entitäten (ab 1.19.4) oder Rüstungsständern. Stühle, Tische, Lampen, Fernseher - beliebige Modelle
MushroomBlock - ein älteres Blocksystem, kompatibel mit früheren Versionen

Ein Beispiel für eine Möbeldefinition:

lamp:
  displayname: "&eLamp"
  material: PAPER
  Pack:
    generate_model: true
    textures:
      - lamp.png
  Mechanics:
    furniture:
      type: DISPLAY_ENTITY
      hitbox:
        width: 1
        height: 2
      light: 14
      placeable_on:
        - FLOOR

Spieler stellen Möbel mit einem Rechtsklick auf, während sie das Item in der Hand halten. Möbel können Licht abgeben, Hitboxen für die Interaktion haben und animiert sein.

Resource Pack

Oraxen erzeugt und verteilt das Resource Pack automatisch. Die Konfiguration steht in der settings.yml:

Pack:
  generation:
    auto-generated: true          # automatisch erzeugen
    compression: BEST_COMPRESSION # Kompression des Packs
  upload:
    type: polymath               # Hosting des Packs
  dispatch:
    send_pack: true              # an die Spieler senden
    mandatory: true              # Download erzwingen

Optionen für das Hosting des Resource Packs:

Polymath - kostenloses Hosting von Oraxen (Standard)
Self-Host - dein eigener HTTP-Server
Amazon S3 / DigitalOcean Spaces - Cloud-Hosting

Führe nach jeder Änderung an Texturen oder Items /oraxen reload all aus. Das Plugin baut das Pack neu und schickt die aktualisierte Version an die Spieler.

Tipps und Integrationen

3D-Modelle - Oraxen unterstützt eigene JSON-Modelle aus Blockbench. Exportiere das Modell als Java Block/Item und lege es in pack/models/ ab
Crafting-Rezepte - definiere eigene Rezepte direkt in der Item-Config
MythicMobs-Integration - nutze eigene Oraxen-Items als Boss-Drops
Shop-Integration - ShopGUI+ und andere Shop-Plugins unterstützen Oraxen-Items
Kompatibilität - Oraxen läuft auf älteren Versionen mit ProtocolLib und nativ mit Paper 1.20.5+

Alternativen: Nova (ein Framework für eigene Inhalte), ItemsAdder (kostenpflichtig, ähnlicher Funktionsumfang), CraftEngine (eine kostenlose Community Edition unter der GPL-3.0-Lizenz, unterstützt 26.x und Folia). Oraxen punktet mit seiner aktiven Entwicklung.