Übersicht

Saro's AI Chat bringt die Power von Google Gemini 2.0 Flash in deine Minecraft-Welt. Es ist nicht nur ein Chatbot; es ist ein kontextbezogener Begleiter, der weiß, wo du bist, wie spät es ist und wie das Wetter ist. Mit dem optionalen "Cheat AI"-Modus kann die KI sogar als Admin-Assistent fungieren und Befehle für dich ausführen.

Hauptfunktionen

🤖 Intelligenter Chat

• Powered by Gemini 2.0 Flash: Nutzt Googles neuestes und schnellstes Gemini-Modell für natürliche, logische Antworten.
• Gedächtnis: Die KI merkt sich den Gesprächsverlauf pro Spieler. Zurücksetzen jederzeit mit !clear.
• Markdown-Support: Chat-Nachrichten unterstützen Fett, Kursiv, Code-Blöcke, Überschriften (H1-H3) und Listen.
• Mehrsprachig: Antwortet automatisch in Deutsch oder Englisch basierend auf deiner Eingabe.

🌍 Kontext-Bewusstsein (Spieler-Daten)

Die KI fliegt nicht blind. Sie sammelt und kennt:

• Spielername: Kennt deinen Namen und spricht dich direkt an.
• Position: Aktuelle X/Y/Z Koordinaten.
• Biom: Erkennt automatisch das aktuelle Biom.
• Gesundheit & Hunger: Zeigt Herzen und Hunger-Level.
• Minecraft-Zeit: Aktueller Tag und Uhrzeit im Spiel.
• Wetter: Klar, Regen oder Gewitter.
• Erfahrungslevel: Dein aktuelles XP-Level.
• Spielmodus: Überleben, Kreativ, Abenteuer oder Zuschauer.
• Inventar: Die ersten 10 Items in deinem Inventar.

💡 Tipp: Frage die KI "Was ist mein Biom?" oder "Zeig mir meine Daten" um Informationen über dich zu erhalten.

⚡ Cheat AI Modus (8 Befehls-Typen)

Aktiviere enableCheatAI in der Config, um die volle Power freizuschalten.

⚠️ Warnung: Der Cheat AI Modus gibt der KI Zugriff auf mächtige Server-Befehle. Nur für vertrauenswürdige Umgebungen!

Wenn aktiviert, kann die KI folgende Aktionen auf natürliche Sprachanfragen ausführen:

🔧 Spezielle Features

• Multi-Summon: Die KI kann mehrere Entities gleichzeitig spawnen (bis zu 50).
• Relative Koordinaten: Unterstützt ~ Koordinaten für Befehle.
• Bracket-Fixing: Automatische Korrektur von unbalancierten Klammern in Befehlen.
• Fehlerbehandlung: Klare Fehlermeldungen bei API-Problemen.

Befehle

Konfiguration

Zu finden in config/sarosaichatmod-common.toml.

[api]
    # Hol dir deinen kostenlosen Key auf aistudio.google.com
    geminiApiKey = "DEIN_KEY_HIER"

[chat]
    # Aktiviert/Deaktiviert AI-Antworten auf Chat-Nachrichten
    respondToTextMessages = true

[features]
    # GEFÄHRLICH: Erlaubt der KI, Server-Befehle auszuführen!
    # Kann Items geben, Inventar leeren, Spieler töten, Wetter ändern, etc.
    enableCheatAI = false

Konfigurationsoptionen

Technische Details

• API: Google Gemini 2.0 Flash (gemini-2.0-flash)
• HTTP Client: Java 11+ HttpClient für asynchrone Anfragen
• Temperature: 0.7 (ausgewogene Kreativität)
• Max Tokens: 1000 pro Antwort
• Spieler-Daten: Persistent gespeichert in config/ai_player_data.json

Installation

1. Installiere Forge für Minecraft 1.20.1.
2. Lade die Mod herunter und lege sie in den mods Ordner.
3. Starte Minecraft einmal, um die Config zu generieren.
4. Besuche aistudio.google.com und erstelle einen kostenlosen API-Key.
5. Trage den Key in config/sarosaichatmod-common.toml ein.
6. Optional: Aktiviere enableCheatAI für erweiterte Funktionen.