
mineopbot
Minecraft AI Assistant Mod / 一个基于 Fabric 的 Minecraft 模组,将 AI 助手集成到游戏中。
查看大图MineOpBot
Minecraft AI 助手模组
一个基于 Fabric 的 Minecraft 模组,将 AI 助手集成到游戏中。
项目简介
MineOpBot 是一个 Minecraft Java 版 Fabric 模组,通过 OpenAI 兼容 API 将 AI 助手集成到游戏中。玩家可以通过游戏内命令与 AI 进行对话,AI 可以理解玩家意图并执行游戏操作。
核心特性
- AI 对话集成 - 支持 OpenAI 兼容 API(OpenAI、DeepSeek、Claude 等)
- 流式响应 - 实时显示 AI 回复,提供流畅的交互体验
- Action 系统 - AI 可通过 JSON 格式响应执行 Minecraft 命令
- 多配置管理 - 支持多个 AI 配置,运行时动态切换
- 用户信息模式 (UIM) - 向 AI 提供玩家的完整游戏状态信息
- 会话管理 - 每位玩家独立的聊天历史记录
模块说明
1. Command 模块 (org.mineopbot.command)
命令注册与处理模块,提供玩家与模组交互的入口。
command/
├── MineOpBotCommand.java # 命令注册中心
└── handler/
├── AiReplyHandler.java # AI 回复协调器
├── MessageHelper.java # 消息格式化工具
└── command/
├── ChatCommandHandler.java # 聊天命令处理
├── ConfigCommandHandler.java # 配置命令处理
└── StatusCommandHandler.java # 状态命令处理
2. AI 模块 (org.mineopbot.ai)
AI 核心功能模块,负责与 AI API 的交互。
ai/
├── chat/
│ ├── AiChatManager.java # 聊天会话管理
│ ├── AiChatStreamingResponseHandler.java # 流式响应处理
│ └── UserInformationMessage.java # 用户信息构建 (UIM)
├── config/
│ ├── AiConfig.java # 配置数据模型
│ ├── AiConfigManager.java # 配置管理器
│ └── AiConfigStore.java # 配置持久化存储
├── action/
│ ├── MineOpBotAction.java # Action 接口定义
│ ├── ActionManager.java # Action 注册与执行
│ ├── ActionParser.java # AI 响应解析器
│ ├── ActionCallback.java # 异步回调接口
│ └── command/
│ └── ExecuteCommandAction.java # 命令执行 Action
└── util/
└── UserMessageCommandParser.java # 消息命令解析
3. Mixin 模块 (org.mineopbot.mixin)
Mixin 扩展模块,用于修改或扩展 Minecraft 原版行为。
使用方法
安装
| 步骤 | 中文说明 |
|---|---|
| 1 | 确保已安装 Minecraft 1.21.4 和 Fabric Loader 0.18.4+ |
| 2 | 安装 Fabric API |
| 3 | 将模组 JAR 文件放入 mods 文件夹 |
| 4 | 启动游戏 |
配置
首次运行后,在游戏对话框输入 /mineopbot config add <name> <apiKey> <baseUrl> <model> 命令,即可在 游戏目录/config/ 下创建配置文件:
mineopbot_configs.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"
}
]
}
支持任何 OpenAI 兼容的 API 服务
命令介绍
| 命令 | 描述 | 示例 |
|---|---|---|
/mineopbot |
显示帮助信息 | /mineopbot |
/mineopbot chat <message> |
与 AI 对话 | /mineopbot chat 你好 |
/mineopbot chat <message> UIM |
带 UIM 模式的对话 | /mineopbot chat 我在哪里 UIM |
/mineopbot status |
查看当前 AI 配置状态 | /mineopbot status |
/mineopbot config list |
列出所有配置 | /mineopbot config list |
/mineopbot config add <name> <apiKey> <baseUrl> <model> |
添加新配置 | /mineopbot config add myai sk-xxx https://api.xxx.com/v1 gpt-4 |
/mineopbot config remove <name> |
删除配置 | /mineopbot config remove myai |
/mineopbot config switch <name> |
切换当前配置 | /mineopbot config switch deepseek |
已实现功能
AI 对话系统
| 状态 | 功能 |
|---|---|
| [x] | OpenAI 兼容 API 集成 |
| [x] | 流式响应显示 |
| [x] | 会话历史管理 |
| [x] | 自定义系统提示词 |
配置管理
| 状态 | 功能 |
|---|---|
| [x] | 多配置支持 |
| [x] | 运行时配置切换 |
| [x] | JSON 持久化存储 |
| [x] | API Key 安全显示 |
Action 系统
| 状态 | 功能 |
|---|---|
| [x] | Action 注册机制 |
| [x] | command_execute - 执行 Minecraft 命令 |
| [x] | AI 响应 JSON 解析 |
| [x] | 异步执行与回调 |
用户信息模式 (UIM)
| 状态 | 功能 |
|---|---|
| [x] | 玩家位置与维度信息 |
| [x] | 生命值与饥饿值 |
| [x] | 装备信息 |
| [x] | 游戏模式与经验 |
| [x] | 移动状态 |
TODO
- Block Action - 添加方块操作相关 Action
- 持久化对话记录 - 保存玩家的聊天历史
- 权限分级 - 不同权限等级的玩家可使用的功能不同
- 知识库 - 集成 RAG 知识库,增强 AI 对 Minecraft 的理解
开发环境
环境要求
- JDK 21+
- Gradle 9.1.0+
构建项目
| 平台 | 命令 |
|---|---|
| Windows | .\gradlew build |
| Linux/macOS | ./gradlew build |
运行测试环境
| 目标 | 命令 |
|---|---|
| 服务端 | .\gradlew runServer |
| 客户端 | .\gradlew runClient |
技术栈
| 技术 | 版本 | 用途 |
|---|---|---|
| Minecraft | 1.21.4 | 目标游戏版本 |
| Fabric Loader | 0.18.4 | 模组加载器 |
| Fabric API | 0.119.4+1.21.4 | Fabric API 模块 |
| LangChain4j | 1.11.0 | AI API 集成 |
| Java | 21 | 编程语言 |
项目结构
| 路径 | 说明 |
|---|---|
src/main/java/org/mineopbot/ |
源代码目录 |
MineOpBot.java |
主入口 |
MineOpBotClient.java |
客户端入口 |
ai/ |
AI 模块 |
command/ |
命令模块 |
mixin/ |
Mixin 模块 |
src/main/resources/ |
资源目录 |
fabric.mod.json |
Fabric 模组元数据 |
mineopbot.mixins.json |
Mixin 配置 |
assets/mineopbot/ |
模组资源 |
config/ |
配置示例 |
prompt/ |
系统提示词 |
build.gradle |
构建配置 |
gradle.properties |
Gradle 属性 |
LICENSE |
许可证 |
许可证
本项目采用 CC0 1.0 Universal 许可证。
贡献指南
欢迎贡献!请随时提交 Pull Request。
- Fork 本仓库
- 创建功能分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 打开 Pull Request
由 PYmili 倾心制作
正在加载版本记录…

正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。