mineopbot

--- ## Описание проекта | 简体中文 | English | |---------|---------| | MineOpBot — это мод для Minecraft Java Edition на Fabric, который интегрирует AI-ассистента в игру через API, совместимые с OpenAI. | MineOpBot is a Minecraft Java Edition Fabric mod that integrates an AI assistant into the game via OpenAI-compatible APIs. Players can chat with the AI using in-game commands, and the AI can understand player intentions and execute game actions. | ### Основные возможности | 简体中文 | English | |---------|---------| | Интеграция AI-чата — поддержка API, совместимых с OpenAI (OpenAI, DeepSeek, Claude и др.) | AI Chat Integration - Supports OpenAI-compatible APIs (OpenAI, DeepSeek, Claude, etc.) | | Потоковые ответы — отображение ответов AI в реальном времени для плавного взаимодействия | Streaming Responses - Real-time display of AI responses for smooth interaction | | Система Action — AI может выполнять команды Minecraft через ответы в формате JSON | Action System - AI can execute Minecraft commands via JSON-formatted responses | | Управление несколькими конфигурациями — поддержка нескольких конфигураций AI с переключением на лету | Multi-Config Management - Supports multiple AI configs with runtime switching | | Режим информации о пользователе (UIM) — предоставляет AI полную информацию об игровом состоянии игрока | User Information Mode (UIM) - Provides AI with complete player game state information | | Управление сессиями — независимая история чата для каждого игрока | Session Management - Independent chat history for each player | ### Описание модулей #### 1. Модуль команд (org.mineopbot.command) | 简体中文 | English | |---------|---------| | Command registration and processing module, providing the entry point for player interaction with the mod. | command/ ├── MineOpBotCommand.java # 命令注册中心 | Command Registration Center └── handler/ ├── AiReplyHandler.java # AI 回复协调器 | AI Reply Coordinator ├── MessageHelper.java # 消息格式化工具 | Message Formatting Utility └── command/ ├── ChatCommandHandler.java # 聊天命令处理 | Chat Command Handler ├── ConfigCommandHandler.java # 配置命令处理 | Config Command Handler └── StatusCommandHandler.java # 状态命令处理 | Status Command Handler #### 2. Модуль AI (org.mineopbot.ai) | 简体中文 | English | |---------|---------| | AI core functionality module, responsible for interacting with AI APIs. | ai/ ├── chat/ │ ├── AiChatManager.java # 聊天会话管理 | Chat Session Manager │ ├── AiChatStreamingResponseHandler.java # 流式响应处理 | Streaming Response Handler │ └── UserInformationMessage.java # 用户信息构建 (UIM) | User Info Builder (UIM) ├── config/ │ ├── AiConfig.java # 配置数据模型 | Config Data Model │ ├── AiConfigManager.java # 配置管理器 | Config Manager │ └── AiConfigStore.java # 配置持久化存储 | Config Persistent Storage ├── action/ │ ├── MineOpBotAction.java # Action 接口定义 | Action Interface Definition │ ├── ActionManager.java # Action 注册与执行 | Action Registration & Execution │ ├── ActionParser.java # AI 响应解析器 | AI Response Parser │ ├── ActionCallback.java # 异步回调接口 | Async Callback Interface │ └── command/ │ └── ExecuteCommandAction.java # 命令执行 Action | Command Execution Action └── util/ └── UserMessageCommandParser.java # 消息命令解析 | Message Command Parser #### 3. Модуль Mixin (org.mineopbot.mixin) | 简体中文 | English | |---------|---------| | Mixin extension module for modifying or extending vanilla Minecraft behavior. | --- ## Использование ### Установка | 步骤 | Step | 中文说明 | English Description | |-----|------|---------|---------------------| | 1 | 1 | 确保已安装 Minecraft 1.21.4 和 Fabric Loader 0.18.4+ | Ensure Minecraft 1.21.4 and Fabric Loader 0.18.4+ are installed | | 2 | 2 | 安装 Fabric API | Install Fabric API | | 3 | 3 | 将模组 JAR 文件放入 mods 文件夹 | Place the mod JAR file into the mods folder | | 4 | 4 | 启动游戏 | Launch the game | ### Настройка | 简体中文 | English | |---------|---------| | 首次运行后，在游戏对话框输入 `/mineopbot config add 命令，即可在游戏目录/config/下创建配置文件： | After the first run, enter the command/mineopbot config add in the game chat to create a configuration file ingame_directory/config/`: | mineopbot_configs.json json { "configs": [ { "name": "openai", "apiKey": "sk-your-api-key", "baseUrl": "https://api.openai.com/v1", "modelName": "gpt-4o" }, { "name": "deepseek", "apiKey": "sk-your-api-key", "baseUrl": "https://api.deepseek.com/v1", "modelName": "deepseek-chat" } ] } | 简体中文 | English | |---------|---------| | Поддерживается любой API-сервис, совместимый с OpenAI | Supports any OpenAI-compatible API service | ### Список команд | 命令
Command | 描述
Description | 示例
Example | |----------------|-------------------|----------------| | /mineopbot | 显示帮助信息
Display help information | /mineopbot | | `/mineopbot chat ` | 与 AI 对话
Chat with AI | /mineopbot chat 你好 | | `/mineopbot chat UIM` | 带 UIM 模式的对话
Chat with UIM mode enabled | /mineopbot chat 我在哪里 UIM | | /mineopbot status | 查看当前 AI 配置状态
View current AI configuration status | /mineopbot status | | /mineopbot config list | 列出所有配置
List all configurations | /mineopbot config list | | `/mineopbot config add ` | 添加新配置
Add new configuration | /mineopbot config add myai sk-xxx https://api.xxx.com/v1 gpt-4 | | `/mineopbot config remove ` | 删除配置
Remove configuration | /mineopbot config remove myai |

Реализованные функции

Система AI-чата

Управление конфигурацией

Система Action

Режим информации о пользователе (UIM)

---

---

Среда разработки

Требования

Сборка проекта

Запуск тестовой среды

---

Технологии

---

Структура проекта

---

Лицензия

---

Участие в разработке

---