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, ViaVersion. 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, party, and leaderboard 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 denyWorldGuard 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: skill levels and XP, power level, party info, skill names, XP rate, and
leaderboard positions.
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 CompatNoCheatPlusOther 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 mcMMOThe 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: falseSoft-dependencies with no active hook
CombatTag, ProtocolLib, and ViaVersion appear in mcMMO's softdepend list so they load
before mcMMO if present, but none has a dedicated integration hook - they're load-order
hints only. ViaVersion is listed because scoreboard objective names are kept short for
compatibility with older clients that connect through it and still enforce a 16-character
objective-name limit. You don't need any of the three 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.
Install & Upgrade
How to install or upgrade mcMMO on a Spigot, Paper, or Folia server, and what happens to your config and data.
Placeholders
The complete PlaceholderAPI reference for mcMMO - every %mcmmo_…% placeholder for skill stats, power level, parties, XP rate, skill names, and leaderboard positions.