mcMMO Rewards: guia do plugin de recompensas por nível no Minecraft

O popular sistema RPG mcMMO acrescenta aos servidores de Minecraft mecânicas de subida de nível em competências como pesca, mineração ou herbologia. No entanto, os criadores do plugin original não previram um sistema flexível para atribuir automaticamente itens, moeda ou títulos personalizados ao atingir determinados níveis. A extensão complementar mcMMO Rewards resolve exatamente esse problema. Ela liga o sistema de níveis do mcMMO a comandos de consola do servidor, permitindo aos donos de servidores criar recompensas automáticas para jogadores ativos sem escrever scripts complexos.

Processamento de eventos e integração com a API

O mcMMO Rewards funciona como um event listener leve, que se integra diretamente no núcleo do servidor Spigot/Paper e comunica com a API oficial do plugin mcMMO.

Interceção do evento McMMOPlayerLevelUpEvent

Sempre que um jogador sobe de nível em qualquer competência (por exemplo, minerando minério ou colhendo culturas), o mcMMO gera um evento McMMOPlayerLevelUpEvent. O mcMMO Rewards intercepta este evento e executa a seguinte lógica:

1. Lê o nome da competência e o novo nível alcançado pelo jogador.

2. Compara estes dados com as listas de recompensas definidas no ficheiro de configuração config.yml.

3. Se encontrar uma correspondência, o plugin executa, em nome da consola, a lista de comandos configurada, substituindo o marcador %player% pelo nome do jogador.

Limitações importantes do processamento de eventos

Como o plugin está associado exclusivamente ao evento McMMOPlayerLevelUpEvent, só reage às subidas de nível naturais obtidas durante o jogo. ⚠️ Reinícios de nível e alterações na base de dados: se um administrador alterar o nível de um jogador diretamente através dos ficheiros da base de dados SQLite/MySQL (por exemplo, durante uma migração de estatísticas ou um wipe), ou usar comandos de consola que alteram o valor do nível sem disparar o evento padrão de subida de nível, as recompensas não serão ativadas. O plugin também não suporta a atribuição retroativa de recompensas: se um jogador já tinha o nível 50 antes de instalar o mcMMO Rewards, não receberá as recompensas dos níveis já ultrapassados (10, 20, etc.) até atingir o nível seguinte.

Estrutura do config.yml e configuração de recompensas

Todas as recompensas são definidas num único ficheiro de configuração, plugins/mcMMORewards/config.yml. Graças à sintaxe simples do YAML, os programadores podem construir rapidamente sistemas de incentivos com vários níveis.

Descrição da sintaxe de configuração

Cada bloco de recompensas segue uma hierarquia estrita:

• Nome da competência (Skill): deve corresponder ao nome oficial da competência no mcMMO (por exemplo, mining, woodcutting, swords, herbalism).

• Nível (Level): um número inteiro, o nível a partir do qual os comandos são executados.

• Lista de comandos: a lista de ações de consola. Não é necessário colocar uma barra / no início dos comandos, uma vez que são todos executados diretamente pelo servidor em nome da consola (nível OP).

Exemplo de ficheiro de configuração

Abaixo está um exemplo de um ficheiro corretamente estruturado para atribuir itens e dinheiro:

rewards:
  mining:
    10:
      - "give %player% iron_ingot 5"
      - "broadcast &6[RPG] &e%player% &fдосяг 10-го рівня видобутку руди!"
    50:
      - "eco give %player% 1000"
      - "give %player% diamond 3"
  swords:
    25:
      - "xp give %player% 500"

Neste exemplo, quando o jogador %player% atinge o nível 10 em mining, recebe lingotes de ferro e é enviada uma mensagem a todo o servidor. Ao atingir o nível 50, o jogador recebe 1000 unidades de moeda através de um plugin económico (como o EssentialsX) e 3 diamantes.

Gerir o plugin: comandos e permissões

Como o mcMMO Rewards é uma extensão muito compacta, a sua lista de comandos e permissões limita-se apenas a funções administrativas.

Comando de recarregamento da configuração

Não é necessário reiniciar todo o servidor de Minecraft nem interromper o jogo para aplicar quaisquer alterações ao ficheiro config.yml. Basta executar o comando: /mcmmorewards reload Este comando descarrega as configurações antigas da memória do servidor e volta a ler o ficheiro de configuração, aplicando instantaneamente as novas recompensas.

Permissões para administradores (Permissions)

Por segurança do servidor, a possibilidade de executar o comando de recarregamento está restrita a uma permissão específica (permission node). Os jogadores normais não têm acesso a este comando. Para conceder o direito a um administrador ou moderador (por exemplo, através do LuckPerms), use o seguinte nó: mcmmorewards.reload Por predefinição, esta permissão é concedida automaticamente a qualquer jogador com estatuto de operador do servidor (OP).

Conclusão

O mcMMO Rewards é uma excelente ferramenta auxiliar para servidores de Minecraft com elementos de RPG e sobrevivência que utilizam o sistema de competências do mcMMO. Permite configurar facilmente a atribuição automática de recompensas pela atividade no jogo, sem necessidade de aprender linguagens de scripting complexas ou usar scripts pesados.

Em comparação com scripts complexos como o Skript (que exigem escrever uma sintaxe própria para escutar os eventos do mcMMO) ou plugins de missões completos, o mcMMO Rewards oferece um sistema tão simples e rápido de configurar quanto possível, com um consumo de recursos do servidor praticamente nulo. No entanto, a sua dependência total da instalação do plugin mcMMO e a limitação de os comandos só poderem ser executados em nome da consola são as suas principais restrições. O plugin é ideal para servidores que querem adicionar rapidamente recompensas simples pela recolha de recursos ou pelo desenvolvimento de competências de combate.