Gemini answers in the Minecraft chat, and it can see where you're standing. Position, biome, health, weather, game mode, XP and the first 10 inventory slots ride along with every message, so "what do I do with all this cobblestone" gets an answer about your cobblestone. Each player keeps their own history until !clear wipes it.
Chat
The AI responds to every chat message you send. Answers support basic markdown formatting (bold, italic, code, headings, lists) and are automatically in German or English based on your input. The conversation history holds the last 10 messages per player. !clear wipes it. Server-side only, no client mod needed. Singleplayer works as well, because the integrated server makes the API calls.
Cheat AI mode
Enable enableCheatAI = true in the config to let the AI execute server commands from natural language requests.
Warning: Cheat AI lets the model run arbitrary server commands, including
/give,/killand/effect. Turn it on only on a server you trust.
| Command Type | Example | What executes |
|---|---|---|
| Give Items | "Give me 64 diamonds" | /give |
| Remove Items | "Remove my sword" | /clear |
| Clear Inventory | "Clear my inventory" | /clear |
| Kill Player | "Kill me" | /kill |
| Apply Effects | "Give me speed" | /effect give |
| Change Weather | "Make it sunny" | /weather |
| Set Time | "Make it day" | /time set |
| Any Command | "Spawn 10 zombies" | direct command ×N |
A single summon request can spawn up to 50 entities. Commands accept relative coordinates (~).
Commands
| Command | Description |
|---|---|
!clear |
Resets the chat context. The AI forgets the current conversation |
Configuration
config/sarosaichatmod-common.toml:
[api]
# Get your free key at aistudio.google.com
geminiApiKey = "YOUR_KEY_HERE"
geminiModel = "gemini-2.5-flash-lite"
[chat]
respondToTextMessages = true
[features]
# DANGEROUS: Allows AI to execute server commands
enableCheatAI = false
| Option | Default | Description |
|---|---|---|
geminiApiKey |
"" |
Your Google Gemini API key |
geminiModel |
"gemini-2.5-flash-lite" |
gemini-2.5-flash-lite (1000 req/day free), gemini-2.5-flash (50 req/day) or gemini-1.5-flash |
respondToTextMessages |
true |
Whether the AI responds to chat |
enableCheatAI |
false |
Enables command execution |
Setup
- Install Forge for Minecraft 1.20.1.
- Place the mod in the
modsfolder and start once to generate configs. - Visit aistudio.google.com and create a free API key.
- Enter the key in
config/sarosaichatmod-common.toml.
Note: This wiki is the documentation. Questions and bug reports are faster on the Discord server.
