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:

Paket	Typ	Konfigurations-Dateiname	Ordnername	Nightbreak-Slug
Basic Furniture Pack	Props	basic_furniture_pack	Basic Furniture Pack	basic-furniture-pack
BetterStructures Prop Pack	Props	betterstructures_prop_pack	bs prop pack	betterstructures-prop-pack
EliteMobs Prop Pack	Props	elitemobs_prop_pack	em_dungeon_prop_pack	elitemobs-prop-pack
Craftenmine's Weapons Item Pack	Benutzerdefinierte Items	craftenmines_weapons_item_pack	fmm_craftenmine_weapons_items_pack	craftenmines-weapons-item-pack
Craftenmine Tools Item Pack	Benutzerdefinierte Items	craftenmine_tools_item_pack	fmm_craftenmine_tools_items_pack	craftenmine-tools-item-pack

Der Konfigurations-Dateiname ist der .yml-Eintrag unter plugins/FreeMinecraftModels/content_packages/. Der Ordnername ist das Verzeichnis, in dem die Modelle des Pakets tatsächlich innerhalb von models/ oder models_disabled/ liegen, und ist zugleich das Standard-Präfix für Inhalts- und Skriptdateien.

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 das Plugin-Jar-Update und anschließend jedes zugängliche Paket herunter, das fehlt oder veraltet ist. Inhalte können durch FMMs anschließenden Reload angewendet werden; das Plugin-Jar selbst erfordert weiterhin einen Server-Neustart
• /fmm downloadallcontent führt denselben Inhaltsdurchlauf ohne das Plugin-Jar-Update aus
• /fmm updatecontent (Alias /fmm updateallcontent) aktualisiert nur veraltete Pakete

Alle drei Bulk-Inhaltsdurchläufe laden FreeMinecraftModels nach erfolgreichen Paket-Downloads automatisch neu, sodass die neu heruntergeladenen Inhalte verfügbar werden. Das Neuladen wird nur ausgelöst, wenn mindestens ein Paket tatsächlich heruntergeladen wurde — ein Durchlauf, der nichts zu tun findet, meldet No new content to download! und überspringt das Neuladen.

Bulk-Operationen sind gegen überlappende Läufe abgesichert: Während einer läuft, wird ein zweiter Bulk-Befehl abgelehnt statt parallel gestartet. Sie erfordern außerdem einen verknüpften Nightbreak-Token und brechen bei einem Authentifizierungsfehler frühzeitig ab.

Ein Paket reparieren

Die normalen Download-Befehle vergleichen Versionsnummern, ein Paket mit beschädigten oder teilweise gelöschten Dateien sieht also weiterhin „aktuell" aus und wird übersprungen. /fmm forcereinstallcontent <package|all> existiert für diesen Fall: Es lädt die gewählten Inhalte unabhängig von der Version erneut herunter und führt anschließend einen Reload durch.

• Die Tab-Vervollständigung bietet all sowie den Nightbreak-Slug jedes Pakets an (basic-furniture-pack, betterstructures-prop-pack, elitemobs-prop-pack, craftenmines-weapons-item-pack, craftenmine-tools-item-pack).
• all deckt nur Pakete ab, die FMM als heruntergeladen erkennt. Fehlen die Dateien eines Pakets vollständig, meldet es No downloaded content was detected. Specify a package slug directly if its files are completely missing. — gib dann stattdessen den Slug an.
• Ein unbekannter Selektor meldet Unknown Nightbreak content package: <name>.
• Es teilt sich dieselbe Absicherung gegen überlappende Läufe mit den anderen Bulk-Operationen und erfordert freeminecraftmodels.*.

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.