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.

Estrutura de arquivos

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

Configuração do plugin (config.yml)

O arquivo config.yml é o coração do plugin, onde você controla todos os aspectos do funcionamento dos terrenos. Abaixo estão todas as opções disponíveis com explicações detalhadas.

debug-mode

Ativa ou desativa o modo de depuração. Quando ativado, o plugin registrará informações detalhadas no console para ajudar a identificar problemas.

# Determina o funcionamento da depuração. Valores válidos: [false, true]
debug-mode: false

database

Define como e onde os dados dos terrenos serão armazenados. O plugin suporta três tipos de armazenamento:

• SQLITE: Armazena dados em um arquivo local. Ideal para servidores pequenos.
• MYSQL: Conecta a um servidor MySQL externo. Recomendado para servidores médios.
• HIKARI: Usa pool de conexões para MySQL. Recomendado para servidores grandes por melhor performance.

database:
  # Determina o tipo de banco de dados. Valores válidos: [SQLITE, MYSQL, HIKARI (recomendado)]
  storage-type: SQLITE

  # Dados para conexão ao banco de dados MYSQL.
  data:
    # Endereço de conexão do banco de dados. [EX: 127.0.0.1]
    host: localhost
    # Porta de conexão do banco de dados. [EX: 3306]
    port: 3306
    # Nome do banco de dados a ser conectado. [EX: minecraft]
    database: ''
    # Usuário de conexão. [EX: root]
    username: ''
    # Senha do usuário de conexão: [EX: 123]
    password: ''

general

Configurações gerais que controlam o comportamento básico do sistema de terrenos.

general:
  # Mundos permitidos para criar terrenos
  allowed-worlds: [ 'PlotWorld' ]
  # Regiões (WorldGuard) proibidas para criar terrenos
  region-blacklist: [ 'spawn' ]
  # Quantia máxima de terrenos que um jogador pode ter
  terrain-max: 2
  # Quando true, o limite de terrenos por mundo é definido na permissão
  # yterrenos.terreno.world.<mundo>.<quantia>
  # Exemplo: yterrenos.terreno.world.plotworld.3
  world-limit-permission: false
  # Tamanho mínimo do terreno
  terrain-min-size: 8
  # Tamanho máximo do terreno
  terrain-max-size: 64
  # Distância mínima entre terrenos
  terrain-min-distance: 10
  # Material da cerca
  fence-material: 'FENCE'
  # Permitir quebrar a cerca do terreno
  break-fence: false
  # Definir a cerca sempre no bloco mais alto
  fence-up-block: true
   # Substituir blocos existentes no caminho da cerca
   fence-overlap: true
   # Blocos que devem ser ignorados e substituídos automaticamente pela cerca
   # Esses blocos serão removidos quando a cerca for construída
   fence-ignore-blocks:
     - 'TALL_GRASS'
     - 'CROPS'
     - 'ROSE'
     - 'DOUBLE_PLANT'
   # Delay para alternar a cerca de um terreno em segundos
   fence-delay: 60
  # Limpar o terreno por completo ao ser deletado
  clear-delete: true
  # Expansão Inteligente: Quando ativado, permite que o terreno expanda
  # para os lados disponíveis mesmo que haja obstáculos em algumas direções.
  #
  # true = O terreno expande o máximo possível considerando obstáculos
  # false = Modo tradicional - só expande se houver espaço em todas as direções
  #
  # Exemplo: Se você tentar expandir +10 blocos mas há um terreno próximo
  # ao norte, o sistema calculará o máximo possível (ex: +7 blocos) e
  # expandirá apenas até onde for seguro, informando o jogador.
   smart-expansion: true
   # Ícone padrão dos terrenos
   default-icon: '69a28ba3ba79be1954710d4db2a3fd22773f619f18fecf5982353fb7ac18393a'
   # PVP padrão dos terrenos
   default-pvp: false
   # Proibir colocar/quebrar blocos perto de terrenos (em áreas sem dono)
  # Define a distância em blocos. 0 = desativado
  # bypass: yterrenos.protection.nearbuild.bypass
  block-near-terrain-distance: 0
  # Custo para teleportar até um terreno
  teleport-cost:
    prices:
      price1:
        provider: 'money'
        amount: 1000.0

Explicação dos parâmetros principais:

• allowed-worlds: Liste apenas os mundos onde deseja permitir terrenos. Útil para proteger mundo de recursos ou lobbies.
• region-blacklist: Regiões do WorldGuard onde não é permitido criar terrenos. Ideal para proteger spawn, warps e áreas importantes.
• terrain-max: Limite de terrenos por jogador. Ajuste conforme o tamanho do servidor e economia.
• world-limit-permission: Quando true, o limite de terrenos por mundo usa a permissão yterrenos.terreno.world.<mundo>.<quantia>.
• terrain-min-size / terrain-max-size: Controla os tamanhos mínimo e máximo dos terrenos. Terrenos pequenos (8-16) são práticos para survival, enquanto terrenos grandes (32-64) permitem construções elaboradas.
• terrain-min-distance: Distância mínima entre terrenos diferentes. Previne terrenos muito próximos e dá espaço para expansão futura.
• fence-material: Define o material da cerca visual. Use materiais visíveis como FENCE, GLASS ou GLOWSTONE.
• break-fence: Quando false, previne que jogadores quebrem acidentalmente ou propositalmente as cercas dos terrenos.
• fence-up-block: Se true, a cerca sempre será colocada no bloco mais alto do terreno, facilitando visualização.
• fence-overlap: Permite que a cerca substitua blocos existentes. Útil em terrenos com construções.
• fence-ignore-blocks: Lista de blocos que devem ser automaticamente removidos quando a cerca é construída. Útil para remover blocos naturais como grama alta, plantas e cultivos que estariam no caminho da cerca.
• fence-delay: Cooldown em segundos para alternar (mostrar/esconder) a cerca. Previne spam.
• clear-delete: Deletar os blocos modificados ao deletar/abandonar um terreno.
• smart-expansion: Sistema inteligente que calcula a expansão máxima possível quando há obstáculos. Quando true, o terreno expande até onde for possível em vez de falhar completamente.
• default-icon: Textura padrão (Base64 ou URL) dos terrenos nos menus. Jogadores podem personalizar depois.
• default-pvp: Define se PvP está ativado por padrão nos novos terrenos criados. Pode ser alterado pelo dono do terreno depois.
• teleport-cost: Custo para se teletransportar até o terreno. Use múltiplos provedores se necessário.

Configuração de blocos ignorados pela cerca (fence-ignore-blocks):

A opção fence-ignore-blocks permite definir quais blocos naturais devem ser automaticamente removidos quando a cerca é construída no terreno. Isso é particularmente útil em mundos com vegetação densa ou cultivos.

Blocos que vêm configurados por padrão:

• TALL_GRASS - Grama alta (2 blocos de altura)
• CROPS - Plantações de trigo, cenoura, beterraba
• ROSE - Flores e rosas
• DOUBLE_PLANT - Plantas duplas (girassóis, lilases, etc)

Você pode adicionar ou remover blocos conforme necessário:

fence-ignore-blocks:
  - 'TALL_GRASS'
  - 'CROPS'
  - 'ROSE'
  - 'DOUBLE_PLANT'
  - 'SEAGRASS'        # Adicione alga marinha se desejar
  - 'SUGAR_CANE'      # Adicione cana de açúcar

Exemplo de uso do teleport-cost com múltiplos preços:

teleport-cost:
  prices:
    price1:
      provider: 'money'
      amount: 1000.0
    price2:
      provider: 'tokens'
      amount: 5.0

buy-cost

Configurações do custo para comprar (criar) um terreno. Sistema de preço dinâmico baseado no tamanho do terreno.

buy-cost:
  # Ativar o custo
  enabled: true
  # Preços por tamanho
  prices-per-size:
    price1:
      provider: 'money'
      amount: 1000.0

Como funciona:

• Quando enabled: true, jogadores precisam pagar para criar terrenos
• O custo é multiplicado pelo tamanho do terreno
• Exemplo: Com amount: 1000.0 e terreno de tamanho 16x16, o custo total será 1000 x 256 = 256.000

Balanceamento:

• Para servidores iniciantes, use valores baixos (100-500) para facilitar acesso
• Para economia madura, use valores altos (1000-5000) para criar sink econômico
• Considere o tamanho máximo permitido ao definir o preço

Exemplo com múltiplos provedores:

buy-cost:
  enabled: true
  prices-per-size:
    price1:
      provider: 'money'
      amount: 500.0
    price2:
      provider: 'tokens'
      amount: 2.0

world-protection

Sistema de proteção global que controla o que pode ser feito fora dos terrenos. Essencial para forçar jogadores a criarem terrenos para construir.

world-protection:
   # Permitir explosões fora de terrenos
   explode: false
   # Permitir construir fora de terrenos
   # bypass: yterrenos.protection.construct.bypass
   construct: false
   # Permitir quebrar fora de terrenos
   # bypass: yterrenos.protection.break.bypass
   break: false
   # Permitir pvp fora de terrenos
   # bypass: yterrenos.protection.pvp.bypass
   pvp: false

Explicação detalhada:

• explode: Se false, previne danos de explosões (TNT, creepers) fora de terrenos. Protege o mundo de griefing.
• construct: Se false, jogadores não podem colocar blocos fora de terrenos. Força criação de terrenos para construir.
• break: Se false, jogadores não podem quebrar blocos fora de terrenos. Mantém o mundo limpo.
• pvp: Se false, jogadores não podem atacar uns aos outros fora de terrenos. Cria zonas seguras fora de terrenos.

Permissões de bypass:

Jogadores com as permissões listadas nos comentários podem ignorar as restrições:

• yterrenos.protection.construct.bypass - Permite construir em qualquer lugar
• yterrenos.protection.break.bypass - Permite quebrar blocos em qualquer lugar
• yterrenos.protection.pvp.bypass - Permite PvP em qualquer lugar

Estratégias de uso:

1. Modo Proteção Total: Todas as opções false - Mundo completamente protegido, apenas terrenos são editáveis
2. Modo Misto: construct: false, break: true - Jogadores podem coletar recursos, mas não construir fora
3. Modo Livre: Todas as opções true - Terrenos são opcionais, mundo é aberto

terrain-protection

Sistema de proteção dentro dos terrenos. Controla o que pode acontecer no território protegido.

terrain-protection:
  # Permitir explosões dentro de terrenos
  explode: false

Explicação:

• explode: Se false, previne que explosões causem dano dentro de terrenos. Protege construções de creepers, TNT e wither.

Importante:

Apenas o dono do terreno e membros autorizados podem construir/quebrar dentro do terreno, independente desta configuração. Esta opção controla apenas danos de explosões.