OxAI

oxai

oxai is a Fabric client mod that adds an Ollama-powered chat companion to Minecraft. Type @ai in chat and the mod sends the prompt to your local Ollama server, then replies in chat.

Support

• Mod version: 0.1.5
• Minecraft: 26.1.x
• Fabric Loader: 0.17.3+
• Fabric API: required
• Java: 25+
• Mod Menu: optional, supported

Mod Menu adds an in-game config screen for the same settings stored in config/oxai.json.

Install

1. Install Fabric Loader and Fabric API for Minecraft 26.1.x.
2. Put the 0xAI JAR in your mods folder.
3. Optional: install Mod Menu to configure 0xAI in-game.
4. Start Ollama:

ollama pull llama3.2
ollama serve

5. Launch Minecraft.

Usage

In chat:

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

The default trigger is @ai. You can change it in Mod Menu or in config/oxai.json.

Configuration

With Mod Menu installed:

1. Open Mods.
2. Select 0xAI.
3. Open the config screen.
4. Change settings and press Done.

Without Mod Menu, edit config/oxai.json:

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

Option	What it does
enabled	Turns AI replies on or off
trigger	Chat text that triggers the AI
ollamaUrl	Ollama server address
model	Ollama model name
systemPrompt	System message sent with each request
maxTokens	Maximum generated response length
temperature	Response randomness from 0.0 to 1.0
responsePrefix	Prefix added before AI chat messages
maxMessageLength	Maximum characters per chat line
showErrors	Shows request errors in chat
requestTimeout	Ollama request timeout in milliseconds
contextMessages	Number of recent chat turns to keep as context

Models

0xAI works with any Ollama chat model. Common choices:

• llama3.2:3b
• llama3.2:1b
• mistral
• phi3

Use smaller models for faster replies or lower-end hardware.

Build

Install JDK 25+, then build with Gradle:

./gradlew build

On Windows PowerShell, if the Unix wrapper script is not executable, run:

java -classpath gradle\wrapper\gradle-wrapper.jar org.gradle.wrapper.GradleWrapperMain build

The built JAR is written to build/libs/.

Troubleshooting

Build says release version 25 not supported

Gradle is using an older JDK. Install JDK 25 and make sure JAVA_HOME or your IDE Gradle JVM points to it.

The mod does not respond

• Make sure 0xAI is enabled in Mod Menu or config/oxai.json.
• Check that Ollama is running with ollama serve.
• Check that the configured model is installed with ollama list.
• Verify that your message contains the configured trigger.

Replies are slow

• Use a smaller model such as llama3.2:1b.
• Lower maxTokens.
• Lower contextMessages.

Connection refused

• Check ollamaUrl.
• Make sure Ollama is running on the configured host and port.