Crear Generadores

Generadores

Los generadores son la parte más poderosa del sistema de configuración de BetterStructures. Por defecto hay 29 generadores que gestionan colectivamente las construcciones distribuidas actualmente por BetterStructures y, aunque puedes crear tus propios generadores, también puedes usar los existentes como atajo.

Los generadores le dicen al plugin dónde exactamente deben aparecer las cosas y definen las tablas de botín. Los generadores predeterminados también están nombrados de manera que debería ser muy fácil adivinar lo que hacen.

Opciones de configuración del generador

Clave	Predeterminado	Obligatorio	Descripción
isEnabled	true	❌	Si el generador está habilitado
structureType	-	✅	Dónde aparecen las estructuras (ver tabla abajo)
lowestYLevel	-59	❌	Nivel Y mínimo para la aparición
highestYLevel	320	❌	Nivel Y máximo para la aparición
validWorlds	Todos permitidos	❌	Lista de mundos donde las estructuras pueden aparecer
validWorldEnvironments	Todos permitidos	❌	NORMAL, NETHER, THE_END
validBiomesV2	Todos los biomas	❌	Lista de biomas válidos (formato namespace:key)
treasureFilename	-	❌	Archivo de tesoro para el botín de cofres
generateLootInBarrels	true	❌	Si los barriles encontrados en los schematics de este generador deben llenarse con botín
barrelTreasureFilename	treasure_barrel_food.yml	❌	Archivo de tesoro usado para llenar los barriles de este generador

---

structureType

Establece qué tipo de estructura es la construcción. ¡Puedes especificar múltiples tipos de estructura para un solo generador!

Tipo	Overworld	Nether	End	Descripción
SURFACE	Superficie	Puntos similares a superficie	Superficie	Aparece en la superficie del mundo
SKY	Y 80-120	Puntos similares a aire	Y 80-120	Aparece en el cielo (configurable en config.yml)
UNDERGROUND_SHALLOW	Y 0-60	Y 60-120	Alturas válidas	Estructuras subterráneas poco profundas
UNDERGROUND_DEEP	Y -64 a 0	Y 0-60	❌ No aparece	Estructuras subterráneas profundas
LIQUID_SURFACE	Agua (océanos)	Lagos de lava	❌ No aparece	Aparece en superficies líquidas
DUNGEON	✅	✅	✅	Usado para colocación de mazmorras modulares

Ejemplo de múltiples tipos de estructura

structureType:
- SURFACE
- UNDERGROUND_SHALLOW

Esto permite al mismo generador generar estructuras en múltiples ubicaciones, como tanto en la superficie como en áreas subterráneas poco profundas.

Nota: Hay dos configuraciones subterráneas porque Minecraft tiene mucho espacio subterráneo. Tener ambas asegura una distribución uniforme a través de las profundidades y evita que los jugadores se pierdan estructuras.

---

Rangos de nivel Y por dimensión

Rangos de altitud predeterminados por dimensión (configurables en config.yml):

Dimensión	Rango predeterminado	Configuraciones
Overworld/Personalizado	Y=-60 a Y=320	lowestYNormalCustom / highestYNormalCustom
Nether	Y=4 a Y=120	lowestYNether / highestYNether
End	Y=0 a Y=320	lowestYEnd / highestYEnd
Cielo (Overworld)	Y=80 a Y=120	normalCustomAirBuildingMinAltitude / Max...
Cielo (End)	Y=80 a Y=120	endAirBuildMinAltitude / Max...

Estos valores predeterminados pueden ser anulados por generador usando lowestYLevel y highestYLevel.

---

Soporte de biomas personalizados

BetterStructures soporta automáticamente biomas personalizados de generadores de mundo como Terralith, Iris, Terra y TerraformGenerator.

Cuando especificas un bioma vanilla en validBiomesV2, el plugin incluye automáticamente biomas personalizados compatibles:

validBiomesV2:
  - minecraft:plains
  - minecraft:forest

Esto genera estructuras en los biomas vanilla Y todos los biomas personalizados mapeados a estos tipos (p.ej., terralith:blooming_plains).

---

treasureFilename

Establece el archivo de tesoro para el botín de cofres. Esto se aplica a todas las construcciones que usan este generador, a menos que se anule en la configuración del schematic.

---

generateLootInBarrels y barrelTreasureFilename

BetterStructures ahora trata los barriles como un segundo contenedor de botín junto a los cofres.

• generateLootInBarrels (predeterminado true) alterna si los barriles dentro de las estructuras colocadas por este generador se llenan. Establécelo en false para dejar los barriles intactos.
• barrelTreasureFilename (predeterminado treasure_barrel_food.yml) selecciona qué archivo de tesoro se sortea al llenar esos barriles. El predeterminado incluye una tabla de botín ligera centrada en comida, pero puedes apuntarlo a cualquier archivo de tesoro.

Ambas opciones pueden anularse por schematic con el campo barrelTreasureFilename correspondiente en la configuración del schematic.