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
Recommended Setup	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.
Manual Setup	Marca la configuración como completada y te deja a ti la gestión del contenido, señalando /bs setup y la carpeta imports.
Use Current Content	Descarta el aviso y conserva el contenido que ya esté instalado, y a continuación ejecuta una recarga. Si no hay contenido instalado, lo indica y te remite a /bs setup.

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 donde los paquetes se dividen en 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, y al hacer clic en él se instala/actualiza.

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). 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 de contenido al iniciar. Está desactivado por defecto y está respaldado por la clave nightbreak.autoDownloadPluginUpdates en config.yml. Aún se requiere un reinicio para aplicar una actualización del plugin descargada.
• 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.

Si los archivos de un paquete acaban dañados o parcialmente borrados, /bs setup no los reparará: compara versiones y considera que el paquete está al día. Usa /bs forcereinstallcontent <package|all> en su lugar.

Respaldo de importación manual

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.