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 bezeichnet den .yml-Eintrag unter plugins/FreeMinecraftModels/content_packages/. Der Ordnername bezeichnet das Modellverzeichnis des Pakets in models/ oder models_disabled/. Präfixe werden wie unten beschrieben getrennt konfiguriert.

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 gehaltene Items mit material:-Definitionen und Verzauberungen mit Namespace. Ältere Kopien mit scripts: für ausgerüstete Items benötigen aktualisierte Inhalte; solche Definitionen werden übersprungen.

Was das Einrichtungsmenü verwaltet

/fmm setup zeigt den Paketstatus anhand lokaler Konfiguration, erkannter Dateien und zwischengespeicherter Nightbreak-Informationen. Das Menü unterscheidet zwischen:

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

Das Menü startet Versions- und Zugriffsprüfungen im Hintergrund mit fünf Minuten Mindestabstand zwischen Aktualisierungen. Versionsprüfungen gelten für als installiert erkannte Pakete. Ein Installiert-Abzeichen bedeutet, dass das Paket aktiviert ist und ein verwalteter Modelleintrag existiert; es beweist weder das Laden aller Modelle noch den Empfang des Ressourcenpakets beim Client. Prüfe auch /fmm admin, die Konsole und die Auslieferung an Clients.

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/

Heruntergeladene Inhalte können auf dem Datenträger liegen, ohne aktiv zu sein. Installation und Deinstallation verschieben passende Modell-, Skript- und Verzauberungseinträge, speichern den Aktivierungszustand und fordern anschließend einen Reload an. Diese Schritte laufen nacheinander, ohne atomare Transaktion: Ein Fehler beim Verschieben oder Speichern kann eine teilweise Änderung hinterlassen. Prüfe Konsole und beide Ordner, bevor du es erneut versuchst. Beide Aktionen benötigen einen verwalteten Modelleintrag im Quellordner; reine Skript- oder Verzauberungsdateien können als heruntergeladen zählen, ohne das Paket über diese Aktion installierbar zu machen.

Ältere Installationen verwenden möglicherweise Models oder Models_disabled. Der aktive Modellpfad bevorzugt das kleingeschriebene models, der deaktivierte Pfad dagegen einen vorhandenen Ordner Models_disabled. Lies die Hinweise zur Modellerstellung, bevor du Verzeichnisse mit unterschiedlicher Groß- und Kleinschreibung zusammenführst.

Dateipräfixe

Paketkonfigurationen enthalten contentFilePrefixes und scriptFilePrefixes. Die fünf eingebauten Definitionen initialisieren beide Listen leer; folderName wird nicht automatisch als Präfix verwendet. Prüfe die Werte in der installierten Paketkonfiguration.

Bei Modellen und Verzauberungen wählt FMM den exakten Eintrag folderName sowie Einträge im Wurzelordner aus, deren Namen mit einem Wert aus contentFilePrefixes beginnen. Bei Skripten werden Wurzeleinträge anhand von scriptFilePrefixes ausgewählt, ohne zusätzlichen Abgleich des Ordnernamens. Präfixe ignorieren Groß- und Kleinschreibung und können Dateien oder ganze Verzeichnisse auswählen; sie suchen nicht rekursiv nach passenden Dateien in anderen Verzeichnissen. Verwende eindeutige Präfixe und halte referenzierte Dateien innerhalb der ausgewählten Einträge.

Download- und Installationszyklus

Es gibt zwei getrennte Schritte:

1. Den Paketinhalt herunterladen. Downloads landen in plugins/FreeMinecraftModels/imports. Ein erfolgreicher verwalteter Download speichert den Aktivierungszustand, bevor er einen Reload mit Import anfordert.
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 wird nach einem Neustart oder nach /fmm applypluginupdate wirksam
• /fmm downloadallcontent führt denselben Inhaltsdurchlauf ohne das Plugin-Jar-Update aus
• /fmm updatecontent (Alias /fmm updateallcontent) erneuert Versions- und Zugriffsinformationen und aktualisiert als veraltet markierte Pakete; Versionsprüfungen erfassen derzeit installierte Pakete

Die Sammeldurchläufe bearbeiten Pakete nacheinander und melden erfolgreiche Downloads samt Vorbereitung getrennt von Fehlern. Wird mindestens ein Paket erfolgreich abgeschlossen, planen sie einen Reload 20 Ticks später, auch wenn andere Pakete scheitern. Ohne erfolgreiche Pakete gibt es keinen Reload; ein leerer Installationsdurchlauf meldet keine neuen Inhalte, ein leerer Aktualisierungsdurchlauf keine ausstehenden Updates. Ein erfolgreicher Download beweist nicht, dass der spätere Import, das Laden der Modelle oder die Auslieferung an Clients gelingt.

Inhaltsdurchläufe teilen eine Sperre, die einen zweiten Lauf bis zum Abschluss des ersten oder zum Beginn seines anschließenden Reloads verhindert. Sie benötigen einen verknüpften Nightbreak-Token und stoppen bei Authentifizierungsfehlern. Gewöhnliche Paketfehler werden gemeldet, während die übrigen Pakete weiterlaufen. Meldet sich der auslösende Spieler ab, läuft die Verarbeitung mit Konsolenmeldungen weiter. Das Herunterfahren des Plugins verwirft ausstehende Download-Veröffentlichungen und Rückrufe dieses Lebenszyklus.

Ein Paket reparieren

Die normale Auswahl nutzt erkannte Dateien und Versionszustand, keine Integritätsprüfung. Ein teilweise beschädigtes Paket kann weiterhin aktuell erscheinen und übersprungen werden. /fmm forcereinstallcontent <package|all> lädt ausgewählte Inhalte unabhängig von der Version erneut herunter und fordert nach erfolgreichen Downloads einen Reload an. Dabei wird ein deaktiviertes Paket nicht zwangsweise aktiviert.

• 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 wählt Pakete aus, die als heruntergeladen, installiert oder veraltet erkannt sind. Passt keines, lautet die Meldung No downloaded content was detected. Specify a package slug directly if its files are completely missing. Gib bei einem vollständig fehlenden Paket den Slug direkt 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.*.

Inhalte aus anderen Paketen

Ein Inhaltspaket für ein beliebiges Nightbreak-Plugin, etwa ein EliteMobs- oder BetterStructures-Paket im imports-Ordner des jeweiligen Plugins, kann FreeMinecraftModels-Inhalte in einem Ordner freeminecraftmodels/ auf oberster Ebene mitbringen, der wie plugins/FreeMinecraftModels/ aufgebaut ist. So liefert zum Beispiel freeminecraftmodels/enchantments/ die freeminecraftmodels:-Verzauberungen, die die Items des Pakets verwenden, und freeminecraftmodels/models/ wird in den Modellordner zusammengeführt, den FMM liest (kleingeschrieben models oder ein alter Models-Ordner, sofern dieser existiert). Ordner models/ und scripts/ auf oberster Ebene eines Pakets gehen ebenfalls an FMM. Ein Ordner enchantments/ auf oberster Ebene richtet sich nach der Plattform des Pakets, die pack.meta angibt (oder, falls es keine gibt, nach dem Plugin, in dessen imports-Ordner das Paket liegt): Ein FreeMinecraftModels-Paket installiert ihn in FMM, EliteMobs- und BetterStructures-Pakete installieren ihn in EliteMobs.

Legt der Import eines anderen Plugins Dateien im FMM-Ordner ab, führt FMM danach seinen Reload für importierte Inhalte aus. Dieser Reload baut Modelle, Items, Verzauberungen, Prop-Skripte, Rezepte und das Ressourcenpaket neu auf, liest config.yml und shop_config.yml aber nicht erneut ein.

Admin-Inhaltsbrowser

/fmm admin öffnet im Spiel einen Browser für geladene Modelle und registrierte benutzerdefinierte Items. Er zeigt:

• aktivierte Pakete mit geladenen Inhalten (mit separaten Prop- und Item-Zählungen)
• nicht paketierte Modellordner (mit separaten Prop- und Item-Zählungen)
• einzelne Prop-Modelle
• erfolgreich registrierte benutzerdefinierte Items

Props verwenden gelbe Gestaltung und ein Papier-Symbol. Benutzerdefinierte Items verwenden ihr konfiguriertes Material und ihren Namen, mit einem lilafarbenen Ersatznamen. Die Anzeige hängt von erfolgreicher Item-Registrierung ab, nicht allein von material: in einer Datei; eine abgelehnte Definition wird nicht als funktionierendes benutzerdefiniertes Item aufgeführt.

Paket- und Ordnereinträge öffnen ihre Inhaltslisten. Ein Klick auf einen einzelnen Prop oder ein Item fügt dem Inventar eine Kopie hinzu. Benutzerdefinierte Items enthalten Material, Verzauberungen, Lore und das Tag fmm_item_id; Props liefern Platzierungsitems aus Papier. Lass Platz im Inventar: Diese Admin-Handler werfen Überlauf nicht auf den Boden. Fehler bei der Item-Erstellung werden im Chat gemeldet. Registrierung und sichtbarer Menüeintrag beweisen keine korrekte Darstellung beim Client.

Verzauberungsinhalte

Aktivierung und Deaktivierung umfassen verwaltete Verzauberungsdateien in YAML/Lua neben Modellen und Prop-Skripten. Aktive Inhalte liegen unter enchantments/, deaktivierte unter enchantments_disabled/. Die Auswahl folgt den obigen Regeln für Ordnernamen und Inhaltspräfixe; halte Provider-Definitionen und referenzierte Skripte innerhalb der ausgewählten Einträge. Die eingestellte Item-Skript-Laufzeit ersetzt keinen fehlenden Verzauberungs-Provider.