Mineuniverse
Log in Register
Mods

Gear Upgrades

Lets you upgrade equipment using Proficiency, Levels, and Materials in an anvil.
by Bizzoula
Download Claim this project
72,484 downloads
0 likes
Updated Jul 6, 2026
0 hypes
Adventure and RPG Armor, Tools, and Weapons

 

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)

There are no included 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:

refinements/name.json
 
id: String, internal name for the upgrade, the string stored in NBT to access the data
key: String, localization key
incompat: String List, id of upgrades this is incompatible with (bidirectional), if incompatible with itself, it can be applied only once
type: String List, entries must either be an UpgradeType (built-in grouping) or an item registry name
- Valid UpgradeTypes:
 - armor > ArmorItem
 - head > ArmorItem that equips to Head slot
 - chest > ArmorItem that equips to Chest slot
 - legs > ArmorItem that equips to Legs slot
 - feet > ArmorItem that equips to Feet slot
 - shield > ShieldItem
 - melee_weapon > SwordItem or AxeItem or TridentItem
 - sword > SwordItem
 - axe > AxeItem
 - ranged_weapon > BowItem or CrossbowItem or TridentItem
 - bxbow > BowItem or CrossbowItem
 - bow > BowItem
 - xbow > CrossbowItem
 - trident > TridentItem
 - digger > DiggerItem (axe, hoe, pickaxe, shovel)
 - digger_only > DiggerItem, excluding AxeItem
 - curios > any curio (auto-detects slots for attributes based on slots curio fits)
 - curios:slot > curios that have this slot (auto-detects slots for attributes)
proficiency_cost: Integer, proficiency required to upgrade
anvil_levels: Integer, amount of XP Levels used when upgrading (optional, default: 5)
material: String, (tag or registry name) material used in Anvil right slot when upgrading
material_count: Integer, how many of the Material is needed to upgrade (optional, default: 1)
allowed_steps: Integer List, what upgrade 'step' this upgrade can be applied during
color: String, Chat Formatting Color (optional, default: white)
- valid ChatFormatting Colors:
 - aqua
 - black
 - blue
 - dark_aqua
 - dark_blue
 - dark_gray
 - dark_green
 - dark_purple
 - dark_red
 - gold
 - gray
 - green
 - light_purple
 - red
 - white
 - yellow
bonuses: RefinedBonus List
 - property > String, Attribute registry name
 - amount > Double, attribute modifier value
 - operation > String: "addition", "multiply_base", "multiply_total"
 - slots > String List: what slot(s) the attribute modifier is active in (optional, default: ["minecraft:mainhand"]) (if UpgradeType is curio, slots is ignored and auto-detected) (if UpgradeType is ArmorItem and this is blank, defaults to appropriate armor slot)
  - valid slots:
    - "minecraft:mainhand"
- "minecraft:offhand"
- "minecraft:head"
- "minecraft:chest"
- "minecraft:legs"
- "minecraft:feet"
 
 
Example:
{
  "id": "storming",
  "key": "refinement.misc.storming",
  "incompat": ["obliterating"],
  "type": ["minecraft:nether_star"],
  "proficiency_cost": 100,
  "material": "minecraft:nether_star",
  "material_count": 8,
  "anvil_levels": 30,
  "bonuses": [
    {
      "property": "minecraft:generic.attack_damage",
      "amount": 5,
      "operation": "addition",
      "slots": ["minecraft:mainhand"]
    },
    {
      "property": "minecraft:generic.movement_speed",
      "amount": 0.1,
      "operation": "multiply_base",
      "slots": ["minecraft:mainhand", "minecraft:offhand"]
    },
    {
      "property": "minecraft:generic.armor",
      "amount": 0.1,
      "operation": "multiply_base",
      "slots": ["minecraft:offhand"]
    },
    {
      "property": "minecraft:generic.armor_toughness",
      "amount": 0.1,
      "operation": "multiply_base",
      "slots": ["minecraft:offhand"]
    }
  ],
  "allowed_steps": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10],
  "color": "light_purple"
}
 
{
  "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"
}

 

upgrade_slots/name.json
item: String, item registry name
max_slots: Integer, total base upgrades an item can have

Example:
{
  "item": "minecraft:nether_star",
  "max_slots": 2
}

 

 

 

 

 

 

gearupgrades-0.1.10.jar
MC Client, 1.20.1, Forge, Server
Release 2025-11-06 Get

More from Bizzoula

Xaero Waypoint Locate
48,311
Rad Weaponry
44,275
Bonfires - Xaero's Minimap Compat
42,131
Rad Enchants
4,123,126
Enchant Scrolls
358
ArsPMMO
2,833,158

You Might Also Like

Falling Meteors Mod
Meteors naturally fall upon your world, holding incredibly useful ores
997,797
Cloro's Gravity Gun
Bring the Half-Life 2 gravity gun to minecraft!
99,152
Cosmaztic's Swords : Reworked [Create]
My Cosmaztic's Sword Mod : Reworked, with some swords using create items.
9,985
Sculk Dagger
Sculk Dagger
9,969
Minewatch Session 2
A new Hero Mod from a Big Game
9,958
Expanded Bow Enchantings
This Datapack and Mod allow to use Looting on a Bow and allows Mending and Infinity to be on the same bow on the same Bow!
9,947