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.

You can also try out Well-Discovered XP for even more ways to earn experience!

earn xp from... building, mining, looting, and more

✨ 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.

Version	Minecraft	Loader	Download
Well-Earned XP 1.1.1 for Minecraft 26.3 1.1.1	26.3	fabric	Download
Well-Earned XP 1.1.0 for Minecraft 26.3 1.1.0	26.3	fabric	Download
Well-Earned XP 1.0.2 for Minecraft 26.2 1.0.2	26.2	fabric	Download
1.0.1 for Minecraft 26.2 1.0.1	26.2	fabric	Download
Well-Earned XP 1.0.0 for Minecraft 26.2 1.0.0	26.2	fabric	Download