0xAI

Minecraft mod that adds AI chat via Ollama. Type @ai in chat to ask questions.

Install

1. Put the mod JAR in your mods folder
2. Run Ollama:

   ollama pull llama3.2
   ollama serve
   

3. Launch Minecraft

Usage

In chat:

@ai how do i find diamonds
@ai what's the best food
@ai how to make a nether portal

Config

Edit config/oxai.json:

{
  "enabled": true,
  "trigger": "@ai",
  "ollamaUrl": "http://localhost:11434",
  "model": "llama3.2",
  "systemPrompt": "You are a helpful AI assistant in Minecraft.",
  "maxTokens": 150,
  "temperature": 0.7,
  "responsePrefix": "[AI] ",
  "maxMessageLength": 256,
  "showErrors": true,
  "requestTimeout": 30000,
  "contextMessages": 5
}

Option	What it does
enabled	Turn mod on/off
trigger	Text to trigger AI (default: @ai)
ollamaUrl	Ollama server address
model	Which model to use
maxTokens	Max response length
temperature	How creative the AI is (0-1)
responsePrefix	Text before AI messages
maxMessageLength	Max characters per chat line
showErrors	Show errors in chat
requestTimeout	Timeout in ms
contextMessages	How many past messages to remember

Models

Works with any Ollama model. Common ones:

• llama3.2
• llama3.2:1b (faster, uses less memory)
• mistral
• phi3

Build

git clone <repo>
cd oxai
./gradlew build

JAR ends up in build/libs/.

Troubleshooting

Mod doesn't respond:

• Check Ollama is running: ollama serve
• Check model is installed: ollama list
• Verify config file

Slow:

• Use smaller model (llama3.2:1b)
• Lower maxTokens
• Lower contextMessages

Connection refused:

• Check ollamaUrl in config
• Make sure Ollama is running on correct port