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 premade, mezclando 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 es la entrada .yml bajo plugins/FreeMinecraftModels/content_packages/. El nombre de carpeta es el directorio bajo el que viven realmente los modelos del pack dentro de models/ o models_disabled/, y es también el prefijo por defecto de los archivos de contenido/script.

Cada paquete tiene un nombre de carpeta local, un slug de Nightbreak, un campo de versión y un estado habilitado/deshabilitado en content_packages. Los dos packs de objetos de Craftenmine incluyen objetos personalizados (modelos con material: establecido) que funcionan con toda la superficie Lua de scripts de objetos.

Lo Que Gestiona el Menú de Setup

/fmm setup es la fuente de verdad actual del estado de paquetes. El menú puede distinguir entre:

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

El menú de setup también desencadena actualizaciones en segundo plano para las versiones de paquetes y comprobaciones de acceso, así que el menú es el lugar correcto para verificar el estado actual de los paquetes.

Comportamiento de 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/

Esto significa que un paquete puede estar completamente descargado en disco sin estar activo en la lista de modelos del runtime. Cuando se instala o desinstala un paquete, tanto su carpeta de modelos como cualquier archivo de script coincidente se mueven juntos.

Prefijos de Archivo

Cada configuración de paquete de contenido tiene un campo contentFilePrefixes y un campo scriptFilePrefixes (ambos por defecto al folderName del paquete). Los archivos de contenido cuyos nombres comienzan con cualquiera de los contentFilePrefixes y los archivos de script en la carpeta scripts/ cuyos nombres comienzan con cualquiera de los scriptFilePrefixes se consideran parte del paquete y se mueven con él durante la instalación/desinstalación.

Ciclo de Vida de Descarga e Instalación

Hay dos pasos distintos:

1. Descargar el contenido del paquete. Las descargas van a plugins/FreeMinecraftModels/imports y luego desencadenan una pasada de reload/import.
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í sigue requiriendo un reinicio del servidor
• /fmm downloadallcontent hace el mismo barrido de contenido sin la actualización del jar del plugin
• /fmm updatecontent (alias /fmm updateallcontent) actualiza solo los paquetes desactualizados

Los tres barridos masivos de contenido recargan FreeMinecraftModels automáticamente tras descargas exitosas para que el contenido recién descargado esté disponible. La recarga solo se dispara cuando al menos un paquete se ha descargado realmente — una ejecución que no encuentra nada que hacer informa No new content to download! y omite la recarga.

Las operaciones masivas están protegidas contra ejecuciones solapadas: mientras una está en curso, un segundo comando masivo se rechaza en lugar de iniciarse en paralelo. También requieren un token de Nightbreak vinculado, y abortan pronto ante un fallo de autenticación.

Reparar Un Paquete

Los comandos de descarga normales comparan números de versión, así que un paquete cuyos archivos se hayan corrompido o borrado parcialmente sigue pareciendo "actual" y se omite. /fmm forcereinstallcontent <package|all> existe para ese caso: vuelve a descargar el contenido seleccionado sin importar la versión y después recarga.

• 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 solo cubre los paquetes que FMM detecta como descargados. Si los archivos de un pack faltan por completo, informa No downloaded content was detected. Specify a package slug directly if its files are completely missing. — indica el slug en su lugar.
• 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.*.

Explorador de Contenido de Administrador

/fmm admin abre una GUI de inventario en el juego que permite a los administradores explorar todo el contenido instalado de un vistazo. El explorador muestra:

• todos los paquetes instalados (con cuentas separadas de props y objetos)
• carpetas de modelos sin empaquetar (con cuentas separadas de props y objetos)
• props individuales (modelos sin material: en su configuración YML)
• objetos personalizados (modelos que tienen material: establecido en su configuración YML)

Los props y los objetos se muestran de forma diferenciada: los props usan un estilo amarillo y un icono de papel, mientras que los objetos personalizados usan un estilo morado y muestran su material configurado. Un modelo que tenga material: establecido en su YML aparece solo como objeto personalizado, nunca como prop y objeto a la vez.

Hacer clic en cualquier entrada del explorador de administrador da al jugador una copia de ese objeto. Para objetos personalizados, el objeto entregado incluye el material configurado, los encantamientos, el lore y la etiqueta PDC fmm_item_id. Esta es la forma más rápida de obtener props, objetos personalizados o objetos de modelo para pruebas y construcción sin necesidad de saber el ID exacto del modelo o la sintaxis del comando.