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

bombs.yml

boosters.yml

classes.yml

skins.yml

tools.yml

rewards.yml

mine_rewards.yml

bungeecord.yml

data.yml

Configuração do plugin (config.yml)

O arquivo config.yml é o coração do plugin, onde você controla todos os aspectos do sistema de mineração. 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 jogadores 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/yMinasPackets/data.db.

redis

Configurações do servidor Redis para sincronização de dados entre múltiplos servidores. Necessário apenas em redes BungeeCord/Velocity para manter os dados sincronizados em tempo real.

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

Redis é essencial se você tem múltiplos servidores de mineração conectados via BungeeCord/Velocity.

Tempo de espera em ticks antes de carregar os dados do jogador após o login. Essencial em redes BungeeCord/Velocity para evitar perda de dados.

# Recomendado: 20 ticks (1 segundo)
login-delay: 20

Em redes com servidor de mina separado, use no mínimo 20 ticks para garantir sincronização.

limit-broken-second

Sistema anti-cheat que limita quantos blocos um jogador pode quebrar por segundo. Ajuda a prevenir hacks de fast break.

# 0 = desativado | Recomendado: 15-30 para prevenção de cheats
limit-broken-second: 0

void-detect

Define a altura Y do void para detectar quando o jogador está caindo. Usado para teleportar o jogador de volta à mina.

# Valor em coordenada Y. Exemplo: 0 para Overworld, -64 para 1.18+
void-detect: 0

mining-skill-identify

Identificador da skill de mineração para integração com mcMMO ou AuraSkills. O plugin dará XP de mineração ao quebrar blocos na mina.

# Para mcMMO/AuraSkills padrão use: 'MINING'
mining-skill-identify: 'MINING'

auto-sell-perm

Permissão necessária para usar o sistema de venda automática. Deixe vazio para que todos possam usar.

# Exemplo: 'yminaspackets.autosell' ou vazio para todos
auto-sell-perm: ''

reset-type

Define qual biblioteca será usada para resetar a mina visualmente para os jogadores.

# PROTOCOL-LIB = Método mais compatível, porém mais lento
# PACKET-EVENTS = Utiliza a LIB do Packet-Events, mais rápido em alguns casos
# YPLUGINS = recomendado. Suporta maiores estruturas, rápido e eficiente (utiliza reatividade, batch-system e multi-threads)
reset-type: 'YPLUGINS'

Se escolher PACKET-EVENTS, certifique-se de ter o plugin PacketEvents instalado.

general

Configurações gerais que controlam diversos aspectos do sistema de mineração.

general:
  # Abrir o menu ao digitar /mina
  mine-menu: true
  # Acumular os bônus que tiver permissão
  accumulate-bonus: false
  formatter-bonus-has: '&a+{bonus}% por ser {display}&a.'
  formatter-bonus-no-has: ''
  # Esconder o encantamento na lore da picareta caso o player desative ele
  # caso esteja false, o encantamento ficará riscado na lore da picareta
  hide-deactivated: false
  # Fazer com que a CustomPickaxe nunca quebre
  pickaxe-unbreakable: true
  # Permitir a troca de itens via numkeys
  numkeys: false
  # Habilitar o menu de evolução ao interagir com a picareta sem shift
  no-shfit-evolution: true
  # Habilitar o menu de evolução ao interagir com a picareta com shift
  shfit-evolution: true
  # Para evoluir as classes ele deverá seguir a ordem delas?
  classes-order: true
  # Evoluir a picareta com a ação do botão direito
  evolute-right: true
  # Evoluir a picareta com a ação do botão Q
  evolute-q: true
  # Máximo permitido para evoluir com Q
  evolute-q-max: 1000
  # Máximo permitido para evoluir com Direito
  evolute-right-max: 1000
  # Ativar o efeito cegueira ao carregar/resetar a mina
  blindness: true
  # Preenchimento de áreas que o player não possui
  area-fill: 'STAINED_CLAY:11'
  # Skin default da picareta
  skin-default: ''
  # Checar upgrades maiores ao evoluir o nível da picareta
  check-upgrades: true
  # Habilitar o price-multiplier de maneira exponencial
  price-multiplier-exponential: true
  # Fechar o menu ao comprar um upgrade de blocos
  mineblock-close-upgrade: true
  # Ativar o upgrade de área ao evoluir de nível
  evolute-minearea: true
  # Necessitar do nível estipulado pela área para comprá-la
  minearea-buy-needlevel: false
  # Mostrar encantamentos zerados na lore da picareta
  show-none-enchants: false
  # Expulsar o jogador da mina ao dar upgrades
  kick-on-upgrade: false
  # Som para quando evoluir algum encantamento
  evolute-sound: 'LEVEL_UP'
  # Som para quando não conseguir evoluir algum encantamento
  evolute-fail-sound: 'VILLAGER_HIT'
  # Materiais que irão ser reconhecidos na skin
  skin-materiais:
    - 'WOOD'
    - 'STONE'
    - 'IRON'
    - 'GOLD'
    - 'DIAMOND'
  # Lista de comandos permitidos na mina
  commands-allowed:
    - '/g'
    - '/l'
    - '/mina'
    - '/minerar'
    - '/mine'
    - '/minas'
  # Lista de comandos para sair da mina
  commands-exit:
    - '/sair'
    - '/spawn'
    - '/exit'

Principais configurações:

mine-menu: Abre o menu principal ao usar /mina ao invés de teleportar diretamente
accumulate-bonus: Permite acumular múltiplos bônus de permissões diferentes
pickaxe-unbreakable: Picareta customizada nunca perde durabilidade
evolute-right/evolute-q: Métodos rápidos para evoluir encantamentos
classes-order: Força o jogador a evoluir classes na ordem (não pode pular)
blindness: Efeito visual ao resetar a mina (evita lag visual)
kick-on-upgrade: Remove o jogador da mina ao expandir área (evita bugs visuais)
commands-allowed: Lista branca de comandos permitidos dentro da mina
commands-exit: Comandos que fazem o jogador sair da mina automaticamente

reset

Sistema que permite jogadores resetarem sua própria mina manualmente antes do tempo automático.

reset:
  enabled: true
  # Tempo de cooldown em segundos entre resets manuais
  delay: 600
  # Permissão para resetar
  permission: 'yminaspackets.reset.self'
  # Preços para resetar
  prices:
    price1:
      provider: 'money'
      amount: 100.0

Como funciona:

Jogadores podem usar /mina reset para resetar a mina manualmente
Útil quando a mina está vazia e o jogador não quer esperar o reset automático
O cooldown previne spam de resets
Você pode cobrar em múltiplas economias (money, cash, etc.)

energy

Sistema de progressão por energia. A picareta ganha energia ao quebrar blocos e evolui de nível automaticamente.

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 (chance,encantamento)
  enchants:
    - '10.0,efficiency'
    - '10.0,nuclear'
    - '10.0,destructor'
    - '10.0,fortune'
  # Mensagens
  enchant-evolved: |
    &r
    &bSua picareta evoluiu de nível!
    &bEncantamento adquirido: &f+1 nível de {enchantment}&b.
    &r
  no-enchant-evolved: |
    &r
    &bSua picareta 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 (nível-necessário,cmd)
  specific-rewards: ['100,give {player} diamond 2']

Como funciona:

Jogador quebra blocos e ganha energia (1 por bloco no padrão)
Ao atingir a energia necessária, a picareta evolui de nível
Energia necessária aumenta progressivamente (1000, 2000, 3000...)
Ao evoluir, pode ganhar +1 em um encantamento aleatório
Você pode executar comandos em níveis específicos (recompensas)

Exemplo de cálculo:

Nível 1→2: precisa 1000 blocos (1000 energia)
Nível 2→3: precisa 2000 blocos (2000 energia)
Nível 10→11: precisa 10000 blocos (10000 energia)

Ajuste per-level para controlar a velocidade de progressão. Valores altos deixam mais grinding.

random

Sistema adicional que dá chance de ganhar +1 em encantamentos aleatórios ao quebrar qualquer bloco, independente do sistema de energia.

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

Este sistema é independente do sistema de energia. Use 0.01 para 0.01% de chance (1 a cada 10.000 blocos).

friends

Sistema que permite jogadores adicionarem amigos para minerarem juntos na mesma mina privada.

friends:
  # Ativar sistema de amigos
  enabled: true
  # Máximo de amigos por mina
  max-per-mine: 5

Funcionalidades:

Amigos podem entrar na sua mina mesmo sendo privada
Útil para jogadores que querem minerar juntos
O dono da mina mantém controle total
Limite ajustável para evitar super farms coletivas

public-mine

Sistema de minas públicas onde múltiplos jogadores podem minerar juntos. Essas minas têm limite de usuários e configurações próprias.

public-mine:
  # Máximo de usuários simultâneos em uma mina pública
  max-users-limit: 10

Funcionalidades:

Múltiplos jogadores podem minerar ao mesmo tempo
Limite ajustável de usuários simultâneos
Configurações personalizadas por mina pública
Taxa de mineração e limite de usuários ajustáveis pelo administrador

luckyblock-message

Resumo periódico de todas as recompensas LuckyBlock obtidas durante a mineração.

luckyblock-message:
  enabled: true
  # Intervalo em segundos para enviar o resumo
  delay: 60
  message: |
    &r
    &eLuckyBlock
    &7Suas recompensas do último minuto.
    &r
    {chat}
    &r

Finalidade: Evita spam no chat mostrando um resumo agrupado de todas as recompensas LuckyBlock ganhas.

earns-message

Resumo periódico de todo o lucro obtido na mineração (dinheiro, cash, tokens, etc).

earns-message:
  enabled: true
  # Intervalo em segundos para enviar o resumo
  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

Finalidade: Mostra ao jogador quanto ele ganhou em cada economia configurada, motivando a continuar minerando.

nuclear-report-message

Relatório especial exibido quando o encantamento Nuclear é ativado e termina de quebrar blocos.

nuclear-report-message:
  enabled: true
  chat-format: '&6&l|&f {provider_display}: &2{provider_symbol}&f{provider_value}'
  message: |
    &r
    &e&lGG! &eVocê quebrou &e&l{blocks}&e blocos ao ativar o NUCLEAR.
    &r
    &6Confira o lucro dos blocos quebrados:
    {chat}
    &r

Finalidade: Destaca o lucro massivo obtido ao usar Nuclear, criando sensação de recompensa poderosa.

pickaxe

Aparência visual da picareta customizada do jogador.

pickaxe:
  material: DIAMOND_PICKAXE
  name: '&bPicareta &6[{blocks_broken}]'
  lore:
    - '&7Inquebrável ∞'
    - '{enchants}'
    - ''
    - ' &fNível: &7{level}'
    - ' &fPrestígio: &7{prestige}'
    - ' &fEnergia: &7{energy}/{energy_next} &f({progressbar}&f)'

Placeholders disponíveis:

{blocks_broken} - Total de blocos quebrados com esta picareta
{enchants} - Lista de encantamentos ativos
{level} - Nível atual da picareta
{prestige} - Prestígio da picareta
{energy} - Energia atual
{energy_next} - Energia necessária para próximo nível
{progressbar} - Barra visual de progresso

prestige

Prestígio da picareta (requer yMinasPacketsPickaxesAddon). Ao prestigiar: reseta nível e encantamentos da picareta e concede bônus de mineração.

prestige:
  enabled: true
  # Nível mínimo da picareta para prestigiar
  min-level: 100
  # Máximo de prestígios (-1 = ilimitado)
  max: -1
  # Permissão (deixe vazio para todos)
  permission: 'yminaspackets.pickaxe.prestige'
  # Modo do bônus: per-level | formula | levels
  mode: per-level
  bonus-per-level: 5.0
  bonus-block-per-level: 5.0
  bonus-formula: '{prestige} * 5'
  bonus-block-formula: '{prestige} * 5'
  levels:
    '1':
      bonus: 5.0
      bonus-block: 5.0
    '2':
      bonus: 10.0
      bonus-block: 10.0
    '3':
      bonus: 15.0
      bonus-block: 15.0
  commands: []

pickaxe-collect

Coleta de picareta (requer yMinasPacketsPickaxesAddon). Fora da mina, o jogador pode coletar a picareta como item físico e depositar com botão direito.

pickaxe-collect:
  # Limite de picaretas no armazém (depósito com botão direito)
  max-stored: 9
  item-lore:
    - '&7Picareta coletada'
    - '&eClique direito para depositar'

block

Item especial que representa blocos minerados acumulados. Pode ser ativado para adicionar blocos à mina.

block:
  material: '1ba16c3890af39c3f2d576586cff443de07dad32b2315e2ff6f0d5d6a3c663dd'
  name: '&b+{amount} Blocos'
  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ó.'
    - ''

Como funciona:

Ao usar, adiciona a quantidade de blocos ao total do jogador
Shift+Clique direito compacta todos os itens de bloco do inventário em um só
Útil para dar recompensas em kits, lojas ou eventos

wand

Item da varinha de seleção usado por administradores para definir áreas das minas.

wand:
  material: 'GOLD_AXE'
  name: '&eSeleção de Área'
  lore: ['&7Mina: &f{mine}', '', '&aEsquerdo -> POS1', '&aDireito -> POS2']

wand-area:
  material: 'GOLD_AXE'
  name: '&eSeleção de Área'
  lore: ['&7Mina: &f{mine}', '&fÁrea: &f{area}', '', '&aEsquerdo -> POS1', '&aDireito -> POS2']

Uso:

Use /mina wand <mina> para receber a varinha
Clique esquerdo para marcar posição 1
Clique direito para marcar posição 2
Use /mina create <nome> <área> para criar a área selecionada

scoreboard

Scoreboard lateral personalizada exibida quando o jogador está na mina.

scoreboard:
  enabled: true
  title: '&b&lyStore'
  lines:
    - '&7     Área de mineração'
    - ''
    - '&f Mina: &7{mine}'
    - '&f B. quebrados: &7{blocks_broken}'
    - ''
    - '&e Picareta'
    - '&8  ❘&f Nível: &7{level}'
    - '&8  ❘&f Energia: &7{energy}/{energy_next}'
    - ''
    - '&f Blocos: &e⛃{blocks}'
    - '&f Coins: &2$&a{money}'
    - ''
    - '&b    ystoreplugins.com.br'

Funcionalidades:

Exibida automaticamente ao entrar na mina
Suporta todos os placeholders do plugin
Atualização em tempo real de estatísticas
Desative se usar plugin de scoreboard externo (como TAB)

items

Itens que aparecem no hotbar do jogador dentro da mina.

items:
  pickaxe-slot: 2
  # Item utilizado para que o jogador saia da mina
  exit:
    material: 'BARRIER:0'
    slot: 8
    name: '&cSair da Mina'
    lore:
      - '&7Clique para sair da'
      - '&7área de mineração.'
  # Item de acesso às classes
  classes:
    material: 'LEATHER_CHESTPLATE:0'
    slot: 6
    name: '&bClasses'
    lore:
      - ' &7As classes irão te dar mais'
      - ' &7chance e coins ao minerar!'
      - ''
      - '&fSua classe: &7{classe}'
      - ''
      - '&aClique para upar sua classe'

Configurações:

pickaxe-slot: Slot onde a picareta aparece (0-8, onde 0 é o primeiro slot)
exit: Item para sair rapidamente da mina
classes: Atalho rápido para menu de classes

progress-bar

Aparência das barras de progresso exibidas em menus e lore.

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

Exemplo de resultado:

Com energia 5000/10000 (50%): &a:::::&7:::::

npc

Sistema de NPCs para acesso às minas (requer Citizens ou znpcs).

npc:
  skin: 'Pitombaa'
  hologram:
    offset: 3.4
    hologram:
      - '&6&lMINERAÇÃO'
      - '&7Minere e fique rico!'
      - '[item]GOLD_INGOT'

Configuração:

skin: Nome do jogador de quem copiar a skin
offset: Altura do holograma acima do NPC
Use [item]MATERIAL para exibir itens flutuantes

Para criar NPCs, use /mina npc create <mina> após instalar Citizens ou znpcs.

bonus

Sistema de bônus progressivos por permissão. Útil para VIPs ganharem mais ao minerar.

bonus:
  membros:
    order: 1
    # Permissão para ser reconhecido
    permission: 'yminaspackets.bonus.membro'
    # Nome que irá aparecer nas mensagens
    display: '&7[Membro]'
    # Bônus de dinheiro/economias em %
    bonus: 10.0
    # Bônus de blocos quebrados em %
    bonus-block: 10.0

Como funciona:

Jogadores com a permissão ganham os bônus configurados
bonus: Aumenta dinheiro/economias ganhas em X%
bonus-block: Aumenta blocos quebrados em X% (afeta progressão)
order: Ordem de prioridade (se accumulate-bonus: false, usa apenas o maior)

Exemplo prático:

Com bonus: 10.0, ao quebrar bloco que dá $100, o jogador ganha $110.

specific-level

Sistema de broadcast quando jogadores atingem níveis importantes.

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

Finalidade:

Cria marcos de progressão que são anunciados para todo o servidor, gerando competitividade e engajamento. Adicione múltiplos níveis (level50, level100, etc).

performance

Sistema para configurar a perfomance do reset-type YPLUGINS

# Configurações de performance do plugin.
# Ajuste conforme a capacidade do seu servidor.
performance:
  # Tamanho do lote de blocos processados por vez no reset da mina
  # Valores maiores = reset mais rápido, porém mais uso de CPU
  # Recomendado: 50000 para servidores médios, 100000 para servidores potentes
  batch-size: 50000
  # Quantidade de blocos processados por jogador no sistema de workload
  # Valores maiores = mais blocos por tick, porém pode causar lag
  workload-batch: 100
  # Quantidade de threads no pool assíncrono
  # Recomendado: 2-4 para servidores pequenos, 4-8 para servidores grandes
  async-pool-size: 4
  # Orçamento de tempo em milissegundos por tick para o sistema de workload
  # Valores menores = menos lag, porém processamento mais lento
  # Recomendado: 10-15ms (1 tick = ~50ms)
  workload-budget-ms: 12

Finalidade:

Configurar o sistema de batch conforme capacidade de processamento e armazenamento aleatório do servidor

Nesta página