Aller au contenu principal

Configuration de FreeMinecraftModels

Cette page couvre les reglages actuels de config.yml qui affectent concretement le setup, le rendu et l'interaction des joueurs.

Emplacement du fichier​

plugins/FreeMinecraftModels/config.yml

Reglages actuellement verifies​

setupDone​

  • Valeur par defaut : false
  • Controle si l'assistance de premiere configuration est consideree comme terminee
  • Les joueurs avec des permissions FreeMinecraftModels larges recoivent un rappel leur demandant d'executer /fmm initialize tant que cette valeur reste a false
  • Le flux de setup change cette valeur pour toi ; tu n'as normalement pas besoin de la modifier a la main

useDisplayEntitiesWhenPossible​

  • Valeur par defaut : true
  • Indique a FreeMinecraftModels de preferer le rendu via display entities lorsque le serveur et le client le permettent
  • Le plugin continue a utiliser une solution de secours si les display entities ne sont pas disponibles
  • Les clients Bedrock sont un cas particulier, donc ne suppose pas que cela force le meme chemin de rendu pour tous les joueurs

maxModelViewDistance​

  • Valeur par defaut : 60
  • Limite la distance a laquelle les entites modelees sont envoyees aux observateurs
  • Des valeurs plus basses reduisent la charge reseau et le rendu cote client dans les zones denses avec beaucoup de modeles

maxInteractionAndAttackDistance​

  • Valeur par defaut : 3
  • S'applique aux entites modelees statiques et dynamiques
  • Utilise par les verifications d'interaction et de collision d'attaque a l'execution

maxInteractionAndAttackDistanceForProps​

  • Valeur par defaut : 6
  • S'applique aux entites de type prop
  • Cette distance est separee de celle utilisee pour les entites statiques et dynamiques

sendCustomModelsToBedrockClients​

  • Valeur par defaut : false
  • Controle si FreeMinecraftModels tente d'envoyer des modeles personnalises aux clients Bedrock
  • Si l'option est desactivee, les joueurs Bedrock reviennent a l'entite vanilla sous-jacente quand elle existe
  • Si tu l'actives, assure-toi que ton chemin de resource pack Bedrock/Geyser/Floodgate est vraiment pret pour ces clients

Notes d'exploitation​

  • /fmm reload reimporte le contenu et regenere le pack de sortie, donc les changements de configuration qui affectent le rendu se verifient le plus facilement apres un reload
  • FreeMinecraftModels genere seulement le resource pack ; il ne l'heberge pas lui-meme
  • ResourcePackManager reste le chemin de distribution recommande pour les clients Java et le chemin le plus surement documente pour les environnements mixtes

Quand modifier ces valeurs​

Utilise cette configuration pour ajuster le comportement a l'execution, pas pour gerer les content packs.

  • Utilise /fmm initialize, /fmm setup, /fmm downloadall et /fmm updatecontent pour le cycle de vie des packs officiels
  • Utilise le dossier imports pour les imports manuels de .bbmodel ou d'autre contenu local
  • Utilise config.yml quand tu dois ajuster le mode de rendu, la distance de visibilite, la distance d'interaction ou le comportement Bedrock

Points d'attention connus​

  • Le depot local a un decalage de metadonnees de version entre plugin.yml et pom.xml, donc cette page documente volontairement le comportement plutot que d'indiquer une version publique fixe
  • Le comportement Bedrock depend a la fois de cette configuration et de ton ensemble Floodgate/Geyser/resource pack, donc garde des formulations prudentes tant que tu n'as pas teste ton propre stack