SmartWield

## ⚡ What It Does

### Smart Block Detection
Hold left-click to mine and QuickEquip instantly switches to the **fastest tool in your hotbar** for that specific
block — pickaxe for stone, axe for wood, shovel for dirt.

> ℹ️ The switch only happens while you are **actively mining**. Simply looking at a block does nothing — so your
sword stays in your hand during combat.

### Auto-Replace on Break
When your current tool breaks mid-task, QuickEquip **immediately equips the best replacement** of the same type
from your hotbar. No more standing there punching stone with your fist.

### Intelligent Ranking
Tools are ranked by:
1. 🔼 **Mining Speed** (includes tool tier + Efficiency enchantments)
2. 💚 **Remaining Durability** as a tiebreaker

## 🎮 How to Use

| Action | Result |
|----------------------------------|------------------------------------------|
| Hold left-click on a block | Best tool auto-equips               |
| Tool breaks                     | Best replacement auto-equips |
| Press **R**                     | Toggle auto-equip ON / OFF    |

## ⚙️ Configuration

A `client-quickequip.toml` file is created in your Forge config folder:
- **defaultEnabled** — whether QuickEquip starts enabled (default: `true`)
- **showMessages** — whether action-bar messages are shown (default: `true`)

The **R** keybind can be rebound in **Options → Controls → Miscellaneous**.

---

## 📦 Compatibility

- ✅ Minecraft **26.1.1** · Forge **63.0.2+**
- ✅ **Client-side only** — no server install needed
- ✅ Works with modded tools
- ✅ Safe to add or remove at any time