Bonded

!Bonded banner

A gear leveling mod for Fabric, Forge, and NeoForge.

Requires Amber. Fabric and Forge builds also require Forge Config API Port.

Bonded levels up your gear as you use it.

• Tools and weapons gain bonus stats through use
• Repair and upgrade items at the Repair Bench and Tool Bench
• Works with any tool/armor mod; upgrade paths need compat mods

!Bonded Benches GIF

The leveling and repairing feature will work with any tool and armor mod out of the box. Upgrade paths, however, will require compat mods that I can make at your request, just hmu.

How To Use It

Use an item on the Repair Bench to repair it, consuming 1 of the repair material for that item.

Use an item on the Tool Bench to upgrade it to the next tier. The item must be level 10 (configurable) and you must have the upgrade material in your inventory.

!Bonded Demo

Current Plan

Fixing bugs and adding requested features.

Thank you for the support!

Pics

!Tool Bench recipe

!Tool Bench recipe

!Repair Bench recipe

!Tool Bench Overlay

!Repair Bench Overlay

Help Translate Bonded

Want to help translate this mod into your language? Join the community translation project:

Contribute translations

🇺🇸 🇪🇸 🇧🇷 🇫🇷 🇩🇪 🇷🇺 🇹🇷 🇯🇵 🇰🇷 🇨🇳

Q&A

Q: Where can I ask something that is not listed here?

A: Make an issue here or join the Discord and shoot me a message.

Q: Can you port it to [MC version/Mod loader]?

A: If enough people request it I'll give it some time, but this really is a 1-man team so it might take a while.

Q: Can I include it in my modpack?

A: Yes, no need to give credit or ask.

More mods by me

Gentle Hurt Cam

Liteminer

Mochila

Torch Toss

Compatibility

Compat Mods

• Bonded: Basic Weapons Compat
• Bonded: Advanced Netherite Compat

The leveling and repairing feature will work with any tool and armor mod out of the box. Upgrade paths, however, will require compat mods that I can make at your request, just hmu.

Addon API

Bonded exposes an addon API under com.iamkaf.bonded.api for Minecraft 26.1.2. Use it to add Tool Bench upgrade paths, Repair Bench materials, custom experience caps, and integrations with Bonded's item state and events.

import com.iamkaf.bonded.api.BondedApi;
import net.minecraft.world.item.Items;

BondedApi.addUpgrade(
        MyItems.STEEL_PICKAXE.get(),
        MyItems.MYTHRIL_PICKAXE.get(),
        MyTags.Items.MYTHRIL_UPGRADE_MATERIALS
);
BondedApi.addRepairMaterial(MyItems.STEEL_PICKAXE.get(), Items.IRON_INGOT);
BondedApi.addExperienceCap(MyItems.STEEL_PICKAXE.get(), 250);

For item stack integrations, use BondedItemStacks to read or change max-damage modifiers and over-repair state. For event integrations, use BondEvent for experience, level-up, repair, and upgrade hooks, or GameEvents.AWARD_ITEM_EXPERIENCE to award Bonded experience from custom gameplay.

Full API docs are available in the GitHub README.

Credits

• My amazing community
• The Fabric, NeoForge, Forge teams and all the other awesome developers whose work I depend on
• And most importantly, Aris, for always being there for me.