Gear Upgrades

The Gear Upgrades mod introduces an equipment enhancement system through proficiency gain. By engaging in various in-game activities, you'll accumulate mastery that can be later used to upgrade your gear.

How the System Works

Proficiency experience is earned through:

• Dealing damage to enemies
• Defeating mobs
• Taking damage
• Collecting experience orbs

Item upgrades are performed in an anvil, requiring specific proficiency levels, player experience levels, and special materials.

System Features

• Reset upgrades by combining with Crying Obsidian (configurable)
• Limit Break - an advanced function allowing you to merge two identical items with maxed base upgrades to gain an additional upgrade slot

For Modpack Developers

This mod doesn't include pre-made upgrades by default, as it's entirely designed for modpack creators. An example datapack is included to help understand configuration principles.

Datapack System

Main configuration file: refinements/name.json contains the following parameters:

• id - internal upgrade name for NBT data
• key - localization key
• type - item type or UpgradeType group
• proficiency_cost - proficiency cost for upgrading
• anvil_levels - experience levels used when upgrading (default: 5)
• material - material for anvil's right slot
• material_count - amount of required material
• allowed_steps - allowed upgrade application steps
• color - chat text color
• bonuses - list of attribute bonuses

Available Item Groups:

• armor, head, chest, legs, feet - various armor types
• shield - shields
• melee_weapon, sword, axe - melee weapons
• ranged_weapon, bow, xbow, trident - ranged weapons
• digger, digger_only - digging tools
• curios - accessories

Bonus System:

Each bonus contains:

• property - attribute name
• amount - modifier numerical value
• operation - operation type: addition, multiply base, or multiply total
• slots - active slots for the modifier

Configuration Example:

{
  "id": "storming",
  "key": "refinement.misc.storming",
  "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"
}

Upgrade Slots Configuration

File upgrade_slots/name.json defines:

• item - item registry name
• max_slots - maximum number of base upgrades

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