Paquetes de contenido de BetterStructures
BetterStructures ahora trata el contenido oficial como paquetes gestionados en lugar de un flujo de trabajo puramente de importación manual.
Comandos principales
| Comando | Propósito |
|---|---|
/bs initialize | Flujo de configuración inicial |
/bs setup | Explorar y gestionar el estado de los paquetes |
/bs downloadall | Descarga la actualización del plugin (si la hay) y todo el contenido disponible, y luego recarga |
/bs downloadallcontent | Descarga solo todo el contenido disponible (sin actualización del plugin) |
/bs updatecontent | Actualiza el contenido desactualizado (alias: /bs updateallcontent) |
/bs forcereinstallcontent <package|all> | Vuelve a descargar el contenido incluso cuando la versión instalada ya está al día: el comando de reparación para paquetes dañados o borrados parcialmente |
/bs recommendedplugins | Lista los plugins complementarios que combinan bien con BetterStructures |
/nightbreaklogin <token> | Registro compartido de token de Nightbreak |
Los comandos de descarga y actualización usan el sistema compartido Nightbreak de MagmaCore incluido en BetterStructures para comprobar el token y el acceso y descargar los archivos. Después, BetterStructures importa el contenido mediante su propio proceso de recarga.
Tipos de paquetes
Cada paquete declara un contentPackageType, y el menú de configuración ofrece un filtro por tipo:
contentPackageType | Filtro del menú de configuración | Los archivos van a |
|---|---|---|
STRUCTURE (predeterminado) | Paquetes de estructuras | plugins/BetterStructures/schematics/<folderNameV2> |
MODULAR | Paquetes de módulos | plugins/BetterStructures/modules/<folderNameV2> |
Usa /bs setup para filtrar e inspeccionar paquetes en lugar de depender de listas estáticas antiguas.
Campos de configuración de un paquete
Cada paquete se describe mediante una configuración en plugins/BetterStructures/content_packages. Rara vez necesitarás editarlas a mano —vienen con el plugin y son la forma en que este rastrea el estado de los paquetes—, pero los campos son:
| Clave | Predeterminado | Descripción |
|---|---|---|
isEnabled | true | Indicador de instalación del paquete que modifica el menú. Cuando es false, no se carga nada de la carpeta del paquete; consulta la explicación siguiente. |
name | — | Nombre visible que se muestra en el menú de configuración |
description | — | Líneas de descripción que se muestran en el menú de configuración |
downloadLink | — | Enlace de descarga manual que se muestra si el paquete no tiene nightbreakSlug; las descargas gestionadas usan el slug |
version | 0 | Versión local del contenido, comparada con la versión remota para decidir si el paquete está desactualizado |
folderNameV2 | — | Subcarpeta en la que viven los archivos del paquete, dentro de schematics o modules según el tipo |
contentPackageType | STRUCTURE | STRUCTURE o MODULAR |
nightbreakSlug | — | Identificador de Nightbreak usado para las comprobaciones de acceso, las descargas y como selector de /bs forcereinstallcontent |
Instalar o desinstalar un paquete desde el menú de configuración solo cambia el isEnabled del paquete y luego inicia una recarga. No edita las configuraciones de esquemáticos ni de módulos que hay dentro del paquete. La desinstalación conserva los archivos en disco.
Mientras un paquete tenga isEnabled: false, los cargadores de esquemáticos y módulos omiten toda su carpeta, schematics/<folderNameV2> o modules/<folderNameV2>, subcarpetas incluidas. Esto se aplica tanto a los paquetes STRUCTURE como a los MODULAR. Dentro de un paquete activado, cada configuración de esquemático y de módulo sigue teniendo su propio isEnabled.
Contenido de un paquete
Un paquete de BetterStructures es un zip cuyo pack.meta declara betterstructures. Un zip sin pack.meta colocado en plugins/BetterStructures/imports se trata de la misma forma. Sus carpetas de nivel superior se desempaquetan según su nombre:
| Carpeta en el paquete | Destino |
|---|---|
content_packages, schematics, modules, module_generators, generators, treasures, spawn_pools, components | La carpeta del mismo nombre en plugins/BetterStructures |
custombosses, customitems, customtreasurechests, powers, enchantments | La carpeta del mismo nombre en plugins/EliteMobs |
models o modelengine | La carpeta de modelos de FreeMinecraftModels, o blueprints de ModelEngine cuando solo está instalado ModelEngine |
scripts | plugins/FreeMinecraftModels/scripts |
freeminecraftmodels, elitemobs, betterstructures | La raíz de la carpeta de datos de ese plugin, conservando la estructura interna, por ejemplo freeminecraftmodels/enchantments |
worldcontainer | El contenedor de mundos del servidor |
Una carpeta de nivel superior que no esté en esta tabla hace que el importador rechace el paquete entero. Consulta Importaciones manuales vs gestión dentro del juego para ver las reglas de importación compartidas.
Cuando un paquete añade contenido de EliteMobs, BetterStructures recarga EliteMobs tras la importación. Cuando el paquete de otro plugin importa archivos en la carpeta de BetterStructures, BetterStructures ejecuta una recarga de contenido en cuanto termina su propio arranque.
Estados de los paquetes
Dependiendo del paquete y el estado de tu token, BetterStructures puede distinguir entre:
- contenido instalado
- contenido descargado pero no activado
- contenido desactualizado
- contenido que necesita acceso de Nightbreak
El menú considera descargado un paquete cuya ruta existe y combina ese dato con su indicador isEnabled para decidir si está instalado. Es un indicador de estado, no una comprobación de integridad: una carpeta vacía o dañada puede seguir apareciendo como instalada. Usa /bs forcereinstallcontent <package|all> para reparar los archivos. all selecciona los paquetes detectados como descargados, instalados o desactualizados; indica el slug directamente si falta toda la carpeta del paquete.
Importación manual como alternativa
Las importaciones manuales aún usan:
plugins/BetterStructures/imports
Mantén los zips de paquetes intactos, luego recarga BetterStructures si es necesario. La importación manual aún está soportada, pero ya no es el flujo de trabajo documentado principal.