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.

commands.yml

config.yml

economies.yml

menus.yml

messages.yml

Configuração do plugin (config.yml)

O arquivo config.yml controla todos os aspectos do funcionamento do sistema de 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

Mantenha desativado em produção, pois pode gerar muitos logs e afetar a performance.

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: ''

Se usar SQLITE, não precisa preencher os dados de conexão. O arquivo será criado automaticamente em plugins/yPlotAddon/data.db.

general

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

general:
  # Quantia máxima de terrenos que um jogador pode ter
  # (Essencial para o sistema de comprar terrenos)
  plot-max: 2
  # Ícone padrão dos terrenos (texture de cabeça em Base64 ou nome do material)
  default-icon: '69a28ba3ba79be1954710d4db2a3fd22773f619f18fecf5982353fb7ac18393a'
  # Custo para teleportar até um terreno
  teleport-cost:
    prices:
      price1:
        provider: 'money'
        amount: 1000.0
  # Custo para limpar um plot (PlotSquared apenas)
  clear-cost:
    prices:
      price1:
        provider: 'money'
        amount: 1000.0
  # Custo para agrupar seus plots (PlotSquared apenas)
  merge-cost:
    prices:
      price1:
        provider: 'money'
        amount: 1000.0

Explicação dos parâmetros:

plot-max: Limite de terrenos por jogador. Controla quantos terrenos um jogador pode possuir. Útil para equilibrar a economia e evitar monopolização de território. Jogadores com a permissão yplotaddon.bypass.plotmax podem ignorar este limite.
default-icon: Ícone padrão exibido nos menus. Aceita texture de cabeça personalizada (formato Base64) ou nome de material do Minecraft (ex: GRASS_BLOCK).
teleport-cost: Define o custo para se teleportar até um terreno próprio ou de um amigo. Útil para criar um sink de economia e valorizar a localização dos terrenos.
clear-cost: (PlotSquared apenas) Custo para limpar completamente um plot, removendo todas as construções. Evita que jogadores abusem desta função fazendo limpezas repetidas sem custo.
merge-cost: (PlotSquared apenas) Custo para unir/agrupar plots adjacentes em um único terreno maior. Cria progressão para jogadores que querem construções maiores.

Ajuste os custos baseando-se na economia do seu servidor. Valores muito baixos podem tornar os recursos triviais, enquanto valores muito altos podem frustrar os jogadores.

Sistema de múltiplos preços:

Todos os custos suportam múltiplos tipos de moeda simultaneamente. Por exemplo, você pode exigir dinheiro E itens:

teleport-cost:
  prices:
    price1:
      provider: 'money'
      amount: 1000.0
    price2:
      provider: 'item'
      amount: 5.0
      material: 'DIAMOND'

Veja mais sobre provedores de economia em Configuração de Economias.

wall-blocks

Sistema de blocos compráveis para personalizar as paredes dos plots. Funciona apenas com PlotSquared.

wall-blocks:
  diamond:
    material: 'DIAMOND_BLOCK'
    prices:
      price1:
        provider: 'money'
        amount: 1000.0
  emerald:
    material: 'EMERALD_BLOCK'
    prices:
      price1:
        provider: 'money'
        amount: 5000.0

Como funciona:

Jogadores podem comprar diferentes materiais para mudar as paredes dos seus plots
As paredes são as estruturas verticais que delimitam cada plot
Cada material tem um identificador único (ex: diamond, emerald)
O material deve ser um tipo de bloco válido do Minecraft

Adicionando novos blocos:

wall-blocks:
  obsidian:
    material: 'OBSIDIAN'
    prices:
      price1:
        provider: 'money'
        amount: 2000.0
  quartz:
    material: 'QUARTZ_BLOCK'
    prices:
      price1:
        provider: 'money'
        amount: 1500.0

Este sistema é exclusivo do PlotSquared. Se você usa Lands, GriefDefender ou outros plugins de proteção, estas opções não estarão disponíveis.

border-blocks

Sistema de blocos compráveis para personalizar as bordas dos plots. Funciona apenas com PlotSquared.

border-blocks:
  diamond:
    material: 'DIAMOND_BLOCK'
    prices:
      price1:
        provider: 'money'
        amount: 1000.0
  emerald:
    material: 'EMERALD_BLOCK'
    prices:
      price1:
        provider: 'money'
        amount: 5000.0

Diferença entre wall e border:

Wall (paredes): Blocos verticais que formam as laterais do plot
Border (bordas): Blocos horizontais no chão que marcam os limites do plot

Ambos os sistemas funcionam da mesma forma, permitindo que jogadores personalizem visualmente seus terrenos comprando diferentes materiais.

day-night

Sistema de PvP automático baseado no ciclo dia/noite do Minecraft. Ativa ou desativa o PvP nos terrenos dependendo da hora do jogo.

day-night:
  # Mundos onde o sistema será monitorado
  # Deixe vazio [] para monitorar todos os mundos
  worlds: ['world']
  # Tempo do Minecraft para ATIVAR o PvP (início da noite)
  # Padrão: 13000 (anoitecer)
  night-time: 13000
  # Tempo do Minecraft para DESATIVAR o PvP (início do dia)
  # Padrão: 0 (amanhecer / tick 0 do ciclo)
  day-time: 0
  # Som tocado para todos os jogadores ao virar noite
  # Lista de sons: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
  sound-night: 'ENTITY_WITHER_SPAWN'
  # Som tocado para todos os jogadores ao virar dia
  sound-day: 'BLOCK_NOTE_BLOCK_PLING'
  # Volume e pitch dos sons (1.0 = padrão)
  sound-volume: 1.0
  sound-pitch: 1.0

Explicação dos parâmetros

worlds

Define em quais mundos o sistema monitorará o ciclo dia/noite. Deixe vazio para monitorar todos.

day-night:
  worlds: [ 'world', 'world_nether' ]
  # ou vazio para todos
  worlds: []

night-time

Tick do ciclo Minecraft onde o PvP é ativado (início da noite).

Padrão: 13000 (anoitecer)
Intervalo válido: 0 a 23999 (ciclo completo = 24000 ticks = 20 minutos)

day-night:
  night-time: 13000

1 tick = 50ms. Um ciclo completo (dia/noite) dura 20 minutos.

0-12000 = Dia
12000-13000 = Anoitecer (PvP ativa aqui por padrão)
13000-23000 = Noite
23000-24000 = Amanhecer

day-time

Tick do ciclo Minecraft onde o PvP é desativado (início do dia).

Padrão: 0 (amanhecer / tick 0 do ciclo)

day-night:
  day-time: 0

sound-night / sound-day

Sons que toquem para os jogadores quando o PvP ativa (noite) ou desativa (dia). Use nomes válidos da API Spigot.

day-night:
  sound-night: 'ENTITY_WITHER_SPAWN'
  sound-day: 'BLOCK_NOTE_BLOCK_PLING'

Ver lista completa de sons disponíveis →

sound-volume / sound-pitch

Controla o volume e tom dos sons.

Valores entre 0.0 a 2.0
1.0 = padrão
Valores acima de 1.0 = mais alto/agudo
Valores abaixo de 1.0 = mais baixo/grave

day-night:
  sound-volume: 1.0
  sound-pitch: 1.0

Como funciona

O sistema monitora continuamente o tempo de cada mundo configurado
Quando o tick alcança night-time, o PvP é ativado nos terrenos
Quando o tick alcança day-time, o PvP é desativado
Sons e mensagens são exibidas a todos os jogadores (veja Mensagens para customizar as mensagens)

Exemplo prático

Sistema clássico: PvP ativo à noite, inativo durante o dia:

day-night:
  worlds: ['world']
  night-time: 13000      # Noite começa (anoitecer)
  day-time: 0            # Dia começa (amanhecer)
  sound-night: 'ENTITY_WITHER_SPAWN'
  sound-day: 'BLOCK_NOTE_BLOCK_PLING'
  sound-volume: 1.0
  sound-pitch: 1.0

Sistema customizado: PvP ativo por menos tempo

day-night:
  worlds: ['world_pvp']
  night-time: 14000      # PvP ativa mais tarde (noite mais avançada)
  day-time: 22000        # PvP desativa mais cedo (quase amanhecer)
  sound-night: 'ENTITY_DRAGON_GROWL'
  sound-day: 'ENTITY_WITHER_SPAWN'
  sound-volume: 0.8
  sound-pitch: 1.2

Os jogadores individuais podem alternar o PvP do seu próprio terreno através do menu de configuração do terreno, mesmo durante o período ativo.

Nesta página