Aller au contenu principal

Configuration de FreeMinecraftModels

Cette page couvre les paramètres actuels de config.yml qui affectent matériellement la configuration, le rendu et l'interaction avec les joueurs.

Emplacement du fichier​

plugins/FreeMinecraftModels/config.yml

Paramètres actuels vérifiés​

setupDone​

  • Par défaut : false
  • Contrôle si le guide de configuration initiale est considéré comme terminé
  • Les joueurs disposant de permissions étendues FreeMinecraftModels sont rappelés d'exécuter /fmm initialize tant que cette valeur reste false
  • Le flux de configuration modifie cette valeur pour vous ; vous n'avez pas besoin de la modifier manuellement lors de l'intégration normale

useDisplayEntitiesWhenPossible​

  • Par défaut : true
  • Indique à FreeMinecraftModels de préférer le rendu par display entities lorsque le chemin serveur et client le supporte
  • Le plugin revient en mode de secours lorsque les display entities ne sont pas disponibles
  • Les clients Bedrock sont un cas particulier, ne supposez donc pas que cela force le même chemin de rendu pour chaque joueur

maxModelViewDistance​

  • Par défaut : 60
  • Limite la distance à laquelle les entités modélisées sont envoyées aux observateurs
  • Des valeurs plus basses réduisent la charge de paquets et de rendu client dans les zones denses en modèles

maxInteractionAndAttackDistance​

  • Par défaut : 3
  • S'applique aux entités modélisées statiques et dynamiques
  • Utilisé par les vérifications d'interaction et de détection de coups à l'exécution

maxInteractionAndAttackDistanceForProps​

  • Par défaut : 6
  • S'applique aux entités prop
  • Distinct de la distance d'interaction des entités statiques/dynamiques

sendCustomModelsToBedrockClients​

  • Par défaut : false
  • Contrôle si FreeMinecraftModels tente d'envoyer des modèles personnalisés aux clients Bedrock
  • Si désactivé, les joueurs Bedrock reviennent à l'entité vanilla sous-jacente lorsqu'elle existe
  • Si vous l'activez, assurez-vous que votre chemin de resource pack Bedrock/Geyser/Floodgate est réellement prêt pour ces clients

Notes opérationnelles​

  • /fmm reload réimporte le contenu et régénère le pack de sortie, donc les changements de configuration qui affectent le comportement de rendu sont plus faciles à valider après un rechargement
  • FreeMinecraftModels ne fait que générer le resource pack ; il ne l'héberge pas par lui-même
  • ResourcePackManager reste le chemin de distribution recommandé pour les clients Java et le chemin documenté le plus sûr pour les configurations mixtes

Quand modifier ces valeurs​

Utilisez cette configuration pour l'ajustement du comportement à l'exécution, pas pour la gestion des packs de contenu.

  • Utilisez /fmm initialize, /fmm setup, /fmm downloadall et /fmm updatecontent pour le cycle de vie des packs officiels
  • Utilisez le dossier imports pour l'importation manuelle de contenu .bbmodel ou autre contenu local
  • Utilisez config.yml lorsque vous devez ajuster le mode de rendu, la distance de visibilité, la distance d'interaction ou le comportement Bedrock

Mises en garde connues​

  • Le dépôt local présente une dérive des métadonnées de version entre plugin.yml et pom.xml, cette page documente donc intentionnellement le comportement plutôt que d'épingler une chaîne de version publique fixe
  • Le comportement Bedrock dépend à la fois de cette configuration et de votre installation Floodgate/Geyser/resource pack plus large, gardez donc les affirmations conservatrices à moins d'avoir testé votre pile exacte