HyronicHyronic Mcmmo Docs

Permissions

A complete, source-verified reference of every mcMMO permission node - defaults, skills, abilities, commands, chat, items, bypasses, perks, and party.

mcMMO ships with sensible permission defaults, so on most servers you don't have to configure anything for players to use it normally. You only need to touch permissions if your permission plugin (LuckPerms, etc.) denies everything by default, or if you want to grant or revoke specific features.

Every node on this page is taken directly from mcMMO's plugin.yml (the authoritative source). Where a node's real name differs from what other guides claim, this page uses the real one.

Default permission groups

GroupGranted toIncludes
mcmmo.defaultsAll players (default: true)Party chat, all skills, chat colors, level-up broadcasts, MOTD, and the standard player commands.
mcmmo.defaultsopOperators (default: op)Admin chat, operator commands, all mcMMO items and tools — on top of defaults.
mcmmo.all / mcmmo.*No one by defaultEverything: admin, bypass.all, all commands, defaults, defaultsop, party.all, perks.all.
mcmmo.defaults:        # all players          mcmmo.defaultsop:     # operators
  mcmmo.chat.partychat                          mcmmo.chat.adminchat
  mcmmo.commands.defaults                        mcmmo.commands.defaultsop
  mcmmo.motd                                     mcmmo.item.all
  mcmmo.skills.all                               mcmmo.tools.all
  mcmmo.chat.colors
  mcmmo.broadcast.levelup

mcmmo.all:             # nobody by default
  mcmmo.admin   mcmmo.bypass.all   mcmmo.commands.all
  mcmmo.defaults   mcmmo.defaultsop   mcmmo.party.all   mcmmo.perks.all

Because mcmmo.defaults is default: true and mcmmo.defaultsop is default: op, a normal player and a normal operator both get the right experience with zero setup.

How nodes nest

Most node families come in three shapes:

ShapeMeaning
mcmmo.ability.mining.superbreakerA single, specific permission.
mcmmo.ability.mining.allEvery child of that family (the form you'll usually grant).
mcmmo.ability.mining.*Wildcard that maps to .all.

Grant the .all (or .*) parent to hand out a whole family, then negate individual children in your permission plugin to carve out exceptions.

Prefer .all over .*. The .* wildcards are hand-maintained in plugin.yml and one is mis-wired: mcmmo.ability.maces.* actually points at Mining's abilities, not Maces. mcmmo.ability.maces.all is correct. When in doubt, grant the .all node.

Skills

Controls whether a player gains XP / has a skill at all.

mcmmo.skills.all          # every skill (in mcmmo.defaults)
mcmmo.skills.<skill>      # one skill

<skill> is one of: acrobatics, alchemy, archery, axes, crossbows, excavation, fishing, herbalism, maces, mining, repair, salvage, smelting, spears, swords, taming, tridents, unarmed, woodcutting.

Abilities

Pattern: mcmmo.ability.<skill>.<ability>. Grant mcmmo.ability.<skill>.all for a whole skill, or mcmmo.ability.all for everything.

Ability nodes have no underscores. Other guides write serrated_strikes or skull_splitter; the real nodes are serratedstrikes and skullsplitter. The same goes for Limit Break: swordslimitbreak, not swords_limit_break.

Combat skills

SkillNodes (mcmmo.ability.<skill>.…)
Swordsserratedstrikes, rupture, counterattack, stab, swordslimitbreak
Axesskullsplitter, axemastery, criticalstrikes, greaterimpact, armorimpact, axeslimitbreak
Unarmedberserk, disarm, irongrip, arrowdeflect, blockcracker, steelarmstyle, unarmedlimitbreak
Archeryexplosiveshot, skillshot, daze, arrowretrieval, archerylimitbreak
Crossbowstrickshot, poweredshot, crossbowslimitbreak
Tridentsimpale, tridentslimitbreak
Spearsmomentum, spearmastery, spearslimitbreak
Macescrush, cripple, maceslimitbreak
Tamingbeastlore, gore, sharpenedclaws, thickfur, shockproof, holyhound, fastfoodservice, environmentallyaware, pummel, callofthewild

Taming → Call of the Wild has its own sub-tree (which animals a player can summon): mcmmo.ability.taming.callofthewild.horse, .ocelot, .wolf (or .callofthewild for all).

Gathering skills

SkillNodes (mcmmo.ability.<skill>.…)
Miningsuperbreaker, doubledrops, motherlode, blastmining.*
Excavationgigadrillbreaker, archaeology
Woodcuttingtreefeller, harvestlumber, leafblower, cleancuts, knockonwood, splinter, barksurgeon, naturesbounty
Herbalismgreenterra, doubledrops, farmersdiet, hylianluck, shroomthumb, verdantbounty, greenthumb.*
Fishingtreasurehunter, magichunter, shake, masterangler, icefishing, fishermansdiet, vanillaxpboost
Alchemycatalysis, concoctions
Acrobaticsroll, dodge

Mining → Blast Mining sub-tree: mcmmo.ability.mining.blastmining.detonate (the actual remote-TNT trigger), .biggerbombs, .demolitionsexpertise (or .blastmining.all).

Herbalism → Green Thumb has a deep tree controlling what can be auto-planted / converted:

mcmmo.ability.herbalism.greenthumb.all
mcmmo.ability.herbalism.greenthumb.plants.<plant>    # wheat, carrots, potatoes,
                                                     # beetroots, netherwart, cocoa
mcmmo.ability.herbalism.greenthumb.blocks.<block>    # dirt, cobblestone, cobblestone_wall,
                                                     # grasspath, stonebricks

Repair & Salvage (per-material)

Repair and Salvage gate each material separately, so you can let players repair iron but not netherite, etc.

mcmmo.ability.repair.<thing>      # arcaneforging, repairmastery, superrepair,
                                  # armorrepair, toolrepair, woodrepair, stonerepair,
                                  # leatherrepair, ironrepair, goldrepair, copperrepair,
                                  # diamondrepair, netheriterepair, stringrepair,
                                  # otherrepair, othermaterialrepair

mcmmo.ability.salvage.<thing>     # arcanesalvage, scrapcollector, armorsalvage,
                                  # toolsalvage, woodsalvage, stonesalvage,
                                  # leathersalvage, ironsalvage, goldsalvage,
                                  # coppersalvage, diamondsalvage, netheritesalvage,
                                  # stringsalvage, othersalvage, othermaterialsalvage

Smelting

mcmmo.ability.smelting.secondsmelt, fluxmining, fuelefficiency, vanillaxpboost.

Commands

Pattern: mcmmo.commands.<command>. Grant mcmmo.commands.all for every command. The standard player set is mcmmo.commands.defaults; the operator set is mcmmo.commands.defaultsop.

Player commands

mcmmo.commands.mcstats   mcmmo.commands.mcrank    mcmmo.commands.mctop
mcmmo.commands.mccooldown mcmmo.commands.mcability mcmmo.commands.mcnotify
mcmmo.commands.mcscoreboard mcmmo.commands.mmoshowdb
mcmmo.commands.<skill>   # e.g. mcmmo.commands.mining - view that skill's info page

Admin commands

mcmmo.commands.addxp        mcmmo.commands.addlevels    mcmmo.commands.mmoedit
mcmmo.commands.skillreset   mcmmo.commands.mcremove     mcmmo.commands.mcpurge
mcmmo.commands.mcgod        mcmmo.commands.mcrefresh    mcmmo.commands.mcchatspy
mcmmo.commands.mcconvert    mcmmo.commands.xprate       mcmmo.commands.reloadlocale
mcmmo.commands.inspect      mcmmo.commands.mmoinfo

Many admin commands have an .others variant that controls using them on other players: addxp.others, addlevels.others, mmoedit.others, mcability.others, mcgod.others, mcchatspy.others, mcrefresh.others, plus mcrank.others / mcrank.others.far, and the full skillreset.others.<skill> tree. Grant the base node for self-use, the .others node to target other players.

Command sub-trees

A few commands split into finer nodes:

CommandSub-nodes
mctopmcmmo.commands.mctop.<skill> (per-skill leaderboard), or mctop.all.
skillresetmcmmo.commands.skillreset.<skill>, or skillreset.all.
inspectinspect.far (inspect from any distance), inspect.hidden (inspect offline/hidden players).
ptpptp.send, ptp.accept, ptp.acceptall, ptp.toggle, ptp.world.* (teleport across worlds).
mcconvertmcconvert.database, mcconvert.experience.
xpratexprate.set, xprate.reset.
mcmmomcmmo.commands.mcmmo.description, mcmmo.commands.mcmmo.help.

Chat, MOTD & broadcasts

mcmmo.chat.partychat    # use party chat (in mcmmo.defaults)
mcmmo.chat.adminchat    # use admin chat (in mcmmo.defaultsop)
mcmmo.chat.colors       # use &-codes / [[NAME]] tokens in mcMMO chat (in mcmmo.defaults)
mcmmo.chat.all          # all of the above - ⚠ includes adminchat
mcmmo.motd              # see the mcMMO MOTD (in mcmmo.defaults)
mcmmo.broadcast.levelup # receive milestone level-up broadcasts (in mcmmo.defaults)

Items

mcmmo.item.all            # all mcMMO items (in mcmmo.defaultsop)
mcmmo.item.chimaerawing   # use the Chimaera Wing
mcmmo.tools.all           # all mcMMO tools (in mcmmo.defaultsop)

Bypasses

mcmmo.bypass.all           # all bypasses below (in mcmmo.all)
mcmmo.bypass.partylimit    # ignore the party size limit
mcmmo.bypass.arcanebypass  # never lose enchantments to Arcane Forging
mcmmo.bypass.hardcoremode  # immune to Hardcore-mode penalties

(mcmmo.bypass.all also grants inspect.far and inspect.hidden.)

Perks

Perks grant ongoing bonuses for as long as the player holds the node - ideal for donor ranks. The bonus amounts are configured in advanced.yml; the nodes just switch them on. Grant mcmmo.perks.all for everything.

Activation time & cooldowns

mcmmo.perks.activationtime.fourseconds      # +4s super-ability duration
mcmmo.perks.activationtime.eightseconds     # +8s
mcmmo.perks.activationtime.twelveseconds    # +12s   (or activationtime.all)

mcmmo.perks.cooldowns.halved                # ability cooldowns ÷2
mcmmo.perks.cooldowns.thirded               # ÷3
mcmmo.perks.cooldowns.quartered             # ÷4     (or cooldowns.all)

Lucky

mcmmo.perks.lucky.all              # +33% activation odds on luck-based sub-skills, all skills
mcmmo.perks.lucky.<skill>          # one skill only

XP boosts

mcmmo.perks.xp.<tier>              # boost applies to all skills
mcmmo.perks.xp.<tier>.<skill>      # boost applies to one skill
mcmmo.perks.xp.all                 # all XP perks

<tier> is one of: 10percentboost, 25percentboost, 50percentboost, 150percentboost, double, triple, quadruple, customboost (the custom amount is set in advanced.yml).

Enchant bypass perks

mcmmo.perks.bypass.repairenchant   # keep enchantments when repairing
mcmmo.perks.bypass.salvageenchant  # recover enchantments when salvaging

Party

Two separate trees - don't confuse them:

mcmmo.commands.party.all     # all /party subcommands
mcmmo.commands.party.<sub>   # create, join, accept, invite, kick, quit, disband, info,
                             # help, chat, teleport, lock, unlock, password, owner,
                             # rename, alliance, itemshare, xpshare

mcmmo.party.all              # party gameplay perks (in mcmmo.all)
mcmmo.party.friendlyfire     # allow hurting party members (gameplay, not a command)

/ptp (party teleport) is its own command tree - see Command sub-trees above. Full mechanics: Parties.

Admin & misc

mcmmo.admin           # ⚠ despite its description, only implies mcconvert.all + xprate.all -
                      # for true all-access use mcmmo.* or mcmmo.all
mcmmo.showversion     # see the version string

The mcmmo.admin node's description says "everything in mcMMO," but in plugin.yml it only actually grants mcmmo.commands.mcconvert.all and mcmmo.commands.xprate.all. For genuine full access, grant mcmmo.* (or mcmmo.all), not mcmmo.admin.

Granting and denying

Grant a .all parent to hand out a family, then negate specific children for exceptions. For example, in LuckPerms - give everything but Fishing:

/lp group default permission set mcmmo.skills.all true
/lp group default permission set mcmmo.skills.fishing false

Exact syntax depends on your permission plugin.

See also

On this page