OxAI

oxai

oxai — это клиентский мод для Fabric, который добавляет в Minecraft чат-компаньона на базе Ollama. Напиши @ai в чате, и мод отправит запрос на твой локальный сервер Ollama, а затем ответит в чате.

Поддержка

• Версия мода: 0.1.5
• Minecraft: 26.1.x
• Fabric Loader: 0.17.3+
• Fabric API: обязателен
• Java: 25+
• Mod Menu: опционально, поддерживается

Mod Menu добавляет экран настроек в игре для тех же параметров, что хранятся в config/oxai.json.

Установка

1. Установи Fabric Loader и Fabric API для Minecraft 26.1.x.
2. Помести JAR-файл 0xAI в папку mods.
3. Опционально: установи Mod Menu, чтобы настраивать 0xAI прямо в игре.
4. Запусти Ollama:

ollama pull llama3.2
ollama serve

5. Запусти Minecraft.

Использование

В чате:

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

По умолчанию триггер — @ai. Его можно изменить в Mod Menu или в config/oxai.json.

Настройка

Если установлен Mod Menu:

1. Открой Mods.
2. Выбери 0xAI.
3. Открой экран настроек.
4. Измени параметры и нажми Done.

Без Mod Menu редактируй 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
}

Модели

0xAI работает с любой чат-моделью Ollama. Популярные варианты:

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

Используй модели поменьше для быстрых ответов или для слабого железа.

Сборка

Установи JDK 25+, затем собери через Gradle:

./gradlew build

В Windows PowerShell, если Unix-скрипт обёртки не исполняется, запусти:

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

Собранный JAR появится в build/libs/.

Решение проблем

При сборке пишет release version 25 not supported

Gradle использует старый JDK. Установи JDK 25 и убедись, что JAVA_HOME или Gradle JVM в твоей IDE указывает на него.

Мод не отвечает

• Убедись, что 0xAI включён в Mod Menu или в config/oxai.json.
• Проверь, что Ollama запущен через ollama serve.
• Проверь, что нужная модель установлена, командой ollama list.
• Убедись, что твоё сообщение содержит настроенный триггер.

Ответы приходят медленно

• Используй модель поменьше, например llama3.2:1b.
• Уменьши maxTokens.
• Уменьши contextMessages.

Connection refused

• Проверь ollamaUrl.
• Убедись, что Ollama запущен на указанном хосте и порту.