ToolBrain

# 🧠 Tool Brain

**Let your hotbar think for you.**

Tool Brain is a lightweight client-side Fabric mod that analyzes the block you're currently looking at and recommends the best tool available in your hotbar.

Instead of manually checking which pickaxe, axe, shovel or other tool is best suited for a block, Tool Brain compares the available options and shows its recommendation directly in a compact HUD.

No server-side installation is required.

---

## ✨ Features

Tool Brain includes:

- 🧠 Automatic tool recommendations
- ⛏️ Analysis of tools in your hotbar
- 🧱 Detection of the block you're looking at
- ⚡ Comparison of mining speed
- 📦 Checks whether the tool is suitable for block drops
- 🔧 Durability information
- ⚠️ Low-durability warning
- 🎒 Recommended hotbar slot
- 📊 Comparison with your currently selected item
- 🖥️ Compact HUD
- ↔️ Movable HUD
- 💾 Persistent HUD position and settings
- 🎮 Configurable Minecraft keybindings
- 🌐 English and German keybinding translations
- 💻 Fully client-side

---

## 🧠 Automatic Tool Recommendation

When you look at a block, Tool Brain checks the tools currently available in your hotbar.

The mod compares them and determines which tool is the best choice for the targeted block.

The HUD can show information such as:

- Recommended tool
- Recommended hotbar slot
- Mining speed
- Whether the tool is suitable for obtaining drops
- Remaining durability
- Comparison with the currently selected item

---

## ⛏️ Hotbar Analysis

Tool Brain analyzes the items available in your hotbar.

This means you do not need to open your inventory or manually compare your tools while mining, building or exploring.

If no special tool is needed, Tool Brain can also tell you that your hand or current item is sufficient.

---

## ⚡ Mining Speed

The HUD displays the mining speed of the recommended tool.

This makes it easier to see which available tool can break the targeted block most efficiently.

---

## 📦 Correct Tool for Drops

Tool Brain also checks whether a tool is suitable for obtaining drops from the targeted block.

This is especially useful for blocks where using the wrong tool can prevent the expected item from dropping.

---

## 🔧 Durability Information

Tool Brain can display the remaining durability of the recommended tool.

If a tool is close to breaking, the HUD can show a warning.

This helps you avoid accidentally destroying an important tool while mining.

---

## 📊 Current Tool Comparison

Tool Brain can compare the recommended tool with the item you are currently holding.

This allows you to quickly see whether changing to another hotbar slot would improve your mining speed.

---

## 🖥️ Movable HUD

The Tool Brain HUD can be repositioned directly in-game.

You can:

- Enable or disable Tool Brain
- Enter HUD move mode
- Move the HUD in all directions
- Hold the fast-move key for quicker positioning
- Reset the HUD to its default position

Your HUD position is saved automatically.

---

## 🎮 Default Controls

- **B** - Toggle Tool Brain
- **N** - HUD move mode
- **Arrow Keys** - Move the HUD
- **Left Shift** - Faster HUD movement
- **M** - Reset HUD position

All controls can be changed through Minecraft's normal keybinding menu.

---

## 💾 Persistent Settings

Tool Brain stores its settings locally.

The following settings are preserved between Minecraft sessions:

- Tool Brain enabled / disabled
- HUD position
- Durability display
- Current-tool comparison

---

## 💻 Client-Side Only

Tool Brain runs entirely on your Minecraft client.

✅ No server-side installation required  
✅ Works on multiplayer servers  
✅ No server permissions required  
✅ Does not modify server gameplay  
✅ Only analyzes information already available to your client  

---

## 📦 Requirements

- Minecraft 1.21.11
- Fabric
- Fabric Loader 0.18.0+
- Fabric API 0.141.3+
- Java 21+

---

## 📜 License

All Rights Reserved

---

Developed by **ClipCraftStudios**

---

# 🇩🇪 Deutsch

# 🧠 Tool Brain

**Lass deine Hotbar mitdenken.**

Tool Brain ist eine leichte clientseitige Fabric-Mod, die den Block analysiert, den du gerade anschaust, und dir das beste Werkzeug aus deiner Hotbar empfiehlt.

Statt selbst herauszufinden, welche Spitzhacke, Axt, Schaufel oder welches andere Werkzeug für einen Block am besten geeignet ist, vergleicht Tool Brain deine verfügbaren Werkzeuge und zeigt dir die beste Wahl direkt in einem kompakten HUD.

Keine Serverinstallation erforderlich.

---

## ✨ Funktionen

Tool Brain bietet:

- 🧠 Automatische Werkzeugempfehlungen
- ⛏️ Analyse deiner Hotbar
- 🧱 Erkennung des angeschauten Blocks
- ⚡ Vergleich der Abbaugeschwindigkeit
- 📦 Prüfung auf geeignete Block-Drops
- 🔧 Haltbarkeitsanzeige
- ⚠️ Warnung bei fast kaputten Werkzeugen
- 🎒 Anzeige des empfohlenen Hotbar-Slots
- 📊 Vergleich mit dem aktuell gehaltenen Item
- 🖥️ Kompaktes HUD
- ↔️ Verschiebbares HUD
- 💾 Speicherung von Position und Einstellungen
- 🎮 Konfigurierbare Minecraft-Tasten
- 🌐 Deutsche und englische Keybindings
- 💻 Vollständig clientseitig

---

## 🧠 Automatische Werkzeugempfehlung

Wenn du einen Block anschaust, prüft Tool Brain die Werkzeuge in deiner Hotbar.

Die Mod vergleicht die vorhandenen Optionen und bestimmt, welches Werkzeug für den Zielblock am besten geeignet ist.

Das HUD kann unter anderem anzeigen:

- Bestes Werkzeug
- Empfohlenen Hotbar-Slot
- Abbaugeschwindigkeit
- Ob das Werkzeug für Drops geeignet ist
- Verbleibende Haltbarkeit
- Vergleich mit dem aktuell ausgewählten Item

---

## ⛏️ Hotbar-Analyse

Tool Brain analysiert die Items, die sich aktuell in deiner Hotbar befinden.

Du musst dadurch beim Minen, Bauen oder Erkunden nicht ständig dein Inventar öffnen oder deine Werkzeuge selbst vergleichen.

Ist kein besonderes Werkzeug notwendig, kann Tool Brain dir ebenfalls anzeigen, dass deine Hand oder das aktuelle Item ausreicht.

---

## ⚡ Abbaugeschwindigkeit

Das HUD zeigt die Abbaugeschwindigkeit des empfohlenen Werkzeugs.

Dadurch kannst du schnell erkennen, welches Werkzeug den anvisierten Block am effizientesten abbauen kann.

---

## 📦 Geeignet für Drops

Tool Brain prüft zusätzlich, ob ein Werkzeug dafür geeignet ist, die vorgesehenen Drops eines Blocks zu erhalten.

Das ist besonders bei Blöcken hilfreich, bei denen mit dem falschen Werkzeug keine oder andere Drops entstehen.

---

## 🔧 Haltbarkeit

Tool Brain kann die verbleibende Haltbarkeit des empfohlenen Werkzeugs anzeigen.

Ist das Werkzeug fast kaputt, erscheint zusätzlich eine Warnung.

So kannst du verhindern, dass ein wichtiges Werkzeug beim Abbauen versehentlich zerbricht.

---

## 📊 Vergleich mit aktuellem Werkzeug

Tool Brain kann das empfohlene Werkzeug mit deinem aktuell gehaltenen Item vergleichen.

Dadurch siehst du direkt, ob ein Wechsel auf einen anderen Hotbar-Slot sinnvoll wäre.

---

## 🖥️ Verschiebbares HUD

Das Tool-Brain-HUD kann direkt im Spiel verschoben werden.

Du kannst:

- Tool Brain ein- oder ausschalten
- Den HUD-Verschiebemodus aktivieren
- Das HUD in alle Richtungen bewegen
- Mit der Schnellbewegungstaste schneller verschieben
- Die Position auf den Standardwert zurücksetzen

Die HUD-Position wird automatisch gespeichert.

---

## 🎮 Standard-Tasten

- **B** - Tool Brain ein-/ausschalten
- **N** - HUD-Verschiebemodus
- **Pfeiltasten** - HUD verschieben
- **Linke Shift-Taste** - HUD schneller verschieben
- **M** - HUD-Position zurücksetzen

Alle Tasten können über die normale Minecraft-Tastenbelegung geändert werden.

---

## 💾 Gespeicherte Einstellungen

Tool Brain speichert seine Einstellungen lokal.

Folgende Werte bleiben nach einem Minecraft-Neustart erhalten:

- Tool Brain aktiviert / deaktiviert
- HUD-Position
- Haltbarkeitsanzeige
- Vergleich mit dem aktuellen Werkzeug

---

## 💻 Nur clientseitig

Tool Brain läuft vollständig auf deinem Minecraft-Client.

✅ Keine Serverinstallation erforderlich  
✅ Funktioniert auf Multiplayer-Servern  
✅ Keine Serverrechte erforderlich  
✅ Verändert keine Server-Spielmechaniken  
✅ Analysiert ausschließlich Informationen, die deinem Client bereits vorliegen  

---

## 📦 Voraussetzungen

- Minecraft 1.21.11
- Fabric
- Fabric Loader 0.18.0+
- Fabric API 0.141.3+
- Java 21+

---

## 📜 Lizenz

All Rights Reserved

---

Entwickelt von **ClipCraftStudios**