McMMO Level Cap lets you set per-player skill level caps and automatically blocks XP gain once a skill reaches its limit. Perfect for servers that want to control McMMO progression with ranks, quests, or custom unlock systems.

Features

• Per-player skill caps via LuckPerms permissions
• Global caps for all skills (
  Code (Text):

  mcmmolevelcap.limit.100
  )
• Per-skill caps (
  Code (Text):

  mcmmolevelcap.limit.MINING.500
  )
• XP gain blocked when a skill hits its cap
• Admin commands to grant, set, and inspect caps
• Offline player support (LuckPerms)
• Bypass permission for staff (
  Code (Text):

  mcmmolevelcap.bypass
  )
• Configurable player messages (chat or action bar)
• Performance optimized (caching, async preload on join)

Requirements

• Paper 1.21 or newer
• mcMMO (required)
• LuckPerms (required for admin commands; recommended for permission-based caps)
• Java 17+

Commands

• Code (Text):

  /mcmmogrant <player> <amount>
  — Increase a player's global skill cap
• Code (Text):

  /mcmmosetallcap <player> <level> [skill1 skill2 ...]
  — Set cap to an absolute level
• Code (Text):

  /mcmmolevelcap reload
  — Reload configuration
• Code (Text):

  /mcmmolevelcap check [player]
  — View a player's skill caps

Permissions
Admin

• Code (Text):

  mcmmolevelcap.addcap
  — Use /mcmmogrant (default: op)
• Code (Text):

  mcmmolevelcap.setallcap
  — Use /mcmmosetallcap (default: op)
• Code (Text):

  mcmmolevelcap.reload
  — Reload config (default: op)
• Code (Text):

  mcmmolevelcap.check
  — Check caps (default: op)

Player caps (set via LuckPerms)

• Code (Text):

  mcmmolevelcap.limit.<level>
  — Global cap for all skills
• Code (Text):

  mcmmolevelcap.limit.<SKILL>.<level>
  — Cap for one skill (e.g. MINING)
• Code (Text):

  mcmmolevelcap.nolimit
  — No cap for all skills
• Code (Text):

  mcmmolevelcap.bypass
  — Ignore cap checks

Cap priority
Skill permission → Global permission → config defaults

LuckPerms examples
Configuration
Player-facing messages and default skill caps can be customized in . Message display supports or .

Support
Report issues or request features on the discussion page. Please include your server version, mcMMO version, and steps to reproduce any bugs.