mineopbot

mineopbot

Minecraft AI Assistant Mod / 一个基于 Fabric 的 Minecraft 模组,将 AI 助手集成到游戏中。

社交

MineOpBot

Minecraft Fabric Java License

Minecraft AI 助手模组

一个基于 Fabric 的 Minecraft 模组,将 AI 助手集成到游戏中。

English | 简体中文


项目简介

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。

  1. Fork 本仓库
  2. 创建功能分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 打开 Pull Request

由 PYmili 倾心制作