Configuración inicial de FreeMinecraftModels

FreeMinecraftModels sigue soportando importaciones manuales de .bbmodel, pero el flujo de configuración actual está integrado con Nightbreak y dirigido por menús.

Requisitos previos

• Un runtime Java 21 para el servidor
• Minecraft 1.21.4 o posterior: el plugin declara api-version: 1.21.4 y no se carga en versiones anteriores
• FreeMinecraftModels instalado e iniciado al menos una vez para que pueda generar sus carpetas de datos. MagmaCore va incluido dentro del jar del plugin, así que no necesita una instalación aparte
• Una forma de entregar el resource pack generado a los jugadores

ResourcePackManager es la ruta de entrega recomendada porque FreeMinecraftModels solo genera el pack; no lo aloja por sí mismo.

Configuración por primera vez

Comando	Propósito
/fmm setup	Menú de gestión de contenido / incorporación inicial solo para jugadores (el comando al que se dirige a los jugadores en el primer arranque)
/fmm recommendedplugins	Muestra plugins complementarios que combinan bien con FreeMinecraftModels
/fmm downloadall	Asistente de instalación masiva: descarga la última actualización del plugin más todos los paquetes de Nightbreak accesibles
/fmm downloadallcontent	Asistente de instalación masiva para los paquetes de Nightbreak accesibles (solo contenido)
/fmm updatecontent	Asistente de actualización masiva para paquetes de Nightbreak desactualizados
/fmm downloadpluginupdate	Descarga únicamente la última actualización del jar del plugin
/fmm applypluginupdate	Aplica una actualización del plugin ya descargada sin reiniciar el servidor
/fmm forcereinstallcontent <package|all>	Asistente de reparación: vuelve a descargar contenido existente aunque los números de versión indiquen que está actualizado
/nightbreaklogin [token]	Vinculación compartida de la cuenta de Nightbreak: imprime un enlace para aprobar el servidor, o guarda un token pegado (permiso: nightbreak.login)
/nightbreaklogout	Borra el token de Nightbreak guardado en este servidor

Si config.yml aún tiene setupDone: false, los jugadores con freeminecraftmodels.* reciben un recordatorio unos 10 segundos después de cada inicio de sesión si siguen conectados. Abrir /fmm setup guarda setupDone: true para el servidor y descarta los recordatorios futuros. El mensaje también menciona /fmm admin y /fmm. Completar una opción de /fmm initialize también marca la configuración como terminada; ese indicador no demuestra que se haya instalado o entregado un pack.

La barra de herramientas de /fmm setup también tiene un botón Pets que cambia el modo de mascotas entre mascotas cosméticas y más criaturas, y guarda la elección en pets.yml.

Flujo de trabajo recomendado

1. Instala FreeMinecraftModels e inicia el servidor una vez.
2. Vincula el servidor a tu cuenta de Nightbreak con /nightbreaklogin y después apruébalo en el enlace que imprime.
3. Abre /fmm setup para inspeccionar los paquetes disponibles y el estado actual.
4. Usa /fmm downloadall si quieres instalar todos los paquetes oficiales a los que tu token tenga acceso (esto también descarga la última actualización del jar del plugin).
5. Usa /fmm updatecontent más adelante para actualizar paquetes oficiales desactualizados.
6. Espera a que la inicialización termine correctamente y comprueba que los jugadores reciben el pack generado output/FreeMinecraftModels.zip, normalmente mediante ResourcePackManager. FMM notifica a ResourcePackManager si está habilitado tras generar el pack correctamente, pero esa notificación por sí sola no demuestra la entrega al cliente.

Las descargas interactivas de paquetes recargan FMM tras los cambios de contenido. Un jar descargado del plugin entra en vigor tras un reinicio, o de inmediato con /fmm applypluginupdate. /fmm reload valida los objetos, encantamientos y recetas de props definidos antes de reconstruir; si la validación se rechaza, mantiene activo el catálogo actual. Comprueba el resultado antes de dar los archivos por aplicados.

Si prefieres que el servidor obtenga las actualizaciones por sí mismo, establece nightbreak.autoDownloadPluginUpdates: true en config.yml (predeterminado false). Las actualizaciones de plugin y contenido descargadas se aplican tras el siguiente reinicio. Para aplicar las actualizaciones del plugin sin reiniciar, establece nightbreak.applyPluginUpdatesWithoutRestart en when-empty o immediately (predeterminado never). Consulta Configuración.

Importaciones manuales de modelos

La importación directa de modelos sigue funcionando a través de:

plugins/FreeMinecraftModels/imports

Esta ruta sigue siendo útil para:

• desarrollo local
• modelos personalizados que no estás obteniendo de Nightbreak
• convertir contenido .bbmodel al formato de runtime actual cuando ejecutas /fmm reload

Las importaciones manuales y las descargas de paquetes oficiales acaban dependiendo de una pasada de reload/import antes de que se reconstruyan la lista de modelos del runtime y el resource pack.

Coloca un .bbmodel suelto directamente en imports/. Esa ruta escribe un .fmmodel convertido en el directorio de modelos y conserva el archivo de origen, por lo que otra recarga puede convertirlo de nuevo. No importa un .yml suelto que lo acompañe. Tampoco recorre las subcarpetas normales sin pack.meta. Para modelos con configuración o scripts asociados, usa el directorio activo models/ y scripts/, o un archivo empaquetado correctamente; consulta Notas de creación de modelos.

Paquetes de contenido oficiales

El plugin actual incluye cinco paquetes premade gestionados por Nightbreak:

• Basic Furniture Pack (props)
• BetterStructures Prop Pack (props)
• EliteMobs Prop Pack (props)
• Craftenmine's Weapons Item Pack (objetos personalizados)
• Craftenmine Tools Item Pack (objetos personalizados)

Estos aparecen en /fmm setup, pueden descargarse en masa con /fmm downloadall y actualizarse con /fmm updatecontent. Los dos paquetes de objetos de Craftenmine son objetos personalizados (modelos con material: establecido) y usan los formatos actuales de definición de objetos y encantamientos. Los paquetes antiguos con scripts de objetos equipados necesitan contenido actualizado.

Recordatorio sobre el paquete de recursos

FreeMinecraftModels siempre necesita que la salida de su resource pack generado llegue al cliente de una forma u otra.

Consulta Salida del resource pack para conocer las rutas de salida actuales y la integración con ResourcePackManager.