Estruturas

Exemplo completo de configuração

Aqui está um exemplo completo de como configurar uma estrutura:

# Nome da ESTRUTURA
display-name: '&aTorre de Cacto'

# Bloco que irá aparecer no preview caso esteja bloqueado de por
preview-block: 'STAINED_GLASS:14'

# Alterar a altura do y ao colocar (se quiser colocar pra setar no ar/setar dentro do solo)
y-offset: 0

# Blocos que serão desconsiderados e removidos ao setar a estrutura
block-blacklist: [ 'GRASS', 'STONE' ]

# Quantia de vezes que a estrutura irá se repetir (para cima)
y-repeat-amount: 3

# Quantia de vezes que a estrutura irá se repetir (para os lados)
xz-repeat-amount: 1

# Distância em blocos pros lados
xz-distance: 4.0

# Colocar de modo gradual
gradual: false

# Item que o jogador irá receber
item:
  material: CACTUS
  name: '&aTorre de Cactos'
  lore:
    - '&fTamanho: &76x'
    - ''
    - '&fSHIFT + Direito'

# Siglas de cada bloco para identificação no pattern
blocks:
  - 'C,CACTUS'
  - 'X,AIR'
  - 'D,DIRT'
  - 'S,SAND'
  - 'L,WOOD_STEP'

# Modelagem da estrutura
patterns:
  sand1:
    y: 1
    pattern:
      - 'SXS'
      - 'XSX'
      - 'SXS'
  cactus:
    y: 2
    pattern:
      - 'CLC'
      - 'LCL'
      - 'CLC'
  sand2:
    y: 3
    pattern:
      - 'XSX'
      - 'SXS'
      - 'XSX'
  cactus2:
    y: 4
    pattern:
      - 'LCL'
      - 'CLC'
      - 'LCL'

Opções disponíveis na configuração

display-name

Nome de exibição da estrutura que será mostrado ao jogador.

Exemplo:

display-name: '&aTorre de Cacto'

Use códigos de cor (&) para colorir o nome da estrutura.

preview-block

Bloco que será exibido no preview quando a estrutura não puder ser colocada em determinado local.

Exemplo:

preview-block: 'STAINED_GLASS:14'

Use o formato MATERIAL:DATA para blocos com data values (ex: STAINED_GLASS:14 para vidro vermelho).

y-offset

Altera a altura Y ao colocar a estrutura. Útil para ajustar a posição vertical.

Exemplo:

y-offset: 0

Use valores negativos para colocar a estrutura abaixo do nível atual, ou positivos para acima.

block-blacklist

Lista de blocos que serão ignorados e removidos ao colocar a estrutura.

Exemplo:

block-blacklist: [ 'GRASS', 'STONE' ]

Útil para substituir blocos naturais como grama ou pedra ao colocar a estrutura.

y-repeat-amount

Quantidade de vezes que a estrutura será repetida verticalmente (para cima).

Exemplo:

y-repeat-amount: 3

xz-repeat-amount

Quantidade de vezes que a estrutura será repetida horizontalmente (nos eixos X e Z).

Exemplo:

xz-repeat-amount: 1

xz-distance

Distância em blocos entre cada repetição horizontal da estrutura.

Exemplo:

xz-distance: 4.0

gradual

Define se a estrutura será colocada gradualmente (bloco por bloco) ou instantaneamente.

Exemplo:

gradual: false

Valores válidos: true, false

item

Configuração do item que representa a estrutura no inventário do jogador.

Exemplo:

item:
  material: CACTUS
  name: '&aTorre de Cactos'
  lore:
    - '&fTamanho: &76x'
    - ''
    - '&fSHIFT + Direito'

material

Material do item no inventário.

name

Nome do item com suporte a códigos de cor.

lore

Lista de linhas de descrição do item.

blocks

Lista de siglas e seus blocos correspondentes usados nos patterns.

Exemplo:

blocks:
  - 'C,CACTUS'
  - 'X,AIR'
  - 'D,DIRT'
  - 'S,SAND'
  - 'L,WOOD_STEP'

O formato é SIGLA,MATERIAL. Cada sigla deve ter apenas uma letra para facilitar a modelagem dos patterns.

patterns

Define a modelagem da estrutura através de patterns em diferentes níveis de altura.

Exemplo:

patterns:
  sand1:
    y: 1
    pattern:
      - 'SXS'
      - 'XSX'
      - 'SXS'
  cactus:
    y: 2
    pattern:
      - 'CLC'
      - 'LCL'
      - 'CLC'

Cada pattern possui:

Identificador

Nome único do pattern (ex: sand1, cactus).

y

Nível de altura Y em que o pattern será colocado.

pattern

Lista de strings representando a estrutura em 3D. Cada linha é uma linha Z, e cada caractere representa um bloco no eixo X.

Os patterns são lidos de cima para baixo. Cada lista de strings representa uma "camada" vista de cima.

Criando sua própria estrutura

Crie um novo arquivo

Crie um novo arquivo .yml dentro da pasta plugins/yTorreDeCacto/structures/.

Exemplo: minha_estrutura.yml

Defina as propriedades básicas

Configure o nome, bloco de preview e offsets:

display-name: '&bMinha Estrutura'
preview-block: 'STAINED_GLASS:11'
y-offset: 0
block-blacklist: []

Configure as repetições

Defina quantas vezes a estrutura se repetirá:

y-repeat-amount: 1
xz-repeat-amount: 1
xz-distance: 0.0
gradual: false

Configure o item

Defina como o item aparecerá no inventário:

item:
  material: DIAMOND_BLOCK
  name: '&bMinha Estrutura'
  lore:
    - '&7Clique para usar'

Defina os blocos

Liste todas as siglas e blocos que usará:

blocks:
  - 'D,DIAMOND_BLOCK'
  - 'G,GOLD_BLOCK'
  - 'X,AIR'

Crie os patterns

Modele sua estrutura camada por camada:

patterns:
  camada1:
    y: 1
    pattern:
      - 'DGD'
      - 'GXG'
      - 'DGD'
  camada2:
    y: 2
    pattern:
      - 'XXX'
      - 'XDX'
      - 'XXX'

Reinicie o servidor

Reinicie o servidor para carregar a nova estrutura.

Teste a estrutura

Use /torre give <jogador> <estrutura> <quantidade> para testar sua criação!

Dicas para criar estruturas

Use siglas simples e fáceis de lembrar (uma letra por bloco)
Comece com estruturas pequenas antes de criar grandes
Use X ou A para representar ar
Teste as coordenadas Y para garantir que as camadas estejam na ordem correta
Use o preview para visualizar antes de colocar

Estruturas muito grandes podem causar lag. Use gradual: true para estruturas complexas.

Nesta página