Permissions

Overview

Permission checks are disabled by default and controlled by two independent flags.

Skill permission checks (XP-gain gating, level caps, admin access when OP is unavailable) are toggled with a slash command:

/mmoconfig permissions --args=true

Command permission checks (the Command Permissions table below) are a separate flag, toggled only from the admin UI (/mmoadmin → General Settings). There is no slash command for it. The Command Permissions table only takes effect once this second toggle is on.

LuckPerms 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 * true

Without 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 true

This is more granular - you can grant admin access without full OP privileges.

Skill Permissions

Control which players can gain XP in specific skills:

Feature Bypass Permissions

Three nodes let an individual player use a feature even while its global toggle is off. Each is checked independently and is not implied by mmoskilltree.admin.

Level Cap Permissions

Restrict an individual player's max level per skill (or globally) by granting a permission node. Useful for tiered access (free vs VIP, trial accounts capped at low levels).

This feature is always on - it is not gated by the “Enable Permissions” toggle. Server owners simply don't grant the node if they don't want to use it.

Permission Format

Precedence

Per-skill nodes override the all wildcard. Granting both mmoskilltree.levelcap.all.50 and mmoskilltree.levelcap.mining.100 lets the player reach Mining level 100 while every other skill is capped at 50.

Examples

# Mining capped at 50; other skills unaffected
mmoskilltree.levelcap.mining.50

# All skills capped at 20
mmoskilltree.levelcap.all.20

# All skills capped at 20 EXCEPT swords (capped at 60)
mmoskilltree.levelcap.all.20
mmoskilltree.levelcap.swords.60

Cache & /mmoconfig resetpermcache

Lookups are cached per player to keep the XP path fast. The cache is cleared automatically when a player disconnects. After granting or revoking nodes via your permissions plugin while the player is online, run:

/mmoconfig resetpermcache

...or have the affected player reconnect for changes to take effect.

At-Cap Behavior

When a player hits their permission cap, XP gain silently stops - the same behavior as hitting the configured server-wide max level. No chat spam, no notifications.

Command Permissions

Admin Permission

Note: OP players always have admin access regardless of permission settings.

XP Boost Permissions

Grant permissions to allow players to self-activate repeatable boosts. MMO Skill Tree ships with 90 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.120

View all 90 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

Admin Help Text

When permissions are enabled, the /mmoadmin page displays permission node examples to help configure your server:

• mmoskilltree.skill.* - Grant all skills
• mmoskilltree.skill.mining - Grant individual skills
• mmoskilltree.command.xp - Grant command access