FreeMinecraftModels

FreeMinecraftModels es tanto un runtime de modelos personalizados como una API orientada a desarrolladores.

El plugin ofrece:

• un flujo de configuración inicial y un recordatorio al unirse hasta que la configuración se marque como completa
• un menú de configuración respaldado por Nightbreak para instalar y actualizar paquetes de modelos oficiales
• una carpeta de resource pack generado en plugins/FreeMinecraftModels/output/FreeMinecraftModels
• un artefacto de pack comprimido en plugins/FreeMinecraftModels/output/FreeMinecraftModels.zip
• una superficie de comandos más amplia para configuración, actualizaciones de contenido, generación, disfraces, props y depuración
• huesos de punto de montaje — los huesos cuyo nombre comienza con m_ crean puntos de asiento montables en un modelo, permitiendo a los jugadores montar entidades personalizadas
• JSON de modelo de visualización personalizado — coloca un archivo .json hermano (exportación de display-item de Blockbench) junto a un .bbmodel para sobrescribir la apariencia del objeto en el juego (requiere 1.21.4+)
• objetos personalizados y armas mágicas: modelos sostenidos con encantamientos que usan espacios de nombres, además de varitas y bastones definidos por sus autores
• partículas de Blockbench — los fotogramas clave de partículas de las animaciones de un modelo se reproducen en entidades personalizadas, props y objetos sostenidos, para jugadores de Java y Bedrock. Consulta Partículas
• explorador de contenido de administrador (/fmm admin) — un menú de inventario con los modelos cargados y los objetos personalizados registrados correctamente, agrupados por paquete habilitado o carpeta
• menú de objetos fabricables para jugadores (/fmm) — muestra las recetas de fabricación de props registradas con su cuadrícula 3x3 y resultado; no incluye entradas sin receta registrada
• sistema de disfraces de jugador — /fmm disguise <model> [player], /fmm undisguise [player], /fmm disguiselist, con una DisguiseAPI pública para plugins de terceros
• tienda de muebles — /fmm shop opcional con Vault para vender objetos de papel que colocan props, configurado por receta mediante shopEnabled / shopPrice; las entradas válidas de la tienda pueden mantenerse aunque se desactive el registro de recetas
• API de UI de jugador — los scripts Lua pueden mostrar barras de jefe, barras de acción y títulos a los jugadores
• LocationAPI: los plugins de terceros pueden registrar detectores de mazmorras y proveedores de protección que controlan los predicados Lua de FMM em.location.is_in_dungeon / em.location.is_protected y la comprobación de colocación de elementos decorativos en regiones protegidas
• notas de cambios dentro del juego: los administradores reciben un aviso al conectarse si tienen notas de versión de FreeMinecraftModels sin leer y pueden consultarlas con /freeminecraftmodelschangelog
• reparación de contenido: /fmm forcereinstallcontent <package|all> vuelve a descargar contenido que figura como actualizado cuando sus archivos están dañados o ausentes
• actualizaciones del plugin sin reinicio: /fmm applypluginupdate o la opción nightbreak.applyPluginUpdatesWithoutRestart instalan un jar del plugin descargado mientras el servidor sigue funcionando. Consulta Configuración
• modo fílmico: /fmm filmic on|off o filmicMode envían a cada jugador todos los modelos cargados en sus chunks cargados, aunque estén fuera de su vista, para grabaciones con ReplayMod. Consulta Configuración

FreeMinecraftModels declara api-version: 1.21.4, por lo que Minecraft 1.21.4 es la versión mínima de servidor compatible.

Empieza aquí

• Configuración Inicial

• Paquetes de contenido

• Comandos

• Configuración

• Disfraces de jugador

• Tienda de muebles

• Salida del resource pack

• Notas de creación de modelos

• Animaciones

• API y guía para desarrolladores

• Preguntas frecuentes

• Lua: Primeros Pasos

• Lua: API de elementos decorativos

• Lua: Ejemplos

• Lua: Solución de problemas

Scripts Lua

FreeMinecraftModels permite escribir scripts Lua para elementos decorativos mediante el motor de scripts de MagmaCore 2.0. Los scripts se guardan en plugins/FreeMinecraftModels/scripts/.

Funciones de evento activas para elementos decorativos (8)

Los scripts de props pueden responder a los siguientes hooks:

Hook	Activador
on_spawn	El prop aparece en el mundo, o vuelve a cargarse con su chunk
on_game_tick	Cada tick del juego mientras el prop está activo
on_zone_enter	Un jugador entra en una zona vigilada creada por un script
on_zone_leave	Un jugador sale de una zona vigilada creada por un script
on_destroy	El prop se elimina definitivamente (no al descargarse el chunk ni al recargar)
on_left_click	Un jugador hace clic izquierdo en el prop
on_right_click	Un jugador hace clic derecho en el prop
on_projectile_hit	Un proyectil impacta en el prop

Los scripts de props reciben una tabla context.prop con campos como model_id y current_location, y métodos como play_animation(name) y stop_animation().

Efectos de objetos

Los scripts Lua de objetos equipados se han retirado. Los objetos sostenidos usan ahora encantamientos definidos por sus autores, y las varitas y los bastones usan definiciones de armas mágicas. No añadas scripts: a una definición de objeto sostenido.

Notas actuales

• Paquetes oficiales gestionados por Nightbreak integrados en el plugin: Basic Furniture Pack, BetterStructures Prop Pack, EliteMobs Prop Pack, Craftenmine's Weapons Item Pack y Craftenmine Tools Item Pack.
• Una inicialización completa correcta reconstruye el resource pack y programa FmmReloadedEvent 40 ticks después para que los plugins dependientes puedan volver a vincular los modelos. Si la recarga se rechaza durante la preparación, se conserva el sistema activo.
• ResourcePackManager puede distribuir automáticamente el pack generado. Comprueba los archivos generados y su aceptación real en el cliente; la marca de configuración completa o de paquete instalado no demuestra que se haya entregado.