Configuração

O plugin deve funcionar sem necessidade de configuração adicional, mas se você precisar alterar o comportamento do plugin, você está no lugar certo.

Após alterar a configuração, é necessário reiniciar o servidor.

Estrutura de arquivos

Abaixo está um exemplo de como é a estrutura de arquivos do plugin. Clique em uma pasta para expandi-la.

cactus_tower.yml

commands.yml

config.yml

messages.yml

Configuração do plugin (config.yml)

O arquivo config.yml controla o comportamento do sistema de preview e colocação das estruturas. Abaixo estão todas as opções disponíveis com explicações detalhadas.

general

Configurações gerais do sistema de preview e placement das estruturas.

general:
  # Ativar o preview no shift
  shift-preview-enabled: true
  # Ativar o preview sem shift
  no-shift-preview-enabled: true
  # Ativar o place no shift
  shift-place: true
  # Ativar o place sem shift
  no-shift-place: false
  # Tempo que levará para atualizar o preview
  # em ticks (20 ticks = 1 segundo)
  refresh-time: 5
  # Distância do preview
  # em blocos
  preview-distance: 5
  # Ativar o uso da task síncrona
  sync-task: false

shift-preview-enabled

Ativa ou desativa o preview da estrutura quando o jogador segura Shift enquanto olha para onde quer colocar.

shift-preview-enabled: true

true - Mostra preview ao segurar Shift
false - Não mostra preview ao segurar Shift

O preview ajuda o jogador a visualizar onde a estrutura será colocada antes de confirmar.

no-shift-preview-enabled

Ativa ou desativa o preview da estrutura quando o jogador não está segurando Shift.

no-shift-preview-enabled: true

true - Mostra preview sem segurar Shift
false - Não mostra preview sem segurar Shift

Configuração recomendada:

shift-preview-enabled: true
no-shift-preview-enabled: true

Desta forma, o preview sempre aparece quando o jogador está com o item na mão.

shift-place

Define se a estrutura pode ser colocada quando o jogador clica com botão direito segurando Shift.

shift-place: true

true - Permite colocar segurando Shift
false - Não permite colocar segurando Shift

no-shift-place

Define se a estrutura pode ser colocada quando o jogador clica com botão direito sem segurar Shift.

no-shift-place: false

true - Permite colocar sem segurar Shift
false - Não permite colocar sem segurar Shift

Combinações úteis:

shift-place	no-shift-place	Resultado
`true`	`false`	Estrutura só é colocada com Shift (recomendado)
`false`	`true`	Estrutura só é colocada sem Shift
`true`	`true`	Estrutura é colocada em qualquer situação
`false`	`false`	Estrutura nunca é colocada (apenas preview)

A configuração padrão (shift-place: true e no-shift-place: false) evita colocações acidentais.

refresh-time

Intervalo em ticks para atualizar o preview da estrutura. Define a velocidade de resposta visual.

refresh-time: 5

Valor padrão: 5 (0.25 segundos)
Valores menores: Preview mais responsivo, mas pode causar lag
Valores maiores: Menos lag, mas preview mais lento

Conversão de ticks:

Ticks	Segundos
1	0.05s
5	0.25s
10	0.5s
20	1.0s

Valores muito baixos (1-2) podem causar lag em servidores com muitos jogadores.

preview-distance

Distância máxima em blocos na qual o preview da estrutura será exibido.

preview-distance: 5

Valor padrão: 5 blocos
Alcance recomendado: 3-10 blocos

O jogador precisa estar olhando para um bloco dentro desta distância para ver o preview.

Exemplo:

preview-distance: 3  # Preview mais próximo, melhor performance
preview-distance: 10 # Preview mais longe, mais flexibilidade

sync-task

Define se o processamento de colocação da estrutura será síncrono (na thread principal) ou assíncrono.

sync-task: false

false - Processa assincronamente (recomendado, melhor performance)
true - Processa sincronamente (pode causar lag)

Quando usar true:

Problemas de compatibilidade com outros plugins
Estruturas muito pequenas (1-10 blocos)
Bugs visuais com processamento assíncrono

Quando usar false (recomendado):

Estruturas médias e grandes
Servidores com múltiplos jogadores
Performance é prioridade

Usar sync-task: true em estruturas grandes pode causar travamentos e lag severo no servidor. Use apenas se necessário.

Exemplos de configuração

Configuração para servidores pequenos

general:
  shift-preview-enabled: true
  no-shift-preview-enabled: true
  shift-place: true
  no-shift-place: false
  refresh-time: 3  # Preview mais rápido
  preview-distance: 7
  sync-task: false

Configuração para servidores grandes

general:
  shift-preview-enabled: true
  no-shift-preview-enabled: false  # Preview apenas com Shift
  shift-place: true
  no-shift-place: false
  refresh-time: 10  # Preview mais lento, menos lag
  preview-distance: 5
  sync-task: false

Configuração para máxima performance

general:
  shift-preview-enabled: true
  no-shift-preview-enabled: false
  shift-place: true
  no-shift-place: false
  refresh-time: 20  # Atualiza a cada 1 segundo
  preview-distance: 3
  sync-task: false

Nesta página