Paquetes de contenido de FreeMinecraftModels

El contenido oficial de FMM ahora se expone como paquetes gestionados de Nightbreak.

Paquetes oficiales actuales

El plugin actual define cinco paquetes oficiales preconfigurados, con contenido de props y objetos:

Pack	Tipo	Nombre del archivo de configuración	Nombre de carpeta	Slug de Nightbreak
Basic Furniture Pack	Props	basic_furniture_pack	Basic Furniture Pack	basic-furniture-pack
BetterStructures Prop Pack	Props	betterstructures_prop_pack	bs prop pack	betterstructures-prop-pack
EliteMobs Prop Pack	Props	elitemobs_prop_pack	em_dungeon_prop_pack	elitemobs-prop-pack
Craftenmine's Weapons Item Pack	Objetos personalizados	craftenmines_weapons_item_pack	fmm_craftenmine_weapons_items_pack	craftenmines-weapons-item-pack
Craftenmine Tools Item Pack	Objetos personalizados	craftenmine_tools_item_pack	fmm_craftenmine_tools_items_pack	craftenmine-tools-item-pack

El nombre del archivo de configuración identifica la entrada .yml bajo plugins/FreeMinecraftModels/content_packages/. El nombre de carpeta identifica el directorio de modelos del paquete dentro de models/ o models_disabled/. Los prefijos se configuran por separado, como se explica más abajo.

Cada paquete tiene un nombre de carpeta local, un slug de Nightbreak, un campo de versión y un estado activado/desactivado en content_packages. Los dos paquetes de objetos de Craftenmine proporcionan objetos sostenidos con definiciones material: y encantamientos con espacio de nombres. Las copias antiguas que contienen scripts: de objetos equipados necesitan contenido actualizado; esas definiciones se omiten.

Qué gestiona el menú de configuración

/fmm setup muestra el estado de los paquetes a partir de la configuración local, los archivos detectados y la información de Nightbreak en caché. El menú puede distinguir entre:

• paquetes instalados
• paquetes descargados pero actualmente deshabilitados
• paquetes desactualizados
• paquetes que requieren acceso a Nightbreak

El menú inicia comprobaciones de versión y acceso en segundo plano, con un intervalo mínimo de cinco minutos. Las comprobaciones de versión se aplican a los paquetes detectados como instalados. El indicador de instalado significa que el paquete está habilitado y existe una entrada de modelo gestionada; no demuestra que todos los modelos se hayan cargado ni que los clientes hayan recibido el paquete de recursos. Comprueba también /fmm admin, la consola y la entrega al cliente.

Comportamiento de las carpetas

El plugin usa movimientos de carpeta según el estado del paquete para contenido habilitado y deshabilitado:

• las carpetas de modelos habilitadas viven en models/<folderName>
• las carpetas de modelos deshabilitadas viven en models_disabled/<folderName>
• los archivos de script habilitados viven en scripts/
• los archivos de script deshabilitados viven en scripts_disabled/

El contenido descargado puede existir en disco sin estar activo. Instalar o desinstalar mueve las entradas coincidentes de modelos, scripts y encantamientos, guarda el estado habilitado y después solicita una recarga. Los movimientos son secuenciales, no una transacción atómica: un fallo al mover o guardar el estado puede dejar un cambio parcial. Comprueba la consola y ambas ubicaciones antes de reintentar. Las dos acciones requieren una entrada de modelo gestionada en la carpeta de origen; los archivos que solo contienen scripts o encantamientos pueden contar como descargados sin permitir instalar el paquete mediante esa acción.

Las instalaciones antiguas pueden usar Models o Models_disabled. La ruta activa prefiere models en minúsculas, mientras que la deshabilitada prefiere una carpeta Models_disabled existente. Consulta las notas de creación de modelos antes de unificar directorios que distingan mayúsculas y minúsculas.

Prefijos de archivo

Las configuraciones tienen contentFilePrefixes y scriptFilePrefixes. Las cinco definiciones integradas inicializan ambas listas vacías; no usan automáticamente folderName como prefijo. Revisa los valores de la configuración instalada.

Para modelos y encantamientos, FMM selecciona la entrada exacta folderName y las entradas de la raíz cuyos nombres empiezan por un valor de contentFilePrefixes. Para scripts selecciona entradas de la raíz que coinciden con scriptFilePrefixes, sin una coincidencia adicional por nombre de carpeta. Los prefijos no distinguen mayúsculas y minúsculas y pueden seleccionar archivos o directorios completos; no buscan recursivamente archivos dentro de directorios ajenos. Usa prefijos distintos y mantén los archivos referenciados dentro de las entradas seleccionadas.

Ciclo de descarga e instalación

Hay dos pasos distintos:

1. Descargar el contenido del paquete. Las descargas van a plugins/FreeMinecraftModels/imports. Una descarga gestionada correcta guarda el estado habilitado antes de solicitar una recarga e importación.
2. Mantener el paquete habilitado o deshabilitado. El menú de setup instala y desinstala paquetes moviendo sus carpetas entre models y models_disabled.

Las operaciones masivas siguen el mismo modelo:

• /fmm downloadall descarga la actualización del jar del plugin y después todos los paquetes accesibles que falten o estén desactualizados. El contenido puede aplicarse con la recarga posterior de FMM; el jar del plugin en sí entra en vigor tras un reinicio o con /fmm applypluginupdate
• /fmm downloadallcontent hace el mismo barrido de contenido sin la actualización del jar del plugin
• /fmm updatecontent (alias /fmm updateallcontent) refresca la información de versión y acceso y actualiza los paquetes marcados como desactualizados; las comprobaciones de versión actualmente cubren los paquetes instalados

Los procesos masivos tratan los paquetes secuencialmente e informan por separado de las descargas y preparaciones correctas y de los fallos. Si al menos un paquete termina correctamente, programan una recarga 20 ticks después, aunque otros fallen. Sin paquetes completados no hay recarga; una instalación sin trabajo informa de que no hay contenido nuevo, mientras que una actualización vacía informa de que no hay actualizaciones pendientes. Una descarga correcta no demuestra que la importación posterior, la carga de modelos o la entrega al cliente hayan funcionado.

Las operaciones masivas de contenido comparten una protección que bloquea una segunda ejecución hasta que la primera termina o inicia su recarga posterior. Requieren un token de Nightbreak vinculado y se detienen ante un fallo de autenticación. Los fallos ordinarios de paquetes se notifican y el resto continúa. Si el jugador que inició el proceso se desconecta, este continúa informando en consola. El cierre del plugin invalida la publicación de descargas pendientes y las devoluciones de llamada de ese ciclo de ejecución.

Reparar un paquete

La selección normal usa los archivos detectados y el estado de versión, no una comprobación de integridad. Un paquete parcialmente dañado puede seguir pareciendo actualizado y omitirse. /fmm forcereinstallcontent <package|all> vuelve a descargar el contenido seleccionado independientemente de la versión y solicita una recarga tras las descargas correctas. Esta ruta no fuerza la activación de un paquete deshabilitado.

• El autocompletado ofrece all más el slug de Nightbreak de cada paquete (basic-furniture-pack, betterstructures-prop-pack, elitemobs-prop-pack, craftenmines-weapons-item-pack, craftenmine-tools-item-pack).
• all selecciona los paquetes detectados como descargados, instalados o marcados como desactualizados. Si ninguno cumple las condiciones, informa No downloaded content was detected. Specify a package slug directly if its files are completely missing. Indica directamente el slug de un paquete que falte por completo.
• Un selector desconocido informa Unknown Nightbreak content package: <name>.
• Comparte la misma protección contra ejecuciones solapadas que las demás operaciones masivas, y requiere freeminecraftmodels.*.

Contenido de otros paquetes

Un paquete de contenido de cualquier plugin de Nightbreak, como un paquete de EliteMobs o BetterStructures colocado en la carpeta imports de ese plugin, puede incluir contenido de FreeMinecraftModels en una carpeta freeminecraftmodels/ de nivel superior organizada como plugins/FreeMinecraftModels/. Por ejemplo, freeminecraftmodels/enchantments/ aporta los encantamientos freeminecraftmodels: que usan los objetos del paquete, y freeminecraftmodels/models/ se fusiona con la carpeta de modelos que lee FMM (models en minúsculas, o una carpeta antigua Models si existe). Las carpetas models/ y scripts/ de nivel superior de un paquete también van a FMM. Una carpeta enchantments/ de nivel superior sigue la plataforma del paquete, que indica pack.meta (o, si no lo hay, el plugin en cuya carpeta imports está el paquete): un paquete de FreeMinecraftModels la instala en FMM, mientras que los paquetes de EliteMobs y BetterStructures la instalan en EliteMobs.

Cuando la importación de otro plugin coloca archivos en la carpeta de FMM, FMM ejecuta después su recarga de contenido importado. Esa recarga reconstruye modelos, objetos, encantamientos, scripts de props, recetas y el resource pack, pero no vuelve a leer config.yml ni shop_config.yml.

Explorador de contenido para administradores

/fmm admin abre un explorador dentro del juego para los modelos cargados y los objetos personalizados registrados. Muestra:

• paquetes habilitados con contenido cargado (con cuentas separadas de props y objetos)
• carpetas de modelos sin empaquetar (con cuentas separadas de props y objetos)
• modelos de props individuales
• objetos personalizados registrados correctamente

Los props usan un estilo amarillo y un icono de papel. Los objetos personalizados usan su material y nombre configurados, con un nombre morado como alternativa. La inclusión depende de que el registro del objeto termine correctamente, no solo de que exista material: en un archivo; una definición rechazada no aparece como objeto personalizado funcional.

Las entradas de paquetes y carpetas abren sus listas de contenido. Pulsar un prop u objeto individual añade una copia al inventario. Los objetos personalizados incluyen el material, los encantamientos, el lore y la etiqueta fmm_item_id configurados; los props entregan objetos de colocación de papel. Deja espacio en el inventario: estos controles de administrador no tiran al suelo lo que no cabe. Los errores al crear objetos se notifican en el chat. El registro y una entrada visible en el menú no demuestran que el cliente los renderice correctamente.

Contenido de encantamientos

La activación y desactivación de paquetes incluye los YAML/Lua de encantamientos gestionados junto con los modelos y scripts de props. El contenido habilitado está en enchantments/; el deshabilitado se mueve a enchantments_disabled/. La selección usa las reglas anteriores de nombre de carpeta y prefijos de contenido: conserva las definiciones de proveedores y los scripts referenciados dentro de las entradas seleccionadas. El antiguo sistema de scripts de objetos no sustituye a un proveedor de encantamientos ausente.