mcMMO Rewards: guía del plugin de recompensas por nivel en Minecraft

El popular sistema RPG mcMMO añade a los servidores de Minecraft mecánicas de subida de nivel en habilidades como la pesca, la minería o la herboristería. Sin embargo, los desarrolladores del plugin original no incluyeron un sistema flexible para entregar automáticamente objetos, dinero o títulos personalizados al alcanzar ciertos niveles. La extensión complementaria mcMMO Rewards resuelve justamente ese problema. Conecta el sistema de niveles de mcMMO con comandos de consola del servidor, permitiendo a los propietarios de servidores crear recompensas automáticas para los jugadores activos sin necesidad de escribir scripts complejos.

Gestión de eventos e integración con la API

mcMMO Rewards funciona como un listener de eventos ligero que se integra directamente en el núcleo del servidor Spigot/Paper y se comunica con la API oficial del plugin mcMMO.

Interceptando el evento McMMOPlayerLevelUpEvent

Cada vez que un jugador sube de nivel en cualquier habilidad (por ejemplo, minando mineral o recolectando cosechas), mcMMO genera un evento McMMOPlayerLevelUpEvent. mcMMO Rewards intercepta este evento y ejecuta la siguiente lógica:

1. Lee el nombre de la habilidad y el nuevo nivel alcanzado por el jugador.

2. Compara estos datos con las listas de recompensas definidas en el archivo de configuración config.yml.

3. Si encuentra una coincidencia, el plugin ejecuta, en nombre de la consola, la lista de comandos configurada, sustituyendo el marcador %player% por el nombre del jugador.

Limitaciones importantes de la gestión de eventos

Como el plugin está vinculado exclusivamente al evento McMMOPlayerLevelUpEvent, solo reacciona a las subidas de nivel naturales obtenidas durante el juego. ⚠️ Reinicios de nivel y edición de la base de datos: si un administrador cambia el nivel de un jugador directamente en los archivos de la base de datos SQLite/MySQL (por ejemplo, durante una migración de estadísticas o un wipe), o usa comandos de consola que modifican el nivel sin disparar el evento estándar de subida de nivel, las recompensas no se activarán. El plugin tampoco admite la entrega retroactiva de recompensas: si un jugador ya tenía el nivel 50 antes de instalar mcMMO Rewards, no recibirá las recompensas de los niveles que ya superó (10, 20, etc.) hasta que alcance el siguiente nivel.

Estructura de config.yml y configuración de recompensas

Todas las recompensas se definen en un único archivo de configuración, plugins/mcMMORewards/config.yml. Gracias a la sencilla sintaxis de YAML, los desarrolladores pueden construir rápidamente sistemas de incentivos con múltiples niveles.

Descripción de la sintaxis de configuración

Cada bloque de recompensas sigue una jerarquía estricta:

• Nombre de la habilidad (Skill): debe coincidir con el nombre oficial de la habilidad en mcMMO (por ejemplo, mining, woodcutting, swords, herbalism).

• Nivel (Level): un número entero, el nivel al que se ejecutan los comandos.

• Lista de comandos: la lista de acciones de consola. No hace falta añadir una barra inicial / a los comandos, ya que todos se ejecutan directamente por el servidor en nombre de la consola (nivel OP).

Ejemplo de archivo de configuración

A continuación se muestra un ejemplo de un archivo correctamente estructurado para entregar objetos y dinero:

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"

En este ejemplo, cuando el jugador %player% alcanza el nivel 10 en mining, recibe lingotes de hierro y se envía un mensaje a todo el servidor. Al alcanzar el nivel 50, el jugador recibe 1000 unidades de moneda a través de un plugin económico (como EssentialsX) y 3 diamantes.

Gestión del plugin: comandos y permisos

Como mcMMO Rewards es una extensión muy compacta, su lista de comandos y permisos se limita únicamente a funciones administrativas.

Comando de recarga de configuración

No es necesario reiniciar todo el servidor de Minecraft ni interrumpir la partida para aplicar cualquier cambio en el archivo config.yml. Basta con ejecutar el comando: /mcmmorewards reload Este comando descarga los ajustes antiguos de la memoria del servidor y vuelve a leer el archivo de configuración, aplicando las nuevas recompensas al instante.

Permisos para administradores (Permissions)

Por seguridad del servidor, la posibilidad de ejecutar el comando de recarga está restringida a un permiso específico (permission node). Los jugadores normales no tienen acceso a este comando. Para conceder el permiso a un administrador o moderador (por ejemplo, mediante LuckPerms), usa el siguiente nodo: mcmmorewards.reload Por defecto, este permiso se concede automáticamente a cualquier jugador con estatus de operador del servidor (OP).

Conclusión

mcMMO Rewards es una excelente herramienta auxiliar para servidores de Minecraft con elementos de RPG y supervivencia que usan el sistema de habilidades de mcMMO. Permite configurar fácilmente la entrega automática de recompensas por actividad en el juego sin necesidad de aprender lenguajes de scripting complejos ni usar scripts pesados.

En comparación con scripts complejos como Skript (que requieren escribir una sintaxis propia para escuchar los eventos de mcMMO) o plugins de misiones completos, mcMMO Rewards ofrece un sistema tan simple y rápido de configurar como sea posible, con un consumo de recursos del servidor prácticamente nulo. Sin embargo, su dependencia total de tener instalado el plugin mcMMO y la limitación de que los comandos solo se ejecuten en nombre de la consola son sus principales restricciones. El plugin es perfecto para servidores que quieren añadir rápidamente recompensas sencillas por recolectar recursos o subir habilidades de combate.