mcMMO Rewards : présentation du plugin de récompenses par niveau sur Minecraft

Le très populaire système RPG mcMMO ajoute aux serveurs Minecraft des mécaniques de montée de niveau dans des compétences comme la pêche, l'extraction de minerai ou l'herboristerie. Cependant, les développeurs du plugin original n'ont pas prévu de système flexible pour distribuer automatiquement des objets, de la monnaie ou des titres personnalisés lorsqu'un joueur atteint certains niveaux. L'extension complémentaire mcMMO Rewards résout justement ce problème. Elle relie le système de niveaux de mcMMO aux commandes console du serveur, permettant aux propriétaires de serveurs de créer des récompenses automatiques pour les joueurs actifs sans écrire de scripts complexes.

Gestion des événements et intégration à l'API

mcMMO Rewards fonctionne comme un event listener léger qui s'intègre directement au cœur du serveur Spigot/Paper et communique avec l'API officielle du plugin mcMMO.

Interception de l'événement McMMOPlayerLevelUpEvent

Chaque fois qu'un joueur monte de niveau dans une compétence (par exemple en minant du minerai ou en récoltant), mcMMO déclenche un événement McMMOPlayerLevelUpEvent. mcMMO Rewards intercepte cet événement et exécute l'algorithme suivant :

1. Il lit le nom de la compétence et le nouveau niveau atteint par le joueur.

2. Il compare ces données aux listes de récompenses définies dans le fichier de configuration config.yml.

3. Si une correspondance est trouvée, le plugin exécute, au nom de la console, la liste de commandes configurée, en remplaçant le placeholder %player% par le nom du joueur.

Limites importantes de la gestion des événements

Comme le plugin est lié exclusivement à l'événement McMMOPlayerLevelUpEvent, il ne réagit qu'aux montées de niveau naturelles obtenues en jouant. ⚠️ Réinitialisation des niveaux et base de données : si un administrateur modifie le niveau d'un joueur directement via les fichiers de base de données SQLite/MySQL (par exemple lors d'une migration de statistiques ou d'un wipe), ou utilise des commandes console qui changent la valeur du niveau sans déclencher l'événement standard de montée de niveau, les récompenses ne seront pas activées. Le plugin ne prend pas non plus en charge l'attribution rétroactive des récompenses : si un joueur avait déjà atteint le niveau 50 avant l'installation de mcMMO Rewards, il ne recevra pas les récompenses des niveaux déjà franchis (10, 20, etc.) tant qu'il n'aura pas atteint le niveau suivant.

Structure du config.yml et configuration des récompenses

Toutes les récompenses sont définies dans un seul fichier de configuration, plugins/mcMMORewards/config.yml. Grâce à la syntaxe simple de YAML, les développeurs peuvent rapidement construire des systèmes de récompenses à plusieurs paliers.

Présentation de la syntaxe de configuration

Chaque bloc de récompense suit une hiérarchie stricte :

• Nom de la compétence (Skill) : doit correspondre au nom officiel de la compétence dans mcMMO (par exemple mining, woodcutting, swords, herbalism).

• Niveau (Level) : un nombre entier, le niveau auquel les commandes sont exécutées.

• Liste de commandes : la liste des actions console. Inutile d'ajouter une barre oblique / au début des commandes, puisqu'elles sont toutes exécutées directement par le serveur au nom de la console (niveau OP).

Exemple de fichier de configuration

Voici un exemple de fichier correctement structuré pour distribuer des objets et de l'argent :

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"

Dans cet exemple, lorsque le joueur %player% atteint le niveau 10 dans mining, il reçoit des lingots de fer et un message est diffusé à tout le serveur. Au niveau 50, le joueur reçoit 1000 unités de monnaie via un plugin d'économie (comme EssentialsX) et 3 diamants.

Gérer le plugin : commandes et permissions

mcMMO Rewards étant une extension très compacte, sa liste de commandes et de permissions se limite uniquement aux fonctions d'administration.

Commande de rechargement de la configuration

Il n'est pas nécessaire de redémarrer tout le serveur Minecraft ni d'interrompre la partie pour appliquer des modifications au fichier config.yml. Il suffit d'exécuter la commande : /mcmmorewards reload Cette commande décharge les anciens paramètres de la mémoire du serveur et relit le fichier de configuration, appliquant instantanément les nouvelles récompenses.

Permissions pour les administrateurs

Pour la sécurité du serveur, la possibilité d'exécuter la commande de rechargement est limitée à une permission dédiée (permission node). Les joueurs normaux n'ont pas accès à cette commande. Pour accorder ce droit à un administrateur ou un modérateur (par exemple via LuckPerms), utilisez le nœud suivant : mcmmorewards.reload Par défaut, cette permission est automatiquement accordée à tout joueur ayant le statut d'opérateur serveur (OP).

Conclusion

mcMMO Rewards est un excellent outil d'appoint pour les serveurs Minecraft avec des éléments RPG et survie qui utilisent le système de compétences de mcMMO. Il permet de configurer facilement la distribution automatique de récompenses pour l'activité en jeu, sans avoir à apprendre des langages de script complexes ni à utiliser de scripts lourds.

Comparé à des scripts complexes comme Skript (qui nécessitent d'écrire une syntaxe propre pour écouter les événements de mcMMO) ou à des plugins de quêtes complets, mcMMO Rewards propose un système aussi simple et rapide à configurer que possible, avec une empreinte quasi nulle sur les ressources du serveur. Sa dépendance totale à la présence du plugin mcMMO installé, ainsi que le fait que les commandes ne puissent s'exécuter qu'au nom de la console, restent toutefois ses principales limites. Le plugin convient parfaitement aux serveurs qui souhaitent ajouter rapidement des récompenses simples pour la collecte de ressources ou la montée en puissance des compétences de combat.