mcMMO Rewards: A Guide to the Level-Up Reward Plugin for Minecraft

The popular mcMMO RPG system adds skill-leveling mechanics to Minecraft servers — things like fishing, mining, or herbalism. However, the developers of the original plugin never built in a flexible way to automatically hand out items, currency, or custom titles when players reach certain levels. The companion add-on mcMMO Rewards solves exactly that problem. It links mcMMO's leveling system to server console commands, letting server owners set up automatic rewards for active players without writing complex scripts.

Event Handling and API Integration

mcMMO Rewards works as a lightweight event listener that hooks directly into the Spigot/Paper server core and talks to the official mcMMO plugin API.

Hooking the McMMOPlayerLevelUpEvent

Every time a player levels up any skill (say, by mining ore or harvesting crops), mcMMO fires a McMMOPlayerLevelUpEvent. mcMMO Rewards intercepts this event and runs the following logic:

1. Reads the skill name and the new level the player just reached.

2. Checks that data against the reward lists defined in the config.yml configuration file.

3. If a match is found, the plugin runs the configured list of commands as the console, substituting the player's name for the %player% placeholder.

Important Limitations of Event Handling

Because the plugin is tied exclusively to the McMMOPlayerLevelUpEvent, it only reacts to natural level-ups earned during gameplay. ⚠️ Level resets and database edits: if an administrator changes a player's level directly through the SQLite/MySQL database files (for example, during a stats migration or a wipe), or uses console commands that change the level value without firing the standard level-up event, rewards will not be triggered. The plugin also doesn't support retroactive rewards: if a player already reached level 50 before mcMMO Rewards was installed, they won't receive the rewards for the levels they passed along the way (10, 20, etc.) until they reach their next level.

The config.yml Structure and Reward Setup

All rewards are defined in a single configuration file, plugins/mcMMORewards/config.yml. Thanks to YAML's simple syntax, developers can quickly build multi-tiered incentive systems.

Configuration Syntax Overview

Each reward block follows a strict hierarchy:

• Skill name: must match the official mcMMO skill name (for example, mining, woodcutting, swords, herbalism).

• Level: an integer — the level at which the commands are run.

• Command list: the list of console actions. Don't put a leading slash / on the commands, since they're all executed directly by the server as the console (OP-level).

Sample Configuration File

Below is an example of a correctly structured file for handing out items and money:

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"

In this example, when a player %player% reaches level 10 in mining, they receive iron ingots and a message is broadcast to the whole server. At level 50, the player receives 1000 units of currency through an economy plugin (such as EssentialsX) and 3 diamonds.

Managing the Plugin: Commands and Permissions

Since mcMMO Rewards is a very compact add-on, its list of commands and permissions is limited to administrative functions only.

Config Reload Command

You don't need to restart the whole Minecraft server or interrupt gameplay to apply changes to the config.yml file. Just run: /mcmmorewards reload This command unloads the old settings from the server's memory and re-reads the configuration file, applying the new rewards instantly.

Admin Permissions

For server security, the ability to run the reload command is restricted to a dedicated permission node. Regular players don't have access to this command. To grant the right to an admin or moderator (for example, via LuckPerms), use the following node: mcmmorewards.reload By default, this permission is automatically granted to any player with server operator (OP) status.

Conclusion

mcMMO Rewards is a great helper tool for Minecraft servers with RPG and survival elements that use the mcMMO skill system. It makes it easy to set up automatic rewards for in-game activity without having to learn complex scripting languages or use heavyweight scripts.

Compared to complex scripts like Skript (which require writing custom syntax to listen for mcMMO events) or full-blown quest plugins, mcMMO Rewards offers a system that's as simple and fast to set up as possible, with almost no server resource footprint. That said, its complete dependency on having the mcMMO plugin installed, and the fact that commands can only run as the console, are its main constraints. The plugin is a perfect fit for servers that want to quickly add simple perks for gathering resources or leveling up combat skills.