Commandes FreeMinecraftModels
registerCraftingRecipes dans config.yml vaut true par défaut. Passez-le à false et redémarrez pour une économie fondée uniquement sur les achats : les recettes restent visibles dans les menus et la boutique, mais leurs recettes Bukkit sont retirées. Les instructions de fabrication de cette page nécessitent true.
Utilisez /freeminecraftmodels ou /fmm.
Installation et gestion de contenu
| Commande | Rôle |
|---|---|
/fmm | Ouvre le menu d'objets craftables pour les joueurs (voir Menu des objets craftables 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 compagnons qui se marient bien avec FreeMinecraftModels (ouvre un menu catalogue pour les joueurs, affiche une 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é nécessite quant à lui toujours un redémarrage du serveur. 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 (appliquée après le prochain redémarrage du serveur) |
/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 | Ré-importe le contenu et régénère la sortie du pack |
/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> | Enregistre le jeton de compte Nightbreak partagé pour ce serveur, débloquant les téléchargements de contenu officiel et les mises à jour du plugin (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 |
/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.
Spawn et placement de modèles
| Commande | Rôle |
|---|---|
/fmm spawn static <id> | Fait apparaître un modèle statique |
/fmm spawn dynamic <id> | Fait apparaître un modèle dynamique |
/fmm spawn prop <id> | Crée une entrée de prop persistante et la fait apparaître. 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 plaçable qui fait apparaître le modèle choisi en tant que prop |
/fmm mount <id> | Fait apparaître une monture chevauchable expérimentale utilisant un cheval déguisé |
/fmm giveitem <item> | Donne un objet FMM personnalisé au joueur (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 |
Déguisements de 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 dont chacun est déguisé (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 sont rendus invisibles aux autres joueurs afin que seul le modèle soit visible. L'invisibilité persiste à travers les seaux de lait et autres interactions qui suppriment les effets.
- Les plugins tiers peuvent piloter les déguisements via la
DisguiseAPIpublique (voir API et guide développeur).
Boutique de mobilier
| Commande | Rôle |
|---|---|
/fmm shop | Ouvre la boutique de mobilier optionnelle adossée à Vault où les joueurs peuvent acheter des props craftables 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: truedansshop_config.yml- Vault est installé
- Un fournisseur d'économie compatible Vault est enregistré
Lorsque l'un de ces éléments manque, /fmm shop n'est pas enregistré (ou affiche le message « boutique désactivée » configurable s'il est désactivé de force au runtime). Voir Configuration pour les clés de config de la boutique et les champs par recette shopEnabled / shopPrice.
Utilitaires
| Commande | Rôle |
|---|---|
/fmm hitbox visualize [duration] | Visualise les hitboxes pour le débogage |
/fmm location | Commande de diagnostic — rapporte combien de détecteurs de donjon et de fournisseurs de protection sont enregistrés avec LocationAPI, et teste les deux prédicats sur votre position actuelle (permission : freeminecraftmodels.*) |
/fmm debug <bedrock|props> [on|off] | Bascules au runtime pour les flux de logs de diagnostic de FMM. bedrock bascule le flux [FMM-BedrockDebug] qui diagnostique le pipeline d'affichage Bedrock ; props bascule le scan des props empilés, qui fait signaler à chaque chargement de chunk toute paire de props situés à moins de 0,1 bloc l'un de l'autre sous la forme STACKED PROPS DETECTED. Omettez l'argument d'état pour connaître l'état actuel sans le modifier. on/true/enable/enabled et off/false/disable/disabled sont tous acceptés. Les deux bascules se réinitialisent toujours sur OFF au rechargement du plugin — ce ne sont volontairement pas des clés de config afin qu'elles ne puissent pas rester activées par accident. Accepte les joueurs et la console (permission : freeminecraftmodels.*) |
/fmm packetdebug [ticks] | Diagnostic ponctuel de charge en paquets. Échantillonne le trafic de paquets des entités modélisées pendant les [ticks] prochains ticks d'horloge de modèle (défaut 1, plafonné à 200) et rapporte les paquets logiques/tick, les paquets réellement délivrés/tick y compris la diffusion par spectateur, le pire joueur/tick, une répartition par type de paquet et les spectateurs les plus lourds. Complète par tabulation 1, 5, 20, 60. Exécutez-la en vous tenant dans la zone qui lague. Les comptages de paquets sont exacts ; les valeurs en octets sont des estimations. Expire avec un avertissement si aucun échantillon n'aboutit (aucune entité modélisée chargée, ou NMS désactivé). Accepte les joueurs et la console (permission : freeminecraftmodels.*) |
/fmm deleteall [radius] | Supprime toutes les entités modélisées chargées et les props persistants. Sans argument, efface tout ; un [radius] optionnel (réservé aux joueurs) limite la suppression aux entités situées dans ce rayon de blocs autour du joueur |
Comportement de placement des props
Lorsqu'un joueur clique droit avec un objet de prop en papier (créé via /fmm itemify ou fabriqué via une recette /fmm craftify), ce qui suit s'applique :
- Consommation de l'objet : l'objet en papier est consommé lorsque le prop est placé, sauf si le joueur est en mode Créatif.
- Rotation : les props sont placés face à la direction du joueur, alignés sur des incréments de rotation de 10 degrés. Cela donne aux joueurs un contrôle précis sur l'orientation du prop simplement en ajustant leur regard avant le placement.
- 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 uniquement : seule la moitié « main principale » de l'événement d'interaction place un prop, de sorte qu'un simple clic droit ne peut plus produire deux props.
- Nettoyage des doublons : au démarrage du serveur et à chaque chargement de chunk, FreeMinecraftModels recherche les porte-armures de props partageant un modèle et un bloc, en garde 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 craftables
Exécuter /fmm sans arguments ouvre un menu d'inventaire pour les joueurs affichant tous les objets craftables qui ont été configurés avec des recettes.
- Chaque objet du menu représente un objet FMM craftable.
- Cliquer sur un objet ouvre un sous-menu détaillé qui affiche la grille d'artisanat spatiale 3x3, une flèche et l'objet de sortie — montrant au joueur exactement comment le fabriquer dans une table de craft.
- Nécessite la permission
freeminecraftmodels.menu(défaut :true, disponible pour tous les joueurs).
Navigateur de contenu admin
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 vous permet de créer une recette de table de craft vanilla pour n'importe quel modèle de prop.
- Exécutez
/fmm craftify <model_id>pour ouvrir l'UI de l'éditeur de recettes. - Un inventaire personnalisé s'ouvre avec une grille de craft 3×3 et un objet de sortie pré-rempli.
- Placez les ingrédients de votre inventaire dans la grille selon le motif voulu.
- Cliquez sur l'objet de sortie (l'objet en papier du prop) pour enregistrer la recette.
- Des particules et un son confirment l'enregistrement.
- La recette est enregistrée dans
plugins/FreeMinecraftModels/recipes/<model_id>.ymlet enregistrée immédiatement. - Les joueurs peuvent désormais fabriquer l'objet prop dans n'importe quelle table de craft.
- Appuyez sur Échap pour annuler sans enregistrer — les ingrédients sont rendus à votre inventaire.
- Exécuter craftify à nouveau pour le même modèle écrase la recette précédente.
- Les recettes persistent entre les redémarrages et les reloads 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 | oui (défaut true) | Mettez false pour désenregistrer la recette sans supprimer le fichier |
model_id | oui | Le modèle que place l'objet en papier fabriqué. Un ID de modèle portant un suffixe d'état d'arc/arbalète est automatiquement réécrit vers l'ID de modèle de base |
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é de recette Bukkit enregistrée est freeminecraftmodels:prop_recipe_<model_id>, et la sortie est toujours l'objet en papier de placement du modèle. Réexécuter /fmm craftify pour le même modèle écrase le fichier et réenregistre sous la même clé.
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 et freeminecraftmodels.bypassregionprotection. 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 location, /fmm setup, /fmm initialize, /fmm recommendedplugins, /fmm downloadall, /fmm downloadallcontent, /fmm updatecontent, /fmm downloadpluginupdate 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 | Autorise le placement et l'interaction avec les props partout où un autre plugin bloquerait le placement normal de blocs, même lorsque preventPropPlacementInProtectedRegions est activé |
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.
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é |
Notes sur l'expéditeur
initialize,setup,spawn,itemify,mount,giveitem,craftify,hitbox visualize,location,adminetshopsont des commandes réservées aux joueurs./freeminecraftmodelschangelogl'est également.recommendedplugins,downloadall,downloadallcontent,updatecontent,downloadpluginupdate,forcereinstallcontent,packetdebug,debug,deleteall,/nightbreakloginet/nightbreaklogoutacceptent les joueurs et la console (un rayondeleteallest réservé aux joueurs).disguiseetundisguiseacceptent un joueur cible et peuvent être exécutées depuis la console tant qu'une cible est fournie.versionn'a aucune restriction de permission et peut être exécutée par tout le monde (joueurs ou console)./fmm initializeouvre le menu de première configuration pour les joueurs disposant defreeminecraftmodels.*. Utilisez/fmm setuppour la gestion quotidienne du contenu.