Zum Hauptinhalt springen

FreeMinecraftModels Inhaltspakete

Offizielle FMM-Inhalte werden jetzt als verwaltete Nightbreak-Pakete bereitgestellt.

Aktuelle offizielle Pakete

Das aktuelle Plugin definiert fünf vorgefertigte offizielle Pakete, die Prop- und Item-Inhalte mischen:

PaketTypOrdnernameNightbreak-Slug
Basic Furniture PackPropsbasic_furniture_packbasic-furniture-pack
BetterStructures Prop PackPropsbetterstructures_prop_packbetterstructures-prop-pack
EliteMobs Prop PackPropselitemobs_prop_packelitemobs-prop-pack
Craftenmine's Weapons Item PackBenutzerdefinierte Itemscraftenmines_weapons_item_packcraftenmines-weapons-item-pack
Craftenmine Tools Item PackBenutzerdefinierte Itemscraftenmine_tools_item_packcraftenmine-tools-item-pack

Jedes Paket hat einen lokalen Ordnernamen, einen Nightbreak-Slug, ein Versionsfeld und einen aktivierten/deaktivierten Zustand in content_packages. Die beiden Craftenmine-Item-Pakete liefern benutzerdefinierte Items (Modelle mit gesetztem material:), die mit der vollständigen Lua-Item-Skript-Oberfläche funktionieren.

Was das Einrichtungsmenü verwaltet

/fmm setup ist die aktuelle Quelle der Wahrheit für den Paketstatus. Das Menü kann unterscheiden zwischen:

  • installierten Paketen
  • heruntergeladenen, aber derzeit deaktivierten Paketen
  • veralteten Paketen
  • Paketen, die Nightbreak-Zugriff erfordern

Das Einrichtungsmenü löst außerdem Hintergrundaktualisierungen für Paketversionen und Zugriffsprüfungen aus, sodass das Menü der richtige Ort ist, um den aktuellen Paketstatus zu überprüfen.

Ordner-Verhalten

Das Plugin verwendet paketstatusabhängige Ordnerverschiebungen für aktivierte und deaktivierte Inhalte:

  • aktivierte Modellordner liegen in models/<folderName>
  • deaktivierte Modellordner liegen in models_disabled/<folderName>
  • aktivierte Skriptdateien liegen in scripts/
  • deaktivierte Skriptdateien liegen in scripts_disabled/

Das bedeutet, dass ein Paket vollständig auf der Festplatte heruntergeladen sein kann, ohne in der Laufzeit-Modellliste aktiv zu sein. Wenn ein Paket installiert oder deinstalliert wird, werden sowohl sein Modellordner als auch alle zugehörigen Skriptdateien gemeinsam verschoben.

Dateipräfixe

Jede Inhaltspaket-Konfiguration hat ein contentFilePrefixes-Feld und ein scriptFilePrefixes-Feld (beide standardmäßig auf den folderName des Pakets gesetzt). Inhaltsdateien, deren Namen mit einem der contentFilePrefixes beginnen, und Skriptdateien im scripts/-Ordner, deren Namen mit einem der scriptFilePrefixes beginnen, werden als Teil des Pakets betrachtet und beim Installieren/Deinstallieren mit ihm verschoben.

Download- und Installationszyklus

Es gibt zwei getrennte Schritte:

  1. Den Paketinhalt herunterladen. Downloads landen in plugins/FreeMinecraftModels/imports und lösen dann einen Reload-/Import-Durchlauf aus.
  2. Das Paket aktiviert oder deaktiviert halten. Das Einrichtungsmenü installiert und deinstalliert Pakete, indem es deren Ordner zwischen models und models_disabled verschiebt.

Bulk-Operationen folgen demselben Modell:

  • /fmm downloadall lädt jedes zugängliche Paket herunter, das fehlt oder veraltet ist
  • /fmm updatecontent aktualisiert nur veraltete Pakete

Beide Bulk-Befehle laden FreeMinecraftModels nach erfolgreichen Downloads automatisch neu, sodass die neu heruntergeladenen Inhalte verfügbar werden.

Admin-Inhaltsbrowser

/fmm admin öffnet eine In-Game-Inventar-GUI, mit der Admins alle installierten Inhalte auf einen Blick durchsuchen können. Der Browser zeigt:

  • alle installierten Pakete (mit separaten Prop- und Item-Zählungen)
  • nicht paketierte Modellordner (mit separaten Prop- und Item-Zählungen)
  • einzelne Props (Modelle ohne material: in ihrer YML-Konfiguration)
  • benutzerdefinierte Items (Modelle, die material: in ihrer YML-Konfiguration gesetzt haben)

Props und Items werden deutlich unterschieden: Props verwenden gelbes Styling und ein Papier-Symbol, während benutzerdefinierte Items lilafarbenes Styling verwenden und ihr konfiguriertes Material zeigen. Ein Modell, das material: in seiner YML-Konfiguration gesetzt hat, erscheint nur als benutzerdefiniertes Item, nie sowohl als Prop als auch als Item.

Ein Klick auf einen beliebigen Eintrag im Admin-Browser gibt dem Spieler eine Kopie dieses Items. Bei benutzerdefinierten Items enthält das gegebene Item das konfigurierte Material, die Verzauberungen, die Lore und das fmm_item_id-PDC-Tag. Dies ist der schnellste Weg, Props, benutzerdefinierte Items oder Modell-Items zum Testen und Bauen zu erhalten, ohne die genaue Modell-ID oder Befehlssyntax kennen zu müssen.