FAQ & Troubleshooting

Quick answers for players and server owners. If your problem isn't here, check the Permissions and Config Files references.

Players

I'm not gaining any XP

In order, the usual causes:

1. Wrong action for the skill. XP comes from specific actions - see the skill's page for what counts (e.g. only certain blocks give Mining XP).
2. This world has mcMMO disabled. The owner may have blacklisted the world or set a WorldGuard mcmmo-xp deny region.
3. You hit the level cap for that skill, or the power level cap - check /mcstats.
4. Missing permission. You need mcmmo.skills.<skill> (granted by default on most servers).

My super ability won't activate

• You must unlock it first - abilities have a level requirement (see the skill page).
• Ready your tool: right-click with the correct tool in hand to enter the ready stance, then act. Abilities have a cooldown after use.
• Abilities can be disabled by config or blocked in protected regions.

I'm taking damage / being flagged by anti-cheat when using abilities

Super abilities make you mine and hit faster than vanilla. The server needs an anti-cheat compatibility layer - for NoCheatPlus that's CompatNoCheatPlus. Tell your server owner; see Integrations → anti-cheat.

I lost levels when I died!

The server runs Hardcore mode. Dying removes a percentage of your levels (Death Stat Loss), and being killed by another player can let them steal levels (Vampirism). This is intentional and configured by the owner.

Why does Smelting / Salvage have no XP bar?

They're child skills - their level is the average of two parent skills, not earned directly. Level the parents (Mining + Repair for Smelting; Repair + Fishing for Salvage).

How do I see my stats?

/mcstats (or /mmoinfo <skill> for one skill). /mctop shows leaderboards, /inspect <player> shows another player's stats if you have permission. See Commands.

Server owners

A command says "unknown command" or does nothing

• The player lacks the command permission (mcmmo.commands.<command>). See Permissions.
• The feature is disabled in config (e.g. parties off → party commands inactive).

Players have no permissions even though I didn't deny anything

Permission plugins like LuckPerms can default to deny. mcMMO ships sensible defaults (mcmmo.defaults is default: true), but if your setup overrides defaults you must grant mcmmo.defaults (and mcmmo.defaultsop for ops) explicitly.

Edits to config.yml aren't applying

mcMMO loads config on startup. After editing, restart the server (or use a reload plugin that re-initializes mcMMO). Some files - like world_blacklist.txt - are only read at startup.

How do I reset a player's skills?

Use /mmoedit <player> <skill> <level> to set a level, or /skillreset <player> [skill] to reset. Database-wide tools exist for purging inactive users - see Commands.

Is mcMMO compatible with my other plugins?

mcMMO hooks into WorldGuard, PlaceholderAPI, HealthBar, and anti-cheat bridges, and has a known conflict with ProjectKorra. Full list on the Integrations page.

How do I move my data to another server / database?

mcMMO supports flat-file and MySQL/MariaDB storage, switchable in config. The Installation guide covers backup and migration basics.

Does mcMMO work on Folia?

Yes - this version targets Minecraft 1.20.5+ on Spigot, Paper, and Folia. See Installation.