Saltar al contenido principal

Comandos de BetterStructures

Usa /betterstructures o /bs.

Configuración y contenido

ComandoPropósito
/bsComando principal de ayuda y estado
/bs initializeFlujo de configuración inicial (abre el menú de configuración inicial)
/bs setupAbre el menú de configuración/contenido
/bs recommendedpluginsMuestra plugins complementarios que funcionan bien con BetterStructures
/bs downloadallDescarga la actualización del plugin (si la hay) y todo el contenido disponible, y luego recarga
/bs downloadallcontentDescarga solo todos los paquetes de contenido disponibles (sin actualización del plugin)
/bs updatecontentDescarga 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 downloadpluginupdateDescarga una actualización del plugin pendiente (requiere un reinicio para aplicarse)
/bs reloadRecarga las configuraciones y el contenido de BetterStructures, e importa el contenido pendiente
/bs versionMuestra 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:

  • Mientras se está ejecutando una recarga, /bs place, /bs lootify, /bs pregenerate y /bs generateModules se rechazan con un mensaje de "content is reloading", y los chunks recién generados se omiten en lugar de escanearse.
  • 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.

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

ComandoPropósito
/bs place <schematic> <type>Coloca una estructura manualmente. 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 cancelPregenerateCancela 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 silentAlterna ciertas advertencias de operador

Permisos

PermisoDescripciónPredeterminado
betterstructures.setupAcceso a /bs setup, /bs recommendedplugins, /bs downloadallcontent y /bs updatecontentOP
betterstructures.initializeAcceso a /bs initializeOP
betterstructures.generatemodulesAcceso a /bs generateModulesOP
betterstructures.generatemodules.slowlyRegistrado en plugin.yml pero no utilizado actualmente por ningún comando en el código fuente. Probablemente vestigial.OP
betterstructures.generatemodules.instantlyRegistrado 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 y /bs forcereinstallcontent. En manos de los OPs por defecto.OP
(ninguno)/bs silent no tiene comprobación de permisos en el código fuente — cualquier remitente puede ejecutarlo.

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, el comando solo de plugin /bs downloadpluginupdate 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.

betterstructures.* también controla el recordatorio de configuración inicial: los jugadores que lo tengan reciben un mensaje único al conectarse que les remite a /bs initialize, hasta que setupDone se ponga en true en config.yml.