XP Boosts | MMO Skill Tree Docs

Overview

The XP Boost system lets server owners reward players with temporary XP multipliers. Perfect for events, VIP perks, quest rewards, or special promotions.

Boost Types

Global Boosts - Affect all online players on the server
Personal Boosts - Affect only the player who activated them

Targeting Options

All Skills - Boost applies to every skill
Specific Skill - e.g., only Mining or only Swords
Skill Category - Gathering, Combat, Crafting, or Misc

Stacking

Multiple boosts stack additively by default. If you have a 1.5x boost and a 2x boost active, you get 2.5x total (not 3x multiplicative). You can switch to highest mode where only the best global + best personal boost apply.

Stacking Limits

Prevent unbounded XP multipliers with server-configurable limits. All settings are in skill-config.json or configurable via /mmoadmin.

Setting	Default	Description
`maxBoostMultiplier`	5.0	Hard cap on total XP multiplier, regardless of active boosts
`maxPersonalBoosts`	3	Maximum simultaneous personal boosts per player
`maxGlobalBoosts`	3	Maximum simultaneous global boosts on the server
`boostStackMode`	`additive`	`additive` (all boosts sum) or `highest` (best of each scope only)

Limit Behavior

When a player tries to activate a token at the limit, the token is preserved (not consumed) and an error message is shown
/mmoboost global returns an error when the global limit is reached
The Boost Page shows current limits: Limits: 5.0x cap | additive | Personal 2/3 | Global 1/3
Activate buttons are disabled with "LIMIT REACHED" when the relevant limit is hit

Admin Configuration

Configure stacking limits in /mmoadmin under "Boost Stacking Limits":

Text fields for max multiplier, max personal boosts, and max global boosts
Toggle between additive and highest stack mode
Save button applies all changes at once

Boost UI

Access the Boost UI via the "Boosts" tab in /xp.

Boost page showing active boosts, tokens, and reusable boosts

Active Boosts Display

When you have active boosts, they appear at the top of the /xp skill overview page:

Shows up to 3 active boosts with time remaining
[G] prefix = Global boost (blue) - affects everyone
[P] prefix = Personal boost (green) - affects only you
Format: [G] 2.0x Mining - 14:32 (scope, multiplier, target, time)

Time displays in human-readable format: mm:ss under 1 hour, 2h 30m for hours, 3d 5h for days.

Three Sections

Section	Description
Active Boosts	Currently running boosts with time remaining
Boost Tokens	One-time tokens ready to activate (shows [Global] tag if server-wide)
Reusable Boosts	Repeatable boosts from permissions (with cooldowns)

Boost Tokens

Tokens are one-time boost awards given by admins. Players can activate them whenever they want.

Key Features

Tokens are stored until the player chooses to activate
Works for offline players - delivered when they log in
No permission required to use - just click to activate
Personal tokens boost only that player
Global tokens boost everyone on the server when activated!

Consumable Boost Token Items

In addition to admin-awarded tokens, players can also earn physical boost token items through milestone rewards. These are consumable items that players hold and right-click to activate, working through the same boost system.

112 boost token variants - 100 personal (5 tiers x 20 targets) + 12 global (3 tiers x 4 categories)
Personal tiers - Minor (1.25x/15m), Lesser (1.5x/30m), Greater (2x/30m), Major (3x/45m), Epic (5x/60m)
Global tiers - Minor (1.25x/15m), Lesser (1.5x/30m), Greater (2x/30m)
Hold-to-consume mechanic - taking damage interrupts consumption
Respects stacking limits - token is preserved (not consumed) if limit is reached

Award Tokens (Admin)

/mmoboost give --args=<player|*>|<target>|<mult>|<mins>|[scope] [--quantity=N]

Parameters (separated by | or _):

player - Player name or * for all online players
target - Skill name, category, or all
mult - Multiplier (e.g., 1.5, 2.0)
mins - Duration in minutes
scope - personal (default) or global
--quantity=N - Award multiple tokens at once (default: 1)

Examples

# Give player a 2x Mining boost token for 30 minutes
/mmoboost give --args=PlayerName|mining|2.0|30

# Same command using underscore delimiter
/mmoboost give --args=PlayerName_mining_2.0_30

# Give everyone a 1.5x all-skills token for 1 hour
/mmoboost give --args=*|all|1.5|60

# Give a GLOBAL boost token (affects everyone when activated)
/mmoboost give --args=PlayerName|all|2.0|60|global

# Give 5 mining tokens at once
/mmoboost give --args=PlayerName|mining|2.0|30 --quantity=5

Immediate Global Boosts

Admins can activate server-wide boosts immediately:

/mmoboost global --args=<target>|<multiplier>|<minutes>

Examples

# 2x XP for all skills, server-wide, for 1 hour
/mmoboost global --args=all|2.0|60

# 3x Combat XP for 30 minutes
/mmoboost global --args=combat|3.0|30

Permission-Based Boosts (VIP)

Grant boost permissions to players for repeatable boosts with cooldowns. Perfect for VIP ranks or donation perks.

Note: Permission-based boosts require a commercial license, but provide no extra gameplay functionality. The exact same boosts are available for free via boost token items that players right-click to activate. Permission boosts are purely an admin workflow preference — managing boosts through permission nodes (LuckPerms/HyperPerms) instead of item distribution. Both methods require creative mode or OP status to configure.

Live Permission Checks

Boost permissions are checked live through your permission mod (e.g., LuckPerms, HyperPerms). Changes take effect immediately:

Grant or revoke permissions through your permission mod
Player sees updated boosts on next Boost page refresh
Supports wildcard permissions (mmoskilltree.xpboosts.*)

Permission Format

mmoskilltree.xpboosts.<target>.<scope>.<multiplier>.<duration>.<cooldown>

Parameters:

target - Skill name, category, or all
scope - self or global
multiplier - Use underscore for decimal (e.g., 1_5 = 1.5x)
duration - Minutes the boost lasts
cooldown - Minutes before they can use it again

Examples

Permission	Effect
`mmoskilltree.xpboosts.all.self.1_5.30.60`	1.5x all skills, 30 min, 1hr cooldown
`mmoskilltree.xpboosts.mining.self.2_0.60.120`	2x Mining, 1 hour, 2hr cooldown
`mmoskilltree.xpboosts.combat.self.1_25.15.30`	1.25x Combat, 15 min, 30min cooldown

Award Boost Admin Page

New in 0.5.9: A visual admin UI for granting boosts to players without memorizing command syntax. Access via the "Award Boost" button in /mmoadmin.

Two Grant Methods

Input Field	Type	Description
UUID	Recurring Permission	Grants a repeatable boost permission (with cooldown). Uses your permission system.
Username	One-time Token	Awards a single-use boost token. Player must be online.

Configuration Options

Target - All skills, category (Gathering, Combat, Production), or individual skill
Multiplier - Presets (1.5x, 2x, 3x, 5x, 10x) or custom value
Duration - Presets (15m, 30m, 1h, 2h, 24h) or custom minutes
Cooldown - Presets (None, 1h, 24h, 7d) or custom minutes (for recurring permissions only)
Scope - Personal (player only) or Global (server-wide when activated)

Live Permission Preview

As you configure, the page shows the exact permission string that will be granted:

mmoskilltree.xpboosts.mining.self.2_0.60.120

This helps you understand and verify the permission format.

Admin Commands

All boost commands require OP or mmoskilltree.admin. Commands also work from server console.

Command	Description
`/mmoboost give ...`	Award boost token(s) to player(s). Supports `--quantity=N`
`/mmoboost global ...`	Activate immediate server-wide boost
`/mmoboost list`	List all active global boosts
`/mmoboost status --args=[player]`	View player's boosts and tokens
`/mmoboost clear --args=[player]`	Clear all boosts/tokens for a player

Persistence

Global boosts survive server restarts
Pending tokens are saved and restored on restart
Active personal boosts continue timing down while offline

Use Cases

Weekend Events

/mmoboost global --args=all|2.0|2880  # 2x XP for 48 hours

Quest Rewards

Award tokens via command rewards when players complete objectives:

{
  "level": 50,
  "commands": ["mmoboost give --args={player}|all|1.5|60"],
  "runAs": "CONSOLE"
}

VIP Ranks

Give VIP players permission to self-activate boosts:

mmoskilltree.xpboosts.all.self.1_5.60.180  # VIP: 1.5x, 1hr, 3hr cooldown

Welcome Bonus

Give new players a boost token on first join using another plugin's welcome system.