Integrations

Every plugin mcMMO hooks into or coexists with - WorldGuard region flags, PlaceholderAPI, HealthBar, anti-cheat, and known conflicts - plus how to set each one up.

mcMMO works on its own, but it also detects and hooks into a handful of other plugins when they're present. None of them are required - each hook activates automatically only if the other plugin is installed. This page lists exactly which plugins mcMMO supports, what the integration does, and how to configure it.

mcMMO's plugin.yml declares these as soft-dependencies: WorldGuard, CombatTag, HealthBar, PlaceholderAPI, ProtocolLib. A soft-dependency only controls load order - mcMMO loads after these if they exist, but runs fine without any of them.

Supported plugins at a glance

Plugin	Type	What the hook does
WorldGuard	Region protection	Region flags to disable mcMMO, XP, or hardcore penalties per area.
PlaceholderAPI	Placeholders	Exposes levels, XP, power level, and party info as `%mcmmo_…%` placeholders.
HealthBar	Mob health display	mcMMO auto-disables its own mob healthbars to avoid conflicts.
NoCheatPlus	Anti-cheat	Needs CompatNoCheatPlus or mcMMO's fast actions get flagged.
ProjectKorra	Combat/abilities	Known conflict — warns about weakness potions and combat skills.
bStats	Anonymous metrics	Reports anonymous usage stats; can be turned off.

WorldGuard

If WorldGuard is installed, mcMMO registers three region flags during server load. Set them on any region with /region flag <name> <flag> <allow|deny>.

Flag	Default	`deny` effect
`mcmmo`	allow	Disables all mcMMO functionality inside the region.
`mcmmo-xp`	allow	Stops players gaining XP inside the region (skills still work).
`mcmmo-hardcore`	allow	Disables hardcore stat-loss / vampirism penalties inside the region.

Because the flags default to allow, mcMMO behaves normally everywhere until you explicitly deny one. Example - a safe spawn zone where no XP is earned:

/region flag spawn mcmmo-xp deny

WorldGuard flags are registered in mcMMO's onLoad() phase, so WorldGuard must load before mcMMO (the soft-dependency handles this automatically). If you see Could not register WG Flags! in console, WorldGuard isn't present or failed to load.

PlaceholderAPI

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

All placeholders are prefixed mcmmo_. The <skill> token is a lowercase skill name (e.g. mining, swords, herbalism).

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.
`%mcmmo_power_level%`	Total power level (sum of all skill levels).
`%mcmmo_power_level_cap%`	The configured power level cap.
`%mcmmo_xprate%`	Global XP multiplier.
`%mcmmo_is_xp_event_active%`	`true`/`false` — is an XP event running.
`%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.

HealthBar

If the standalone HealthBar plugin is installed, mcMMO automatically disables its own mob healthbars so the two don't fight over the mob name display. You'll see this in console on startup:

HealthBar plugin found, mcMMO's healthbars are automatically disabled.

No configuration is needed. If you'd rather control mcMMO's healthbars manually instead, remove the HealthBar plugin and use the Mob_Healthbar.Display_Type setting in config.yml (HEARTS, BAR, or DISABLED).

Anti-cheat (NoCheatPlus)

mcMMO's super abilities make players mine and attack faster than vanilla allows, which anti-cheat plugins flag as cheating. For NoCheatPlus, you must also install the CompatNoCheatPlus bridge. If mcMMO finds NoCheatPlus without it, it warns:

NoCheatPlus plugin found, but CompatNoCheatPlus was not found!
mcMMO will not work properly alongside NoCheatPlus without CompatNoCheatPlus

Other anti-cheat plugins (Spartan, Matrix, Vulcan, etc.) aren't detected by mcMMO. With those you must manually whitelist mcMMO's fast block-breaking and combat, or players will be flagged when Super Breaker, Giga Drill Breaker, and similar abilities are active.

Known conflict: ProjectKorra

If ProjectKorra is installed, mcMMO logs a warning at startup:

ProjectKorra was detected, this can cause some issues with weakness potions and combat
skills for mcMMO

The two plugins both manipulate combat and potion effects, which can produce odd behavior. mcMMO does not disable anything automatically here - test combat skills carefully if you run both.

bStats (anonymous metrics)

mcMMO reports anonymous usage statistics to bStats (plugin ID 3894) - server count, mcMMO version, and Standard vs Retro leveling mode. No player data is sent. To opt out, set it in config.yml:

Metrics:
    bstats: false

Soft-dependencies with no active hook

CombatTag and ProtocolLib appear in mcMMO's softdepend list so they load before mcMMO if present, but this version of mcMMO has no dedicated code path for them - they're load-order hints only. You don't need either for mcMMO to work.

For developers

If you're writing a plugin that needs to read or modify mcMMO data, or react to mcMMO events, see the API reference.

Integrations

On this page