Comandos de BetterStructures

Usa /betterstructures o /bs.

Configuración y contenido

Comando	Propósito
/bs	Comando principal de ayuda
/bs initialize	Flujo de configuración inicial (abre el menú de configuración inicial)
/bs setup	Abre el menú de configuración/contenido
/bs recommendedplugins	Muestra plugins complementarios que funcionan bien con BetterStructures
/bs downloadall	Descarga la actualización del plugin (si la hay) y todo el contenido disponible, y luego recarga
/bs downloadallcontent	Descarga solo todos los paquetes de contenido disponibles (sin actualización del plugin)
/bs updatecontent	Descarga actualizaciones para el contenido desactualizado (alias: /bs updateallcontent)
/bs forcereinstallcontent <package|all>	Vuelve a descargar el contenido a través del canal autenticado normal incluso cuando la versión instalada ya está al día. El autocompletado ofrece all más el slug de cada paquete de Nightbreak.
/bs downloadpluginupdate	Descarga una actualización del plugin pendiente. Un reinicio la aplica, salvo que /bs applypluginupdate o la opción nightbreak.applyPluginUpdatesWithoutRestart la apliquen antes.
/bs applypluginupdate	Aplica una actualización del plugin ya descargada sin reiniciar el servidor
/bs reload	Recarga las configuraciones y el contenido de BetterStructures, e importa el contenido pendiente
/bs version	Muestra la versión del plugin

Sobre /bs reload

/bs reload ya no desactiva y reactiva el plugin. Ahora realiza una recarga de contenido en el sitio: config.yml y ValidWorlds.yml se releen en el hilo del servidor, y después se reconstruyen en un hilo de trabajo las configuraciones de tesoro, generadores, generadores de módulos, spawn pools, esquemáticos, módulos y paquetes de contenido. Los comandos, listeners y el adaptador NMS se dejan registrados.

Consecuencias que conviene conocer:

• La recarga cancela la pregeneración y la generación modular activas, y detiene donde estén los pegados de estructuras y mazmorras que sigan en cola o en curso. Los menús de configuración y configuración inicial tampoco están disponibles durante la recarga.
• Mientras se ejecuta una recarga, /bs place, /bs lootify, /bs pregenerate y /bs generateModules se rechazan con un mensaje que indica que el contenido se está recargando, y los análisis de chunks nuevos se conservan hasta que la recarga termine correctamente. Los análisis pendientes de mazmorras también se conservan. Si un chunk en cola se descarga de la memoria, su análisis espera a que vuelva a cargarse.
• Si lanzas /bs reload otra vez mientras hay una en curso, tu petición se pone en cola y después se ejecuta una segunda recarga completa, así que un archivo que cambiaste a mitad de recarga se recoge igualmente.
• Si la recarga falla, BetterStructures se desactiva a propósito en lugar de continuar con registros de contenido a medio llenar. Revisa la consola para ver la causa y reinicia el servidor tras arreglarlo.

Sobre /bs forcereinstallcontent

Las descargas normales omiten un paquete cuya versión local ya coincide con la remota, lo que las vuelve inútiles cuando los archivos del disco se han dañado o borrado parcialmente. forcereinstallcontent se salta esa comprobación de versión y vuelve a pasar el paquete seleccionado por el mismo canal autenticado de descarga, importación y recarga.

• all selecciona todos los paquetes que BetterStructures cree actualmente que están descargados, instalados o desactualizados. Si no coincide ninguno, el comando se rechaza y te pide que indiques un slug directamente, que es justo lo que quieres cuando los archivos de un paquete faltan por completo.
• Indicar un único slug reinstala solo ese paquete.
• Un slug desconocido se rechaza con un mensaje que te remite al autocompletado.

Sobre /bs applypluginupdate

/bs applypluginupdate instala una actualización de BetterStructures que ya está descargada y esperando en la carpeta de actualizaciones del servidor, sin reiniciar. Desactiva BetterStructures y todos los plugins de MagmaGuy que dependen de él, reemplaza el jar y después los vuelve a cargar y activar. Los plugins que se recargan con él aparecen en el chat. Si el nuevo jar no se activa, se vuelve a cargar el jar anterior y la actualización queda preparada para el siguiente reinicio.

El comando se rechaza cuando no hay ninguna actualización preparada, cuando el jar preparado no es válido o no es más reciente que la versión en ejecución, o cuando un plugin de otro autor depende de BetterStructures. En ese caso, reinicia el servidor. Los jefes, arenas e instancias de mazmorra en curso terminan cuando el plugin se recarga.

Para aplicar automáticamente las actualizaciones descargadas, configura nightbreak.applyPluginUpdatesWithoutRestart en config.yml (consulta Configuración del archivo).

Los comandos de descarga/actualización, de plugins recomendados y de actualización del plugin los proporciona el sistema compartido MagmaCore Nightbreak que viene incluido en BetterStructures. El mismo menú de configuración expone una entrada de Actualización del plugin, una entrada de Plugins recomendados y un interruptor de Actualizaciones automáticas (consulta Configuración).

Comandos de utilidad y administración

Comando	Propósito
/bs place <schematic> <type>	Intenta encajar una estructura partiendo del chunk actual del jugador; la búsqueda puede elegir una posición cercana. Tipos válidos: SURFACE, UNDERGROUND_SHALLOW, UNDERGROUND_DEEP, SKY, LIQUID_SURFACE
/bs lootify <generator> <rarity> <minAmount> <maxAmount> <weight>	Añade el ítem sostenido a una tabla de tesoros. El generador debe ser una configuración de tesoro válida, la rareza debe existir en esa configuración, minAmount debe ser al menos 1, maxAmount debe ser como máximo 64 y debes estar sosteniendo un ítem.
/bs pregenerate <centerType> <shape> <radiusInBlocks> <applyWorldBorder>	Pre-genera chunks con BetterStructures activado. El mundo se deriva del mundo actual del jugador. centerType: HERE, WORLD_CENTER, WORLD_SPAWN. shape: SQUARE, CIRCLE. applyWorldBorder: TRUE/FALSE.
/bs cancelPregenerate	Cancela la pre-generación activa en el mundo actual del jugador (alias: /bs cancelpregenerate)
/bs generateModules <generatorFile>	Genera contenido modular desde un archivo generador de módulos
/bs teleport <world> <x> <y> <z>	Teletransporta a una ubicación específica (alias: /bs tp)
/bs silent	Alterna ciertas advertencias de operador

Ten en cuenta estas restricciones al usar los comandos de utilidad:

• /bs place informa de un intento de colocación, no confirma que se haya colocado una estructura.
• Ejecuta /bs lootify dentro del juego con el objeto en la mano principal. Las cantidades y el peso deben ser enteros. Elige 1 <= minAmount <= maxAmount <= 64 y un peso positivo; el comando no rechaza todos los rangos inválidos. Guardar una entrada inicia una recarga del contenido.
• /bs pregenerate acepta un radio de cero o más bloques y redondea hacia arriba a chunks completos. Con applyWorldBorder en TRUE, al terminar establece un borde de mundo cuadrado con diámetro 2 × radiusInBlocks, incluso si la generación es CIRCLE. Cancelar no establece el borde ni revierte los chunks generados. Si un chunk no se carga, la pregeneración se detiene, registra el chunk fallido y deja el borde del mundo sin cambios.
• /bs teleport requiere un mundo cargado y coordenadas enteras; no admite coordenadas relativas.

Permisos

Permiso	Descripción	Predeterminado
betterstructures.setup	Acceso a /bs setup, /bs recommendedplugins, /bs downloadallcontent y /bs updatecontent	OP
betterstructures.initialize	Acceso a /bs initialize	OP
betterstructures.generatemodules	Acceso a /bs generateModules	OP
betterstructures.generatemodules.slowly	Registrado en plugin.yml pero no utilizado actualmente por ningún comando en el código fuente. Probablemente vestigial.	OP
betterstructures.generatemodules.instantly	Registrado en plugin.yml pero no utilizado actualmente por ningún comando en el código fuente. Probablemente vestigial.	OP
betterstructures.*	Comodín para los comandos de utilidad y administración (place, pregenerate, cancelPregenerate, reload, teleport, version, lootify, ayuda de /bs) más los comandos de contenido de administración /bs downloadall, /bs downloadpluginupdate, /bs applypluginupdate y /bs forcereinstallcontent. En manos de los OPs por defecto.	OP
betterstructures.*	También se requiere para /bs silent, que cambia la opción de advertencias de todo el servidor.	OP
betterstructures.warn	Recibe los mensajes clicables de "nuevo edificio generado" y "nueva mazmorra empezó a generarse" mientras warnAdminsAboutNewBuildings sea true. No está declarado en plugin.yml, así que Bukkit se lo da a los OPs por defecto.	OP

betterstructures.setup cubre los comandos de exploración/gestión de contenido, betterstructures.initialize cubre la configuración inicial y betterstructures.generatemodules cubre la generación de mazmorras. El comando combinado de plugin y contenido /bs downloadall, los comandos solo de plugin /bs downloadpluginupdate y /bs applypluginupdate, y el comando de reparación /bs forcereinstallcontent están protegidos tras el comodín de administración betterstructures.*. Las variantes .slowly e .instantly siguen declaradas en plugin.yml pero ningún comando las comprueba actualmente.

Conceder cualquiera de los permisos betterstructures.*, betterstructures.setup, betterstructures.initialize o betterstructures.generatemodules permite acceder al comando raíz. Cada subcomando sigue comprobando su propio permiso, por lo que un administrador dedicado solo a la configuración no necesita el comodín.

betterstructures.* también controla el recordatorio de configuración inicial: quienes lo tengan reciben un mensaje diez segundos después de cada conexión mientras setupDone sea false en config.yml, que les remite a /bs initialize.