Overview

Saro's AI Chat brings the power of Google Gemini 2.0 Flash into your Minecraft world. It's not just a chatbot; it's a context-aware companion that knows where you are, what time it is, and what the weather is like. With optional "Cheat AI" enabled, it can even act as an admin assistant, executing commands on your behalf.

Key Features

🤖 Intelligent Chat

• Powered by Gemini 2.0 Flash: Uses Google's latest and fastest Gemini model for natural, logical responses.
• Memory: The AI remembers conversation context per player. Reset it anytime with !clear.
• Markdown Support: Chat messages support bold, italics, code blocks, headings (H1-H3), and lists.
• Multilingual: Automatically responds in German or English based on your input.

🌍 Context Awareness (Player Data Collection)

The AI isn't flying blind. It collects and knows:

• Player Name: Knows your name and addresses you directly.
• Position: Current X/Y/Z coordinates.
• Biome: Automatically detects your current biome.
• Health & Hunger: Shows hearts and hunger level.
• Minecraft Time: Current in-game day and time.
• Weather: Clear, rain, or thunderstorm.
• Experience Level: Your current XP level.
• Game Mode: Survival, Creative, Adventure, or Spectator.
• Inventory: First 10 items in your inventory.

💡 Tip: Ask the AI "What biome am I in?" or "Show me my stats" to get information about yourself.

⚡ Cheat AI Mode (8 Command Types)

Enable enableCheatAI in the config to unlock full power.

⚠️ Warning: Cheat AI mode gives the AI access to powerful server commands. Only for trusted environments!

When enabled, the AI can perform the following actions on natural language requests:

🔧 Special Features

• Multi-Summon: AI can spawn multiple entities at once (up to 50).
• Relative Coordinates: Supports ~ coordinates for commands.
• Bracket Fixing: Automatic correction of unbalanced brackets in commands.
• Error Handling: Clear error messages for API issues.

Commands

Configuration

Located in config/sarosaichatmod-common.toml.

[api]
    # Get your free key at aistudio.google.com
    geminiApiKey = "YOUR_KEY_HERE"

[chat]
    # Enables/Disables AI responses to chat messages
    respondToTextMessages = true

[features]
    # DANGEROUS: Allows AI to execute server commands!
    # Can give items, clear inventory, kill player, change weather, etc.
    enableCheatAI = false

Configuration Options

Technical Details

• API: Google Gemini 2.0 Flash (gemini-2.0-flash)
• HTTP Client: Java 11+ HttpClient for async requests
• Temperature: 0.7 (balanced creativity)
• Max Tokens: 1000 per response
• Player Data: Persistently saved in config/ai_player_data.json

Installation

1. Install Forge for Minecraft 1.20.1.
2. Download the mod and place it in the mods folder.
3. Start Minecraft once to generate the config.
4. Visit aistudio.google.com and create a free API key.
5. Enter the key in config/sarosaichatmod-common.toml.
6. Optional: Enable enableCheatAI for extended features.