mcMMO Unofficial Docs - Placeholders

The complete PlaceholderAPI reference for mcMMO - every %mcmmo_…% placeholder for skill stats, power level, parties, XP rate, skill names, and leaderboard positions.

If PlaceholderAPI is installed, mcMMO registers the mcmmo expansion automatically - no download needed from the eCloud, no config to enable it. Any plugin that resolves placeholders (scoreboards, tab lists, holograms, chat formatters, GUI menus) can then show mcMMO data.

All placeholders are prefixed mcmmo_. This page is the full reference; see Integrations for how mcMMO detects PlaceholderAPI in the first place.

The <skill> token below is always a lowercase skill name, e.g. mining, swords, herbalism. Child skills (Salvage, Smelting) work for the per-skill stat placeholders, but not for the leaderboard-position ones - they have no XP of their own.

Skill stats

One of each per skill - swap <skill> for any skill name.

Placeholder	Returns
`%mcmmo_level_<skill>%`	Player's level in that skill.
`%mcmmo_xp_<skill>%`	Current XP into the level.
`%mcmmo_xp_needed_<skill>%`	Total XP required for the next level.
`%mcmmo_xp_remaining_<skill>%`	XP still needed to level up.
`%mcmmo_rank_<skill>%`	Leaderboard rank for that skill.
`%mcmmo_xprate_<skill>%`	This player's effective XP multiplier for that skill (from perks).

Example: %mcmmo_level_mining% returns the viewing player's Mining level.

Skill names

Returns the skill's display name, following the server's active locale and any locale overrides - useful for building menus or scoreboards that need to show a skill's name without hardcoding it.

Placeholder	Returns
`%mcmmo_skillname_<skill>%`	Message-style name (e.g. `Mining`) - same text used in level-up broadcasts, `/mcrank`, `/mctop`.
`%mcmmo_skillname_header_<skill>%`	All-caps header name (e.g. `MINING`) - same text used in scoreboards and skill command screens.

Power level

Power level is the sum of a player's skill levels (only skills they have permission for).

Placeholder	Returns
`%mcmmo_power_level%`	Total power level.
`%mcmmo_power_level_cap%`	The configured power level cap (`0` = no cap).

XP rate & events

Placeholder	Returns
`%mcmmo_xprate%`	Global XP multiplier.
`%mcmmo_is_xp_event_active%`	`true`/`false` - is an XP rate event currently running.

These reflect the global rate only. Per-skill rates set via /xprate <skill> <rate> aren't exposed as separate placeholders - %mcmmo_xprate_<skill>% above is the player's perk-based multiplier, not the admin-set event rate.

Party

Placeholder	Returns
`%mcmmo_in_party%`	`true`/`false` - is the player in a party.
`%mcmmo_party_name%`	The player's party name.
`%mcmmo_party_leader%`	The party leader's name.
`%mcmmo_is_party_leader%`	`true`/`false` - is the player the leader.
`%mcmmo_party_size%`	Number of members in the party.

All five return blank/false if the player isn't in a party.

Leaderboard rank-position placeholders

These read a specific position on a leaderboard, rather than the viewing player's own stats - built for scoreboards or holograms that show a top-10 list.

Placeholder	Returns
`%mcmmo_mctop_<skill>:<position>%`	Skill level at that leaderboard position (e.g. `%mcmmo_mctop_mining:1%` = the #1 Mining level).
`%mcmmo_mctop_name_<skill>:<position>%`	Player name at that leaderboard position.
`%mcmmo_mctop_overall:<position>%`	Power level at that position on the overall leaderboard.
`%mcmmo_mctop_name_overall:<position>%`	Player name at that position on the overall leaderboard.

overall has two aliases that return identical data - use whichever reads better in your config: %mcmmo_mctop_all:<position>% and %mcmmo_mctop_powerlevel:<position>% (and their _name_ equivalents).

Not available for the child skills Salvage and Smelting - they have no XP of their own, so they have no leaderboard. <position> must be a positive whole number; a missing, non-numeric, zero, negative, or too-high position returns an empty string.

Building a top-10 list

Chain ten placeholders with different positions to build a leaderboard display, e.g. for a scoreboard or hologram plugin:

#1 %mcmmo_mctop_name_mining:1% - %mcmmo_mctop_mining:1%
#2 %mcmmo_mctop_name_mining:2% - %mcmmo_mctop_mining:2%
#3 %mcmmo_mctop_name_mining:3% - %mcmmo_mctop_mining:3%

Performance & caching

These are backed by a cache, not a live database query on every placeholder request, so even a busy leaderboard display doesn't hammer your database:

The highest position you can request is capped by General.PlaceholderAPI.Leaderboards.Max_Tracked_Rank in config.yml (default 100, clamped between 10 and 1000 - higher values use more memory and read more rows on every refresh).
How often the cache refreshes is set by General.Leaderboards.Refresh_Interval_Seconds in the same file - SQL (default 60) for MySQL/MariaDB servers, FlatFile (default 600) for the default flatfile database. Both have a 60-second floor. See config.yml for details.
The cache only does work while at least one leaderboard placeholder is actively in use - a server that never displays them pays no background cost.

Placeholders