Zum Hauptinhalt springen

FreeMinecraftModels FAQ

Wenn deine Frage hier nicht aufgeführt ist, wirf einen Blick auf die Seitenleiste, um zu sehen, ob es eine eigene Seite im Wiki dafür 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 die Plugin-Ordner zu generieren
  3. Führe /fmm initialize aus, wenn du den Ersteinrichtungs-Ablauf nutzen möchtest
  4. Wenn du offizielle Inhaltspakete verwendest, verknüpfe Nightbreak mit /nightbreaklogin <token>
  5. Verwende /fmm setup oder /fmm downloadall für offiziell von Nightbreak verwaltete Inhalte
  6. Für manuelle Inhalte platziere .bbmodel-Dateien in ~/plugins/FreeMinecraftModels/imports/ und führe /fmm reload aus
  7. Das generierte Ressourcenpaket findest du unter ~/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: Manuelle Konfiguration über server.properties oder einen Hosting-Dienst

Modelle spawnen:

  • /fmm spawn static <id> - Temporäres Dekorationsmodell spawnen
  • /fmm spawn dynamic <id> - An eine Entity angehängtes Modell spawnen
  • /fmm spawn prop <id> - Persistentes Weltmodell spawnen

Verwaltung:

  • /fmm - Einrichtungs-/Hilfe-Zusammenfassung anzeigen
  • /fmm initialize - Ersteinrichtungsmenü öffnen
  • /fmm setup - Inhaltsverwaltungsmenü öffnen
  • /fmm downloadall - Alle verfügbaren offiziellen Inhalte herunterladen
  • /fmm updatecontent - Veraltete offizielle Inhalte aktualisieren
  • /fmm reload - Plugin neu laden und neue Modelle konvertieren
  • /fmm version - Plugin-Version anzeigen
  • /fmm stats - Entity-Anzahl-Statistiken anzeigen

Spieler-Funktionen:

  • /fmm disguise <modelID> - Dein Aussehen in ein benutzerdefiniertes Modell verwandeln
  • /fmm undisguise - Spieler-Verkleidung entfernen und normales Aussehen wiederherstellen
  • /fmm itemify <model> <material> - Ein platzierbares Item erstellen, das das angegebene Modell spawnt
  • /fmm craftify <modelID> - Einen interaktiven Rezept-Editor öffnen, um ein Herstellungsrezept für einen Prop zu erstellen
  • /fmm mount <modelID> - Ein reitbares Pferd spawnen, das als benutzerdefiniertes Modell verkleidet ist (experimentell)

Debugging:

  • /fmm hitbox visualize [dauer] - Modell-Hitboxen mit Partikeln visualisieren (Dauer in Ticks, Standard 100)

Administration:

  • /fmm deleteall - Alle derzeit geladenen modellierten Entities entfernen (mit Vorsicht verwenden - keine Bestätigungsabfrage)

Berechtigungen:

  • freeminecraftmodels.* - Erforderlich für die meisten Befehle (disguise, itemify, mount, hitbox visualize, spawn)
  • freeminecraftmodels.deleteall - Erforderlich für den Befehl /fmm deleteall

Befehle sind standardmäßig nur für OPs verfügbar. Gewähre diese Berechtigungen bei Bedarf an Nicht-OP-Spieler.

Modellfunktionen und -grenzen

Was sind die Größen- und Rotationsgrenzen für Modelle?​

Info

Größengrenzen:

  • Maximum: 112x112x112 Pixel (7x7x7 Spielblöcke)
  • FreeMinecraftModels verwendet 4-fache interne Skalierung, um diese Größen zu erreichen
  • Standard-Minecraft-Ressourcenpakete sind auf kleinere Größen beschränkt

Würfel-Rotationsgrenzen:

  • Erlaubte Winkel: 0, +/-22,5, +/-45 Grad und Vielfache von 22,5 Grad (seit 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

Bone-Rotation:

  • Bones unterstützen jeden Rotationswinkel
  • Vermeide Standard-Ruhepositionen von 90, -90, 180, -180 Grad (kann unerwartetes Verhalten verursachen)
  • Mehrachsen-Rotation wird unterstützt
  • Jeder Bone erzeugt eine separate Entity (Leistungsaspekt)

Leistungshinweis:

Halte die Bone-Anzahl so niedrig wie möglich. Jeder Bone spawnt eine separate Entity in Minecraft, was die Serverleistung bei großer Anzahl beeinträchtigen kann.

Welche Animationen werden unterstützt?​

Info

FreeMinecraftModels unterstützt diese Standard-Zustandsanimationen:

Standardanimationen:

  • Walk
  • Idle
  • Death
  • Attack
  • Spawn

Wie es funktioniert:

  • Erstelle Animationen in BlockBench
  • Das Plugin liest Animations-Keyframes aus .bbmodel-Dateien
  • Animationen werden automatisch basierend auf dem Entity-Zustand ausgelöst
  • Entwickler können Animationen programmatisch mit playAnimation(animationName, false, false) auslösen

Sonderfall:

Evoker-Entities erkennen nahegelegene Evoker Fangs, um Angriffsanimationen automatisch auszulösen.

Was sind virtuelle Bones und wie funktionieren sie?​

Info

Virtuelle Bones sind spezielle Bones mit reservierten Namen, die deinen Modellen zusätzliche Funktionalität verleihen:

Hitbox-Bones:

  • Name: hitbox
  • Erstellt Interaktionszonen und Kollisionsboxen
  • Definiert Entity-Grenzen mit übereinstimmenden x/z-Werten

Namensschild-Bones:

  • Präfix: tag_
  • Zeigt Text über Modellen an
  • Wird für Entity-Benennung verwendet

Kopfrotations-Bones:

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

Verwendung:

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

Fehlerbehebungs-FAQ

Anstelle von benutzerdefinierten Modellen sehe ich nur Pferderüstung.​

Info

Wenn anstelle von benutzerdefinierten Modellen in deinem Spiel nur Pferderüstung erscheint, liegt das Problem höchstwahrscheinlich daran, dass du das FMM-Ressourcenpaket nicht ordnungsgemäß mit deinem bestehenden 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 von 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 sie sich auf deinem Server einloggen.

Warum kann ich mein Modell nach dem Hinzufügen der .bbmodel-Datei nicht sehen?​

Info

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

1. Vergessen neu zu laden

Führe /fmm reload aus, nachdem du .bbmodel-Dateien im Imports-Ordner platziert hast. Dies konvertiert Modelle und generiert das Ressourcenpaket.

2. Ressourcenpaket nicht angewendet

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

  • Überprüfe ~/plugins/FreeMinecraftModels/output/FreeMinecraftModels.zip auf das generierte Paket
  • Installiere 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 in: ~/plugins/FreeMinecraftModels/imports/ abgelegt werden

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

4. Modell hat Fehler

Überprüfe die Konsolenprotokolle auf Fehlermeldungen während /fmm reload. Häufige Probleme sind nicht unterstützte Rotationen, zu große Modelle oder Texturprobleme.

5. Ressourcenpaket-Zusammenführungsproblem

Wenn du Pferderüstung anstelle von Modellen siehst, wurden die Ressourcenpakete nicht ordnungsgemäß zusammengeführt. Verwende Resource Pack Manager (RSPM), um die Zusammenführung automatisch durchzuführen.

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

Info

ViaVersion kann Probleme mit Ressourcenpaketen verursachen, insbesondere wenn der Server auf einer Version unter 1.21.4 läuft. Minecraft hat ab Version 1.21.4 Änderungen an der Handhabung von Ressourcenpaketen eingeführt. 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 diese Clients Probleme bei der Anzeige bestimmter Ressourcenpaketinhalte haben, wie z.B. benutzerdefinierte Modelle von FMM (FreeMinecraftModels).

Dies geschieht, weil sich das Ressourcenpaketsystem 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 möglicherweise Ressourcenpaketänderungen nicht vollständig, wenn der Server auf Versionen unter 1.21.4 läuft.

Um dies zu beheben, erwäge ein Update deines Servers auf 1.21.4 oder höher, da dies eine bessere Kompatibilität mit modernen Ressourcenpaketfunktionen gewährleistet, einschließlich benutzerdefinierter FMM-Modelle.

Warum verursachen meine Modelle Lag oder Leistungsprobleme?​

Info

Jeder Bone in deinem BlockBench-Modell erzeugt eine separate Entity in Minecraft. Modelle mit vielen Bones können die Serverleistung beeinträchtigen.

Optimierungstipps:

  • Minimiere die Bone-Anzahl in deinen Modellen
  • Begrenze die Anzahl der gespawnten Modelle
  • Erwäge die Verwendung von statischen Modellen anstelle von dynamischen Modellen, wenn keine Animationen benötigt werden
  • Vermeide es, viele Modelle mit hoher Bone-Anzahl nahe beieinander zu spawnen

Technische Erklärung:

FreeMinecraftModels rendert jeden Bone als separate Minecraft-Entity. Ein Modell mit 50 Bones spawnt 50 Entities. Bei großer Anzahl beeinträchtigt dies die Leistung.

Best Practices:

  • Entwirf Modelle mit weniger Bones
  • Teste die Leistung mit realistischen Spawn-Mengen
  • Überwache die Server-TPS beim Hinzufügen neuer Modelle

Erweiterte Funktionen

Brauche ich Resource Pack Manager (RSPM)?​

Info

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

Was RSPM macht:

  • Führt automatisch Ressourcenpakete von mehreren Plugins zusammen
  • Hostet Ressourcenpakete (kein externer Hosting-Dienst nötig)
  • Verteilt Pakete automatisch an Spieler beim Login
  • Eliminiert manuelle Ressourcenpaket-Konfiguration

Ohne RSPM:

Musst du manuell:

  • Das FMM-Ressourcenpaket mit vorhandenen Server-Ressourcenpaketen zusammenführen
  • Das zusammengeführte Paket auf einem externen Dienst oder über server.properties hosten
  • Den Server konfigurieren, um das Paket an Spieler zu senden
  • Das Paket jedes Mal aktualisieren, wenn du neue Modelle hinzufügst

Warum RSPM verwenden:

Die meisten "Pferderüstung statt Modelle"-Probleme werden durch fehlerhafte Ressourcenpaket-Zusammenführung verursacht. RSPM erledigt dies automatisch.

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

Entwickelt von MagmaGuy, dem gleichen 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

Artefakt:

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

Primäre API-Klassen:

  • ModeledEntity (Basisklasse)
  • StaticEntity
  • DynamicEntity
  • PropEntity

Beispielverwendung:

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 das offizielle README.

Wie verkleidet man einen Spieler als benutzerdefiniertes Modell?​

Info

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

Befehl:

/fmm disguise <modelID>

Wie es funktioniert:

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

Beispiel:

/fmm disguise dragon

Zum Entfernen der Verkleidung:

/fmm undisguise

Voraussetzungen:

  • Berechtigung: freeminecraftmodels.*
  • modelID muss ein gültiges konvertiertes Modell in deinem Models-Ordner sein

Hinweise:

  • Die Spieler-Hitbox bleibt unverändert (gleiche Kollisionsbox)
  • Andere Spieler sehen das benutzerdefinierte Modell anstelle deines Spieler-Skins
  • Der Unsichtbarkeitseffekt ist permanent, bis du die Verkleidung entfernst

Wie erstellt man platzierbare Modell-Items?​

Info

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

Befehl:

/fmm itemify <model> <material>

Parameter:

  • model - Jede gültige Modell-ID aus deinem Models-Ordner
  • material - Jedes Minecraft-Material (STICK, PAPER, DIAMOND, etc.)

Beispiel:

/fmm itemify lamp_post STICK

Was es erstellt:

  • Ein benutzerdefiniertes Item mit einem formatierten goldverzierten 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 Bauten zu dekorieren
  • Benutzerdefinierte "Spawn-Eier" für Möbel erstellen
  • Modelle verteilen, ohne Bau-Berechtigungen zu vergeben
  • Kits für kreatives Bauen einrichten

Voraussetzungen:

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

Wie debuggt man Modell-Hitboxen?​

Info

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

Befehl:

/fmm hitbox visualize [dauer]

Parameter:

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

Beispiele:

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

Wie es funktioniert:

  • Sucht nach Modellen im Umkreis von 10 Blöcken um dich
  • Zeigt orientierte Begrenzungsbox-Grenzen (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 zu visuellen Modellen passen
  • Interaktionsprobleme debuggen
  • Hitbox-Rotationen verifizieren
  • Klickerkennung-Fehlerbehebung

Voraussetzungen:

  • Berechtigung: freeminecraftmodels.*

Hinweis: Hitboxen in FMM rotieren mit dem Modell, im Gegensatz zu Standard-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 macht:

  • 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

Voraussetzungen:

  • 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 Roleplay-Server
  • Spezielle Transportmittel für VIP-Spieler
  • Einzigartige reitbare Kreaturen für Abenteuerkarten