Configuración de FreeMinecraftModels

Esta página cubre los ajustes actuales de config.yml que afectan materialmente la configuración, el renderizado y la interacción de los jugadores.

Ubicación del Archivo

plugins/FreeMinecraftModels/config.yml

Ajustes Verificados Actuales

setupDone

• Predeterminado: false
• Controla si la guía de configuración inicial se considera completa
• Los jugadores con permisos amplios de FreeMinecraftModels reciben un recordatorio para ejecutar /fmm initialize mientras este permanezca en false
• El flujo de configuración cambia este valor por ti; no necesitas editarlo manualmente durante la incorporación normal

useDisplayEntitiesWhenPossible

• Predeterminado: true
• Indica a FreeMinecraftModels que prefiera el renderizado con display entities cuando el servidor y el cliente lo soporten
• El plugin aún recurre al fallback cuando las display entities no están disponibles
• Los clientes de Bedrock son un caso especial, así que no asumas que esto fuerza la misma ruta de renderizado para cada jugador

maxModelViewDistance

• Predeterminado: 60
• Limita la distancia a la que las entidades modeladas se envían a los espectadores
• Valores más bajos reducen la carga de paquetes y renderizado del cliente en áreas densas con muchos modelos

maxInteractionAndAttackDistance

• Predeterminado: 3
• Se aplica a entidades modeladas estáticas y dinámicas
• Usado por las verificaciones de interacción y detección de impacto en tiempo de ejecución

maxInteractionAndAttackDistanceForProps

• Predeterminado: 6
• Se aplica a entidades prop
• Esto es independiente de la distancia de interacción de entidades estáticas/dinámicas

sendCustomModelsToBedrockClients

• Predeterminado: false
• Controla si FreeMinecraftModels intenta enviar modelos personalizados a clientes de Bedrock
• Si está deshabilitado, los jugadores de Bedrock recurren a la entidad vanilla subyacente donde exista
• Si lo habilitas, asegúrate de que tu ruta de resource pack de Bedrock/Geyser/Floodgate esté realmente lista para esos clientes

Permisos (plugin.yml)

FreeMinecraftModels registra los siguientes permisos en plugin.yml:

Permiso	Predeterminado	Descripción
freeminecraftmodels.*	op	Otorga acceso a todos los comandos de FreeMinecraftModels
freeminecraftmodels.admin	op	Otorga acceso a comandos de administrador como /fmm admin y /fmm giveitem
freeminecraftmodels.menu	true	Otorga acceso al menú de objetos fabricables /fmm (disponible para todos los jugadores por defecto)
freeminecraftmodels.deleteall	op	Otorga acceso a /fmm deleteall

Configuración YML de Modelos

Cada archivo .bbmodel puede tener un archivo .yml acompañante (mismo nombre, mismo directorio) que controla ajustes específicos del modelo. El formato YML unificado soporta los siguientes campos:

isEnabled: true
voxelize: true
solidify: true
scripts:
  - my_script.lua
material: DIAMOND_SWORD
name: "&bFrost Blade"
lore:
  - "&7A sword forged in ice"
  - "&7Deals frost damage"
enchantments:
  - SHARPNESS,3
  - UNBREAKING,2

Campo	Tipo	Descripción
isEnabled	boolean	Si el modelo se carga (predeterminado: true)
scripts	lista de strings	Nombres de archivos de scripts Lua a adjuntar (desde plugins/FreeMinecraftModels/scripts/)
voxelize	boolean	Cuando es true, el prop se ajusta a incrementos de rotación de 90 grados y se alinea a la cuadrícula de bloques al colocarse. La huella se calcula a partir de las dimensiones de la hitbox del modelo (redondeadas a bloques enteros). La colocación verifica que todos los bloques de la huella sean no sólidos.
solidify	boolean	Cuando es true (requiere voxelize: true), se colocan bloques de barrera solo de paquetes en cada bloque de la huella del prop, dándole colisión del lado del cliente. Estas barreras son invisibles y existen solo en paquetes -- no se colocan en el mundo. Las barreras se eliminan automáticamente cuando el prop se recoge o se destruye.
material	string	Un nombre de material de Bukkit (por ejemplo, DIAMOND_SWORD, PAPER). Cuando se establece, el modelo se convierte en un objeto personalizado que los jugadores pueden sostener y equipar
name	string	Nombre para mostrar del objeto personalizado (soporta códigos de color &)
lore	lista de strings	Líneas de descripción para el objeto personalizado (soporta códigos de color &)
enchantments	lista de strings	Encantamientos en formato ENCHANTMENT_NAME,LEVEL (por ejemplo, SHARPNESS,3)

Cuando material está establecido, el modelo se registra como un objeto personalizado. Los jugadores pueden recibirlo vía /fmm giveitem, fabricarlo si una receta está configurada, y obtiene acceso a los 22 hooks Lua de objetos.

Notas Operativas

• /fmm reload re-importa contenido y regenera el pack de salida, por lo que los cambios de configuración que afectan el comportamiento de renderizado son más fáciles de validar después de una recarga
• FreeMinecraftModels solo genera el resource pack; no lo aloja por sí mismo
• ResourcePackManager sigue siendo la ruta de entrega recomendada para clientes Java y la ruta documentada más segura para configuraciones mixtas

Cuándo Cambiar Estos Valores

Usa esta configuración para el ajuste de comportamiento en tiempo de ejecución, no para gestión de paquetes de contenido.

• Usa /fmm initialize, /fmm setup, /fmm downloadall y /fmm updatecontent para el trabajo del ciclo de vida de paquetes oficiales
• Usa la carpeta imports para trabajo manual de importación de .bbmodel u otro contenido local
• Usa config.yml cuando necesites ajustar el modo de renderizado, distancia de visibilidad, distancia de interacción o comportamiento de Bedrock

Advertencias Conocidas

• El repositorio local tiene desfases de metadatos de versión entre plugin.yml y pom.xml, por lo que esta página documenta intencionalmente el comportamiento en lugar de fijar una cadena de versión pública específica
• El comportamiento de Bedrock depende tanto de esta configuración como de tu configuración más amplia de Floodgate/Geyser/resource pack, así que mantén las afirmaciones conservadoras a menos que hayas probado tu stack exacto