AI ChatGame Solver
> Never lose a chat game again — your AI plays them for you.

🎮 What It Does
AI ChatGame Solver is a client-side Fabric mod that watches your chat for server mini-games — unscrambles, trivia, first-to-type, word puzzles — and solves them for you in milliseconds using AI. It reads the game announcement, thinks, and types the answer before anyone else can even finish reading the question.
It's not a dumb keyword macro: a smart multi-stage pipeline filters out fake games, result announcements and ordinary chat, then sends only real games to your AI provider — saving you money on every token.

✨ Features
⚡ Local Quick-Detect
Well-known game formats ("Unscramble the word: …", "First to type…", quick math, trivia, riddles, decode, and more) are recognized locally with zero AI — detection is instant and deterministic, never dependent on the AI having an off day.
🛡 Keyword-Only Trigger Mode
Nothing goes to the AI unless a line contains your keywords. Zero accidental calls, zero wasted money. Add, edit and delete keywords right in the GUI.
🧠 Smart Game-Over Detection
"Time's up!", "Nobody answered in time.", "Answer: X", "Winner: X" — result announcements are vetoed locally before the AI ever sees them, and the AI itself is trained to reject already-ended rounds. It will never type a revealed answer into chat.
🔢 Letter-Perfect Unscrambles
Every unscramble answer is verified in code, letter by letter against the scramble. A wrong letter count (enhanced vs enchanted) is caught locally and auto-retried with the exact mistake explained to the AI. A provably wrong answer is never typed.
🧩 Complete-Announcement Grouping
Once a keyword triggers, the announcement's remaining lines are automatically grouped into the same block — the AI always sees the full announcement, never a half-cut one.
⚙ Fully Configurable In-Game
Every setting lives in a vanilla-styled GUI (open with the U key by default, rebindable in Options → Controls): AI provider & keys, answer typing speed & delays, filter triggers, per-server context, prompt tuning — all saved instantly.

🌐 Per-Server Context
Different servers, different game formats. Store custom instructions per server IP so the AI always knows exactly how your server phrases its games.
📊 Live Stats & Logs
Track solved games, success rate and history in the Stats screen, with a built-in error log for debugging.

🚀 Getting Started
- Drop the jar into your
.minecraft/modsfolder (Fabric Loader & Fabric API required) - Press U in-game to open the config
- Open AI Settings → paste your API key and pick a model
- Check Filter Settings → add keywords matching your server's game announcements
- Play. The HUD lights up when it solves — you don't touch anything.

🔌 Supported AI Providers
| Provider | Notes |
|---|---|
| OpenAI | Any OpenAI model, bring your own key |
| Anthropic | Claude models, bring your own key |
| Groq | 🆓 Free tier available — blazing fast inference |
| Google AI Studio | 🆓 Free tier available — generous Gemini quota |
| Custom / OpenAI-compatible | OpenRouter, Ollama, LM Studio, or any self-hosted endpoint |
> No budget for AI? Groq and Google AI Studio both offer free API keys — the setup screen links you straight to them.
💬 Join the Community
Need help, want to suggest a feature, or just show off your solve streak?
Client-side only · Works on servers that don't block AI assist · Bring your own API key