Zum Hauptinhalt springen

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
  • FreeMinecraftModels installiert und einmal gestartet, damit es seine Datenordner erzeugen kann
  • 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.

Erstmaliger Ablauf

BefehlZweck
/fmm setupSpieler-exklusives Inhaltsverwaltungs-/Ersteinrichtungsmenü (der Befehl, auf den Spieler beim ersten Start hingewiesen werden)
/fmm recommendedpluginsDurchsuche Begleit-Plugins, die gut mit FreeMinecraftModels zusammenpassen
/fmm downloadallBulk-Installationshilfe: lädt das neueste Plugin-Update plus alle zugänglichen Nightbreak-Pakete herunter
/fmm downloadallcontentBulk-Installationshilfe für zugängliche Nightbreak-Pakete (nur Inhalte)
/fmm updatecontentBulk-Updatehilfe für veraltete Nightbreak-Pakete
/fmm downloadpluginupdateLädt nur das neueste Plugin-Jar-Update herunter
/nightbreaklogin <token>Gemeinsame Nightbreak-Token-Registrierung

Wenn config.yml weiterhin setupDone: false enthält, erhalten Spieler mit freeminecraftmodels.* eine einmalige Login-Erinnerung, die sie auf /fmm setup hinweist (das Öffnen verwirft die Nachricht dauerhaft). Die Erinnerung weist außerdem auf /fmm admin und /fmm hin.

Empfohlener Ablauf

  1. Installiere FreeMinecraftModels und starte den Server einmal.
  2. Verknüpfe einen Nightbreak-Token mit /nightbreaklogin <token>.
  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. Stelle sicher, dass Spieler das generierte output/FreeMinecraftModels.zip-Paket erhalten, üblicherweise über ResourcePackManager.

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. 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.

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 innerhalb von /fmm setup, können mit /fmm downloadall per Bulk heruntergeladen und mit /fmm updatecontent aktualisiert werden. Die beiden Craftenmine-Item-Pakete sind benutzerdefinierte Items (Modelle mit gesetztem material:) und sind für Lua-Item-Skripte geeignet.

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.