# Bonded

[](https://modrinth.com/mod/amber)
[](https://github.com/iamkaf/mod-issues)
[](https://discord.gg/HV5WgTksaB)
[](https://ko-fi.com/iamkaffe)
A gear leveling mod for Fabric, Forge, and NeoForge.
Requires [Amber](https://modrinth.com/mod/amber). Fabric and Forge builds also require [Forge Config API Port](https://modrinth.com/mod/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

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.

### Current Plan
Fixing bugs and adding requested features.
Thank you for the support!
## Pics





## Help Translate Bonded
Want to help translate this mod into your language? Join the community translation project:
[Contribute translations](https://i18n.kaf.sh/projects/bonded)
🇺🇸 🇪🇸 🇧🇷 🇫🇷 🇩🇪 🇷🇺 🇹🇷 🇯🇵 🇰🇷 🇨🇳
## Q&A
**Q: Where can I ask something that is not listed here?**
A: Make an issue [here](https://github.com/iamkaf/mod-issues) or join the [Discord](https://discord.gg/HV5WgTksaB) 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.
[](https://discord.gg/HV5WgTksaB)
## More mods by me
Gentle Hurt Cam
Liteminer
Mochila
Torch Toss
## Compatibility
### Compat Mods
- [Bonded: Basic Weapons Compat](https://modrinth.com/mod/bonded-basic-weapons-compat)
- [Bonded: Advanced Netherite Compat](https://modrinth.com/mod/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.
```java
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.