🛠️ Tool Utility

A clean, responsive, and lightweight multi-loader mod for Fabric, Forge, and NeoForge that adds intelligent client-side inventory swapping and combat utility to Minecraft.

Never get caught fumbling through your inventory in the middle of a battle again! Tool Utility gives you instant hotkeys to swap between your primary weapons, toggle an empty hand for safe interactions, and automatically feed yourself from your offhand while keeping your shield or totem fully protected.

⚡ Core Features

1. Smart Weapon Swap ( R ) ⚔️

• Intelligent Weapon Cycling: Instantly swaps between your Sword and Axe with a single keystroke.
• Hotbar Priority & Inventory Fallback: Searches your hotbar first for an alternate weapon. If none is found, it automatically reaches into your main inventory and equips your best weapon directly to your active slot.
• Weapon Memory: Automatically remembers the last weapon type used, ensuring smooth transitions even after switching slots.

2. Instant Empty Hand Toggle ( V ) ✋

• Accident-Free Interactions: Quickly clears your main hand so you can safely open chests, interact with Villagers, lead animals, or inspect redstone contraptions without accidentally swinging a Netherite sword.
• One-Key Weapon Restoration: Press the key again to instantly restore your previous weapon back into your hand.
• Full Inventory Support: If your hotbar has no empty slots, it safely swaps with an empty slot in your main inventory.

3. Smart Offhand Food & Defensive Auto-Restore ( G ) 🛡️

• Quick Nutrition Access: Instantly places the best food item from your inventory directly into your offhand.
• Automatic Shield & Totem Return: The moment you finish eating, your Shield or Totem of Undying is automatically returned to your offhand!
• Harmful Food Filter: Automatically ignores dangerous foods such as Rotten Flesh, Spider Eyes, Poisonous Potatoes, Pufferfish, and Chorus Fruit.
• Safe Totem Protection: Built-in safeguards ensure that holding, looting, or moving Totems of Undying in your GUI never causes accidental item deletion or unwanted auto-swaps.

🌐 100% Client-Side & Server-Friendly

• Works on Any Server: You can join vanilla, Paper, Purpur, Spigot, Fabric, or Forge multiplayer servers—no server-side mod or plugin installation required!
• Zero Server Desync: Utilizes standard client-side inventory packets (handleInventorySwap) to ensure seamless synchronization with server containers without glitching or desync.
• Clean Actionbar Feedback: Subtle, clean actionbar messages notify you of swaps, with an option to toggle them off anytime.

⚙️ Fully Configurable (config/tool_utility.json)

• All features and timings can be tailored to your playstyle:

💬 Feedback, Suggestions & Bug Reports

Found a bug or have an idea for a new feature? Feel free to leave a comment below! Every bug report and suggestion helps make the mod better.