Saltar al contenido principal

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 tres paquetes oficiales premade:

  • Basic Furniture Pack
  • BetterStructures Prop Pack
  • EliteMobs Prop 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.

Lo que Gestiona el Menú de Configuración​

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

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

El menú de configuración también activa actualizaciones en segundo plano para verificaciones de versiones de paquetes y comprobaciones de acceso, por lo que el menú es el lugar adecuado para verificar el estado actual de los paquetes.

Comportamiento de Carpetas​

El plugin usa movimientos de carpetas de estado de paquetes para contenido habilitado y deshabilitado:

  • las carpetas de modelos habilitados están en models/<folderName>
  • las carpetas de modelos deshabilitados están en models_disabled/<folderName>
  • los archivos de scripts habilitados están en scripts/
  • los archivos de scripts deshabilitados están 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 un paquete se instala o desinstala, tanto su carpeta de modelos como cualquier archivo de script coincidente se mueven juntos.

Prefijos de Archivos​

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 scripts 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 activan un pase de recarga/importación.
  2. Mantener el paquete habilitado o deshabilitado. El menú de configuración instala y desinstala paquetes moviendo sus carpetas entre models y models_disabled.

Las operaciones masivas siguen el mismo modelo:

  • /fmm downloadall descarga cada paquete accesible que falte o esté desactualizado
  • /fmm updatecontent actualiza solo los paquetes desactualizados

Ambos comandos masivos recargan FreeMinecraftModels automáticamente después de 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 conteos separados de props y objetos)
  • carpetas de modelos sin empaquetar (con conteos separados 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 objetos se muestran de forma diferente: los props usan estilo amarillo y un icono de papel, mientras que los objetos personalizados usan estilo púrpura y muestran su material configurado. Un modelo que tiene material: establecido en su configuración YML aparece solo como objeto personalizado, nunca como prop y objeto a la vez.

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