XP Tokens

Overview

XP Tokens are physical consumable items that players hold and use to instantly gain skill XP or activate timed XP multipliers. There are 292 token variants in total, each with a unique name, description, and quality tier.

Two Token Types

Flat XP Tokens

Flat XP tokens grant an exact amount of XP when consumed. The XP bypasses active boosts, so a Fragment always gives exactly 100 XP regardless of any multipliers running.

Tiers

Each tier exists for all 20 token-eligible skills (every built-in skill except Enchanting), giving 160 flat XP token variants.

Boost Tokens

Boost tokens activate timed XP multipliers through the same system as /mmoboost. They respect stacking limits and expiration rules.

Personal Boost Tiers

Personal boost tokens are available for 24 targets: 20 individual skills and 4 categories (All Skills, Gathering, Combat, Crafting). That's 120 personal boost variants.

Global Boost Tiers

Global boost tokens affect all players on the server when activated. Only the first 3 boost tiers (Minor, Standard, Major) are available as global tokens.

Global tokens target 4 categories (All Skills, Gathering, Combat, Crafting), giving 12 global boost variants.

How to Use

1. Hold the XP token item in your hotbar
2. Hold right-click to start consuming the token
3. The token charges briefly before activating
4. Taking damage interrupts the consumption

On successful consumption, flat XP tokens show the XP gained in chat, and boost tokens show the activated multiplier and duration. Global boost tokens broadcast to all online players.

Tokens as Rewards

Token items can be granted through any item reward: a skill-tree milestone, a command reward, a quest payout, or another mod. Award a flat XP token or a boost token by its item ID (see the patterns below) and players right-click to consume it.

Note that the default skill-tree milestone rewards do not hand out XP tokens directly; the headline level-100 milestone grant is a Life Essence plus that skill's Skill Cape. Token items are an additional, fully configurable reward you can attach wherever you like.

Admin Commands

Admins can give token items to players using standard Hytale /give commands. Token item IDs follow the pattern:

# Flat XP tokens (skill uses its display name; Defense is "Block")
XpToken_<Skill>_<Tier>
# Examples: XpToken_Mining_Fragment, XpToken_Swords_Artifact

# Personal boost tokens
BoostToken_<Target>_Personal_<Tier>
# Examples: BoostToken_Mining_Personal_Minor, BoostToken_All_Personal_Epic

# Global boost tokens
BoostToken_<Target>_Global_<Tier>
# Examples: BoostToken_All_Global_Major, BoostToken_Combat_Global_Standard

Configuration

Token definitions are stored in mods/mmoskilltree/xp-tokens.json using the override-based config system. Only your customizations are saved; defaults auto-update with mod versions.

Config Options

• enabled - Toggle the entire token system on/off
• chargeDurationTicks - How long players must hold before consumption (default: 40 ticks / 2 seconds)
• Per-token overrides - Customize XP amounts, multipliers, durations, or disable individual tokens

Override Example

{
  "schemaVersion": 1,
  "enabled": true,
  "chargeDurationTicks": 40,
  "overrides": {
    "XpToken_Mining_Fragment": {
      "xpAmount": 200
    },
    "BoostToken_All_Personal_Epic": {
      "disabled": true
    },
    "BoostToken_Mining_Personal_Minor": {
      "multiplier": 2.0,
      "durationMinutes": 45
    }
  }
}

Token Overrides Editor

The admin dashboard includes a visual editor for token values. Open /mmoadmin and click "Edit Tokens" to access it.

• Three browsing modes - Switch between XP Tokens, Personal Boosts, and Global Boosts tabs
• Skill and category navigation - Browse by individual skills or boost target categories
• Override values - Change XP amounts for flat tokens, or multiplier and duration for boost tokens
• Disable tokens - Prevent specific tokens from being consumed
• Reset to defaults - Restore any overridden token with one click
• Trim redundant overrides - Remove overrides that match default values
• Enable/disable toggle - Turn the entire token system on or off

Status indicators show whether each token uses Default, Override, or Disabled values at a glance.