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 initialize	Menu d'onboarding initial réservé aux joueurs
/fmm setup	Menu de gestion de contenu réservé aux joueurs
/fmm downloadall	Aide à l'installation en masse des packs Nightbreak accessibles
/fmm updatecontent	Aide à la mise à jour en masse des packs Nightbreak obsolètes
/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 leur indiquant d'exécuter /fmm initialize.

Workflow recommandé

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

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.