AI Builder - Minecraft AI Assistant

# AI Builder - Minecraft AI Assistant Mod

A feature-rich Fabric mod that deeply integrates AI conversational capabilities into Minecraft. You can chat with AI using natural language, have AI build structures for you, manage NBT structure files, export selections, and even let AI search the web for information.


## ✨ Features 

### 🤖 AI Chat & Command Execution
- **`/ai <message>`** — Chat with AI in-game; AI understands both Chinese and English
- AI can execute in-game operations via natural language commands:
  - Place/fill blocks, clear areas
  - Give items, spawn entities
  - Set time and weather, teleport players
- **Multi-turn conversation memory** — AI remembers context
- **Screenshot support** — AI can "see" your game screen and respond accordingly

### 🏗️ Structure Management 
- **NBT Structure Browser** — A graphical interface similar to Litematica for browsing, searching, and placing `.nbt` structure files
- **TXT Blueprint System** — Supports two blueprint formats:
  - V1: Character grid + legend mapping, intuitive and readable
  - V2 (MCBLUEPRINT v2): Explicit coordinates + full block state properties, precise reproduction
- **`/ai build <name>`** — Quickly build a loaded blueprint via command
- **`/ai blueprints`** — List all available blueprints

### 📐 Selection Tools 
- Graphical selection interface with two-point selection
- **Selection Analysis** — Count block types and quantities within selection
- **Export to NBT** — Export selection as `.nbt` file (includes block entity data like chest contents, sign text)
- **Export to Blueprint** — Export selection as V2 format blueprint text
- Real-time selection highlight rendering

### 🌐 Web Capabilities
- **Web Search** — AI can search for the latest information via Tavily API
- **Web Scraping** — AI can access specified URLs to fetch web content
- Can automatically generate building commands based on web content

### ⚙️ Configuration & Settings
- **In-game Settings UI** — Press `K` to open, toggle:
  - AI chat screenshot
  - Multi-turn conversation memory
  - Web search
- **`/aiconfig`** — Configure API URL, key, model via command
- **`/ainew`** — Clear conversation history, start a new topic
- **`/ailog`** — Forward mod logs to chat for debugging

## 📋 Commands

| Command | Description |
|---------|-------------|
| `/ai <message>` | Chat with AI |
| `/ai build <name>` | Build a specified blueprint |
| `/ai blueprints` | List all blueprints |
| `/ai reload_blueprints` | Reload blueprints |
| `/ainew` | Clear conversation history |
| `/aiconfig show` | View current configuration |
| `/aiconfig <key> <value>` | Modify configuration |
| `/aipos` | Show current coordinates |
| `/ailog [on/off]` | Toggle log display |
| `/ainbt` | NBT-related commands |

## 🔧 Configuration

A configuration file will be generated at `config/helloworld.properties` on first launch:

| Config Key | Description | Default |
|------------|-------------|---------|
| `api_base_url` | AI API endpoint | Kimi API |
| `api_key` | API key | Must be set manually |
| `model` | AI model name | kimi-for-coding |
| `screenshot_enabled` | Screenshot feature | true |
| `context_enabled` | Multi-turn conversation | true |
| `web_search_enabled` | Web search | true |
| `tavily_api_key` | Tavily search API key | empty |

> ⚠️ You need to configure your own AI API key before use. Supports any OpenAI-compatible API.

## 📁 File Structure 

- `nbts/` — Store `.nbt` structure files, supports subfolder organization
- `txts/` — Store `.txt` blueprint files
- `config/helloworld.properties` — Mod configuration file

## 🎮 Keybinds

| Key | Function |
|-----|----------|
| `K` | Open mod settings UI |

## 📦 Installation

1. Install [Fabric Loader](https://fabricmc.net/) (≥ 0.15.0)
2. Install [Fabric API](https://modrinth.com/mod/fabric-api)
3. Place the mod JAR file into `.minecraft/mods/` directory
4. Launch the game, press `K` to open settings, or use `/aiconfig` to configure your API key