The Documentation
Unofficial, source-verified documentation for the mcMMO Minecraft plugin - for both players and server owners.
mcMMO turns ordinary Minecraft activities - mining, fighting, fishing, farming - into trainable RPG skills. Every action you take earns experience, and leveling up unlocks bonus drops, extra damage, automatic farming, super abilities, and much more.
This is an unofficial documentation project. Every mechanic, value, and formula here is checked directly against the mcMMO source code, so it aims to be more accurate and far more detailed.
These docs target mcMMO 2.2.054 on Minecraft 1.20.5+ (Spigot / Paper / Folia). Numbers shown are mcMMO's defaults - your server owner may have changed them.
For players
Getting Started
New to mcMMO? Start here: skills, XP, super abilities, and your first commands.
All Skills
Every skill at a glance - combat, gathering, and misc - with links to the details.
Commands
Every command, its aliases, and what it does.
Parties
Team up to share XP and items, unlock party teleport, chat, and alliances.
FAQ & Troubleshooting
Why am I not gaining XP? Abilities not working? Lost levels? Fixes here.
For server owners
Installation
Install or upgrade mcMMO on Spigot, Paper, or Folia.
Configuration
How mcMMO's config files work and what each one controls.
Integrations
Plugins mcMMO hooks into: WorldGuard, PlaceholderAPI, anti-cheat, and known conflicts.
Hardcore Mode
Death stat loss and vampirism - make levels something players can lose.
Permissions
Default permission groups and the full node patterns.
Localization
Translate or rewrite any in-game text, with color and tooltip control.
Glossary
Plain-language definitions of every mcMMO term used in these docs.
Developer API
Static API classes, custom events, and Maven coordinates for plugin developers.