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
• FreeMinecraftModels instalado e iniciado al menos una vez para que pueda generar sus carpetas de datos
• 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.

Flujo de 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
/nightbreaklogin <token>	Registro de token compartido de Nightbreak

Si config.yml aún tiene setupDone: false, los jugadores con freeminecraftmodels.* reciben un recordatorio único al iniciar sesión indicándoles que ejecuten /fmm setup (abrirlo descarta el mensaje de forma permanente). El recordatorio también menciona /fmm admin y /fmm.

Flujo de Trabajo Recomendado

1. Instala FreeMinecraftModels e inicia el servidor una vez.
2. Vincula un token de Nightbreak con /nightbreaklogin <token>.
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. Asegúrate de que los jugadores reciban el pack generado output/FreeMinecraftModels.zip, normalmente a través de ResourcePackManager.

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. 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.

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 dentro de /fmm setup, pueden descargarse en masa con /fmm downloadall y actualizarse con /fmm updatecontent. Los dos packs de objetos de Craftenmine son objetos personalizados (modelos con material: establecido) y son elegibles para scripts Lua de objetos.

Recordatorio sobre el Resource Pack

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.