Zum Hauptinhalt springen

FreeMinecraftModels FAQ

Wenn du eine Frage hast, die hier nicht aufgeführt ist, wirf einen Blick auf die Seitenleiste, um zu sehen, ob es eine eigene Seite dafür im Wiki gibt!

Erste Schritte

Wie installiere und verwende ich FreeMinecraftModels?​

Info

Installation:

  1. Lade FreeMinecraftModels.jar herunter und lege es in deinen Plugins-Ordner
  2. Starte deinen Server neu, um Plugin-Ordner zu erzeugen
  3. Führe /fmm setup für das Ersteinrichtungs-/Inhaltsverwaltungsmenü aus
  4. Wenn du offizielle Inhaltspakete nutzt, verknüpfe Nightbreak mit /nightbreaklogin <token>
  5. Verwende /fmm setup oder /fmm downloadall für offizielle Nightbreak-verwaltete Inhalte
  6. Für manuelle Inhalte platziere .bbmodel-Dateien in ~/plugins/FreeMinecraftModels/imports/ und führe /fmm reload aus
  7. Finde das generierte Ressourcenpaket in ~/plugins/FreeMinecraftModels/output/FreeMinecraftModels.zip

Verteilung des Ressourcenpakets:

Wähle eine dieser Methoden:

  • Option A (empfohlen): Installiere Resource Pack Manager für automatische Verteilung
  • Option B: Manuell über server.properties oder einen Hosting-Dienst konfigurieren

Modelle spawnen:

  • /fmm spawn static <id> - Spawnt ein temporäres dekoratives Modell
  • /fmm spawn dynamic <id> - Spawnt ein an eine Entität angehängtes Modell
  • /fmm spawn prop <id> - Spawnt ein persistentes Weltmodell

Verwaltung:

  • /fmm - Öffnet das Menü craftbarer Items (erfordert freeminecraftmodels.menu)
  • /fmm setup - Öffnet das Inhaltsverwaltungs-/Ersteinrichtungsmenü
  • /fmm recommendedplugins - Durchsuche Begleit-Plugins, die gut mit FMM zusammenpassen
  • /fmm downloadall - Lädt das neueste Plugin-Update plus alle zugänglichen offiziellen Inhalte herunter
  • /fmm downloadallcontent - Lädt alle zugänglichen offiziellen Inhalte herunter (nur Inhalte)
  • /fmm updatecontent - Aktualisiert veraltete offizielle Inhalte
  • /fmm downloadpluginupdate - Lädt nur das neueste Plugin-Jar-Update herunter
  • /fmm reload - Lädt das Plugin neu und konvertiert neue Modelle
  • /fmm version - Zeigt die Plugin-Version
  • /fmm stats - Zeigt Statistiken zur Entitätsanzahl

Spieler-Funktionen:

  • /fmm disguise <modelID> [player] - Verwandelt dein Aussehen (oder das eines Ziel-Spielers) in ein benutzerdefiniertes Modell
  • /fmm undisguise [player] - Entfernt die Verkleidung eines Spielers
  • /fmm disguiselist - Listet alle derzeit verkleideten Spieler auf
  • /fmm itemify <model> <material> - Erstellt ein platzierbares Item, das das angegebene Modell spawnt
  • /fmm craftify <modelID> - Öffnet einen interaktiven Rezept-Builder, um ein Crafting-Rezept für einen Prop zu erstellen
  • /fmm shop - Öffnet den optionalen Vault-gestützten Möbelshop (nur wenn in shop_config.yml aktiviert)
  • /fmm mount <modelID> - Spawnt ein reitbares Pferd, das als benutzerdefiniertes Modell verkleidet ist (experimentell)

Debugging:

  • /fmm hitbox visualize [duration] - Visualisiert Modell-Hitboxen mit Partikeln (Dauer in Ticks, Standard 100)
  • /fmm location - Meldet registrierte Schutz-/Dungeon-Anbieter und testet sie an deinem aktuellen Standort
  • /fmm debug bedrock [on|off] - Schaltet den ausführlichen [FMM-BedrockDebug]-Logstream zum Diagnostizieren der Bedrock-Display-Pipeline um. Kein Config-Schlüssel — wird bei jedem Neustart auf OFF zurückgesetzt

Administrativ:

  • /fmm deleteall [radius] - Entfernt alle geladenen modellierten Entitäten und Props (mit Vorsicht verwenden - keine Bestätigungsabfrage). Ein optionaler [radius] (nur für Spieler) beschränkt die Entfernung auf so viele Blöcke

Berechtigungen:

  • freeminecraftmodels.* (Standard: OP) - Wildcard, die freeminecraftmodels.admin, freeminecraftmodels.deleteall, freeminecraftmodels.disguise.self und freeminecraftmodels.disguise.others gewährt. Ebenfalls die wörtliche Berechtigung, die für /fmm reload, /fmm stats, /fmm spawn, /fmm itemify, /fmm craftify, /fmm mount, /fmm hitbox visualize, /fmm debug bedrock, /fmm location, /fmm setup, /fmm recommendedplugins, /fmm downloadall, /fmm downloadallcontent, /fmm updatecontent und /fmm downloadpluginupdate erforderlich ist
  • freeminecraftmodels.admin (Standard: OP) - /fmm admin (der Admin-Inhaltsbrowser) und /fmm giveitem
  • freeminecraftmodels.disguise.self (Standard: OP) - Lässt einen Spieler nur sich selbst verkleiden/enthüllen
  • freeminecraftmodels.disguise.others (Standard: OP) - Erlaubt gezielte Verkleidung/Enthüllung und /fmm disguiselist
  • freeminecraftmodels.deleteall (Standard: OP) - Erforderlich für /fmm deleteall (Kind der Wildcard)
  • freeminecraftmodels.bypassregionprotection (Standard: OP) - Platzieren von/Interagieren mit Props innerhalb von WorldGuard-Regionen oder GriefPrevention-Claims, selbst wenn preventPropPlacementInProtectedRegions aktiviert ist
  • freeminecraftmodels.menu (Standard: true) - Lässt alle Spieler den Browser craftbarer Items über /fmm öffnen
  • freeminecraftmodels.shop (Standard: true) - Lässt alle Spieler /fmm shop öffnen (weiterhin abhängig davon, dass der Shop aktiviert ist)

Befehle sind standardmäßig nur für OP, sofern nicht anders angegeben. Gewähre diese Berechtigungen bei Bedarf an Nicht-OP-Spieler.

Modell-Funktionen & -Limits

Was sind die Limits für Modellgröße und -rotation?​

Info

Größen-Limits:

  • Maximale Bounding-Box pro Knochen: 192x192x192 Modell-Pixel (12x12x12 In-Game-Blöcke) — gemessen über alle Würfel innerhalb eines einzelnen Knochens
  • FreeMinecraftModels verwendet 4-fache interne Skalierung und verschiebt den Modellursprung, um in den -16..+32-Bereich des Ressourcenpakets von Minecraft zu passen
  • Wenn ein Knochen das Limit überschreitet, protokolliert FMM eine Konsolen-Warnung; entweder verkleinere die Würfel, rücke sie näher zusammen oder teile sie in mehrere Knochen auf
  • Ganze Modelle können größer als dies sein — nur das Pro-Knochen-Limit gilt

Würfel-Rotations-Limits:

  • Erlaubte Winkel: 0°, ±22,5°, ±45° und Vielfache von 22,5° (ab v2.3.0)
  • Nur Einzelachsen-Rotation
  • Beispiel: [22.5, 0, 0] funktioniert, aber [22.5, 0, 45] rotiert nur teilweise
  • Andere Winkel werden nicht korrekt angezeigt

Knochen-Rotation:

  • Knochen unterstützen jeden Rotationswinkel
  • Vermeide Standard-Ruhepositionen von 90°, -90°, 180°, -180° (kann unerwartetes Verhalten verursachen)
  • Mehrachsen-Rotation wird unterstützt
  • Jeder Knochen erzeugt eine separate Entität (Performance-Überlegung)

Performance-Hinweis:

Halte die Knochenanzahl so niedrig wie möglich. Jeder Knochen spawnt eine separate Entität in Minecraft, was die Server-Performance bei großem Maßstab beeinträchtigen kann.

Welche Animationen werden unterstützt?​

Info

FreeMinecraftModels unterstützt diese Standard-Zustandsanimationen (deklariert im AnimationStateType-Enum):

Standard-Animationen:

  • spawn
  • idle
  • walk
  • jump
  • attack
  • death
  • custom (Sammelbegriff für einmalige Animationen, die über die API oder Lua ausgelöst werden)

So funktioniert es:

  • Erstelle Animationen in BlockBench mit den obigen Kleinbuchstaben-Namen, damit FMM sie automatisch an den passenden Zustand bindet
  • Das Plugin liest Animations-Keyframes aus .bbmodel-Dateien
  • Animationen werden automatisch basierend auf dem Entitätszustand ausgelöst
  • Entwickler können Animationen programmatisch über playAnimation(animationName, blend, loop) auf einer ModeledEntity oder über context.prop:play_animation(name, blend, loop) aus Lua auslösen

Sonderfall:

Evoker-Entitäten erkennen nahegelegene Evoker-Fangzähne, um Angriffsanimationen automatisch auszulösen.

Was sind virtuelle Knochen und wie funktionieren sie?​

Info

Virtuelle Knochen sind besondere Knochen mit reservierten Namen, die deinen Modellen Funktionalität hinzufügen:

Hitbox-Knochen:

  • Name: hitbox
  • Erstellt Interaktionszonen und Kollisionsboxen
  • Definiert Entitätsgrenzen mit übereinstimmenden x/z-Werten

Namensschild-Knochen:

  • Präfix: tag_
  • Zeigt Text über Modellen an
  • Wird zur Entitätsbenennung verwendet

Kopfrotations-Knochen:

  • Präfix: h_
  • Rotiert basierend auf der Kopfposition des Spielers/der Entität
  • Verfolgt Kopfbewegungen automatisch

Verwendung:

Erstelle in BlockBench einen Knochen mit einem dieser besonderen Namen, und das Plugin wendet automatisch die entsprechende Funktionalität an.

Fehlerbehebungs-FAQ

Statt benutzerdefinierter Modelle sehe ich nur Pferderüstung.​

Info

Wenn du statt benutzerdefinierter Modelle in deinem Spiel nur Pferderüstung siehst, liegt das Problem höchstwahrscheinlich daran, dass du das FMM-Ressourcenpaket nicht korrekt mit deinem bereits vorhandenen Ressourcenpaket zusammengeführt hast.

MagmaGuy hat ein Plugin namens Resource Pack Manager (RSPM) entwickelt, das Ressourcenpakete automatisch für dich zusammenführen kann. Du kannst es bei Spigot hier herunterladen.

Lege einfach die RSPM-.jar-Datei in deinen Plugins-Ordner, und RSPM kümmert sich um alles. Es führt alle Ressourcenpakete zusammen, hostet sie automatisch und verteilt sie an Spieler, wenn diese sich auf deinem Server einloggen.

Warum sehe ich mein Modell nicht, nachdem ich die .bbmodel-Datei hinzugefügt habe?​

Info

Wenn dein Modell nicht erscheint, prüfe diese häufigen Probleme:

1. Reload vergessen

Führe nach dem Ablegen von .bbmodel-Dateien im Imports-Ordner /fmm reload aus. Dies konvertiert Modelle und generiert das Ressourcenpaket.

2. Ressourcenpaket nicht angewendet

Spieler müssen das FMM-Ressourcenpaket aktiv haben, um Modelle zu sehen.

  • Prüfe ~/plugins/FreeMinecraftModels/output/FreeMinecraftModels.zip auf das generierte Paket
  • Installiere den Resource Pack Manager für automatische Verteilung
  • ODER verteile manuell über server.properties oder einen Hosting-Dienst

3. Falscher Dateispeicherort

.bbmodel-Dateien für manuelle Importe müssen hierher: ~/plugins/FreeMinecraftModels/imports/

Wenn du stattdessen offizielle Inhaltspakete verwendest, nutze /fmm setup oder /fmm downloadall, anstatt Dateien manuell abzulegen.

4. Modell hat Fehler

Prüfe die Konsolen-Logs auf Fehlermeldungen während /fmm reload. Häufige Probleme sind nicht unterstützte Rotationen, übergroße Modelle oder Texturprobleme.

5. Problem beim Zusammenführen des Ressourcenpakets

Wenn du Pferderüstung statt Modellen siehst, wurden die Ressourcenpakete nicht korrekt zusammengeführt. Verwende den Resource Pack Manager (RSPM), um das Zusammenführen automatisch zu erledigen.

ViaVersion kann dazu führen, dass Ressourcenpakete nicht korrekt angezeigt werden.​

Info

ViaVersion kann Probleme mit Ressourcenpaketen verursachen, insbesondere wenn ein Server auf einer Version niedriger als 1.21.4 läuft. Minecraft hat ab 1.21.4 Änderungen daran eingeführt, wie Ressourcenpakete behandelt werden. Wenn du einen Server auf einer Version wie 1.21.3 betreibst und ViaVersion verwendest, um 1.21.4-Clients die Verbindung zu ermöglichen, können bei diesen Clients Probleme bei der Anzeige bestimmter Ressourcenpaket-Inhalte auftreten, wie etwa benutzerdefinierten Modellen von FMM (FreeMinecraftModels).

Dies passiert, weil sich das Ressourcenpaket-System in Minecraft mit dem 1.21.4-Update geändert hat.

Hinweis: Dies ist eine Einschränkung von Minecraft und ViaVersion, nicht spezifisch für FreeMinecraftModels. Die Protokollübersetzung von ViaVersion unterstützt Ressourcenpaket-Änderungen möglicherweise nicht vollständig, wenn sie auf Server-Versionen unter 1.21.4 läuft.

Um dies zu beheben, ziehe in Betracht, deinen Server auf 1.21.4 oder höher zu aktualisieren, da dies eine bessere Kompatibilität mit modernen Ressourcenpaket-Funktionen sicherstellt, einschließlich benutzerdefinierter FMM-Modelle.

Warum verursachen meine Modelle Lag oder Performance-Probleme?​

Info

Jeder Knochen in deinem BlockBench-Modell erzeugt eine separate Entität in Minecraft. Modelle mit vielen Knochen können die Server-Performance beeinträchtigen.

Optimierungstipps:

  • Minimiere die Knochenanzahl in deinen Modellen
  • Begrenze die Anzahl gespawnter Modelle
  • Erwäge die Verwendung statischer Modelle anstelle dynamischer Modelle, wenn keine Animationen benötigt werden
  • Vermeide es, viele Modelle mit hoher Knochenanzahl nah beieinander zu spawnen

Technische Erklärung:

FreeMinecraftModels rendert jeden Knochen als separate Minecraft-Entität. Ein Modell mit 50 Knochen spawnt 50 Entitäten. Bei großem Maßstab beeinträchtigt dies die Performance.

Best Practices:

  • Entwirf Modelle mit weniger Knochen
  • Teste die Performance mit realistischen Spawn-Anzahlen
  • Überwache die Server-TPS, wenn du neue Modelle hinzufügst

Erweiterte Funktionen

Brauche ich den Resource Pack Manager (RSPM)?​

Info

Der Resource Pack Manager (RSPM) ist optional, aber sehr empfehlenswert.

Was RSPM tut:

  • Führt automatisch Ressourcenpakete aus mehreren Plugins zusammen
  • Hostet Ressourcenpakete (kein externes Hosting nötig)
  • Verteilt Pakete beim Login automatisch an Spieler
  • Beseitigt die manuelle Ressourcenpaket-Konfiguration

Ohne RSPM:

Du musst manuell:

  • Das FMM-Ressourcenpaket mit allen vorhandenen Server-Ressourcenpaketen zusammenführen
  • Das zusammengeführte Paket bei einem externen Dienst oder über server.properties hosten
  • Den Server so konfigurieren, dass er das Paket an Spieler sendet
  • Das Paket jedes Mal aktualisieren, wenn du neue Modelle hinzufügst

Warum RSPM verwenden:

Die meisten „Pferderüstung statt Modelle"-Probleme werden durch unsachgemäßes Zusammenführen von Ressourcenpaketen verursacht. RSPM erledigt dies automatisch.

RSPM herunterladen: https://www.spigotmc.org/resources/resource-pack-manager.118574/

Entwickelt von MagmaGuy, demselben Autor wie FreeMinecraftModels.

Kann ich FreeMinecraftModels in meinem eigenen Plugin verwenden?​

Info

Ja, FreeMinecraftModels bietet eine API für Entwickler.

Maven/Gradle-Integration:

Repository: https://repo.magmaguy.com/releases

Artifact:

  • GroupId: com.magmaguy
  • ArtifactId: FreeMinecraftModels
  • Scope: provided (muss auf dem Server installiert sein, nicht shaden)

Primäre API-Klassen:

  • ModeledEntity (Basisklasse)
  • StaticEntity
  • DynamicEntity
  • PropEntity

Beispiel-Verwendung:

StaticEntity staticEntity = StaticEntity.create(id, location);
if (staticEntity == null) {
    Bukkit.getLogger().warning("Failed to create model");
    return;
}
staticEntity.setRightClickCallback(...);
staticEntity.remove();

Wichtig:

Shade FreeMinecraftModels nicht in dein Plugin. Es muss separat auf dem Server installiert werden.

Für detaillierte API-Dokumentation siehe die offizielle README.

Wie verkleide ich einen Spieler als benutzerdefiniertes Modell?​

Info

Der Befehl /fmm disguise verwandelt das Aussehen eines Spielers in ein beliebiges benutzerdefiniertes Modell.

Befehle:

/fmm disguise <modelID> [player]
/fmm undisguise [player]
/fmm disguiselist

So funktioniert es:

  • Macht den Spieler für andere Spieler unsichtbar
  • Überlagert das benutzerdefinierte Modell auf der Position des Spielers
  • Das Modell folgt den Bewegungen des Spielers
  • Perfekt für Rollenspiel-Server oder besondere Events

Beispiele:

/fmm disguise dragon              # Verkleide dich selbst
/fmm disguise dragon Steve         # Verkleide einen anderen Spieler
/fmm undisguise Steve              # Enthülle Steve
/fmm disguiselist                  # Liste alle derzeit verkleideten Spieler auf

Anforderungen:

  • Auf sich selbst zielend: freeminecraftmodels.disguise.self (Standard: OP)
  • Auf andere zielend und /fmm disguiselist: freeminecraftmodels.disguise.others (Standard: OP)
  • Die Konsole kann die gezielte Form ausführen, solange ein Spielername angegeben wird
  • modelID muss ein gültiges konvertiertes Modell in deinem Modell-Ordner sein
  • Drittanbieter-Plugins können Verkleidungen über die öffentliche DisguiseAPI steuern

Hinweise:

  • Die Spieler-Hitbox bleibt unverändert (gleiche Kollisionsbox)
  • Andere Spieler sehen das benutzerdefinierte Modell anstelle deines Spieler-Skins
  • Erneutes Verkleiden, während du bereits verkleidet bist, ersetzt die vorherige Verkleidung sauber
  • Die Unsichtbarkeit bleibt durch Milcheimer und andere effekt-entfernende Interaktionen erhalten, bis der Spieler enthüllt wird

Wie erstelle ich platzierbare Modell-Items?​

Info

Der Befehl /fmm itemify erstellt besondere Items, mit denen Spieler Modelle in der Welt platzieren können.

Befehl:

/fmm itemify <model> <material>

Parameter:

  • model - Eine beliebige gültige Modell-ID aus deinem Modell-Ordner
  • material - Ein beliebiges Minecraft-Material (STICK, PAPER, DIAMOND usw.)

Beispiel:

/fmm itemify lamp_post STICK

Was es erstellt:

  • Ein benutzerdefiniertes Item mit einem formatierten, golden verzierten Anzeigenamen (z. B. „✦ Wolf ✦")
  • Beschreibende Lore, die das Item erklärt
  • Das Item wird direkt deinem Inventar hinzugefügt
  • Rechtsklick, um das Modell als Prop zu platzieren

Anwendungsfälle:

  • Spielern Items geben, um ihre Bauwerke zu dekorieren
  • Benutzerdefinierte „Spawn-Eier" für Möbel erstellen
  • Modelle verteilen, ohne Bau-Berechtigungen zu vergeben
  • Setup-Kits für kreatives Bauen

Anforderungen:

  • Berechtigung: freeminecraftmodels.*
  • Spieler muss im Spiel sein (nicht Konsole)

Wie debugge ich Modell-Hitboxen?​

Info

Der Befehl /fmm hitbox visualize visualisiert Modell-Hitboxen mit Partikeln.

Befehl:

/fmm hitbox visualize [duration]

Parameter:

  • duration (optional) - Wie lange Hitboxen in Ticks angezeigt werden (Standard: 100, max: 1200)
  • 20 Ticks = 1 Sekunde

Beispiele:

/fmm hitbox visualize          # 5 Sekunden anzeigen
/fmm hitbox visualize 200      # 10 Sekunden anzeigen

So funktioniert es:

  • Sucht nach Modellen innerhalb von 10 Blöcken um dich herum
  • Zeigt die Grenzen der ausgerichteten Bounding-Box (OBB) mit Partikeln an
  • Zeigt sowohl das Modell als auch seine Kollisionsgrenzen
  • Nützlich zum Überprüfen von Hitbox-Größe und -Rotation

Wann verwenden:

  • Testen, ob Hitboxen mit den visuellen Modellen übereinstimmen
  • Debuggen von Interaktionsproblemen
  • Überprüfen von Hitbox-Rotationen
  • Fehlerbehebung bei der Klick-Erkennung

Anforderungen:

  • Berechtigung: freeminecraftmodels.*

Hinweis: Hitboxen in FMM rotieren mit dem Modell, anders als bei standardmäßigen Minecraft-AABBs.

Kann ich reitbare benutzerdefinierte Modelle erstellen?​

Info

Ja, verwende den Befehl /fmm mount, um reitbare benutzerdefinierte Modelle zu erstellen (experimentelle Funktion).

Befehl:

/fmm mount <modelID>

Was es tut:

  • Spawnt ein Pferd an deinem Standort
  • Verkleidet das Pferd als dein benutzerdefiniertes Modell
  • Zähmt das Pferd automatisch und fügt einen Sattel hinzu
  • Lässt dich sofort auf dem Pferd reiten

Beispiel:

/fmm mount dragon

Anforderungen:

  • Berechtigung: freeminecraftmodels.*
  • Gültige Modell-ID

Wichtige Hinweise:

  • Diese Funktion ist als experimentell gekennzeichnet
  • Bewegungsgeschwindigkeit und -verhalten entsprechen einem Standardpferd
  • Die Hitbox des Pferdes bleibt unverändert
  • Funktioniert am besten mit Modellen, die für Reittiere entworfen wurden

Anwendungsfälle:

  • Benutzerdefinierte Reittiere für Rollenspiel-Server
  • Besonderes Transportmittel für VIP-Spieler
  • Einzigartige reitbare Kreaturen für Abenteuer-Maps

Was sind Mount-Point-Knochen?​

Info

Mount-Points lassen dich reitbare Positionen direkt auf deinem Modell mithilfe speziell benannter Knochen definieren.

So erstellst du Mount-Points:

Benenne in Blockbench einen beliebigen Knochen mit dem Präfix m_ (z. B. m_seat, m_back). Jeder m_-Knochen wird zu einer Sitzposition auf dem Modell, auf der ein Spieler oder eine Entität platziert werden kann.

So funktioniert es:

  • Die Mount-Position folgt dem Standort des Knochens, einschließlich Animationen
  • Mehrere m_-Knochen erzeugen mehrere Sitze
  • Spieler/Entitäten können über die API oder Lua-Skripte auf diese Positionen gesetzt werden

Testen:

Verwende /fmm mount <modelID>, um Mount-Points auf einem Modell schnell zu testen.

Anwendungsfälle:

  • Mehrsitzige Fahrzeuge (Boote, Kutschen)
  • Reitbare Kreaturen mit bestimmten Sitzpositionen
  • Schulter-getragene Haustiere oder Begleiter

Benutzerdefinierte Items

Was sind benutzerdefinierte Items?​

Info

Benutzerdefinierte Items sind Modelle, die in ihrer begleitenden YML-Konfigurationsdatei ein material:-Feld gesetzt haben, wodurch sie zu haltbaren, ausrüstbaren Items mit Lua-Skripting-Unterstützung werden.

Hauptunterschiede zu Prop-Platzierungs-Items:

  • Benutzerdefinierte Items verwenden den PDC-Schlüssel fmm_item_id (PersistentDataContainer)
  • Prop-Platzierungs-Items (aus /fmm itemify) verwenden den PDC-Schlüssel model_id
  • Benutzerdefinierte Items unterstützen 22 item-spezifische Lua-Skript-Hooks (equip, attack, consume usw.)
  • Benutzerdefinierte Items können Verzauberungen, benutzerdefinierte Namen und Lore haben, die in ihrer YML-Konfiguration definiert sind

So erstellst du ein benutzerdefiniertes Item:

  1. Erstelle ein .bbmodel-Modell in Blockbench
  2. Erstelle eine begleitende YML-Datei mit demselben Basisnamen (z. B. magic_sword.yml neben magic_sword.bbmodel)
  3. Setze das material:-Feld in der YML auf ein beliebiges gültiges Minecraft-Material (z. B. material: DIAMOND_SWORD)
  4. Setze optional die Felder name:, lore: und enchantments:
  5. Erstelle optional ein Lua-Skript in plugins/FreeMinecraftModels/scripts/ und referenziere es über das scripts:-Feld

Beispiel-YML:

isEnabled: true
material: DIAMOND_SWORD
name: "&6Flame Blade"
lore:
  - "&7A legendary weapon"
  - "&cBurns enemies on hit"
enchantments:
  - "FIRE_ASPECT,2"
scripts:
  - flame_blade.lua

So erhältst du ein benutzerdefiniertes Item:

  • /fmm giveitem <id> (erfordert die Berechtigung freeminecraftmodels.admin)
  • Über das Admin-Menü (/fmm admin)

Menüs

Welche Menüs bietet FMM?​

Info

FreeMinecraftModels bietet zwei In-Game-Menüs zum Durchsuchen und Verwalten von Inhalten.

Spieler-Menü — /fmm

  • Berechtigung: freeminecraftmodels.menu (Standard: true, alle Spieler können es nutzen)
  • Zeigt nur Items, für die Crafting-Rezepte definiert sind
  • Klicke auf ein Item, um eine Detailansicht mit einer räumlichen 3x3-Crafting-Gitter-Vorschau zu sehen
  • Ermöglicht Spielern, zu entdecken und zu lernen, wie man benutzerdefinierte Items craftet

Admin-Menü — /fmm admin

  • Berechtigung: freeminecraftmodels.admin (Standard: OP)
  • Vollständiger Inhaltsbrowser, der Folgendes zeigt:
    • Installierte Pakete
    • Nicht verpackte Modell-Ordner
    • Modelle auf Stammebene
    • Benutzerdefinierte Items (Modelle mit gesetztem material:)
  • Ermöglicht Admins, Items zu geben, Modelle vorzuschauen und Inhalte zu verwalten

Display-Modelle

Was sind Display-Modelle?​

Info

Display-Modelle lassen benutzerdefinierte Items ein 3D-Modell im Inventar und in der Hand des Spielers anzeigen, anstelle des standardmäßigen Material-Aussehens.

So richtest du ein Display-Modell ein:

  1. Verwende in Blockbench File > Export > Java Block/Item, um eine .json-Modelldatei zu exportieren
  2. Lege die .json-Datei neben die .bbmodel-Datei mit demselben Basisnamen (z. B. magic_sword.json neben magic_sword.bbmodel)
  3. Führe /fmm reload aus

So funktioniert es:

  • Auf Minecraft 1.21.4+ wird das Item mit dem benutzerdefinierten 3D-Modell angezeigt, wenn es gehalten oder im Inventar betrachtet wird
  • Reine Texturreferenzen in der JSON werden automatisch zu FMM-Namespace-Pfaden umgeschrieben
  • Wenn keine .json-Datei existiert, fällt das Item auf das einfache Material-Aussehen zurück
  • Ältere Server-Versionen ignorieren Display-Modelle stillschweigend

Anforderungen:

  • Server, der Minecraft 1.21.4 oder neuer ausführt
  • Ein gültiger Blockbench-„Java Block/Item"-Export (.json), der neben der Modelldatei platziert wird