BlockBrain

Your Personal Context-Aware AI Assistant, Right Inside Minecraft.

Built for Fabric 1.21 - 1.21.11

---

🌟 Overview

BlockBrain is a premium, seamlessly integrated AI companion for Minecraft. Instead of alt-tabbing to look up recipes, mechanics, or mod documentation, you can simply ask BlockBrain from within the game. It uses advanced contextual awareness to read your game state and provide answers tailored specifically to your exact situation.

✨ Features

• 🧠 Context-Aware Intelligence: BlockBrain isn't just a basic chatbot. It secretly reads your game context—including your current dimension, gamemode, biome, and even your list of installed mods—to give you incredibly accurate, personalized answers.
• 🎨 Gorgeous Animated UI: Designed from the ground up with a custom charcoal-and-blue aesthetic. Features smooth transition animations, a built-in markdown renderer for AI responses, and beautiful in-game toast notifications.
• ☁️ BlockBrain Cloud (Free Tier): Jump right in! Every new user gets 3 free requests via the official BlockBrain Cloud backend with zero setup required.
• 🔑 Bring Your Own Key (BYOK): Power user? You can completely bypass the cloud limits by entering your own Custom API Key for OpenAI, Groq, or OpenRouter directly into the mod settings.
• 🎭 Customizable Personalities: Tailor the AI to your playstyle. Set it to a helpful guide, a strict hardcore survivalist, or a lore-accurate villager.
• 🚀 Ultra-Fast Async Rendering: Built with a non-blocking asynchronous backend, ensuring that waiting for the AI never drops your frame rate or freezes your game.

🎮 How to Use

1. Open the Dashboard: Press Right Shift on your keyboard (default keybind) or type /blockbrain in the chat to open the AI interface.
2. Chat: Type your question in the bottom text box and hit send.
3. Settings: Click the Settings icon in the top right to configure API keys, change AI providers, or swap personalities.

📥 Installation

1. Download the latest version of Fabric Loader (0.16.0+) for Minecraft 1.21 - 1.21.11.
2. Download the Fabric API mod.
3. Download the BlockBrain mod from modrinth or BlockBrain from curseforge.
4. Place both the Fabric API .jar and the BlockBrain .jar into your .minecraft/mods folder.
5. Launch the game!

🛠️ Building from Source

If you want to compile the mod yourself or contribute to the development:

# Clone the repository
git clone https://github.com/Hardik-Verma/blockbrain.git
cd blockbrain

# Build the mod
./gradlew build

Once finished, the compiled .jar file will be waiting for you inside the build/libs directory.

---

Created and maintained by the ZyrenPlugins / BlockBrain Development team.