Configuração
Conheça as várias opções de 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.
Configuração do plugin (config.yml)
O arquivo config.yml é o coração do plugin, onde você controla limites, custos, flags padrão, cosméticos e o ciclo dia/noite. 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: falseMantenha 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.
redis
Configurações do servidor Redis para sincronização multi-servidor (BungeeCord/Velocity).
redis:
# Ativar a conexão com o redis
enabled: false
# Endereço de conexão. [EX: 127.0.0.1]
host: 'localhost'
# Porta de conexão. [EX: 6379]
port: 6379
# Usuário de conexão. [EX: root]
username: ''
# Senha do usuário de conexão: [EX: 123]
password: ''Quando usar Redis:
- Rede BungeeCord/Velocity com múltiplos servidores
- Sincronização em tempo real de dados entre servidores
login-delay
Delay em ticks para carregar os dados depois do login. Útil em redes com servidor de mina separado.
# Delay para carregar os dados depois do login
# Necessário para usar em servidor de mina separado
# Recomendado: 20 ticks
login-delay: 20general
Configurações gerais do sistema de terrenos: limites, custos, teleporte, merge, membros, voo, delays e sons.
general:
# Máximo de terrenos por jogador (sem permissão yplots.plots.X)
max-plots-default: 1
# Preço padrão para reivindicar terreno livre (0 = grátis)
default-claim-price: 0.0
# Economia padrão para compra/venda (chave em economies.yml)
default-economy: 'money'
# Delay de teleporte em segundos (0 = instantâneo)
teleport-delay-seconds: 3
# Cancelar teleporte se o jogador se mover
teleport-cancel-on-move: true
# Colocar vidro sob o jogador no TP/home se não houver chão
teleport-place-glass: true
# Mostrar menu de compra ao entrar em terreno livre
auto-claim-menu: true
# Cooldown do menu auto-claim (segundos)
auto-claim-cooldown-seconds: 30
# Mensagem ao entrar/sair de terreno
enter-exit-messages: true
# Permitir voo em terrenos próprios (ainda depende de flag/desbloqueio)
allow-fly: true
# Limpar inventário ao resetar terreno
clear-on-reset: false
# Taxa de venda para o servidor (% do preço; 0 = sem taxa)
sell-tax-percent: 5.0
# Altura máxima (Y) em que o jogador pode construir no plot world. 0 = ilimitado
max-build-height: 0
# Altura mínima (Y) em que o jogador pode construir. 0 = sem limite mínimo
min-build-height: 0
# Mostrar bordas com partículas
border-particles: true
# Intervalo de partículas (ticks) — 20 = 1 segundo
border-particle-interval: 20
# Custo para limpar/resetar terreno (personalização / clear)
clear-cost: 0.0
# Economia usada no clear-cost (chave em economies.yml)
clear-economy: 'money'
# Custo para agrupar (merge) terrenos vizinhos
merge-cost: 1000.0
# Economia usada no merge-cost
merge-economy: 'money'
# Máximo de plots num merge (sem slots comprados / perms yplots.merge.X)
merge-max-default: 2
# Teto absoluto de plots no merge (0 = sem teto extra). Ex: 16
merge-max-hard-cap: 0
# Custo para comprar +1 slot de merge no menu
merge-slot-cost: 5000.0
# Economia usada no merge-slot-cost
merge-slot-economy: 'money'
# Máximo de membros/confiáveis por plot (sem slots comprados / perms yplots.members.X)
# Negados NÃO contam e são ilimitados.
max-members-default: 3
# Teto absoluto de membros (0 = sem teto extra). Ex: 20
member-max-hard-cap: 0
# Custo para comprar +1 slot de membro no menu
member-slot-cost: 2500.0
# Economia usada no member-slot-cost
member-slot-economy: 'money'
# Custo para desbloquear fly no terreno (painel). 0 = grátis para todos.
# yplots.fly.free / yplots.admin desbloqueiam sem pagar mesmo com custo > 0.
fly-cost: 5000.0
# Economia usada no fly-cost
fly-economy: 'money'
# Limite de caracteres do nome do terreno (0 = sem limite)
max-name-length: 24
# Limite de caracteres da descrição do terreno (0 = sem limite)
max-description-length: 48
# Cooldowns por ação em segundos (0 = sem cooldown)
delays:
claim-seconds: 0
clear-seconds: 0
delete-seconds: 0
wall-seconds: 0
border-seconds: 0
# Sons do plugin (nomes Bukkit Sound)
sounds:
claim-success: 'ENTITY_EXPERIENCE_ORB_PICKUP'
claim-fail: 'ENTITY_VILLAGER_NO'
teleport: 'ENTITY_ENDERMAN_TELEPORT'
menu-click: 'UI_BUTTON_CLICK'
sell-success: 'ENTITY_PLAYER_LEVELUP'
delete: 'ENTITY_ITEM_BREAK'Destaques importantes:
- max-plots-default: Limite base de terrenos. Use
yplots.plots.Xpara aumentar por grupo/VIP. - default-claim-price / default-economy: Preço e economia padrão do claim. Cada mundo pode sobrescrever em
worlds/<mundo>.yml. - teleport-delay-seconds: Delay antes de teleportar. Staff com
yplots.delay.bypassignora. - auto-claim-menu: Ao entrar em terreno livre, abre o menu de reivindicação automaticamente.
- sell-tax-percent: Percentual retido pelo servidor na venda entre jogadores (
5.0= 5%). - max-build-height: Altura máxima de construção no plot world.
0= ilimitado. - min-build-height: Altura mínima de construção.
0= sem limite mínimo. - merge-max-default / merge-slot-cost: Limite de plots no merge e preço para comprar slots extras. Use
/plots unmergepara desfazer. - max-members-default / member-slot-cost: Limite de membros/confiáveis. Negados são ilimitados.
- fly-cost / fly-economy: Custo no painel (
fly-locked) para desbloquear voo no terreno.0= grátis para todos.yplots.fly.freeeyplots.adminnão pagam. - max-name-length / max-description-length: Limite de caracteres do nome e da descrição (
0= sem limite).
Exemplo de economia VIP com mais terrenos e merge:
general:
max-plots-default: 1
merge-max-default: 2
max-members-default: 3Permissões no grupo VIP:
yplots.plots.5yplots.merge.8yplots.members.10
day-night
Sistema global de anúncio dia/noite + flag de PvP noturno por terreno.
day-night:
# Ativar o ciclo dia/noite do plugin
enabled: true
# Mundos monitorados (vazio = todos os mundos)
worlds: []
# Tick do mundo considerado início da noite (Minecraft: 13000 ≈ sunset)
night-time: 13000
# Tick do mundo considerado início do dia
day-time: 0
# Som ao virar noite
sound-night: 'ENTITY_WITHER_SPAWN'
# Som ao virar dia
sound-day: 'NOTE_PLING'
# Volume dos sons (0.0 a 1.0+)
sound-volume: 1.0
# Pitch dos sons (0.5 a 2.0)
sound-pitch: 1.0Como funciona:
- O plugin monitora o horário do mundo.
- Ao virar noite/dia, envia mensagens (chat, title e actionbar em
messages.yml). - Terrenos com PvP noturno ativo permitem PvP apenas durante a noite.
Exemplo restrito a mundos de plot:
day-night:
enabled: true
worlds: ['plots', 'plots2']wall-blocks
Blocos compráveis para a parede do terreno (camada na borda). Cada chave é o id interno do cosmético.
wall-blocks:
# Parede padrão (grátis)
stone:
display-name: '&7Pedra'
material: 'STONE'
prices:
price1:
provider: 'money'
amount: 0.0
diamond:
display-name: '&bBloco de Diamante'
material: 'DIAMOND_BLOCK'
prices:
price1:
provider: 'money'
amount: 1000.0- display-name: Nome no menu (suporta
&cores). - material:
MATERIALouMATERIAL:data(1.8). - prices: Lista de preços (
provider= chave emeconomies.yml,amount= valor).
border-blocks
Blocos compráveis para a borda (slab/topo). Mesma estrutura de wall-blocks.
border-blocks:
# Borda padrão (grátis)
slab:
display-name: '&7Laje de Pedra Vermelha'
material: 'STONE_SLAB2'
prices:
price1:
provider: 'money'
amount: 0.0
glass:
display-name: '&fVidro'
material: 'GLASS'
prices:
price1:
provider: 'money'
amount: 800.0default-flags
Flags padrão aplicadas a terrenos novos (true = permitido para visitantes/sem cargo).
default-flags:
# Permite PvP no terreno
pvp: false
# Permite explosões (TNT, creepers, etc.)
explosion: false
# Permite fogo e propagação
fire: false
# Permite spawn natural de monstros (zombie, creeper, slime, etc.)
mob-spawn: false
# Permite spawn natural de animais e passivos (vaca, ovelha, squid, morcego, etc.)
animal-spawn: false
# Permite redstone
redstone: true
# Permite fluxo de líquidos (água/lava)
liquid-flow: true
# Permite crescimento de plantas
plant-grow: true
# Permite queda de blocos (areia/cascalho)
block-fall: true
# Permite dropar itens
item-drop: true
# Permite coletar itens
item-pickup: true
# Permite interação geral
interact: false
# Permite usar portas
use-doors: false
# Permite usar botões
use-buttons: false
# Permite usar alavancas
use-levers: false
# Permite usar baús e contêineres
use-containers: false
# Permite voar (flag do terreno; separado do fly comprável)
fly: true
# Permite usar elytra
elytra: true
# Permite veículos
vehicle: false
# Permite projéteis
projectile: false
# Permite efeitos climáticos
weather: true
# Permite trocar com aldeões
villager-trade: false
# Permite quebrar quadros/suportes
hanging-break: false
# Permite interagir com armor stands
armor-stand: false
# Permite usar baldes
bucket: falseConfiguração recomendada para survival seguro:
default-flags:
pvp: false
explosion: false
fire: false
interact: false
use-containers: false
animal-spawn: false
mob-spawn: false
redstone: trueO dono/gerente pode alterar flags depois no menu, conforme permissões yplots.flag.*.
status
Textos de status exibidos em menus, info e placeholders.
status:
# Terreno com dono
claimed: '&aReivindicado'
# Terreno sem dono
free: '&7Livre'
# Terreno listado no mercado
for-sale: '&eÀ venda'
# Jogador negado no terreno
denied: '&cNegado'