Permissions
Fine-grained control over skills and commands
Overview
The permission system is disabled by default. Enable it when you need fine-grained control:
/mmoconfig permissions --args=trueLuckPerms Setup
If you're using LuckPerms, admin access depends on whether permissions are enabled:
When "Enable Permissions" is OFF (default)
The mod checks for OP status. With LuckPerms, you need the wildcard permission to act as OP:
/lp user <player> permission set * trueWithout this, admin commands like /mmoadmin will be blocked even for server operators.
When "Enable Permissions" is ON
The mod checks for the mmoskilltree.admin permission instead:
/lp user <player> permission set mmoskilltree.admin trueThis is more granular - you can grant admin access without full OP privileges.
Skill Permissions
Control which players can gain XP in specific skills:
| Permission | Description |
|---|---|
mmoskilltree.skill.* | Gain XP in all skills (wildcard) |
mmoskilltree.skill.mining | Gain XP in Mining |
mmoskilltree.skill.woodcutting | Gain XP in Woodcutting |
mmoskilltree.skill.excavation | Gain XP in Excavation |
mmoskilltree.skill.harvesting | Gain XP in Harvesting |
mmoskilltree.skill.fishing | Gain XP in Fishing |
mmoskilltree.skill.swords | Gain XP in Swords |
mmoskilltree.skill.daggers | Gain XP in Daggers |
mmoskilltree.skill.polearms | Gain XP in Polearms |
mmoskilltree.skill.staves | Gain XP in Staves |
mmoskilltree.skill.axes | Gain XP in Axes |
mmoskilltree.skill.blunt | Gain XP in Blunt |
mmoskilltree.skill.archery | Gain XP in Archery |
mmoskilltree.skill.unarmed | Gain XP in Unarmed |
mmoskilltree.skill.defense | Gain XP in Defense |
mmoskilltree.skill.taming | Gain XP in Taming |
mmoskilltree.skill.acrobatics | Gain XP in Acrobatics |
mmoskilltree.skill.crafting | Gain XP in Crafting |
mmoskilltree.skill.repair | Gain XP in Repair |
mmoskilltree.skill.alchemy | Gain XP in Alchemy |
mmoskilltree.skill.enchanting | Gain XP in Enchanting |
mmoskilltree.skill.cooking | Gain XP in Cooking |
mmoskilltree.skill.smithing | Gain XP in Smithing |
mmoskilltree.skill.building | Gain XP in Building |
Command Permissions
| Permission | Description | Default |
|---|---|---|
mmoskilltree.command.xp | Use /mmoxp | granted |
mmoskilltree.command.skilltree | Use /skilltree | granted |
mmoskilltree.command.xpdisplay | Use /xpdisplay | granted |
mmoskilltree.command.setxp | Use /setmmoxp | OP only |
mmoskilltree.command.setxp.others | Use --target flag | OP only |
mmoskilltree.command.config | Use /mmoconfig | OP only |
Admin Permission
| Permission | Description |
|---|---|
mmoskilltree.admin | Access admin features (OP always has this) |
Note: OP players always have admin access regardless of permission settings.
XP Boost Permissions
Admin Convenience Feature: XP Boost permission nodes require the Permission Boosts entitlement.
No extra gameplay: The same boosts are available for free via boost token items. Permission Boosts are purely an admin workflow preference — managing boosts through permission nodes instead of item distribution. Both require creative/OP to configure.
Grant permissions to allow players to self-activate repeatable boosts. MMO Skill Tree ships with 124 built-in boost permission nodes covering personal and global boosts at various multipliers, durations, and cooldowns.
Permissions are checked live through the native permission system — changes take effect on the next Boost page refresh. All templates can be customized via mods/mmoskilltree/boost-templates.json or the admin UI.
Permission Format
mmoskilltree.xpboosts.<target>.<scope>.<multiplier>.<duration>.<cooldown>Examples
# 1.5x all skills, 30min duration, 2hr cooldown (personal)
mmoskilltree.xpboosts.all.self.1_5.30.120
# 2x mining, 30min duration, 2hr cooldown (personal)
mmoskilltree.xpboosts.mining.self.2_0.30.120
# 1.25x global (server-wide), 15min duration, 2hr cooldown
mmoskilltree.xpboosts.all.all.1_25.15.120View all 124 boost permission nodes & purchase →
Skill Visibility Filtering
When permissions are enabled, skills are filtered throughout the UI based on what the player has access to:
- XP Overview - Skills without permission are hidden from the list
- Total Levels - Only permitted skills count toward total/category levels
- Skill Tree - Navigation skips skills the player can't access; shows "No permission" if accessed directly
- Item Rewards - Navigation skips unpermitted skills (total rewards always available)
- Leaderboards - Skill filters only show skills the viewer has permission for
This creates a seamless experience where players only see skills relevant to them.
Admin Help Text
When permissions are enabled, the /mmoadmin page displays permission node examples to help configure your server:
mmoskilltree.skill.*- Grant all skillsmmoskilltree.skill.mining- Grant individual skillsmmoskilltree.command.xp- Grant command access