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 initialize	Menú de incorporación inicial solo para jugadores
/fmm setup	Menú de gestión de contenido solo para jugadores
/fmm downloadall	Asistente de instalación masiva para paquetes Nightbreak accesibles
/fmm updatecontent	Asistente de actualización masiva para paquetes Nightbreak desactualizados
/nightbreaklogin <token>	Registro de token compartido de Nightbreak

Si config.yml aún tiene setupDone: false, los jugadores con freeminecraftmodels.* reciben un recordatorio al iniciar sesión indicándoles que ejecuten /fmm initialize.

Flujo de Trabajo Recomendado

1. Instala FreeMinecraftModels e inicia el servidor una vez.
2. Ejecuta /fmm initialize.
3. Vincula un token de Nightbreak con /nightbreaklogin <token>.
4. Abre /fmm setup para inspeccionar los paquetes disponibles y el estado actual.
5. Usa /fmm downloadall si quieres instalar todos los paquetes oficiales a los que tu token tenga acceso.
6. Usa /fmm updatecontent más adelante para actualizar paquetes oficiales desactualizados.
7. Asegúrate de que los jugadores reciban el pack generado output/FreeMinecraftModels.zip, normalmente a través de ResourcePackManager.

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.