LogoyStore

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.

README.txt
plots.yml
commands.yml
config.yml
economies.yml
menus.yml
messages.yml

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

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

general

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.X para 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.bypass ignora.
  • 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 unmerge para 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.free e yplots.admin nã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: 3

Permissões no grupo VIP:

  • yplots.plots.5
  • yplots.merge.8
  • yplots.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.0

Como funciona:

  1. O plugin monitora o horário do mundo.
  2. Ao virar noite/dia, envia mensagens (chat, title e actionbar em messages.yml).
  3. 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: MATERIAL ou MATERIAL:data (1.8).
  • prices: Lista de preços (provider = chave em economies.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.0

default-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: false

Configuraçã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: true

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

Nesta página