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.

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 todos os aspectos do sistema de mcMMO personalizado. 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

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

shop-menu

Define se o botão de loja de créditos será exibido no menu de habilidades.

# Ativar o sistema de loja no menu
shop-menu: true

• true - Exibe o botão da loja no menu /stats
• false - Oculta o botão da loja

accumulate-bonus

Define se os bônus de XP de diferentes permissões devem ser somados.

# Acumular os bônus que tiver permissão
accumulate-bonus: false

Como funciona:

• false - Apenas o bônus de maior valor será aplicado
• true - Todos os bônus das permissões que o jogador tiver serão somados

Exemplo:

Jogador tem as permissões:

• ymcmmoutil.bonus.vip (10% de bônus)
• ymcmmoutil.bonus.premium (20% de bônus)

Com accumulate-bonus: false → Receberá 20% (maior valor)
Com accumulate-bonus: true → Receberá 30% (10% + 20%)

general

Configurações gerais de formatação de mensagens de bônus.

general:
  formatter-bonus-has: '&a+{bonus}% por ser {display}&a.'
  formatter-bonus-no-has: ''

Placeholders disponíveis:

• {bonus} - Porcentagem do bônus
• {display} - Nome de exibição configurado no bônus

formatter-bonus-has: Mensagem exibida quando o jogador tem bônus de XP
formatter-bonus-no-has: Mensagem exibida quando o jogador não tem bônus (deixe vazio para não exibir nada)

actionbar

Sistema de barra de ação que exibe informações de XP ganho em tempo real acima da hotbar.

actionbar:
  enabled: true
  # Mundos em que a actionbar estará desativada
  disabled-worlds: []
  # Mensagem que irá aparecer na actionbar ao ganhar XP do mcMMO
  message: '&a{skill}: {level} ({xp_has} / {xp_need}) +{xp_earned}XP'

Placeholders disponíveis:

Exemplo visual:

Mineração: 150 (850 / 1000) +5XP

level-up

Sistema de anúncio público quando jogadores atingem níveis específicos.

level-up:
  enabled: true
  # Enviar mensagem a cada x level ( por exemplo, a cada 100 leveis em tal skill: lvl 100, 200...)
  level: 100
  strike: true
  message: |
    <nl>
    &b&lSKILLS: &bO jogador &f{player}&b atingiu o &fnível {nivel} &bna habilidade &f{skill}&f!
    <nl>

Configurações:

• enabled: Ativa ou desativa o sistema de anúncios
• level: Intervalo de níveis para anunciar (100 = anuncia nos níveis 100, 200, 300...)
• strike: Envia lightning visual no jogador ao atingir o nível
• message: Mensagem broadcast para o servidor

Placeholders disponíveis:

• {player} - Nome do jogador
• {nivel} - Nível alcançado
• {skill} - Nome da habilidade

rewards

Sistema de recompensas automáticas quando jogadores atingem níveis específicos.

rewards:
  mining_lvl100:
    skill: 'MINING'
    level: 100
    reward:
      - 'give {player} stone 1'

Como configurar recompensas:

Cada recompensa precisa de:

• ID único (ex: mining_lvl100)
• skill: Nome da habilidade em inglês
• level: Nível específico para dar a recompensa
• reward: Lista de comandos a executar

Habilidades disponíveis:

• ALCHEMY - Alquimia
• ARCHERY - Arqueria
• AXES - Machados
• EXCAVATION - Escavação
• FISHING - Pescaria
• HERBALISM - Herbalismo
• MINING - Mineração
• REPAIR - Reparação
• SWORDS - Espadas
• TAMING - Adestramento
• UNARMED - Desarmado
• WOODCUTTING - Arvorismo

Exemplo com múltiplas recompensas:

rewards:
  mining_lvl100:
    skill: 'MINING'
    level: 100
    reward:
      - 'give {player} diamond_pickaxe 1'
      - 'eco give {player} 1000'
      - 'broadcast &a{player} dominou a mineração!'
  
  mining_lvl500:
    skill: 'MINING'
    level: 500
    reward:
      - 'give {player} diamond 64'
      - 'lp user {player} permission set minerador.lendario'
  
  swords_lvl250:
    skill: 'SWORDS'
    level: 250
    reward:
      - 'give {player} diamond_sword 1'

task

Configurações de tarefas automáticas do plugin.

task:
  # Segundos para atualizar o ranking
  ranking: 1800
  # Segundos para atualizar as tags
  tags: 1800

Configurações:

• ranking: Intervalo de atualização do ranking de habilidades (1800s = 30 minutos)
• tags: Intervalo de atualização das tags dos jogadores (1800s = 30 minutos)

tags

Sistema de tags personalizadas para jogadores baseado em nível de habilidades.

tags:
  all:
    skill: ''
    tag: '&9[⚒] '
    # {ymcmmoutil_global} e %ymcmmoutil_ymcmmoutil_global%
    placeholder: 'ymcmmoutil_global'
    min-level: 0

Como configurar tags:

Cada tag precisa de:

• ID único (ex: all, master_miner)
• skill: Habilidade requerida (vazio = nível total de todas)
• tag: Texto da tag com cores
• placeholder: Nome do placeholder para usar em outros plugins
• min-level: Nível mínimo necessário

Exemplo com múltiplas tags:

tags:
  all:
    skill: ''
    tag: '&9[⚒] '
    placeholder: 'ymcmmoutil_global'
    min-level: 1000
  
  master_miner:
    skill: 'MINING'
    tag: '&6[⛏ Mestre] '
    placeholder: 'ymcmmoutil_miner'
    min-level: 500
  
  legendary_swordsman:
    skill: 'SWORDS'
    tag: '&c[⚔ Lendário] '
    placeholder: 'ymcmmoutil_swordsman'
    min-level: 750
  
  expert_woodcutter:
    skill: 'WOODCUTTING'
    tag: '&a[🪓 Expert] '
    placeholder: 'ymcmmoutil_woodcutter'
    min-level: 300

Usando tags em outros plugins:

No nChat ou outro plugin de chat, use:

{ymcmmoutil_global}{ymcmmoutil_miner}{player}: {message}

bonus

Sistema de bônus de XP baseado em permissões. Jogadores com permissões específicas ganham mais XP.

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

Como configurar bônus:

Cada bônus precisa de:

• ID único (ex: membros, vip, premium)
• order: Ordem de prioridade (menor = maior prioridade)
• permission: Permissão necessária
• display: Nome exibido nas mensagens
• bonus: Porcentagem de bônus de XP

Exemplo com múltiplos bônus:

bonus:
  membro:
    order: 3
    permission: 'ymcmmoutil.bonus.membro'
    display: '&7[Membro]'
    bonus: 10.0
  
  vip:
    order: 2
    permission: 'ymcmmoutil.bonus.vip'
    display: '&a[VIP]'
    bonus: 25.0
  
  premium:
    order: 1
    permission: 'ymcmmoutil.bonus.premium'
    display: '&6[Premium]'
    bonus: 50.0

Como funciona:

Se accumulate-bonus: false:

• Jogador com VIP e Membro → Recebe 25% (maior valor)

Se accumulate-bonus: true:

• Jogador com VIP e Membro → Recebe 35% (25% + 10%)

format

Sistema de formatação de números grandes para exibição nos menus e mensagens.

format:
  type: 'LETTER' # Tipos: LETTER - NUMBER
  max-decimals: 4
  formats:
    - ''
    - ''
    - 'K'
    - 'M'
    - 'B'
    - 'T'
    - 'Q'
    - 'QQ'
    - 'S'
    - 'SS'
    - 'O'
    - 'N'
    - 'D'

Tipos de formatação:

• LETTER: Usa abreviações para números grandes
• NUMBER: Exibe números completos com pontuação

Exemplos com LETTER:

Exemplos com NUMBER:

max-decimals: Quantidade máxima de casas decimais a exibir (4 = até 4 casas)

formats: Lista de sufixos para cada ordem de grandeza. A ordem é:

1. Unidades (1-999)
2. Milhares (1K-999K)
3. Milhões (1M-999M)
4. Bilhões (1B-999B)
5. E assim por diante...