Commandes FreeMinecraftModels

registerCraftingRecipes vaut true par défaut dans config.yml. Passez à false et redémarrez pour une économie fondée uniquement sur les achats : les entrées valides et activées restent dans le catalogue de la boutique, mais sont retirées de la fabrication Bukkit et du menu de fabrication /fmm des joueurs. Les instructions de fabrication ci-dessous nécessitent true.

Utilisez /freeminecraftmodels ou /fmm.

Installation et gestion du contenu

Commande	Rôle
/fmm	Ouvre le menu des objets fabricables pour les joueurs (voir le menu des objets fabricables ci-dessous)
/fmm admin	Ouvre le navigateur de contenu admin — parcourez les packs installés, dossiers, modèles et objets personnalisés (permission : freeminecraftmodels.admin)
/fmm setup	Ouvre le menu de gestion de contenu / configuration initiale réservé aux joueurs (la commande vers laquelle les joueurs sont dirigés au premier démarrage)
/fmm recommendedplugins	Affiche les plugins complémentaires recommandés pour FreeMinecraftModels : catalogue dans un menu pour les joueurs, liste pour la console
/fmm downloadall	Télécharge la dernière mise à jour du plugin et tout le contenu officiel disponible. Si le contenu a changé, FMM recharge pour l'appliquer. Le jar du plugin téléchargé prend effet après un redémarrage, après /fmm applypluginupdate, ou selon le réglage nightbreak.applyPluginUpdatesWithoutRestart. Si l'étape de mise à jour du plugin échoue faute de jeton Nightbreak ou sur un échec d'authentification, l'étape du contenu est entièrement ignorée
/fmm downloadallcontent	Télécharge tout le contenu officiel disponible (contenu uniquement, sans mise à jour du jar du plugin) et recharge si au moins un pack a changé
/fmm updatecontent	Télécharge les mises à jour du contenu officiel obsolète et recharge si au moins un pack a changé (alias : /fmm updateallcontent)
/fmm downloadpluginupdate	Télécharge uniquement la dernière mise à jour du jar du plugin. Elle prend effet après le prochain redémarrage, sauf si vous exécutez /fmm applypluginupdate ou définissez nightbreak.applyPluginUpdatesWithoutRestart
/fmm applypluginupdate	Applique une mise à jour du plugin déjà téléchargée sans redémarrer le serveur. FMM et chaque plugin MagmaGuy activé qui en dépend (depend ou softdepend) sont désactivés, le jar est remplacé, puis ils sont rechargés et réactivés. Refusée lorsqu'aucune mise à jour plus récente n'est en attente ou lorsqu'un plugin d'un autre auteur dépend de FMM. Si le nouveau jar ne parvient pas à s'activer, l'ancien jar est rechargé et la mise à jour reste en attente pour le prochain redémarrage. Accepte les joueurs et la console (permission : freeminecraftmodels.*)
/fmm forcereinstallcontent <package|all>	Commande de réparation — re-télécharge le contenu que vous possédez déjà, même lorsque les numéros de version indiquent qu'il est à jour. L'autocomplétion propose all ainsi que chaque slug de pack Nightbreak. all couvre tous les packs détectés comme téléchargés ; si les fichiers d'un pack sont entièrement absents, indiquez son slug directement. Recharge ensuite (permission : freeminecraftmodels.*)
/fmm reload	Importe et valide les objets, enchantements et recettes de props définis par les auteurs, puis réinitialise complètement configurations, recettes, modèles et sortie du pack en cas de réussite. La validation peut refuser le rechargement en conservant le catalogue actuel actif
/fmm version	Affiche la version du plugin (aucune permission requise -- tout le monde peut l'exécuter)
/fmm stats	Affiche les statistiques des modèles chargés

Commandes Nightbreak partagées

Celles-ci sont enregistrées par MagmaCore plutôt que par FreeMinecraftModels lui-même : ce sont donc des commandes de premier niveau, et non des sous-commandes de /fmm.

Commande	Rôle
/nightbreaklogin [token]	Lie ce serveur à votre compte Nightbreak, débloquant les téléchargements de contenu officiel et les mises à jour du plugin. Sans jeton, affiche un lien nightbreak.io à approuver ; avec un jeton, enregistre ce jeton (permission : nightbreak.login, défaut : op). Enregistrée une seule fois par serveur — le premier plugin Nightbreak chargé en devient propriétaire
/nightbreaklogout	Efface le jeton de compte Nightbreak enregistré sur ce serveur (permission : nightbreak.login, défaut : op). Accepte les joueurs et la console
/nightbreak plugins	Affiche le catalogue des plugins Nightbreak, sous forme de menu pour les joueurs et de liste dans le chat pour la console (permission : nightbreak.plugins, défaut : op). Enregistrée une seule fois par serveur, comme /nightbreaklogin. Voir Configuration de Nightbreak et gestion de contenu
/freeminecraftmodelschangelog [dismiss|disable]	Affiche les notes de version FreeMinecraftModels non lues (versions du plugin et packs de contenu suivis). dismiss marque comme lues les notes actuellement affichées ; disable masque définitivement les rappels de changelog pour vous. Réservée aux joueurs et aux admins — un joueur a besoin de freeminecraftmodels.*, de l'une des permissions setup/admin, ou d'être OP. Si un autre plugin possède déjà le libellé /freeminecraftmodelschangelog, la commande s'enregistre sous un repli avec espace de noms tel que /freeminecraftmodels:freeminecraftmodelschangelog

Les admins ayant des notes de version non lues reçoivent un rappel dans le chat à la connexion, avec une invite cliquable [VIEW CHANGELOG] ; la vue résumé propose des boutons Dismiss These Updates et Never Show Changelogs qui font la même chose que les deux sous-commandes. L'état de lecture par joueur est stocké dans plugins/FreeMinecraftModels/nightbreak-changelogs.yml.

Apparition et placement des modèles

Commande	Rôle
/fmm spawn static <id>	Fait apparaître un modèle statique au-dessus du bloc visé, avec un rayon de détection des blocs allant jusqu'à 300 blocs
/fmm spawn dynamic <id>	Fait apparaître un modèle sur un cochon masqué au-dessus du bloc visé, avec le même rayon de 300 blocs
/fmm spawn prop <id>	Fait apparaître un prop persistant à la position actuelle du joueur. Refuse avec A prop of that model already exists on this block. si un prop du même modèle est déjà chargé sur ce bloc
/fmm itemify <id> <material>	Crée un objet de placement utilisant le matériau Bukkit indiqué. Utilisez son nom d'énumération en majuscules, comme PAPER. L'objet reprend le name et le lore du .yml du prop lorsqu'ils sont définis. Cela ne crée pas un objet tenu défini par l'auteur
/fmm mount <id> [scale]	Fait apparaître une monture chevauchable expérimentale : un cheval apprivoisé et sellé portant le modèle, que vous montez et dirigez. L'échelle facultative, supérieure à 0 et jusqu'à 16, règle la taille du cheval et de son modèle ; la complétion par tabulation propose 1.0, 2.0 et 3.0. Voir les modèles personnalisés chevauchables
/fmm giveitem <item>	Donne au joueur un objet FMM enregistré et défini par l'auteur ; les identifiants ne sont pas sensibles à la casse (permission : freeminecraftmodels.admin)
/fmm craftify <id>	Ouvre un éditeur de recette interactif — placez les ingrédients dans une grille 3×3 puis cliquez sur la sortie pour enregistrer une recette d'artisanat pour ce prop

Les commandes d'apparition directe n'exécutent pas les contrôles de protection et d'espace libre de l'objet de placement. Gardez une case d'inventaire libre pour itemify et giveitem : leurs gestionnaires ignorent les objets qui ne tiennent pas dans l'inventaire au lieu de les déposer au sol.

Déguisements des joueurs

Commande	Rôle
/fmm disguise <modelID> [player]	Déguise un joueur en modèle chargé. Sans argument cible, déguise l'expéditeur. Avec une cible, nécessite freeminecraftmodels.disguise.self + freeminecraftmodels.disguise.others et fonctionne depuis la console
/fmm undisguise [player]	Retire le déguisement. Sans cible, retire celui de l'expéditeur. Avec une cible, nécessite freeminecraftmodels.disguise.self + freeminecraftmodels.disguise.others et fonctionne depuis la console
/fmm disguiselist	Liste les joueurs actuellement déguisés et le modèle utilisé par chacun (permission : freeminecraftmodels.disguise.others)

Comportement du déguisement :

• Déguiser remplace proprement tout déguisement précédent sur ce joueur.
• Les joueurs déguisés et leur équipement sont masqués aux observateurs. Si le déguisement a ajouté l'effet d'invisibilité, il le rétablit après le lait, la suppression des effets et la réapparition. Une invisibilité déjà présente avant le déguisement n'est ni gérée ni restaurée par ce mécanisme.
• Les plugins tiers peuvent piloter les déguisements via la DisguiseAPI publique (voir API et guide développeur).

Familiers

Commande	Rôle
/fmm pets	Ouvre votre menu de familiers, où vous emmenez vos familiers avec vous ou les renvoyez chez eux (permission : freeminecraftmodels.pets)
/fmm petadmin mode [creatures|cosmetic]	Affiche le mode des familiers, ou le change et l'enregistre dans pets.yml (permission : freeminecraftmodels.pets.admin)
/fmm petadmin list	Liste les espèces de familiers chargées avec leur fichier, leur modèle, leur corps, leur nourriture d'apprivoisement et leur nourriture de reproduction (permission : freeminecraftmodels.pets.admin)
/fmm petadmin spawn <species>	Fait apparaître un familier sauvage de l'espèce au-dessus du bloc que vous regardez, jusqu'à 12 blocs de distance. Fonctionne uniquement en mode CREATURES (permission : freeminecraftmodels.pets.admin)
/fmm petadmin give <species>	Ajoute un adulte de l'espèce à votre propre collection de familiers (permission : freeminecraftmodels.pets.admin)
/fmm petmigrate [species]	Envoie dès maintenant une volée de migration nocturne au-dessus de vous, quelle que soit l'heure ou l'état du ciel (permission : freeminecraftmodels.pets.admin)

Voir Familiers pour les fichiers d'espèce, pets.yml et les deux modes de familiers.

Boutique de mobilier

Commande	Rôle
/fmm shop	Ouvre la boutique facultative utilisant Vault, où les joueurs achètent des props fabricables avec la monnaie du jeu (permission : freeminecraftmodels.shop, défaut : true)

La boutique est désactivée par défaut et ne s'enregistre que lorsque :

• enabled: true dans shop_config.yml
• Vault est installé
• Un fournisseur d'économie compatible Vault est enregistré

Si un prérequis manque, /fmm shop n'est pas enregistrée. Une boutique activée sans Vault ou fournisseur d'économie journalise un avertissement. Un gestionnaire enregistré peut renvoyer le message de désactivation si la configuration ou la connexion en cache indique cet état ; il ne détecte pas continuellement la disparition du fournisseur. Consultez la configuration pour les paramètres de la boutique et les champs shopEnabled / shopPrice de chaque recette.

Utilitaires

Commande	Rôle
/fmm hitbox visualize [duration]	Visualise les hitboxes des modèles à moins de 10 blocs dans le même monde et affiche leurs entités sous-jacentes. La durée est en ticks et vaut 100 par défaut (cinq secondes) ; les valeurs non positives ou non numériques utilisent 100, celles supérieures à 1200 utilisent 1200
/fmm location	Indique les détecteurs de donjon et fournisseurs de protection enregistrés et interroge is_in_dungeon / is_protected à votre position. Ces prédicats de lieu ne sont pas le contrôle de placement tenant compte du joueur (permission : freeminecraftmodels.*)
/fmm debug <bedrock|props> [on|off]	Active ou désactive les journaux [FMM-BedrockDebug] ou la recherche STACKED PROPS DETECTED de paires de props à 0,1 bloc pendant les opérations de nettoyage. Sans état, indique si cet indicateur est activé. Accepte aussi true/enable/enabled et false/disable/disabled. Les deux acceptent joueurs et console (permission : freeminecraftmodels.*)
/fmm packetdebug [ticks]	Échantillonne le trafic des entités modélisées pendant le nombre indiqué de ticks de l'horloge des modèles, 1 par défaut, limité à 1–200 (les entiers invalides utilisent 1). Indique les paquets logiques et livrés par tick, leur diffusion aux observateurs, le maximum par joueur/tick, les types de paquets et les observateurs les plus sollicités. Complète 1, 5, 20, 60. Exécutez dans la zone concernée. Les comptes sont exacts pour le trafic instrumenté ; les octets sont estimés. Un seul échantillonnage peut s'exécuter à la fois. Avertit après 400 ticks serveur sans nouvel échantillon. Accepte joueurs et console (permission : freeminecraftmodels.*)
/fmm filmic [on|off]	Active ou désactive temporairement le mode filmique pour enregistrer des vidéos avec ReplayMod. Chaque joueur reçoit alors tous les modèles chargés dans ses chunks chargés, même hors de vue, et ces modèles continuent de s'animer. Déconseillé en dehors des enregistrements : il consomme beaucoup de bande passante et de performances serveur. Il ne modifie jamais config.yml ; le réglage dure jusqu'au redémarrage du serveur, ou jusqu'à ce que filmicMode soit modifié dans config.yml et que FMM recharge. Sans argument, indique l'état actuel et s'il provient de la commande ou de config.yml. Accepte joueurs et console (permission : freeminecraftmodels.*)
/fmm boneglide [ticks]	Définit temporairement riddenBoneInterpolationTicks, le nombre de ticks que les clients Java mettent à faire glisser un os de modèle passager vers sa pose suivante. 0 le place directement sur sa pose. Accepte 0 à 59 et propose 0 à 3 à la complétion par tabulation. Sans argument, indique la valeur actuelle. Il ne modifie jamais config.yml ; la valeur de config.yml revient quand FMM recharge. Accepte joueurs et console (permission : freeminecraftmodels.*)
/fmm deleteall [radius]	Supprime toutes les entités modélisées actuellement chargées dans tous les mondes, en supprimant définitivement les props chargés. Ne recherche pas les props déchargés. Un rayon entier positif est réservé aux joueurs et limite la suppression à leur monde et à cette distance

Les indicateurs de débogage ne sont pas sauvegardés sur disque, mais /fmm reload ne les réinitialise pas. Désactivez explicitement les journaux après avoir recueilli les preuves ; un nouveau démarrage du serveur initialise les deux à l'état désactivé.

Comportement du placement des props

Lorsqu'un joueur clique droit avec un objet de placement provenant d'itemify, de la fabrication ou de la boutique, les règles suivantes s'appliquent. Les objets tenus définis par les auteurs sont exclus de ce gestionnaire.

• Consommation : un objet est consommé après un placement réussi, sauf en mode Créatif.
• Cible : cliquer sur un bloc utilise le bloc et la face de l'événement d'interaction. Cliquer dans l'air lance une détection jusqu'à cinq blocs. Les props libres utilisent le centre de la face ; les props voxelisés utilisent le bloc adjacent et un volume aligné sur la grille
• Rotation : les props font face à la position du joueur par rapport au point de placement, pas simplement à l'angle de son regard. Le placement libre utilise des pas de 10 degrés ; le placement voxelisé, de 90 degrés
• Un prop par modèle et par bloc : le placement est refusé avec A prop of that model already exists on this block. lorsqu'un prop du même modèle est déjà chargé sur ce bloc. L'objet n'est pas consommé lors d'un placement refusé.
• Main principale et délai : seules les interactions de la main principale placent des props. Les tentatives ont un délai de 500 ms, y compris celles dont la validation échoue ensuite
• Protection et espace : la requête de protection configurée vérifie la case adjacente. Les props voxelisés vérifient ensuite l'espace libre et la protection dans leur volume pivoté. La permission de contournement saute les requêtes de protection. Consultez la configuration pour les limites d'intégration et de couverture des collisions
• Nettoyage des doublons : au démarrage, lors des événements de chargement d'entités et avant une apparition directe de prop, FMM recherche les supports partageant modèle et bloc, en conserve un et supprime les autres. Les suppressions sont journalisées sous la forme [FMM Props] Removed N duplicate prop armor stand(s) ....

Menu des objets fabricables

Exécuter /fmm sans argument ouvre un menu pour les joueurs affichant les entrées de modèles chargés dont les recettes de fabrication sont effectivement enregistrées.

• Chaque entrée représente un objet FMM fabricable.
• Cliquer sur un objet ouvre un sous-menu avec la disposition des ingrédients dans une grille 3x3, une flèche et le résultat, pour montrer exactement comment le fabriquer dans un établi.
• Nécessite la permission freeminecraftmodels.menu (défaut : true, disponible pour tous les joueurs).

Navigateur de contenu administrateur

Exécuter /fmm admin ouvre un menu d'inventaire pour les administrateurs de serveur leur permettant de parcourir :

• Les packs de contenu installés
• Les dossiers et modèles individuels
• Les objets personnalisés (modèles avec material: défini)

Nécessite la permission freeminecraftmodels.admin (défaut : op).

Éditeur de recettes

La commande /fmm craftify crée une recette d'établi vanilla pour n'importe quel modèle de prop.

1. Exécutez /fmm craftify <model_id> pour ouvrir l'éditeur de recettes.
2. Un inventaire personnalisé s'ouvre avec une grille de fabrication 3×3 et un objet de sortie déjà renseigné.
3. Placez les ingrédients de votre inventaire dans la grille selon le motif voulu.
4. Cliquez sur l'objet de sortie (l'objet en papier du prop) pour enregistrer la recette.
5. Une sauvegarde réussie produit des particules, un son et un message de réussite. En cas d'échec de sauvegarde ou d'enregistrement, le menu reste ouvert, les ingrédients restent dans la grille et le joueur reçoit une erreur. FMM tente de restaurer la recette précédemment enregistrée ; consultez la console si cette restauration échoue aussi.
6. La recette est sauvegardée dans plugins/FreeMinecraftModels/recipes/<model_id>.yml ; son enregistrement Bukkit dépend de registerCraftingRecipes.
7. Si l'enregistrement réussit et la fabrication est activée, les joueurs peuvent fabriquer l'objet de prop en papier dans un établi.
8. Appuyez sur Échap avant de sauvegarder pour annuler et récupérer les ingrédients, en déposant le surplus à vos pieds. Sauvegarder vide au contraire les piles entières de la grille ; seuls les matériaux et leur disposition font partie de la recette, pas les quantités ni les métadonnées.
9. Réexécuter craftify pour le même modèle remplace la recette et rétablit ses champs d'activation et de boutique aux valeurs par défaut, prix compris.
10. Les recettes persistent après les redémarrages et les rechargements du serveur.

Format du fichier de recette

isEnabled: true
model_id: "wooden_chair"
shape:
  - "L L"
  - "LLL"
  - "L L"
ingredients:
  L: OAK_LOG
shopEnabled: true
shopPrice: 250.0

Champ	Obligatoire	Notes
isEnabled	non (défaut true)	Définissez false pour désenregistrer la recette sans supprimer le fichier
model_id	oui	Le modèle placé par l'objet en papier fabriqué. Un suffixe d'état d'arc/arbalète est résolu vers l'identifiant de base uniquement si cette base possède un modèle d'affichage enregistré
shape	oui	Jusqu'à trois lignes de trois caractères maximum. Un espace signifie « emplacement vide »
ingredients	oui	Association d'un caractère unique de la forme à un nom de matériau Bukkit. Les matériaux non reconnus sont ignorés silencieusement
shopEnabled	non (défaut true)	Indique si la recette est listée dans /fmm shop
shopPrice	non (défaut defaultPrice depuis shop_config.yml)	Coût en monnaie Vault dans la boutique

La clé Bukkit est freeminecraftmodels:prop_recipe_<model_id> et le résultat est toujours l'objet de placement en papier du modèle, pas un objet tenu défini avec son matériau et ses enchantements. Réexécuter /fmm craftify remplace le fichier et tente l'enregistrement sous la même clé lorsque la fabrication est activée.

FMM lit chaque .yml de recipes/, sous-dossiers compris, et les charge comme un seul catalogue. Chaque model_id ne peut avoir qu'un seul fichier de recette activé. Un second fichier activé pour le même model_id, ou un fichier contenant une erreur de syntaxe YAML, fait refuser /fmm reload en conservant les recettes actuelles et invite l'expéditeur à consulter la console. Au démarrage, le même problème ne rejette que le catalogue de recettes : FMM finit de démarrer sans recettes de props ni entrées de boutique de meubles, jusqu'à ce que vous corrigiez le fichier et exécutiez /fmm reload. Recherchez Prop recipe catalog rejected, Duplicate recipe model ou Cannot prepare prop recipes dans la console.

Permissions

Enregistrées dans plugin.yml

Permission	Défaut	Description
freeminecraftmodels.*	OP	Wildcard qui accorde freeminecraftmodels.admin, freeminecraftmodels.deleteall, freeminecraftmodels.disguise.self, freeminecraftmodels.disguise.others, freeminecraftmodels.bypassregionprotection et freeminecraftmodels.pets.admin. La chaîne wildcard est aussi la permission littérale requise par /fmm reload, /fmm stats, /fmm spawn, /fmm itemify, /fmm craftify, /fmm mount, /fmm hitbox visualize, /fmm debug, /fmm packetdebug, /fmm filmic, /fmm boneglide, /fmm location, /fmm setup, /fmm initialize, /fmm recommendedplugins, /fmm downloadall, /fmm downloadallcontent, /fmm updatecontent, /fmm downloadpluginupdate, /fmm applypluginupdate et /fmm forcereinstallcontent
freeminecraftmodels.admin	OP	Accès à /fmm admin (le navigateur de contenu admin) et /fmm giveitem
freeminecraftmodels.deleteall	OP	Enfant du wildcard ; accès à /fmm deleteall
freeminecraftmodels.disguise.self	OP	Autorise /fmm disguise et /fmm undisguise ciblant uniquement l'expéditeur
freeminecraftmodels.disguise.others	OP	Autorise /fmm disguise <model> <player>, /fmm undisguise <player> et /fmm disguiselist
freeminecraftmodels.bypassregionprotection	OP	Contourne les requêtes de protection de FMM pour le placement et l'interaction avec les props, dont preventPropPlacementInProtectedRegions. Les vérifications d'espace libre restent actives
freeminecraftmodels.menu	true	Accès au menu d'objets craftables /fmm (disponible à tous les joueurs)
freeminecraftmodels.shop	true	Accès à /fmm shop (disponible à tous les joueurs lorsque la boutique est activée)

Les commandes disguise et undisguise visant un joueur nécessitent à la fois freeminecraftmodels.disguise.self et freeminecraftmodels.disguise.others. disguiselist ne nécessite que .others.

Permissions des familiers

Permission	Défaut	Description
freeminecraftmodels.pets	true	Accès à /fmm pets (accessible à tous les joueurs)
freeminecraftmodels.pets.admin	OP	Enfant du wildcard ; accès à /fmm petadmin et /fmm petmigrate

Enregistrées par MagmaCore

Permission	Défaut	Description
nightbreak.login	OP	Requise par les commandes partagées /nightbreaklogin et /nightbreaklogout. Enregistrée une seule fois par serveur par le premier plugin Nightbreak chargé
nightbreak.plugins	OP	Requise par la commande partagée /nightbreak plugins. Enregistrée une seule fois par serveur par le premier plugin Nightbreak chargé

Qui peut exécuter les commandes ?

• initialize, setup, spawn, itemify, mount, giveitem, craftify, hitbox visualize, location, admin, shop, pets, petadmin et petmigrate sont des commandes réservées aux joueurs. /freeminecraftmodelschangelog l'est également.
• reload, stats, recommendedplugins, downloadall, downloadallcontent, updatecontent, downloadpluginupdate, applypluginupdate, forcereinstallcontent, packetdebug, debug, filmic, boneglide, deleteall, /nightbreaklogin, /nightbreaklogout et /nightbreak plugins acceptent les joueurs et la console (un rayon deleteall est réservé aux joueurs).
• disguise et undisguise acceptent un joueur cible et peuvent être exécutées depuis la console tant qu'une cible est fournie.
• version n'a aucune restriction de permission et peut être exécutée par tout le monde (joueurs ou console).
• /fmm initialize ouvre le menu de première configuration pour les joueurs disposant de freeminecraftmodels.*. Utilisez /fmm setup pour la gestion quotidienne du contenu.