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.

custom_enchants.yml

enchants.yml

areas.yml

blocks.yml

boosters.yml

bungeecord.yml

classes.yml

commands.yml

config.yml

data.yml

economies.yml

menus.yml

messages.yml

rewards.yml

skins.yml

Configuração do plugin (config.yml)

O arquivo config.yml é o coração do plugin, onde você controla todos os aspectos do funcionamento da floresta. 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 da floresta 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/yFloresta/data.db.

Delay para carregar os dados do jogador após o login. Necessário quando a floresta está em um servidor separado conectado via BungeeCord.

# em ticks (20 ticks = 1 segundo)
login-delay: 20

Valores recomendados:

Servidor único: 0 ou 10
BungeeCord/Velocity: 20 a 40

limit

Sistema de limite de recompensas coletadas por vez. Evita lag ao coletar muitas recompensas simultaneamente.

limit:
  enabled: true
  # Máximo que irá recolher por vez
  max: 1000

Desativar ou aumentar muito o limite pode causar lag severo ou até crash do servidor ao coletar grandes quantidades de recompensas.

void-detect

Define a altura do void do seu servidor. Jogadores que caírem abaixo desta altura serão teleportados para fora da floresta.

void-detect: 0

skill-identify

Identificador da skill do mcMMO ou AuraSkills que será contabilizada ao quebrar blocos na floresta.

skill-identify: 'MINING'

Skills comuns:

MINING - Para picaretas
WOODCUTTING - Para machados (mais apropriado para floresta)
EXCAVATION - Para pás

general

Configurações gerais do plugin que controlam o comportamento da ferramenta e da área de floresta.

general:
  # Acumular os bônus que tiver permissão
  accumulate-bonus: false
  formatter-bonus-has: '&a+{bonus}% por ser {display}&a.'
  formatter-bonus-no-has: ''
  # Ativar a invisibilidade na área da floresta
  invisibility: false
  # Esconder o encantamento na lore da ferramenta caso o player desative ele
  # caso esteja false, o encantamento ficará riscado na lore da ferramenta
  hide-deactivated: false
  # Fazer com que a ferramenta nunca quebre
  tool-unbreakable: true
  # Permitir a troca de itens via numkeys
  numkeys: false
  # Habilitar o menu de evolução ao interagir com a ferramenta sem shift
  no-shfit-evolution: true
  # Habilitar o menu de evolução ao interagir com a ferramenta com shift
  shfit-evolution: true
  # Para evoluir as classes ele deverá seguir a ordem delas?
  classes-order: true
  # Evoluir a ferramenta com a ação do botão direito
  evolute-right: true
  # Evoluir a ferramenta com a ação do botão Q
  evolute-q: true
  # Máximo permitido para evoluir com Q (0 = ilimitado)
  evolute-q-max: 0
  # Skin default da ferramenta
  skin-default: ''
  # Necessitar estar com o inv vazio
  inv-empty: false
  # Materiais que irão ser reconhecidos na skin
  skin-materiais:
    - 'WOOD'
    - 'STONE'
    - 'IRON'
    - 'GOLD'
    - 'DIAMOND'
  # Lista de comandos permitidos na floresta
  commands-allowed:
    - '/g'
    - '/l'
    - '/floresta'
  # Lista de comandos para sair da floresta
  commands-exit:
    - '/sair'
    - '/spawn'
    - '/exit'

Destaques importantes:

accumulate-bonus: Se true, acumula todos os bônus de permissão. Se false, usa apenas o maior.
invisibility: Útil para servidores com muitos jogadores na mesma área.
tool-unbreakable: Recomendado true para evitar perda da ferramenta evolutiva.
classes-order: Se true, força evolução sequencial das classes (Classe 1 → Classe 2 → Classe 3).
inv-empty: Se true, exige inventário vazio ao entrar na floresta.

Exemplo de configuração PvP:

general:
  invisibility: true  # Esconde nametags
  numkeys: false  # Impede troca rápida
  inv-empty: true  # Força inventário limpo
  commands-allowed:
    - '/g'
    - '/l'
    - '/floresta'
    - '/report'

energy

Sistema de energia da ferramenta. Jogadores ganham energia ao quebrar blocos e evoluem de nível ao acumular energia suficiente.

energy:
  # Ativar o sistema de energia
  enabled: true
  # Quantia de energia por bloco quebrado
  amount: 1
  # Quantia de energia que irá aumentar a cada nível
  per-level: 1000
  # Ativar o sistema de dar encantamento aleatório
  give-enchant: true
  # Comandos que irá dar quando evoluir (com enchant)
  enchant-commands: []
  # Comandos que irá dar quando evoluir (sem enchant)
  no-enchant-commands: []
  # Enchants que poderão ser dados (formato: chance,encantamento)
  enchants:
    - '10.0,efficiency'
    - '10.0,fortune'
    - '10.0,speed'
    - '10.0,haste'
    - '10.0,lucky'
    - '10.0,multiplier'
  # Mensagens
  enchant-evolved: |
    &r
    &bSua ferramenta evoluiu de nível!
    &bEncantamento adquirido: &f+1 nível de {enchantment}&b.
    &r
  no-enchant-evolved: |
    &r
    &bSua ferramenta evoluiu de nível!'
    &cInfelizmente todos seus encantamentos estão no máximo.'
    &r
  # Comandos que serão executados ao alcançar determinado nível
  # formato: nível,comando
  specific-rewards: [ '100,give {player} diamond 2' ]

Como funciona:

Jogador quebra 1 bloco = ganha 1 de energia (configurável)
Ao atingir 1000 de energia = sobe 1 nível
Ao subir de nível = 10% de chance de ganhar cada encantamento listado
Próximo nível precisará de 2000 de energia, depois 3000, e assim por diante

Exemplo de progressão equilibrada:

energy:
  enabled: true
  amount: 1
  per-level: 500  # Mais rápido
  enchants:
    - '20.0,efficiency'  # Mais comum
    - '15.0,fortune'
    - '10.0,speed'
    - '10.0,multiplier'
    - '5.0,lucky'  # Mais raro
  specific-rewards:
    - '10,broadcast &a{player} chegou ao nível 10!'
    - '50,give {player} diamond 10'
    - '100,broadcast &6{player} é um LENHADOR MESTRE!'

random

Sistema de encantamento aleatório por chance ao quebrar blocos, independente do sistema de energia.

random:
  # Chance por bloco quebrado (0 = desativado)
  chance: 0
  title: ''
  actionbar: ''
  chat: |
    &r
    &bEncantamento adquirido: &f+1 nível de {enchantment}&b.
    &r

Exemplo de uso:

random:
  chance: 0.1  # 0.1% de chance por bloco
  title: '&aENCHANT!<nl>&f{enchantment}'
  actionbar: '&a+1 {enchantment}'

earns-message

Envia uma mensagem periódica mostrando o que o jogador ganhou em um período de tempo.

earns-message:
  enabled: true
  # delay para enviar a mensagem em segundos
  delay: 60
  chat-format: '&6&l|&f {provider_display}: &2{provider_symbol}&f{provider_value}'
  message: |
    &r
    &e&lGG! &eVocê quebrou &e&l{blocks}&e blocos no último minuto.
    &r
    &6Confira o lucro dos blocos quebrados:
    {chat}
    &r

Como funciona:

A cada 60 segundos (configurável), o jogador recebe um resumo do que ganhou:

GG! Você quebrou 156 blocos no último minuto.

Confira o lucro dos blocos quebrados:
| Dinheiro: $312
| Folhas: 156

tool

Configuração da aparência da ferramenta.

tool:
  material: WOOD_AXE
  name: '&bMachado &6[{blocks_broken}]'
  lore:
    - '&7Inquebrável ∞'
    - '{enchants}'
    - ''
    - ' &fNível: &7{level}'
    - ' &fEnergia: &7{energy}/{energy_next} &f({progressbar}&f)'

Placeholders disponíveis:

{blocks_broken} - Total de blocos quebrados formatado
{level} - Nível atual da ferramenta
{energy} - Energia atual
{energy_next} - Energia necessária para próximo nível
{progressbar} - Barra de progresso visual
{enchants} - Lista de encantamentos

leave

Configuração do item de folha físico (moeda do plugin).

leave:
  material: '1ba16c3890af39c3f2d576586cff443de07dad32b2315e2ff6f0d5d6a3c663dd'
  name: '&b+{amount} Folhas'
  lore:
    - ''
    - '&fQuantia: &b{amount}'
    - ''
    - '&7Clique com botão direito para ativar.'
    - ''
    - '&7Clique com shift + botão direito para compactar'
    - '&7todos os seus blocos no inventário em 1 só.'
    - ''

Use /folhas give <jogador> <quantidade> para dar folhas físicas.

scoreboard

Configuração da scoreboard exibida na área de floresta.

scoreboard:
  enabled: true
  title: '&b&lyStore'
  lines:
    - '&7     Área de Floresta'
    - ''
    - '&f B. quebrados: &7{blocks_broken}'
    - ''
    - '&e Machado'
    - '&8  ❘&f Nível: &7{level}'
    - '&8  ❘&f Energia: &7{energy}/{energy_next}'
    - ''
    - '&f Folhas: &e⛃{leaves}'
    - '&f Coins: &2$&a{money}'
    - ''
    - '&b    ystoreplugins.com.br'

Exemplo visual:

     yStore
     
  Área de Floresta

 B. quebrados: 1,234

 Machado
  ❘ Nível: 15
  ❘ Energia: 750/1000

 Folhas: ⛃156
 Coins: $3,120

    ystoreplugins.com.br

items

Itens padrões que o jogador recebe ao entrar na área de floresta.

items:
  # Slot onde a ferramenta será colocada
  tool-slot: 2
  # Item para sair da floresta
  exit:
    material: 'BARRIER:0'
    slot: 8
    name: '&cSair da Floresta'
    lore:
      - '&7Clique para sair da'
      - '&7área de floresta.'
  # Item de classes
  classes:
    material: 'LEATHER_CHESTPLATE:0'
    slot: 6
    name: '&bClasses'
    lore:
      - ' &7As classes irão te dar mais'
      - ' &7chance e coins na floresta!'
      - ''
      - '&fSua classe: &7{classe}'
      - ''
      - '&aClique para upar sua classe'

Criando itens customizados:

items:
  tool-slot: 2
  exit:
    material: 'BARRIER:0'
    slot: 8
    name: '&cSair'
  # Item customizado
  loja:
    material: 'EMERALD:0'
    slot: 4
    name: '&aLoja VIP'
    lore:
      - '&7Clique para abrir'
    left-command: 'loja'
    right-command: 'loja vip'
    left-perm: 'yfloresta.loja'
    right-perm: 'yfloresta.loja.vip'

progress-bar

Configuração da barra de progresso de energia.

progress-bar:
  amount: 10
  symbol: ':'
  color-yes: '&a'
  color-no: '&7'

Resultado: &a::::&7:::::: (40% completo)

bonus

Sistema de bônus por permissão. Jogadores com permissões específicas ganham bônus percentuais.

bonus:
  membros:
    order: 1
    # Permissão para ser reconhecido
    permission: 'yfloresta.bonus.membro'
    # Nome que irá aparecer nas mensagens
    display: '&7[Membro]'
    # Quantia do bônus em % para coins
    bonus: 10.0
    # Quantia do bônus em % para folhas
    bonus-leave: 10.0

Criando sistema de VIP:

bonus:
  normal:
    order: 1
    permission: ''
    display: '&7[Normal]'
    bonus: 0.0
    bonus-leave: 0.0
  vip:
    order: 2
    permission: 'yfloresta.bonus.vip'
    display: '&a[VIP]'
    bonus: 25.0
    bonus-leave: 25.0
  mvip:
    order: 3
    permission: 'yfloresta.bonus.mvip'
    display: '&b[MVIP]'
    bonus: 50.0
    bonus-leave: 50.0
  supremo:
    order: 4
    permission: 'yfloresta.bonus.supremo'
    display: '&6[SUPREMO]'
    bonus: 100.0
    bonus-leave: 100.0

Se accumulate-bonus: false, apenas o maior bônus será aplicado. Se true, todos os bônus serão somados.

specific-level

Sistema de anúncios broadcast ao jogador atingir níveis específicos.

specific-level:
  level10:
    # Nível necessário
    level: 10
    # Mensagem que será enviada (broadcast para todos)
    message: |
      &r
      &c&lNÍVEL! &cO jogador &f{player} &cevoluiu para o nível &f&l{level}&c.
      &r

Criando marcos importantes:

specific-level:
  level10:
    level: 10
    message: |
      &r
      &a{player} chegou ao nível 10!
      &r
  level50:
    level: 50
    message: |
      &r
      &6&l⭐ {player} É UM LENHADOR EXPERT! ⭐
      &r
  level100:
    level: 100
    message: |
      &r
      &c&l✦ {player} ATINGIU O NÍVEL 100! ✦
      &eParabéns pela dedicação!
      &r

Use specific-level combinado com specific-rewards no sistema de energia para criar marcos memoráveis e recompensar jogadores dedicados.

Nesta página