Installation de FreeMinecraftModels

FreeMinecraftModels prend toujours en charge les imports manuels de .bbmodel, mais le flux d'installation actuel est conscient de Nightbreak et piloté par menu.

Prérequis

• Un runtime Java 21 pour le serveur
• FreeMinecraftModels installé et démarré une fois pour qu'il puisse générer ses dossiers de données
• Un moyen de livrer le resource pack généré aux joueurs

ResourcePackManager est le chemin de livraison recommandé car FreeMinecraftModels ne fait que générer le pack ; il ne l'héberge pas de lui-même.

Flux de première utilisation

Commande	Rôle
/fmm setup	Menu de gestion de contenu / onboarding initial réservé aux joueurs (la commande vers laquelle les joueurs sont dirigés au premier démarrage)
/fmm recommendedplugins	Affiche les plugins compagnons qui se marient bien avec 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
/nightbreaklogin <token>	Enregistrement du token Nightbreak partagé

Si config.yml contient encore setupDone: false, les joueurs disposant de freeminecraftmodels.* reçoivent un rappel à la connexion (unique) leur indiquant d'exécuter /fmm setup (l'ouvrir rejette définitivement le message). Le rappel met aussi en avant /fmm admin et /fmm.

Workflow recommandé

1. Installez FreeMinecraftModels et démarrez le serveur une fois.
2. Liez un token Nightbreak avec /nightbreaklogin <token>.
3. Ouvrez /fmm setup pour inspecter les packs disponibles et l'état actuel.
4. Utilisez /fmm downloadall si vous souhaitez installer chaque pack officiel auquel votre token a accès (cela tire aussi la dernière mise à jour du jar du plugin).
5. Utilisez /fmm updatecontent plus tard pour rafraîchir les packs officiels obsolètes.
6. Assurez-vous que les joueurs reçoivent le pack généré output/FreeMinecraftModels.zip, généralement via ResourcePackManager.

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. Voir Configuration.

Imports manuels 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 que vous ne tirez pas de Nightbreak
• la conversion de contenu .bbmodel vers le format runtime actuel lorsque vous exécutez /fmm reload

Les imports manuels et les téléchargements de packs officiels dépendent tous deux d'une passe de reload/import avant que la liste de modèles runtime et le resource pack ne soient reconstruits.

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 en masse avec /fmm downloadall et mis à jour avec /fmm updatecontent. Les deux packs d'objets Craftenmine sont des objets personnalisés (modèles avec material: défini) et sont éligibles aux scripts Lua d'objet.

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.