Gear Upgrades
Lets you upgrade equipment using Proficiency, Levels, and Materials in an anvil.
⬇ Download on CurseForgeThe author built this one for Minecraft 1.20.1 on Forge. On other versions it may install and then do nothing.





This mod lets you earn Proficiency for valid upgradeable items by doing things such as:
- Dealing damage
- Killing mobs
- Receiving damage
- Picking up XP orbs
- Breaking Blocks
You can upgrade items in an anvil with the required proficiency and levels, as well as the necessary material(s).
Upgrades can be reset by combining with Crying Obsidian (configurable).
You can Limit Break items by combining two of the same item that have maxed base upgrades, so two times with 5 slots both need 5 upgrades, and the resulting item is the left item with 5+1 slots. This can only be performed once. (configurable)
This mod does not come packaged with default upgrades, as this is designed solely for modpack devs.
For pack devs:
There is also a new Potion Effect, "Mastery", which increases the new "Mastery' attribute (gearupgrades:mastery) by 0.25 per level. This multiplies all basic proficiency-gaining methods, excluding usage in Anvils.
Commands also exist that affect the item held in the main hand:
/gearupgrades <Player> <add/set/remove> <amount>
You can also make any item grant proficiency by adding a "Mastery" (double) tag to an item's Tag, which works similarly to repairing items in anvils.
Included is an example datapack and resourcepack to give you some basic ideas on how to set things up.
Here is information on how datapacks work for this mod:
"id": "speedy",
"key": "refinement.curio.speedy",
"type": ["curios:necklace"],
"proficiency_cost": 5,
"material": "#forge:ingots/gold",
"material_count": 2,
"bonuses": [
{
"property": "minecraft:generic.movement_speed",
"amount": 0.02,
"operation": "multiply_base"
}
],
"allowed_steps": [1, 2],
"color": "aqua"
}
"id": "hilt_change",
"key": "refinement.sword.hilt_change",
"type": ["#minecraft:swords"],
"proficiency_cost": 80,
"material": "#forge:ingots/netherite",
"material_count": 1,
"bonuses": [
{
"property": "minecraft:generic.attack_speed",
"amount": 0.12,
"operation": "addition"
}
],
"allowed_steps": [1],
"color": "yellow"
}
upgrade_slots/name.json
items: String List:: Item registry name, or an item tag (#minecraft:shovels), supports inversion (["#forge:armors", "!minecraft:diamond_chestplate"])
max_slots: Integer, total base upgrades an item can have
Example:
{
"items": ["minecraft:nether_star"],
"max_slots": 2
}
- Ships as gearupgrades-0.1.14.jar — drop this file into the mods folder
- Download size: 82 KB
- Download link checked 22 Aug 2026 — working
These come from our own check of the pack file, not from the source page.