Configuración de BetterStructures

BetterStructures aún soporta importaciones manuales, pero el flujo de trabajo recomendado actualmente prioriza Nightbreak y se realiza dentro del juego.

Requisitos

• Soporte de schematics compatible con WorldEdit o FAWE
• Runtime de Java 21 para la línea de compilación actual

Flujo de trabajo recomendado

1. Instala BetterStructures y WorldEdit, luego inicia el servidor una vez.
2. Ejecuta /bs initialize.
3. Vincula un token de Nightbreak con /nightbreaklogin <token>.
4. Abre /bs setup para explorar paquetes de estructuras y paquetes de módulos.
5. Usa /bs downloadall para un bootstrap rápido (obtiene una actualización del plugin pendiente y todo el contenido).
6. Usa /bs updatecontent cuando haya actualizaciones de paquetes disponibles.

El menú de configuración inicial

/bs initialize abre un pequeño menú guiado. Hasta que se elija una de sus opciones, cada jugador con el permiso betterstructures.* recibe un mensaje recordatorio diez segundos después de conectarse. Las tres opciones marcan la configuración como completada escribiendo setupDone: true en config.yml.

Opción	Qué hace
Configuración recomendada	Marca la configuración como completada e imprime la ruta de tres pasos: obtener un token en nightbreak.io/account, vincularlo con /nightbreaklogin <token> y después abrir /bs setup.
Configuración manual	Marca la configuración como completada y te deja a ti la gestión del contenido, señalando /bs setup y la carpeta imports.
Usar el contenido actual	Descarta el aviso y conserva el contenido actual. Si el registro de esquemáticos no está vacío, ejecuta una recarga; en caso contrario indica que no hay contenido instalado y te remite a /bs setup. Esta comprobación no cuenta los módulos.

Si no están instalados ni WorldEdit ni FastAsyncWorldEdit, la tercera casilla se sustituye por una advertencia que te pide instalar uno de ellos antes de continuar.

El menú de configuración

/bs setup abre un menú paginado con dos filtros: Paquetes de estructuras y Paquetes de módulos. Cada paquete muestra si está instalado, descargado pero no activado, desactualizado o si necesita acceso de Nightbreak. La acción al hacer clic depende de ese estado: descargar, instalar, actualizar, desinstalar o mostrar información de acceso.

Junto a los paquetes, el menú también expone controles compartidos de MagmaCore incluidos en BetterStructures:

• Actualización del plugin - muestra si hay disponible una compilación más reciente de BetterStructures y te permite descargarla. Un reinicio la aplica, salvo que ejecutes /bs applypluginupdate o establezcas nightbreak.applyPluginUpdatesWithoutRestart en config.yml a when-empty o immediately. La comprobación se ejecuta automáticamente al arrancar y se refresca aproximadamente una vez por hora, así que un servidor recién iniciado puede mostrar brevemente "Plugin Update Pending".
• Plugins recomendados - abre la vista de recomendación de plugins complementarios (igual que /bs recommendedplugins). El icono se vuelve verde una vez que todas las recomendaciones listadas están instaladas.
• Descargar todo el contenido - la entrada masiva añadida al final de la lista de paquetes, equivalente a /bs downloadall.
• Actualizaciones automáticas - un interruptor de la barra de herramientas para que BetterStructures descargue automáticamente las actualizaciones de plugin y contenido al iniciar. Está desactivado por defecto y usa la clave nightbreak.autoDownloadPluginUpdates en config.yml. Las descargas automáticas de contenido quedan preparadas para el próximo reinicio, sin iniciar una recarga en vivo. El reinicio también aplica una actualización del plugin descargada, salvo que nightbreak.applyPluginUpdatesWithoutRestart esté en when-empty o immediately (consulta Configuración del archivo).
• Consejos de instalación - el botón de información, que imprime en el chat la guía de configuración, la página del token de la cuenta, el Discord de soporte y los comandos de configuración en los que se puede hacer clic.

/bs setup se rechaza mientras se está ejecutando una recarga de contenido, ya que el menú lee los mismos registros que el proceso de recarga está reconstruyendo. Espera a que la recarga informe de que fue exitosa y ábrelo de nuevo.

El menú no comprueba la integridad de los archivos. Un paquete dañado o parcialmente borrado puede seguir apareciendo como actualizado si su ruta existe y la versión coincide. Usa /bs forcereinstallcontent <package|all> para repararlo; indica directamente el slug si falta toda la carpeta del paquete. La desinstalación conserva los archivos en disco. Pone el isEnabled del paquete en false y recarga, y la recarga omite todos los esquemáticos o módulos que haya dentro de la carpeta de ese paquete, subcarpetas incluidas.

Importación manual como alternativa

Las importaciones manuales aún funcionan a través de:

plugins/BetterStructures/imports

Mantén los zips de paquetes intactos, luego ejecuta /bs reload si es necesario. /bs reload importa cualquier cosa que esté en esa carpeta como parte de la recarga, así que no necesitas reiniciar para recoger un paquete que hayas dejado caer ahí.

Ten en cuenta que dejar archivos en imports ralentiza el arranque: cuando la carpeta no está vacía, BetterStructures espera a que los plugins listados en su softdepend terminen de inicializarse antes de arrancar, porque importar contenido en la carpeta de datos de otro plugin implica que ese plugin tenga que recargarse. Una vez que la carpeta vuelve a estar vacía, BetterStructures se inicializa sin esperar.

Consulta la guía compartida: Importaciones manuales vs gestión dentro del juego.