Well-Earned XP

Well-Earned XP introduces new ways to earn experience, allowing players to earn levels for enchanting and repairing. Builders, miners, farmers, explorers, and mixed-style players can all earn XP by doing things they already spend time doing, without feeling pushed toward XP farms or mob grinders.

✨ New Ways to Earn XP

• Mining
• Building
• Farming
• Crafting New Items
• Looting Chests
• Breaking Tools
• Completing Raids

📁 Data Packs

Well-Earned XP is completely data-driven and uses in-game statistics to detect rewardable player engagement. You can easily add or remove support for different stats using a simple data pack.

Learn More

Each JSON file defines:

• Which stat to listen for.
• How often that stat should grant XP.
• How much XP to spawn.

The file path selects the stat target:

data/<namespace>/wellearnedxp/engagement_type/<category>/<namespace>/<path>.json

The category decides how the stat is matched:

• stat_type targets every stat under a stat type, for example, minecraft:crafted.
  • For an exhaustive list of stat types, visit the wiki.
• custom_stat targets one specific custom stat, for example, minecraft:fish_caught.
  • For an exhaustive list of custom stats, visit the wiki.

Stat Type Example

The following example grants 5 - 10 XP for every item crafted:

// data/mycoolexample/wellearnedxp/engagement_type/stat_type/minecraft/crafted.json

{
  "experience": {
    "min": 5,
    "max": 10
  }
}

Custom Stat Example

The following example grants 5 XP for every 10 fish caught:

// data/mycoolexample/wellearnedxp/engagement_type/custom_stat/minecraft/fish_caught.json

{
  "experience": {
    "min": 5,
    "max": 5
  },
  "interval": 10
}

Overriding Engagement Types

If you want to change any of the default values, like how much experience a stat gives, you can overwrite engagement types using a file of the same path. You can even disable built-in engagement types by setting the file's contents to an empty object, {}.

Disabled Engagement Type Example

By default, Well-Earned XP rewards players experience for mining. The following example disables that behavior:

// data/wellearnedxp/wellearnedxp/engagement_type/stat_type/minecraft/mined.json

{}

🚦 Permissions

✅ You may use this mod in modpacks.

✅ You may create add-ons, extensions, or companion mods.

✅ You may submit pull requests to contribute to the code.

❌ You may not publish this mod or modified versions anywhere without explicit permission.