Discord
CustomStructures
Wiki - Plugins

CustomStructures: genera estructuras en tu mundo

CustomStructures genera construcciones personalizadas en los chunks recién generados de tu mundo de Minecraft. Crea tus propias mazmorras, aldeas y ruinas a partir de archivos schematic, y el plugin las coloca en el terreno según las condiciones que configures.

Tiempo de lectura: ~5 min Plataforma: Paper / Spigot / Purpur

Qué es CustomStructures

CustomStructures es un plugin gratuito de ryandw11 que genera construcciones personalizadas en tu mundo de Minecraft. Igual que el juego base genera aldeas, templos de la jungla y fortalezas, CustomStructures te permite añadir tus propias estructuras, que aparecen solas en los chunks que se exploran por primera vez.

El plugin usa archivos schematic (el formato de WorldEdit/FAWE) como fuente. Construyes una estructura en el juego, la guardas como schematic y defines las condiciones de aparición. Y ya: el plugin coloca la estructura en el terreno mientras se generan los chunks.

CustomStructures está disponible en SpigotMC y es compatible con las versiones 1.13 a 1.21.x.

Cómo funciona la generación

El plugin se engancha a la generación de chunks de Minecraft. Cada vez que el servidor genera un chunk nuevo (un jugador explora terreno nuevo), CustomStructures revisa las condiciones y coloca una estructura con la probabilidad que hayas definido:

  1. El servidor genera un chunk nuevo
  2. El plugin sortea si debe aparecer una estructura en ese chunk (según la probabilidad de aparición)
  3. Revisa las condiciones: bioma, altura, bloques alrededor, distancia al spawn
  4. Si se cumplen, pega el schematic en la posición correcta
  5. Opcionalmente, llena los cofres con botín aleatorio de las loot tables

Las estructuras solo se generan en chunks nuevos. El terreno que ya existe no cambia al agregar una estructura nueva, así que tienes que explorar zonas sin visitar.

Crear una estructura

Este es el proceso, paso a paso:

  1. Construye la estructura en el juego (o descarga un schematic ya hecho)
  2. Selecciónala con las herramientas de WorldEdit (//pos1, //pos2)
  3. Guárdala como schematic: //schem save [nombre]
  4. Copia el archivo .schem a plugins/CustomStructures/schematics/
  5. Crea el archivo de configuración de la estructura en plugins/CustomStructures/structures/
  6. Recarga el plugin: /cstructure reload

Consejo: al seleccionar la estructura, incluye bloques de aire donde quieras que reemplace el terreno. Los bloques de vacío estructural (Minecraft 1.10+) se ignoran, lo cual es útil cuando quieres conservar el terreno natural alrededor de la estructura.

Configuración de la estructura

Cada estructura tiene un archivo YAML en plugins/CustomStructures/structures/:

# dungeon_ruin.yml
schematic: dungeon_ruin.schem
probability:
  chance: 1
  number: 500        # 1 de cada 500 chunks
spawn:
  y: -1              # -1 = nivel del suelo
  randomRotation: true
  spawnInWater: false
  spawnInLava: false
biomes:
  - PLAINS
  - FOREST
  - DARK_FOREST
  - TAIGA
worlds:
  - world
distance:
  minFromSpawn: 200  # distancia mínima al spawn
  minFromOther: 100  # distancia mínima a otra estructura

Parámetros principales:

  • probability: probabilidad de aparición (chance/number = probabilidad por chunk)
  • biomes: los biomas donde puede aparecer la estructura
  • worlds: los mundos donde se genera la estructura
  • distance: distancias mínimas para que las estructuras no queden demasiado juntas
  • randomRotation: rotación aleatoria al pegar (0/90/180/270 grados)

Loot tables y cofres

CustomStructures admite botín aleatorio en los cofres colocados dentro de las estructuras. Una loot table se ve así:

# En el archivo de la estructura
lootTables:
  default:
    rolls: 3-6
    items:
      - material: IRON_INGOT
        amount: 1-5
        weight: 30
      - material: GOLD_INGOT
        amount: 1-3
        weight: 15
      - material: DIAMOND
        amount: 1-2
        weight: 5
      - material: ENCHANTED_BOOK
        amount: 1
        weight: 10

Los cofres del schematic se llenan automáticamente con objetos aleatorios de la loot table. El weight define qué tan probable es que se elija un objeto. Rolls es cuántas veces el plugin elige un objeto: un rango de 3-6 significa de 3 a 6 tiradas.

También puedes usar las loot tables del Minecraft vanilla (por ejemplo minecraft:chests/simple_dungeon), así el botín es coherente con el resto del juego.

Consejos y optimización

  • Prueba antes de publicar: usa /cstructure test [nombre] para pegar la estructura a mano y ver cómo queda en el terreno
  • No te pases: demasiadas estructuras con probabilidad alta hacen más lenta la generación de chunks. Empieza con probabilidades bajas (1/500-1/1000)
  • Usa vacío estructural: los bloques de vacío estructural conservan el terreno natural alrededor de la estructura, lo que da un aspecto más orgánico
  • Pregenera el mundo: después de agregar estructuras, pregenera el mapa con Chunky para repartir la carga de generación en el tiempo
  • Varía el botín: las estructuras más lejanas o más grandes deberían tener mejor botín. Le da a los jugadores una razón para explorar
  • Compatibilidad: CustomStructures funciona con generadores de terreno como Terra o Iris. Las estructuras se pegan después de generar el terreno

Alternativas: StructureBoxes (más sencillo de configurar), Advancius Structures (premium, con más opciones) y los datapacks integrados de Minecraft, que también pueden añadir estructuras personalizadas.