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

enchantments.yml

redstone.yml

commands.yml

config.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 das minas privadas, picaretas e encantamentos. 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 das minas privadas 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/yMinasPv/data.db.

Delay em ticks para carregar os dados do jogador após o login. Útil para evitar problemas de sincronia em servidores separados (BungeeCord/Velocity).

# Delay em ticks (20 ticks = 1 segundo)
# Recomendado: 20 ticks para redes multi-servidor
login-delay: 20

Quando usar:

Rede BungeeCord/Velocity com servidor de mina separado
Problemas de dados não carregando no login

mining-skill-identify

Identificador da skill de mineração para integração com plugins de skills (mcMMO ou AuraSkills).

# Identificador da skill de mineração
mining-skill-identify: 'MINING'

O plugin dará experiência na skill configurada ao minerar blocos.

general

Configurações gerais do sistema de minas privadas e picaretas.

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 o preview no shift
  shift-preview-enabled: true
  # Ativar o preview sem shift
  no-shift-preview-enabled: true
  # Ativar o place no shift
  shift-place: true
  # Ativar o place sem shift
  no-shift-place: false
  # Tempo que levará para atualizar o preview em ticks (20 ticks = 1 segundo)
  refresh-time: 5
  # Distância do preview em blocos
  preview-distance: 7
  # Máximo de minas privadas que um jogador poderá ter
  player-max-mines: 1
  # Ativar o sistema de limitador de amigos da mina
  mine-limit-friends: true
  # Quantia de amigos (padrão) que cada mina poderá ter
  mine-default-friends: 10
  # Máximo de amigos que uma mina privada poderá ter
  mine-max-friends: 20
  # 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
  # Habilitar o price-multiplier de maneira exponencial
  price-multiplier-exponential: 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
  # Esconder o encantamento na lore da picareta caso o player desative ele
  hide-deactivated: false
  # Habilitar o menu da mina ao interagir com a mina sem shift
  no-shift-menu: true
  # Habilitar o menu da mina ao interagir com a mina com shift
  shift-menu: true
  # Requerer a picareta customizada para minerar na mina privada
  require-custom-pickaxe: false
  # Materiais que irão ser reconhecidos na skin
  skin-materials:
    - 'WOOD'
    - 'STONE'
    - 'IRON'
    - 'GOLD'
    - 'DIAMOND'

Destaques importantes:

Sistema de preview

shift-preview-enabled/no-shift-preview-enabled: Controla quando o preview aparece
refresh-time: Quanto menor, mais fluído o preview (cuidado com performance)
preview-distance: Distância em blocos que o preview é visível

Sistema de colocação

shift-place/no-shift-place: Controla quando a mina pode ser colocada
Recomendado: Deixar apenas shift-place: true para evitar colocações acidentais

Sistema de amigos

player-max-mines: Quantas minas um jogador pode ter ativas simultaneamente
mine-default-friends: Slots de amigos que cada mina começa
mine-max-friends: Máximo de slots que podem ser adquiridos

Sistema de evolução de picaretas

price-multiplier-exponential:
- true: Preço aumenta exponencialmente (1000 → 2000 → 4000 → 8000)
- false: Preço aumenta linearmente (1000 → 2000 → 3000 → 4000)
evolute-q-max/evolute-right-max: Limite de evolução por interação

Use price-multiplier-exponential: true para equilibrar melhor a progressão de encantamentos.

Controle de interações

no-shfit-evolution/shfit-evolution: Quando o menu de evolução abre
no-shift-menu/shift-menu: Quando o menu da mina abre
hide-deactivated: Se false, encantamentos desativados aparecem riscados na lore

Sistema de skins

skin-materials: Lista de materiais aceitos como skins de picaretas
Apenas picaretas destes materiais serão reconhecidas

pickaxe

Configuração do item da picareta padrão que os jogadores recebem.

pickaxe:
  unbreakable: true
  material: DIAMOND_PICKAXE
  name: '&bPicareta &7(Mina Privada)'
  lore:
    - '&7Inquebrável ∞'
    - '{enchants}'

Opções disponíveis:

unbreakable: Picareta não perde durabilidade
material: Material da picareta (deve estar em skin-materials)
name: Nome inicial da picareta
lore: Lore da picareta (use {enchants} para listar os encantamentos)

A placeholder {enchants} será substituída automaticamente pela lista de encantamentos da picareta.

friend-slot

Item que jogadores podem usar para adicionar slots de amigos extras em suas minas.

friend-slot:
  material: 'f5eafa77ffc89b1c4cb939beca1e0364a176b8f44e13be76d5d51b59fd084144'
  name: '&b+1 Slot de Amigo &7(Mina Privada)'
  lore:
    - '&7Ativando este item na sua mina privada'
    - '&7ela ira receber +1 slot para adicionar amigos.'
    - ''
    - '&aClique com botão direito na Mina para ativar.'

Como funciona:

Jogador recebe o item (via comando /minapv give ou recompensas)
Clica com botão direito na mina privada
Ganha +1 slot de amigo (até o limite de mine-max-friends)

bonus

Sistema de bônus de coins por permissão. Jogadores com determinadas permissões ganham porcentagens extras ao minerar.

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

Como funciona:

Jogadores com a permissão yminaspv.bonus.membro ganham +10% de coins ao minerar
accumulate-bonus: false (em general): Apenas o maior bônus é aplicado
accumulate-bonus: true (em general): Todos os bônus com permissão são somados

Exemplo de múltiplos bônus:

bonus:
  vip:
    order: 1
    permission: 'yminaspv.bonus.vip'
    display: '&a[VIP]'
    bonus: 15.0
  
  vip-plus:
    order: 2
    permission: 'yminaspv.bonus.vipplus'
    display: '&6[VIP+]'
    bonus: 25.0
  
  mvp:
    order: 3
    permission: 'yminaspv.bonus.mvp'
    display: '&b[MVP]'
    bonus: 50.0

reward-message

Sistema que envia mensagens periódicas ao jogador mostrando as recompensas coletadas.

reward-message:
  enabled: true
  # Delay para enviar a mensagem em segundos
  delay: 60
  message: |
    &r
    &eMina Privada
    &7Suas recompensas do último minuto.
    &r
    {chat}
    &r

Como funciona:

A cada 60 segundos, o jogador recebe uma mensagem listando todas as recompensas que coletou durante esse período.

Placeholder:

{chat}: Lista de recompensas formatadas

Ajuste o delay conforme a atividade do seu servidor. 60 segundos é ideal para servidores ativos.

earns-message

Sistema que envia mensagens periódicas ao jogador mostrando o total de coins ganhos na mina.

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, o jogador recebe uma mensagem mostrando quantos blocos quebrou e quanto ganhou de cada economia.

Placeholders:

{blocks}: Quantidade de blocos quebrados no período
{chat}: Lista de economias ganhas (formatado por chat-format)
{provider_display}: Nome da economia (ex: Dinheiro)
{provider_symbol}: Símbolo da economia (ex: $)
{provider_value}: Valor total ganho

Exemplo de saída:

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

Confira o lucro dos blocos quebrados:
| Dinheiro: $15000
| Pontos: ⭐750

Nesta página