📘 XP Mode – Documentation

🎯 Purpose

The XP system allows players to gain experience points (XP) from various actions like mining, crafting, trading, killing mobs, etc. Based on their total XP, players unlock new items, actions, and abilities.

⚙️ Configuration (xpmode.yml)

🔧 Options

options:
  allowUnlimitedXP: true        # Should players continue to gain XP after reaching max level?
  gainXPInCreative: true        # Should players gain XP while in creative mode?

🧪 Levels & Unlocks

Players unlock new items, actions, and effects by reaching specific XP thresholds:

Recipes:
  level1:
    needed_xp: 0
    items: [...]
    runCommandsOnReach: [...]
    entities_actions: [...]

• needed_xp – the XP required to reach the level.
• items – list of items unlocked at this level.
• runCommandsOnReach – commands executed when the level is reached (e.g., rewards).
• entities_actions – special actions unlocked, such as shear, villagerTrade, mobFeed.
• potions – potion effects unlocked at the level.

🎁 XP Rewards

Players earn XP through various actions:

xpRewards:
  default:
    breakBlock: 1
    placeBlock: 1
    killMob: 10
    tradeWithVillager: 5
    craftItem: 2

• default – base XP values for common actions.
• specific – detailed XP values for specific blocks, mobs, trades, and crafted items.

Example:

specific:
  blocks:
    DIAMOND_ORE: 50
  mobs:
    CREEPER: 25
  trades:
    LIBRARIAN: 15
  crafting:
    BEACON: 100

🧠 Summary

• Players earn XP through gameplay actions.
• Gained XP unlocks new tools, features, and commands.
• Fully customizable via xpmode.yml.