Level-Up Commands

Want players to get a diamond at Mining 50, a server-wide announcement at power level 1000, or a permission node unlocked at Herbalism 100? Level-up commands run any server command automatically the moment a player crosses a milestone you choose - no other plugin required.

Where it's configured

Everything lives in one file:

plugins/mcMMO/level_up_commands.yml

It ships with several ready-to-use example entries, all disabled by default. Copy one, tweak it, flip enabled to true, and restart the server (like every mcMMO config file, changes need a full restart).

Setting up your first reward

Each entry needs a commands list and a trigger - either a skill level, a power level, or both. Here's a simple one: give a diamond and announce it when someone hits Mining 50:

level_up_commands:
    mining_milestones:
        enabled: false
        skills: [ Mining, Excavation ]
        levels: [ 10, 50, 100 ]
        commands:
            - "say {@player} reached level {@level} in {@skill}!"
            - "give {@player} minecraft:diamond 1"

skills and commands accept either one value or a list, so this single entry actually covers six milestones (three levels × two skills). Commands are written without a leading slash, and run once per milestone even if a player gains several levels at once (e.g. through /addlevels).

Reward power level instead of a single skill

Power level is the sum of a player's skill levels - use power_levels on its own, no skills/levels needed:

level_up_commands:
    power_level_milestones:
        enabled: false
        power_levels: [ 500, 1000, 2000 ]
        commands:
            - "say {@player} has reached power level {@power_level}!"
            - "lp user {@player} permission set some.reward.node true"

An entry can combine both trigger types at once - it fires whenever either condition is met, so you can reward "any combat skill hits 50, or overall power hits 750" in one entry:

level_up_commands:
    combined_triggers:
        enabled: false
        skills: [ Swords, Axes ]
        levels: [ 50 ]
        power_levels: [ 750 ]
        commands:
            - "say {@player} reached a combat milestone! Swords: {@swords_level}, Axes: {@axes_level}, power level: {@power_level}"

Placeholders you can use

Drop these straight into any command string - no leading slash, no extra setup:

If PlaceholderAPI is installed, its placeholders - including mcMMO's own %mcmmo_…% ones and third-party expansions - also resolve against the leveling player:

level_up_commands:
    papi_examples:
        enabled: false
        skills: all
        levels: [ 500 ]
        commands:
            - "say {@player} hit {@skill} {@level} while exploring %player_world%!"
            - "say {@player} is now position %mcmmo_rank_mining% on the Mining leaderboard!"

%player_world% needs PlaceholderAPI's separate Player expansion downloaded; mcMMO's own %mcmmo_rank_mining% works out of the box.

Running the command as the player

By default commands run from CONSOLE, which bypasses permissions entirely - good for give, lp, or anything an admin could run. Set run_as: PLAYER to run it as the player instead, using their own permissions - handy for things like /me broadcasts:

level_up_commands:
    any_skill_mastery:
        enabled: false
        skills: all
        levels: [ 100 ]
        run_as: PLAYER
        commands:
            - "me just reached level {@level} in {@skill}!"

skills: all covers every skill in one entry - it fires whenever any skill hits the listed level(s), not just once total.

Sending a rich chat message

For something fancier than plain chat, run tellraw - it supports colors, bold text, and hover tooltips:

level_up_commands:
    fancy_message:
        enabled: false
        skills: all
        levels: [ 250 ]
        commands:
            - 'tellraw {@player} {"text":"","extra":[{"text":"Milestone! ","color":"gold","bold":true},{"text":"[{@skill} {@level}]","color":"aqua","underlined":true,"hover_event":{"action":"show_text","value":"Keep it up, {@player}! Power level: {@power_level}"}},{"text":" (hover for details)","color":"gray","italic":true}]}'

Reference

For developers

Other plugins can register their own level-up triggers or callbacks (and unregister them later) through LevelUpCommandAPI without touching this file. See the API reference.