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 235 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 16 implemented skills (Mining, Woodcutting, Excavation, Harvesting, Swords, Daggers, Polearms, Staves, Axes, Blunt, Archery, Unarmed, Defense, Acrobatics, Crafting, Building), giving 128 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 20 targets: All Skills, 16 individual skills, and 3 categories (Gathering, Combat, Crafting). That's 100 personal boost variants.

Global Boost Tiers

Global boost tokens affect all players on the server when activated. Only the first 3 boost tiers (Minor, Lesser, Greater) 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 Milestone Rewards

XP tokens are awarded as item rewards at skill milestones:

Admin Commands

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

# Flat XP tokens
XpToken_<Skill>_<Tier>
# Examples: XpToken_Mining_Fragment, XpToken_Swords_Artifact

# Personal boost tokens
BoostToken_<Target>_<Scope>_<Tier>
# Examples: BoostToken_Mining_Self_Minor, BoostToken_All_Self_Epic

# Global boost tokens
BoostToken_<Target>_All_<Tier>
# Examples: BoostToken_All_All_Greater, BoostToken_Combat_All_Lesser

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_Self_Epic": {
      "disabled": true
    },
    "BoostToken_Mining_Self_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.