CustomStructures: gerando estruturas no seu mundo

O que é o CustomStructures

O CustomStructures é um plugin gratuito do ryandw11 que gera construções personalizadas no seu mundo de Minecraft. Assim como o jogo base gera vilas, templos da selva e fortalezas, o CustomStructures permite adicionar estruturas próprias que aparecem automaticamente em chunks recém-explorados.

O plugin usa arquivos schematic (o formato do WorldEdit/FAWE) como fonte. Você constrói uma estrutura no jogo, salva como schematic e define as condições de geração. Só isso: o plugin coloca a estrutura no terreno enquanto os chunks são gerados.

O CustomStructures está disponível no SpigotMC e suporta as versões 1.13 a 1.21.x.

Como a geração funciona

O plugin se conecta à geração de chunks do Minecraft. Toda vez que o servidor gera um chunk novo (um jogador explora terreno novo), o CustomStructures verifica as condições e coloca uma estrutura com a probabilidade que você definiu:

1. O servidor gera um chunk novo
2. O plugin sorteia se uma estrutura deve aparecer nesse chunk (com base na chance de geração)
3. Ele verifica as condições: bioma, altura, blocos ao redor, distância do spawn
4. Se as condições forem atendidas, ele cola o schematic na posição certa
5. Opcionalmente, ele enche os baús com loot aleatório das loot tables

As estruturas só são geradas em chunks novos. O terreno que já existe não muda quando você adiciona uma estrutura nova, então é preciso explorar áreas inéditas.

Criando uma estrutura

Este é o processo, passo a passo:

1. Construa a estrutura no jogo (ou baixe um schematic pronto)
2. Selecione-a com as ferramentas do WorldEdit (//pos1, //pos2)
3. Salve como schematic: //schem save [nome]
4. Copie o arquivo .schem para plugins/CustomStructures/schematics/
5. Crie o arquivo de configuração da estrutura em plugins/CustomStructures/structures/
6. Recarregue o plugin: /cstructure reload

Dica: ao selecionar a estrutura, inclua blocos de ar onde você quiser que ela substitua o terreno. Os blocos de vazio de estrutura (Minecraft 1.10+) são ignorados, o que é útil quando você quer manter o terreno natural ao redor da estrutura.

Configuração da estrutura

Cada estrutura tem um arquivo YAML em plugins/CustomStructures/structures/:

# dungeon_ruin.yml
schematic: dungeon_ruin.schem
probability:
  chance: 1
  number: 500        # 1 a cada 500 chunks
spawn:
  y: -1              # -1 = nível do solo
  randomRotation: true
  spawnInWater: false
  spawnInLava: false
biomes:
  - PLAINS
  - FOREST
  - DARK_FOREST
  - TAIGA
worlds:
  - world
distance:
  minFromSpawn: 200  # distância mínima do spawn
  minFromOther: 100  # distância mínima de outra estrutura

Parâmetros principais:

• probability - chance de geração (chance/number = probabilidade por chunk)
• biomes - os biomas em que a estrutura pode aparecer
• worlds - os mundos em que a estrutura é gerada
• distance - distâncias mínimas que evitam estruturas muito amontoadas
• randomRotation - rotação aleatória ao colar (0/90/180/270 graus)

Loot tables e baús

O CustomStructures suporta loot aleatório em baús colocados dentro das estruturas. Uma loot table fica assim:

# No arquivo da estrutura
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

Os baús do schematic são preenchidos automaticamente com itens aleatórios da loot table. O weight define a chance de um item ser escolhido. Rolls é quantas vezes o plugin sorteia um item: um intervalo de 3-6 significa de 3 a 6 sorteios.

Você também pode usar as loot tables do Minecraft (por exemplo minecraft:chests/simple_dungeon), o que mantém o loot consistente com o resto do jogo.

Dicas e otimização

• Teste antes de publicar - use /cstructure test [nome] para colar a estrutura manualmente e ver como ela fica no terreno
• Não exagere - estruturas demais com probabilidade alta deixam a geração de chunks mais lenta. Comece com chances baixas (1/500-1/1000)
• Use o vazio de estrutura - blocos de vazio de estrutura mantêm o terreno natural ao redor da estrutura, o que dá um visual mais orgânico
• Pré-gere o mundo - depois de adicionar estruturas, pré-gere o mapa com o Chunky para distribuir a carga da geração ao longo do tempo
• Varie o loot - estruturas mais distantes ou maiores devem ter loot melhor. Isso dá aos jogadores um motivo para explorar
• Compatibilidade - o CustomStructures funciona com geradores de terreno como Terra ou Iris. As estruturas são coladas depois que o terreno é gerado

Alternativas: StructureBoxes (mais simples de configurar), Advancius Structures (premium, com mais opções) e os data packs nativos do Minecraft, que também podem adicionar estruturas personalizadas.