Packs de contenu FreeMinecraftModels

Le contenu FMM officiel est désormais exposé en tant que packs Nightbreak gérés.

Packs officiels actuels

Le plugin actuel définit cinq packs officiels prêts à l'emploi, mêlant contenu prop et objet :

Pack	Type	Nom de dossier	Slug Nightbreak
Basic Furniture Pack	Props	basic_furniture_pack	basic-furniture-pack
BetterStructures Prop Pack	Props	betterstructures_prop_pack	betterstructures-prop-pack
EliteMobs Prop Pack	Props	elitemobs_prop_pack	elitemobs-prop-pack
Craftenmine's Weapons Item Pack	Objets personnalisés	craftenmines_weapons_item_pack	craftenmines-weapons-item-pack
Craftenmine Tools Item Pack	Objets personnalisés	craftenmine_tools_item_pack	craftenmine-tools-item-pack

Chaque pack a un nom de dossier local, un slug Nightbreak, un champ de version, et un état activé/désactivé dans content_packages. Les deux packs d'objets Craftenmine fournissent des objets personnalisés (modèles avec material: défini) qui fonctionnent avec la surface complète des scripts Lua d'objet.

Ce que gère le menu d'installation

/fmm setup est la source de vérité actuelle pour l'état des packs. Le menu peut distinguer entre :

• les packs installés
• les packs téléchargés mais actuellement désactivés
• les packs obsolètes
• les packs qui nécessitent un accès Nightbreak

Le menu d'installation déclenche également des rafraîchissements en arrière-plan pour les versions de pack et les vérifications d'accès, donc le menu est le bon endroit pour vérifier l'état actuel des packs.

Comportement des dossiers

Le plugin utilise des déplacements de dossier basés sur l'état du pack pour le contenu activé et désactivé :

• les dossiers de modèles activés vivent dans models/<folderName>
• les dossiers de modèles désactivés vivent dans models_disabled/<folderName>
• les fichiers de scripts activés vivent dans scripts/
• les fichiers de scripts désactivés vivent dans scripts_disabled/

Cela signifie qu'un pack peut être entièrement téléchargé sur disque sans être actif dans la liste de modèles runtime. Lorsqu'un pack est installé ou désinstallé, son dossier de modèles et tous les fichiers de scripts correspondants sont déplacés ensemble.

Préfixes de fichiers

Chaque config de pack de contenu a un champ contentFilePrefixes et un champ scriptFilePrefixes (les deux par défaut au folderName du pack). Les fichiers de contenu dont les noms commencent par l'un des contentFilePrefixes et les fichiers de script dans le dossier scripts/ dont les noms commencent par l'un des scriptFilePrefixes sont considérés comme faisant partie du pack et sont déplacés avec lui lors de l'installation/désinstallation.

Cycle de vie de téléchargement et d'installation

Il y a deux étapes distinctes :

1. Téléchargez le contenu du pack. Les téléchargements vont dans plugins/FreeMinecraftModels/imports puis déclenchent une passe de reload/import.
2. Maintenez le pack activé ou désactivé. Le menu d'installation installe et désinstalle les packs en déplaçant leurs dossiers entre models et models_disabled.

Les opérations en masse suivent le même modèle :

• /fmm downloadall télécharge chaque pack accessible manquant ou obsolète
• /fmm updatecontent met à jour uniquement les packs obsolètes

Les deux commandes en masse rechargent FreeMinecraftModels automatiquement après les téléchargements réussis afin que le contenu nouvellement téléchargé devienne disponible.

Navigateur de contenu admin

/fmm admin ouvre une GUI d'inventaire en jeu qui permet aux admins de parcourir tout le contenu installé en un coup d'œil. Le navigateur affiche :

• tous les packs installés (avec des comptes séparés pour les props et les objets)
• les dossiers de modèles non packagés (avec des comptes séparés pour les props et les objets)
• les props individuels (modèles sans material: dans leur config YML)
• les objets personnalisés (modèles ayant material: défini dans leur config YML)

Les props et les objets sont affichés de manière distincte : les props utilisent un style jaune et une icône de papier, tandis que les objets personnalisés utilisent un style violet et affichent leur matériau configuré. Un modèle qui a material: défini dans sa config YML apparaît uniquement comme objet personnalisé, jamais comme à la fois prop et objet.

Cliquer sur n'importe quelle entrée du navigateur admin donne au joueur une copie de cet objet. Pour les objets personnalisés, l'objet donné inclut le matériau configuré, les enchantements, le lore et le tag PDC fmm_item_id. C'est la méthode la plus rapide pour obtenir des props, objets personnalisés ou objets de modèle pour les tests et la construction sans avoir besoin de connaître l'ID exact du modèle ou la syntaxe de commande.