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 de carpeta | Slug de Nightbreak |
|---|---|---|---|
Basic Furniture Pack | Props | basic_furniture_pack | basic-furniture-pack |
BetterStructures Prop Pack | Props | betterstructures_prop_pack | betterstructures-prop-pack |
EliteMobs Prop Pack | Props | elitemobs_prop_pack | elitemobs-prop-pack |
Craftenmine's Weapons Item Pack | Objetos personalizados | craftenmines_weapons_item_pack | craftenmines-weapons-item-pack |
Craftenmine Tools Item Pack | Objetos personalizados | craftenmine_tools_item_pack | craftenmine-tools-item-pack |
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:
- Descargar el contenido del paquete.
Las descargas van a
plugins/FreeMinecraftModels/importsy luego desencadenan una pasada de reload/import. - Mantener el paquete habilitado o deshabilitado.
El menú de setup instala y desinstala paquetes moviendo sus carpetas entre
modelsymodels_disabled.
Las operaciones masivas siguen el mismo modelo:
/fmm downloadalldescarga todos los paquetes accesibles que falten o estén desactualizados/fmm updatecontentactualiza solo los paquetes desactualizados
Ambos comandos masivos recargan FreeMinecraftModels automáticamente tras descargas exitosas para que el contenido recién descargado esté disponible.
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.