Saltar al contenido principal

Configuracion de FreeMinecraftModels

Esta pagina cubre la configuracion actual de config.yml que afecta de forma material al setup, al renderizado y a la interaccion de los jugadores.

Ubicacion del archivo​

plugins/FreeMinecraftModels/config.yml

Ajustes verificados actualmente​

setupDone​

  • Valor por defecto: false
  • Controla si la guia de configuracion inicial se considera completada
  • Los jugadores con permisos amplios de FreeMinecraftModels reciben un recordatorio para ejecutar /fmm initialize mientras este valor siga en false
  • El flujo de setup cambia este valor por ti; no necesitas editarlo a mano durante el onboarding normal

useDisplayEntitiesWhenPossible​

  • Valor por defecto: true
  • Indica a FreeMinecraftModels que prefiera el renderizado con display entities cuando la ruta del servidor y del cliente lo permita
  • El plugin sigue usando un modo alternativo cuando las display entities no estan disponibles
  • Los clientes Bedrock son un caso especial, asi que no asumas que esto fuerza la misma ruta de renderizado para todos los jugadores

maxModelViewDistance​

  • Valor por defecto: 60
  • Limita a que distancia se envian las entidades modeladas a los observadores
  • Los valores mas bajos reducen la carga de paquetes y de renderizado del cliente en zonas densas con muchos modelos

maxInteractionAndAttackDistance​

  • Valor por defecto: 3
  • Se aplica a entidades modeladas estaticas y dinamicas
  • Lo usan las comprobaciones de interaccion y deteccion de golpes en tiempo de ejecucion

maxInteractionAndAttackDistanceForProps​

  • Valor por defecto: 6
  • Se aplica a entidades de tipo prop
  • Esto esta separado de la distancia de interaccion para entidades estaticas y dinamicas

sendCustomModelsToBedrockClients​

  • Valor por defecto: false
  • Controla si FreeMinecraftModels intenta enviar modelos personalizados a clientes Bedrock
  • Si esta desactivado, los jugadores de Bedrock vuelven a la entidad vanilla subyacente cuando exista
  • Si lo activas, asegurate de que tu ruta de resource pack para Bedrock/Geyser/Floodgate este realmente preparada para esos clientes

Notas operativas​

  • /fmm reload vuelve a importar el contenido y regenera el paquete de salida, asi que los cambios de configuracion que afectan al renderizado se validan mejor despues de un reload
  • FreeMinecraftModels solo genera el resource pack; no lo aloja por si mismo
  • ResourcePackManager sigue siendo la via recomendada para clientes Java y la via documentada mas segura para entornos mixtos

Cuando deberias cambiar estos valores​

Usa esta configuracion para ajustar el comportamiento en tiempo de ejecucion, no para gestionar paquetes de contenido.

  • Usa /fmm initialize, /fmm setup, /fmm downloadall y /fmm updatecontent para el ciclo de vida de los paquetes oficiales
  • Usa la carpeta imports para importaciones manuales de .bbmodel u otro contenido local
  • Usa config.yml cuando necesites ajustar el modo de renderizado, la distancia de visibilidad, la distancia de interaccion o el comportamiento en Bedrock

Advertencias conocidas​

  • El repositorio local tiene deriva en los metadatos de version entre plugin.yml y pom.xml, asi que esta pagina documenta el comportamiento en vez de fijar una version publica concreta
  • El comportamiento en Bedrock depende tanto de esta configuracion como de tu configuracion general de Floodgate/Geyser/resource pack, asi que conviene mantener afirmaciones conservadoras salvo que hayas probado exactamente tu stack