FAQ FreeMinecraftModels

Si votre question n'est pas listée ici, consultez la barre latérale pour voir s'il existe une page dédiée dans le wiki !

Pour commencer

Comment installer et utiliser FreeMinecraftModels ?

Infos

Installation :

1. Téléchargez FreeMinecraftModels.jar et placez-le dans votre dossier plugins
2. Redémarrez votre serveur pour générer les dossiers du plugin
3. Exécutez /fmm initialize si vous souhaitez le flux de configuration initiale
4. Si vous utilisez des packs de contenu officiels, associez Nightbreak avec /nightbreaklogin <token>
5. Utilisez /fmm setup ou /fmm downloadall pour le contenu officiel géré par Nightbreak
6. Pour le contenu manuel, placez les fichiers .bbmodel dans ~/plugins/FreeMinecraftModels/imports/ et exécutez /fmm reload
7. Trouvez le resource pack généré dans ~/plugins/FreeMinecraftModels/output/FreeMinecraftModels.zip

Distribution du resource pack :

Choisissez l'une de ces méthodes :

• Option A (Recommandée) : Installez Resource Pack Manager pour la distribution automatique
• Option B : Configurez manuellement via server.properties ou un service d'hébergement

Faire apparaître des modèles :

• /fmm spawn static <id> - Fait apparaître un modèle décoratif temporaire
• /fmm spawn dynamic <id> - Fait apparaître un modèle attaché à une entité
• /fmm spawn prop <id> - Fait apparaître un modèle persistant dans le monde

Gestion :

• /fmm - Affiche le résumé de configuration/aide
• /fmm initialize - Ouvre le menu de configuration initiale
• /fmm setup - Ouvre le menu de gestion de contenu
• /fmm downloadall - Télécharge tout le contenu officiel accessible
• /fmm updatecontent - Met à jour le contenu officiel obsolète
• /fmm reload - Recharge le plugin et convertit les nouveaux modèles
• /fmm version - Affiche la version du plugin
• /fmm stats - Affiche les statistiques du nombre d'entités

Fonctionnalités joueur :

• /fmm disguise <modelID> - Transforme votre apparence en un modèle personnalisé
• /fmm undisguise - Supprime le déguisement du joueur et restaure l'apparence normale
• /fmm itemify <model> <material> - Crée un objet plaçable qui fait apparaître le modèle spécifié
• /fmm craftify <modelID> - Ouvre un constructeur de recettes interactif pour créer une recette d'artisanat pour un prop
• /fmm mount <modelID> - Fait apparaître un cheval montable déguisé en modèle personnalisé (expérimental)

Débogage :

• /fmm hitbox visualize [duration] - Visualise les hitboxes des modèles avec des particules (durée en ticks, 100 par défaut)

Administration :

• /fmm deleteall - Supprime toutes les entités modélisées actuellement chargées (utilisez avec prudence - pas de confirmation)

Permissions :

• freeminecraftmodels.* - Requise pour la plupart des commandes (disguise, itemify, mount, hitbox visualize, spawn)
• freeminecraftmodels.deleteall - Requise pour la commande /fmm deleteall

Les commandes sont réservées aux OP par défaut. Accordez ces permissions aux joueurs non-OP si nécessaire.

Fonctionnalités et limites des modèles

Quelles sont les limites de taille et de rotation des modèles ?

Infos

Limites de taille :

• Maximum : 112x112x112 pixels (7x7x7 blocs en jeu)
• FreeMinecraftModels utilise un facteur d'échelle interne de 4x pour atteindre ces tailles
• Les resource packs Minecraft standard sont limités à des tailles plus petites

Limites de rotation des cubes :

• Angles autorisés : 0°, ±22.5°, ±45° et multiples de 22.5° (depuis la v2.3.0)
• Rotation sur un seul axe uniquement
• Exemple : [22.5, 0, 0] fonctionne, mais [22.5, 0, 45] ne pivote que partiellement
• Les autres angles ne s'afficheront pas correctement

Rotation des os :

• Les os supportent n'importe quel angle de rotation
• Évitez les positions de repos par défaut de 90°, -90°, 180°, -180° (peut causer un comportement inattendu)
• La rotation multi-axes est supportée
• Chaque os crée une entité séparée (considération de performance)

Note de performance :

Gardez le nombre d'os aussi bas que possible. Chaque os génère une entité séparée dans Minecraft, ce qui peut impacter les performances du serveur à grande échelle.

Quelles animations sont supportées ?

Infos

FreeMinecraftModels supporte ces animations d'état par défaut :

Animations standard :

• Walk (Marche)
• Idle (Inactif)
• Death (Mort)
• Attack (Attaque)
• Spawn (Apparition)

Comment ça fonctionne :

• Créez les animations dans BlockBench
• Le plugin lit les images clés d'animation depuis les fichiers .bbmodel
• Les animations se déclenchent automatiquement en fonction de l'état de l'entité
• Les développeurs peuvent déclencher les animations programmatiquement en utilisant playAnimation(animationName, false, false)

Cas spécial :

Les entités Evoker détectent les Crocs d'Évocateur à proximité pour déclencher automatiquement les animations d'attaque.

Que sont les os virtuels et comment fonctionnent-ils ?

Infos

Les os virtuels sont des os spéciaux avec des noms réservés qui ajoutent des fonctionnalités à vos modèles :

Os de hitbox :

• Nom : hitbox
• Crée des zones d'interaction et des boîtes de collision
• Définit les limites de l'entité avec des valeurs x/z correspondantes

Os d'étiquette de nom :

• Préfixe : tag_
• Affiche du texte au-dessus des modèles
• Utilisé pour le nommage des entités

Os de rotation de la tête :

• Préfixe : h_
• Pivote en fonction de la position de la tête du joueur/de l'entité
• Suit automatiquement le mouvement de la tête

Utilisation :

Créez un os dans BlockBench avec l'un de ces noms spéciaux, et le plugin applique automatiquement la fonctionnalité correspondante.

FAQ de dépannage

Au lieu de modèles personnalisés, je ne vois que de l'armure de cheval.

Infos

Si, au lieu de voir des modèles personnalisés dans votre jeu, vous ne voyez que de l'armure de cheval, le problème est très probablement que vous n'avez pas correctement fusionné le resource pack FMM avec votre resource pack préexistant.

MagmaGuy a développé un plugin appelé Resource Pack Manager (RSPM) qui peut automatiquement fusionner les resource packs pour vous. Vous pouvez le télécharger depuis Spigot ici.

Il suffit de déposer le fichier .jar de RSPM dans votre dossier plugins, et RSPM s'occupera de tout. Il fusionnera tous les resource packs, les hébergera automatiquement et les distribuera aux joueurs lorsqu'ils se connecteront à votre serveur.

Pourquoi ne puis-je pas voir mon modèle après avoir ajouté le fichier .bbmodel ?

Infos

Si votre modèle n'apparaît pas, vérifiez ces problèmes courants :

1. Oubli de recharger

Exécutez /fmm reload après avoir placé les fichiers .bbmodel dans le dossier imports. Cela convertit les modèles et génère le resource pack.

2. Resource pack non appliqué

Les joueurs doivent avoir le resource pack FMM actif pour voir les modèles.

• Vérifiez ~/plugins/FreeMinecraftModels/output/FreeMinecraftModels.zip pour le pack généré
• Installez Resource Pack Manager pour la distribution automatique
• OU distribuez manuellement via server.properties ou un service d'hébergement

3. Mauvais emplacement de fichier

Les fichiers .bbmodel pour les importations manuelles doivent aller dans : ~/plugins/FreeMinecraftModels/imports/

Si vous utilisez des packs de contenu officiels à la place, utilisez /fmm setup ou /fmm downloadall plutôt que de déposer les fichiers manuellement.

4. Le modèle contient des erreurs

Vérifiez les journaux de la console pour les messages d'erreur lors de /fmm reload. Les problèmes courants incluent les rotations non supportées, les modèles surdimensionnés ou les problèmes de textures.

5. Problème de fusion de resource packs

Si vous voyez de l'armure de cheval au lieu de modèles, les resource packs n'ont pas été correctement fusionnés. Utilisez Resource Pack Manager (RSPM) pour gérer la fusion automatiquement.

ViaVersion peut empêcher les resource packs de s'afficher correctement.

Infos

ViaVersion peut causer des problèmes avec les resource packs, particulièrement lorsque vous utilisez un serveur sur une version inférieure à 1.21.4. Minecraft a introduit des changements dans la gestion des resource packs à partir de la version 1.21.4. Si vous utilisez un serveur en version 1.21.3 par exemple et utilisez ViaVersion pour permettre aux clients 1.21.4 de se connecter, ces clients peuvent rencontrer des problèmes d'affichage de certains contenus de resource packs, comme les modèles personnalisés de FMM (FreeMinecraftModels).

Cela se produit parce que le système de resource packs dans Minecraft a changé avec la mise à jour 1.21.4.

Note : C'est une limitation de Minecraft et ViaVersion, pas spécifique à FreeMinecraftModels. La traduction de protocole de ViaVersion peut ne pas supporter entièrement les changements de resource packs lorsque le serveur tourne sur des versions inférieures à 1.21.4.

Pour résoudre ce problème, envisagez de mettre à jour votre serveur vers la version 1.21.4 ou supérieure, car cela garantira une meilleure compatibilité avec les fonctionnalités modernes de resource packs, y compris les modèles personnalisés FMM.

Pourquoi mes modèles causent-ils du lag ou des problèmes de performance ?

Infos

Chaque os de votre modèle BlockBench crée une entité séparée dans Minecraft. Les modèles avec beaucoup d'os peuvent impacter les performances du serveur.

Conseils d'optimisation :

• Minimisez le nombre d'os dans vos modèles
• Limitez le nombre de modèles générés
• Envisagez d'utiliser des modèles statiques au lieu de modèles dynamiques lorsque les animations ne sont pas nécessaires
• Évitez de faire apparaître plusieurs modèles avec beaucoup d'os à proximité les uns des autres

Explication technique :

FreeMinecraftModels rend chaque os comme une entité Minecraft séparée. Un modèle avec 50 os génère 50 entités. À grande échelle, cela impacte les performances.

Bonnes pratiques :

• Concevez des modèles avec moins d'os
• Testez les performances avec des quantités réalistes de spawns
• Surveillez le TPS du serveur lorsque vous ajoutez de nouveaux modèles

Fonctionnalités avancées

Ai-je besoin de Resource Pack Manager (RSPM) ?

Infos

Resource Pack Manager (RSPM) est optionnel mais fortement recommandé.

Ce que fait RSPM :

• Fusionne automatiquement les resource packs de plusieurs plugins
• Héberge les resource packs (pas d'hébergement externe nécessaire)
• Distribue les packs aux joueurs automatiquement à la connexion
• Élimine la configuration manuelle des resource packs

Sans RSPM :

Vous devez manuellement :

• Fusionner le resource pack FMM avec les resource packs existants du serveur
• Héberger le pack fusionné sur un service externe ou via server.properties
• Configurer le serveur pour envoyer le pack aux joueurs
• Mettre à jour le pack à chaque ajout de nouveaux modèles

Pourquoi utiliser RSPM :

La plupart des problèmes « armure de cheval au lieu de modèles » sont causés par une fusion incorrecte des resource packs. RSPM gère cela automatiquement.

Télécharger RSPM : https://www.spigotmc.org/resources/resource-pack-manager.118574/

Développé par MagmaGuy, le même auteur que FreeMinecraftModels.

Puis-je utiliser FreeMinecraftModels dans mon propre plugin ?

Infos

Oui, FreeMinecraftModels fournit une API pour les développeurs.

Intégration Maven/Gradle :

Dépôt : https://repo.magmaguy.com/releases

Artefact :

• GroupId : com.magmaguy
• ArtifactId : FreeMinecraftModels
• Scope : provided (doit être installé sur le serveur, ne pas shader)

Classes API principales :

• ModeledEntity (classe de base)
• StaticEntity
• DynamicEntity
• PropEntity

Exemple d'utilisation :

StaticEntity staticEntity = StaticEntity.create(id, location);
if (staticEntity == null) {
    Bukkit.getLogger().warning("Failed to create model");
    return;
}
staticEntity.setRightClickCallback(...);
staticEntity.remove();

Important :

Ne shadez pas FreeMinecraftModels dans votre plugin. Il doit être installé séparément sur le serveur.

Pour la documentation détaillée de l'API, consultez le README officiel.

Comment déguiser un joueur en modèle personnalisé ?

Infos

La commande /fmm disguise transforme l'apparence d'un joueur en n'importe quel modèle personnalisé.

Commande :

/fmm disguise <modelID>

Comment ça fonctionne :

• Rend le joueur invisible aux autres joueurs
• Superpose le modèle personnalisé sur la position du joueur
• Le modèle suit les mouvements du joueur
• Parfait pour les serveurs roleplay ou les événements spéciaux

Exemple :

/fmm disguise dragon

Pour supprimer le déguisement :

/fmm undisguise

Prérequis :

• Permission : freeminecraftmodels.*
• modelID doit être un modèle converti valide dans votre dossier models

Notes :

• La hitbox du joueur reste inchangée (même boîte de collision)
• Les autres joueurs voient le modèle personnalisé au lieu de votre skin de joueur
• L'effet d'invisibilité est permanent jusqu'à ce que vous retiriez le déguisement

Comment créer des objets de modèle plaçables ?

Infos

La commande /fmm itemify crée des objets spéciaux que les joueurs peuvent utiliser pour placer des modèles dans le monde.

Commande :

/fmm itemify <model> <material>

Paramètres :

• model - N'importe quel identifiant de modèle valide de votre dossier models
• material - N'importe quel matériau Minecraft (STICK, PAPER, DIAMOND, etc.)

Exemple :

/fmm itemify lamp_post STICK

Ce que cela crée :

• Un objet personnalisé avec un nom d'affichage décoré en or (ex : "✦ Wolf ✦")
• Une description explicative sur l'objet
• L'objet est ajouté directement à votre inventaire
• Clic droit pour placer le modèle en tant que prop

Cas d'utilisation :

• Donner aux joueurs des objets pour décorer leurs constructions
• Créer des « oeufs d'apparition » personnalisés pour du mobilier
• Distribuer des modèles sans donner de permissions de construction
• Kits de configuration pour la construction créative

Prérequis :

• Permission : freeminecraftmodels.*
• Le joueur doit être en jeu (pas depuis la console)

Comment déboguer les hitboxes des modèles ?

Infos

La commande /fmm hitbox visualize visualise les hitboxes des modèles en utilisant des particules.

Commande :

/fmm hitbox visualize [duration]

Paramètres :

• duration (optionnel) - Durée d'affichage des hitboxes en ticks (défaut : 100, max : 1200)
• 20 ticks = 1 seconde

Exemples :

/fmm hitbox visualize          # Afficher pendant 5 secondes
/fmm hitbox visualize 200      # Afficher pendant 10 secondes

Comment ça fonctionne :

• Recherche les modèles dans un rayon de 10 blocs autour de vous
• Affiche les limites de la boîte englobante orientée (OBB) avec des particules
• Montre à la fois le modèle et ses limites de collision
• Utile pour vérifier la taille et la rotation des hitboxes

Quand l'utiliser :

• Tester si les hitboxes correspondent aux modèles visuels
• Déboguer les problèmes d'interaction
• Vérifier les rotations des hitboxes
• Résoudre les problèmes de détection de clics

Prérequis :

• Permission : freeminecraftmodels.*

Note : Les hitboxes dans FMM pivotent avec le modèle, contrairement aux AABB standard de Minecraft.

Puis-je créer des modèles personnalisés montables ?

Infos

Oui, utilisez la commande /fmm mount pour créer des modèles personnalisés montables (fonctionnalité expérimentale).

Commande :

/fmm mount <modelID>

Ce que ça fait :

• Fait apparaître un cheval à votre position
• Déguise le cheval en votre modèle personnalisé
• Apprivoise automatiquement le cheval et ajoute une selle
• Vous fait monter le cheval immédiatement

Exemple :

/fmm mount dragon

Prérequis :

• Permission : freeminecraftmodels.*
• Identifiant de modèle valide

Notes importantes :

• Cette fonctionnalité est marquée comme expérimentale
• La vitesse de déplacement et le comportement correspondent à un cheval standard
• La hitbox du cheval reste inchangée
• Fonctionne mieux avec des modèles conçus pour être des montures

Cas d'utilisation :

• Montures personnalisées pour les serveurs roleplay
• Transport spécial pour les joueurs VIP
• Créatures montables uniques pour les cartes d'aventure