FreeMinecraftModels Einrichtung

FreeMinecraftModels unterstützt weiterhin manuelle .bbmodel-Importe, aber der aktuelle Einrichtungsablauf ist Nightbreak-fähig und menügesteuert.

Voraussetzungen

• Eine Java-21-Laufzeitumgebung für den Server
• Minecraft 1.21.4 oder neuer — das Plugin deklariert api-version: 1.21.4 und lädt auf älteren Versionslinien nicht
• FreeMinecraftModels installiert und einmal gestartet, damit es seine Datenordner erzeugen kann. MagmaCore ist im Plugin-Jar gebündelt und muss nicht separat installiert werden
• Eine Möglichkeit, das generierte Ressourcenpaket an Spieler auszuliefern

ResourcePackManager ist der empfohlene Auslieferungsweg, da FreeMinecraftModels das Paket nur generiert und es nicht selbst hostet.

Ersteinrichtung

Befehl	Zweck
/fmm setup	Spieler-exklusives Inhaltsverwaltungs-/Ersteinrichtungsmenü (der Befehl, auf den Spieler beim ersten Start hingewiesen werden)
/fmm recommendedplugins	Durchsuche Begleit-Plugins, die gut mit FreeMinecraftModels zusammenpassen
/fmm downloadall	Bulk-Installationshilfe: lädt das neueste Plugin-Update plus alle zugänglichen Nightbreak-Pakete herunter
/fmm downloadallcontent	Bulk-Installationshilfe für zugängliche Nightbreak-Pakete (nur Inhalte)
/fmm updatecontent	Bulk-Updatehilfe für veraltete Nightbreak-Pakete
/fmm downloadpluginupdate	Lädt nur das neueste Plugin-Jar-Update herunter
/fmm applypluginupdate	Wendet ein heruntergeladenes Plugin-Update an, ohne den Server neu zu starten
/fmm forcereinstallcontent <package|all>	Reparaturhilfe: lädt bereits vorhandene Inhalte erneut herunter, selbst wenn die Versionsnummern sagen, sie seien aktuell
/nightbreaklogin [token]	Gemeinsame Nightbreak-Kontoverknüpfung: gibt einen Link zum Genehmigen des Servers aus oder speichert ein eingefügtes Token (Berechtigung: nightbreak.login)
/nightbreaklogout	Löscht das gespeicherte Nightbreak-Token von diesem Server

Enthält config.yml noch setupDone: false, erhalten Spieler mit freeminecraftmodels.* etwa 10 Sekunden nach jeder Anmeldung eine Erinnerung, sofern sie noch online sind. Das Öffnen von /fmm setup speichert setupDone: true für den Server und beendet weitere Erinnerungen. Die Nachricht nennt auch /fmm admin und /fmm. Ein abgeschlossener Auswahlpunkt in /fmm initialize setzt die Einrichtung ebenfalls auf erledigt; dieser Status beweist keine Paketinstallation oder Auslieferung.

Die Symbolleiste von /fmm setup hat außerdem eine Schaltfläche Pets, die den Haustier-Modus zwischen kosmetischen Haustieren und mehr Kreaturen umschaltet und die Wahl in pets.yml speichert.

Empfohlener Ablauf

1. Installiere FreeMinecraftModels und starte den Server einmal.
2. Verknüpfe den Server über /nightbreaklogin mit deinem Nightbreak-Konto und genehmige ihn dann unter dem Link, den der Befehl ausgibt.
3. Öffne /fmm setup, um verfügbare Pakete und den aktuellen Status zu überprüfen.
4. Verwende /fmm downloadall, wenn du jedes offizielle Paket installieren möchtest, auf das dein Token Zugriff hat (dies zieht auch das neueste Plugin-Jar-Update).
5. Verwende später /fmm updatecontent, um veraltete offizielle Pakete zu aktualisieren.
6. Warte auf eine erfolgreiche Initialisierung und prüfe, dass Spieler das generierte Paket output/FreeMinecraftModels.zip erhalten, üblicherweise über ResourcePackManager. FMM benachrichtigt einen aktivierten ResourcePackManager nach erfolgreicher Erzeugung, doch diese Meldung allein beweist keine Auslieferung an Clients.

Interaktive Paketdownloads laden FMM nach Inhaltsänderungen neu. Ein heruntergeladenes Plugin-Jar wird nach einem Neustart wirksam oder sofort mit /fmm applypluginupdate. /fmm reload validiert selbst definierte Items, Verzauberungen und Prop-Rezepte vor dem Neuaufbau. Wird die Validierung abgelehnt, bleibt der aktuelle Katalog aktiv. Prüfe das Ergebnis, bevor du die Dateien als angewendet betrachtest.

Wenn du es vorziehst, dass der Server Updates eigenständig abruft, setze nightbreak.autoDownloadPluginUpdates: true in config.yml (Standard false). Heruntergeladene Plugin- und Inhalts-Updates werden nach dem nächsten Neustart angewendet. Um Plugin-Updates ohne Neustart anzuwenden, setze nightbreak.applyPluginUpdatesWithoutRestart auf when-empty oder immediately (Standard never). Siehe Konfiguration.

Manuelle Modell-Importe

Direkter Modellimport funktioniert weiterhin über:

plugins/FreeMinecraftModels/imports

Dieser Pfad ist weiterhin nützlich für:

• lokale Entwicklung
• benutzerdefinierte Modelle, die du nicht von Nightbreak beziehst
• das Konvertieren von .bbmodel-Inhalten in das aktuelle Laufzeitformat, wenn du /fmm reload ausführst

Sowohl manuelle Importe als auch offizielle Paket-Downloads sind letztlich auf einen Reload-/Import-Durchlauf angewiesen, bevor die Laufzeitmodellliste und das Ressourcenpaket neu aufgebaut werden.

Lege eine einzelne .bbmodel direkt in imports/ ab. Dieser Weg schreibt eine konvertierte .fmmodel ins Modellverzeichnis und behält die Importquelle, sodass ein späteres Neuladen sie erneut konvertieren kann. Eine danebenliegende einzelne .yml wird nicht mitimportiert. Gewöhnliche Unterordner ohne pack.meta werden auf diesem Weg nicht rekursiv importiert. Verwende für Modelle mit begleitenden Einstellungen oder Skripten das aktive Verzeichnis models/ und scripts/ oder ein korrekt gepacktes Archiv; siehe Hinweise zur Modellerstellung.

Offizielle Inhaltspakete

Das aktuelle Plugin liefert fünf vorgefertigte Nightbreak-verwaltete Pakete:

• Basic Furniture Pack (Props)
• BetterStructures Prop Pack (Props)
• EliteMobs Prop Pack (Props)
• Craftenmine's Weapons Item Pack (benutzerdefinierte Items)
• Craftenmine Tools Item Pack (benutzerdefinierte Items)

Diese erscheinen in /fmm setup, können mit /fmm downloadall gemeinsam heruntergeladen und mit /fmm updatecontent aktualisiert werden. Die beiden Craftenmine-Item-Pakete enthalten benutzerdefinierte Items (Modelle mit gesetztem material:) und verwenden die aktuellen Formate für selbst definierte Items und Verzauberungen. Ältere Item-Pakete mit Skripten für ausgerüstete Items benötigen aktualisierte Inhalte.

Hinweis zum Ressourcenpaket

FreeMinecraftModels benötigt immer, dass seine generierte Ressourcenpaket-Ausgabe auf irgendeine Weise an den Client gelangt.

Siehe Ressourcenpaket-Ausgabe für die aktuellen Ausgabepfade und die ResourcePackManager-Integration.