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.
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.
Each JSON file defines:
The file path selects the stat target:
data/<namespace>/wellearnedxp/engagement_type/<category>/<namespace>/<path>.jsonThe category decides how the stat is matched:
stat_type targets every stat under a stat type, for example, minecraft:crafted.
custom_stat targets one specific custom stat, for example, minecraft:fish_caught.
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
}
}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
}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, {}.
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
{}✅ 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.
