Well-Earned XP
Earn experience by building, mining, farming, crafting, exploring, and more with a fully data-driven system.
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.
!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_typetargets every stat under a stat type, for example,minecraft:crafted.- For an exhaustive list of stat types, visit the wiki.
custom_stattargets 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.