Installation de FreeMinecraftModels

FreeMinecraftModels accepte toujours les importations manuelles de .bbmodel. La configuration actuelle intègre Nightbreak et se fait à travers des menus.

Prérequis

• Un environnement Java 21 pour le serveur
• Minecraft 1.21.4 ou plus récent : le plugin déclare api-version: 1.21.4 et ne se charge pas sur les versions antérieures
• FreeMinecraftModels installé et démarré une fois pour qu'il puisse générer ses dossiers de données. MagmaCore est inclus dans le jar du plugin : aucune installation séparée n'est nécessaire
• Un moyen de livrer le resource pack généré aux joueurs

ResourcePackManager est la solution recommandée pour distribuer le pack : FreeMinecraftModels le génère, mais ne l'héberge pas lui-même.

Première utilisation

Commande	Rôle
/fmm setup	Menu de gestion du contenu et de configuration initiale réservé aux joueurs, proposé au premier démarrage
/fmm recommendedplugins	Affiche les plugins complémentaires recommandés pour FreeMinecraftModels
/fmm downloadall	Aide à l'installation en masse : télécharge la dernière mise à jour du plugin plus tous les packs Nightbreak accessibles
/fmm downloadallcontent	Aide à l'installation en masse des packs Nightbreak accessibles (contenu uniquement)
/fmm updatecontent	Aide à la mise à jour en masse des packs Nightbreak obsolètes
/fmm downloadpluginupdate	Télécharge uniquement la dernière mise à jour du jar du plugin
/fmm applypluginupdate	Applique une mise à jour du plugin déjà téléchargée sans redémarrer le serveur
/fmm forcereinstallcontent <package|all>	Aide à la réparation : re-télécharge un contenu que vous possédez déjà, même lorsque les numéros de version indiquent qu'il est à jour
/nightbreaklogin [token]	Liaison de compte Nightbreak partagée : affiche un lien pour approuver le serveur, ou enregistre un jeton collé (permission : nightbreak.login)
/nightbreaklogout	Efface le jeton Nightbreak enregistré sur ce serveur

Si config.yml contient encore setupDone: false, les joueurs disposant de freeminecraftmodels.* reçoivent un rappel environ 10 secondes après chaque connexion s'ils sont toujours en ligne. Ouvrir /fmm setup enregistre setupDone: true pour le serveur et supprime les futurs rappels. Le message présente aussi /fmm admin et /fmm. Valider un choix dans /fmm initialize termine également cette configuration ; cet indicateur ne prouve pas qu'un pack a été installé ou livré.

La barre d'outils de /fmm setup comporte aussi un bouton Pets qui bascule le mode des familiers entre familiers cosmétiques et davantage de créatures, et enregistre ce choix dans pets.yml.

Procédure recommandée

1. Installez FreeMinecraftModels et démarrez le serveur une fois.
2. Liez le serveur à votre compte Nightbreak avec /nightbreaklogin, puis approuvez-le via le lien affiché.
3. Ouvrez /fmm setup pour inspecter les packs disponibles et l'état actuel.
4. Utilisez /fmm downloadall pour installer tous les packs officiels accessibles avec votre jeton ; cette commande télécharge aussi la dernière mise à jour du jar du plugin.
5. Utilisez ensuite /fmm updatecontent pour mettre à jour les packs officiels obsolètes.
6. Attendez la réussite de l'initialisation et vérifiez que les joueurs reçoivent le pack généré output/FreeMinecraftModels.zip, généralement via ResourcePackManager. Après une génération réussie, FMM avertit ResourcePackManager s'il est activé, mais cette notification seule ne prouve pas la livraison au client.

Les téléchargements interactifs de packs rechargent FMM après une modification du contenu. Un jar du plugin téléchargé prend effet après un redémarrage, ou immédiatement avec /fmm applypluginupdate. /fmm reload valide les objets, enchantements et recettes de props définis avant la reconstruction ; un refus de validation conserve le catalogue actuel. Vérifiez le résultat avant de considérer les fichiers comme appliqués.

Si vous préférez que le serveur récupère les mises à jour de lui-même, définissez nightbreak.autoDownloadPluginUpdates: true dans config.yml (défaut false). Les mises à jour téléchargées du plugin et du contenu sont appliquées après le prochain redémarrage. Pour appliquer les mises à jour du plugin sans redémarrage, définissez nightbreak.applyPluginUpdatesWithoutRestart sur when-empty ou immediately (défaut never). Voir Configuration.

Importations manuelles de modèles

L'import direct de modèles fonctionne toujours via :

plugins/FreeMinecraftModels/imports

Ce chemin reste utile pour :

• le développement local
• les modèles personnalisés qui ne proviennent pas de Nightbreak
• la conversion du contenu .bbmodel vers le format actuel du moteur lorsque vous exécutez /fmm reload

Les importations manuelles comme les téléchargements officiels nécessitent une étape de rechargement et d'importation avant la reconstruction de la liste des modèles disponibles et du resource pack.

Placez un .bbmodel isolé directement dans imports/. Ce chemin écrit un .fmmodel converti dans le dossier des modèles et conserve l'import source : un prochain rechargement peut donc le convertir à nouveau. Il n'importe pas un .yml isolé placé à côté. Les sous-dossiers ordinaires sans pack.meta ne sont pas parcourus récursivement. Pour un modèle accompagné de paramètres ou de scripts, utilisez les dossiers actifs models/ et scripts/, ou une archive correctement structurée ; voir Notes de création des modèles.

Packs de contenu officiels

Le plugin actuel est livré avec cinq packs Nightbreak prêts à l'emploi :

• Basic Furniture Pack (props)
• BetterStructures Prop Pack (props)
• EliteMobs Prop Pack (props)
• Craftenmine's Weapons Item Pack (objets personnalisés)
• Craftenmine Tools Item Pack (objets personnalisés)

Ils apparaissent dans /fmm setup, peuvent être téléchargés ensemble avec /fmm downloadall et mis à jour avec /fmm updatecontent. Les deux packs Craftenmine contiennent des objets personnalisés, c'est-à-dire des modèles avec material: défini, et utilisent les formats actuels de définition d'objets et d'enchantements. Les anciens packs utilisant des scripts d'objets équipés nécessitent un contenu mis à jour.

Rappel sur le resource pack

FreeMinecraftModels a toujours besoin que sa sortie de resource pack générée parvienne au client d'une manière ou d'une autre.

Voir Sortie du resource pack pour les chemins de sortie actuels et l'intégration ResourcePackManager.