Configuración de BetterStructures

Esta página es la referencia de los dos archivos de configuración a nivel de plugin que BetterStructures escribe en plugins/BetterStructures. La configuración a nivel de contenido vive en otro sitio: consulta Crear generadores, Crear estructuras, Crear tesoros y Mazmorras modulares.

Ambos archivos se releen en el hilo del servidor cada vez que ejecutas /bs reload, así que no necesitas reiniciar para aplicar un cambio aquí.

Disposición de carpetas

Ruta	Contenido
config.yml	Ajustes globales del plugin, documentados más abajo
ValidWorlds.yml	Interruptores de activación/desactivación por mundo, documentados más abajo
schematics/	Archivos .schem de estructuras y sus configuraciones .yml generadas, escaneados de forma recursiva
modules/	Archivos .schem de mazmorras modulares y sus configuraciones .yml generadas, escaneados de forma recursiva
generators/	Configuraciones de generadores
module_generators/	Configuraciones de generadores de módulos
treasures/	Configuraciones de tesoros (tablas de botín)
spawn_pools/	Configuraciones de spawn pools usadas por los carteles [pool: name]
content_packages/	Descriptores de paquetes usados por el menú de configuración y los comandos de descarga
components/	Se crea vacía al arrancar, para el contenido que incluya componentes de apoyo
imports/	Carpeta de arrastrar y soltar para importaciones manuales de contenido
.schematic_cache/	Caché gestionada de esquemáticos convertidos, se puede borrar sin problema

---

config.yml

Espaciado de estructuras

BetterStructures coloca las estructuras sobre una cuadrícula en diamante generada a partir de la semilla, una cuadrícula por tipo de estructura. Las claves de distancia establecen a qué separación quedan los puntos de la cuadrícula, y las claves de desplazamiento apartan cada punto de la cuadrícula para que las colocaciones no parezcan mecánicas.

Ambas se miden en chunks, no en bloques. Un distanceSurface de 27 significa aproximadamente una estructura de superficie cada 27 chunks (unos 432 bloques).

Clave	Predeterminado	Descripción
distanceSurface	27	Separación de la cuadrícula para estructuras SURFACE
distanceShallow	22	Separación de la cuadrícula para estructuras UNDERGROUND_SHALLOW
distanceDeep	22	Separación de la cuadrícula para estructuras UNDERGROUND_DEEP
distanceSky	90	Separación de la cuadrícula para estructuras SKY
distanceLiquid	60	Separación de la cuadrícula para estructuras LIQUID_SURFACE
distanceDungeonV2	80	Separación de la cuadrícula para las colocaciones DUNGEON
maxOffsetSurface	5	Desviación aleatoria aplicada a los puntos de cuadrícula de superficie
maxOffsetShallow	5	Desviación aleatoria aplicada a los puntos de cuadrícula subterráneos poco profundos
maxOffsetDeep	5	Desviación aleatoria aplicada a los puntos de cuadrícula subterráneos profundos
maxOffsetSky	5	Desviación aleatoria aplicada a los puntos de cuadrícula del cielo
maxOffsetLiquid	5	Desviación aleatoria aplicada a los puntos de cuadrícula de superficie líquida
maxOffsetDungeonV2	18	Desviación aleatoria aplicada a los puntos de cuadrícula de mazmorras

Distancias más pequeñas significan más estructuras. Desplazamientos más pequeños producen colocaciones más parecidas a una cuadrícula; desplazamientos mayores producen colocaciones menos predecibles.

Validación. Las distancias deben ser como mínimo 1. Los desplazamientos deben estar entre 0 y 1073741823, el mayor valor que el aleatorizador de colocación puede usar con seguridad. Un valor fuera de su rango hace que BetterStructures registre una advertencia, vuelva a escribir el valor predeterminado de esa clave en config.yml y continúe con el predeterminado en lugar de fallar la generación.

Los desplazamientos se derivan de la semilla del mundo y del nombre del tipo de estructura, así que la misma semilla produce la misma disposición en cada reinicio.

Protección del punto de origen

Clave	Predeterminado	Descripción
spawnProtectionRadius	100	Distancia mínima en bloques desde las coordenadas 0, 0 dentro de la cual no se coloca ninguna estructura. Se aplica a todos los mundos. Ponlo en 0 para desactivarlo.

Ten en cuenta que se mide desde el origen del mundo, no desde el punto de aparición de cada mundo.

Límites de altitud

Estos limitan dónde pueden acabar las estructuras subterráneas, por dimensión. Una estructura cuyo anclaje quedaría fuera del rango se devuelve dentro de él.

Clave	Predeterminado	Descripción
lowestYNormalCustom	-60	Y mínima para los mundos NORMAL y CUSTOM
highestYNormalCustom	320	Y máxima para los mundos NORMAL y CUSTOM
lowestYNether	4	Y mínima en el Nether
highestYNether	120	Y máxima en el Nether
lowestYEnd	0	Y mínima en el End
highestYEnd	320	Y máxima en el End

Las estructuras del cielo usan sus propios ajustes, y estos son desplazamientos por encima del bloque más alto de la columna, no niveles de Y absolutos. Para cada colocación se sortea un valor aleatorio entre el mínimo y el máximo.

Clave	Predeterminado	Descripción
normalCustomAirBuildingMinAltitude	80	Desplazamiento mínimo en el cielo en los mundos NORMAL y CUSTOM
normalCustomAirBuildingMaxAltitude	120	Desplazamiento máximo en el cielo en los mundos NORMAL y CUSTOM
endAirBuildMinAltitude	80	Desplazamiento mínimo en el cielo en el End
endAirBuildMaxAltitude	120	Desplazamiento máximo en el cielo en el End

El Nether ignora los cuatro: allí las estructuras del cielo se colocan dentro de una bolsa de aire encontrada escaneando entre la Y 45 y la Y 100.

Rendimiento

Clave	Predeterminado	Descripción
percentageOfTickUsedForPasting	0.2	Parte de cada tick del servidor que BetterStructures puede dedicar a pegar bloques, de 0.01 (1%) a 1 (100%). Valores más bajos reducen el lag pero hacen que las construcciones aparezcan de forma más visible.
percentageOfTickUsedForPregeneration	0.1	Parte de cada tick del servidor usada por /bs pregenerate, con el mismo rango de 0.01 a 1
pregenerationTPSPauseThreshold	12.0	La pregeneración se pausa cuando los TPS del servidor caen por debajo de este valor
pregenerationTPSResumeThreshold	14.0	La pregeneración se reanuda cuando los TPS están en este valor o por encima. Mantenlo por encima del umbral de pausa para evitar ciclos rápidos de pausa/reanudación.
modularChunkPastingSpeed	10	Actualmente sin uso. La clave se sigue escribiendo en config.yml, pero nada la lee, así que cambiarla no tiene ningún efecto.

Administración e integración

Clave	Predeterminado	Descripción
warnAdminsAboutNewBuildings	true	Si los jugadores conectados con betterstructures.warn (los OPs por defecto) reciben un mensaje clicable de teletransporte cuando una estructura termina de pegarse o una mazmorra modular empieza a generarse, en cualquier parte del servidor. /bs silent invierte este valor y lo guarda.
setupDone	false	Si se ha completado el flujo de configuración inicial. Ponlo en false y recarga para que /bs initialize vuelva a avisar.
protectEliteMobsRegions	true	Si BetterStructures crea protección de WorldGuard para las zonas de combate respaldadas por EliteMobs. Requiere tanto WorldGuard como EliteMobs.
regionProtectedMessage	&8[BetterStructures] &cDefeat the zone's bosses to edit blocks!	Mensaje mostrado cuando un jugador intenta editar bloques dentro de una de esas regiones protegidas
nightbreak.autoDownloadPluginUpdates	false	Si las actualizaciones de plugin y de contenido se descargan automáticamente al arrancar. Esta es la clave que hay detrás del interruptor de Actualizaciones automáticas en /bs setup. Las actualizaciones de contenido y del plugin descargadas se usan tras el siguiente reinicio, salvo que nightbreak.applyPluginUpdatesWithoutRestart aplique antes la actualización del plugin.
nightbreak.applyPluginUpdatesWithoutRestart	never	Cuándo se aplica una actualización del plugin descargada. never espera al siguiente reinicio. when-empty la aplica la próxima vez que no haya jugadores conectados, comprobándolo cada 30 segundos. immediately la aplica en cuanto se descarga. Cualquier otro valor cuenta como never. Aplicar una actualización recarga BetterStructures y los plugins de MagmaGuy que dependen de él, así que los jefes, arenas e instancias de mazmorra en curso terminan. Un plugin de otro autor que dependa de BetterStructures bloquea el cambio. /bs applypluginupdate aplica bajo demanda una actualización preparada.

---

ValidWorlds.yml

Este archivo decide en qué mundos genera BetterStructures.

New worlds spawn structures: true
Valid worlds v2:
  world: true
  world_nether: true
  world_the_end: true

Clave	Predeterminado	Descripción
New worlds spawn structures	true	Si un mundo que BetterStructures no ha visto antes se registra como activado
Valid worlds v2	se rellena automáticamente	Una entrada worldname: true/false por mundo. Pon un mundo en false para detener toda la generación de estructuras en él.

Al actualizar, un ValidWorlds.yml que contenga la antigua clave Valid worlds se mueve intacto a plugins/MagmaCore/outdated files/BetterStructures/<archive batch>/ValidWorlds.yml. BetterStructures genera un archivo nuevo con los valores predeterminados actuales de los mundos. Revisa tus elecciones anteriores en el archivo guardado y vuelve a aplicar las que quieras bajo Valid worlds v2; después ejecuta /bs reload. No restaures el archivo antiguo sin modificarlo, porque seguirá coincidiendo con el formato retirado.

Comportamiento automático

• Los mundos nuevos se registran al cargarse. Un mundo que se carga por primera vez recibe una entrada escrita inmediatamente, usando New worlds spawn structures como valor.
• Los mundos gestionados por EliteMobs quedan excluidos. El hub del gremio de aventureros y las copias instanciadas de mazmorras se registran como false incluso cuando New worlds spawn structures es true, porque sus chunks vacíos sin construir cuentan como chunks nuevos y hacían que BetterStructures decorara los hubs de mazmorras. La entrada se sigue escribiendo, así que volver a ponerla en true funciona si eso es realmente lo que quieres.
• Las decisiones en el formato actual se conservan. BetterStructures no deduce la propiedad de un mundo por el nombre em_ ni reescribe una opción existente de Valid worlds v2. Utiliza el registro de mundos de EliteMobs para los valores predeterminados de mundos nuevos. Un mundo de EliteMobs activado explícitamente sigue activado y produce una advertencia para que decidas si cambiarlo. Los archivos antiguos con Valid worlds siguen el proceso de archivado y regeneración descrito anteriormente.
• Las entradas muertas se eliminan. Al arrancar, y unos diez segundos después de que un mundo se descargue, se eliminan las entradas cuyo mundo no está ni cargado ni presente en el disco, para que el archivo no crezca indefinidamente.