Introduction
Unofficial, source-verified documentation for the mcMMO Minecraft plugin - for both players and server owners. Actively maintained by Hyronic Studios.
What is this?
This is an UNOFFICIAL documentation project. Every mechanic, value, and formula here is checked directly against the mcMMO source code and also references the official documentation, so it aims to be more accurate and far more detailed.
mcMMO is not our project and has no affiliation with Hyronic Studios. We do not own, maintain, or develop it, and we are not responsible for the plugin, its support, or its bug fixes. These are unofficial docs we maintain purely to make mcMMO easier to search and use for our own community.
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.
If you have any ideas to improve the documentation, would like to contribute, or want to report issues related to this project, please join our Discord.
What does this documentation offer?
This site is meant to save you time and guesswork.
- Extremely detailed and well explained, even providing the formulas and a complete explanation of how each feature works.
- The data is extracted directly from the source code, ensuring 100% accuracy with the default configuration.
- Clean, modern interface, full light and dark mode support, and a powerful search experience.
- AI/LLM friendly, making it easier to search, explore, and learn with tools like ChatGPT, Claude, ...
- We're actively maintaining the documentation and are always open to ideas that can help improve it.
For players
If you want mcMMO to feel more guided in-game, McmmoGui is a natural companion: it adds menu-driven access to skills, abilities, and other mcMMO information instead of relying entirely on chat commands.
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
If you're building a survival server around mcMMO and want a production-ready reference point, Hyronic Studios' McMMO Survival Setup is a practical example of mcMMO-focused progression, packaging, and presentation.
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.
Support these docs
These docs are free and take real work to maintain. If they help you, the best way to give back is to grab one of our premium mcMMO addons by Hyronic Studios - it funds this project and upgrades your server too.