mineGPT

mineGPT

仅限客户端的Minecraft聊天伴侣集成。

使用 ChatGPT Desktop 作为 Minecraft 1.21.1 游戏中的伴侣。在 Minecraft 中输入以 @gpt 开头的问题,即可收到本地聊天消息形式的回复。MineGPT 仅限客户端使用:不需要服务器模组或插件,你的 @gpt 消息绝不会发送到多人游戏服务器或其他玩家。

Minecraft @gpt 消息 -> 本地 MineGPT 桥接 -> ChatGPT Desktop -> 本地回复

安装 MineGPT

  1. 将 MineGPT 模组 JAR 文件添加到你要游玩的 Minecraft 实例的 mods 文件夹中。Fabric 用户还必须在同一实例中安装 Fabric API。

  2. 将 MineGPT Bridge 发行版解压到电脑上某个保持可用的位置。你需要向 ChatGPT Desktop 提供其启动脚本的绝对路径:

    • macOS/Linux:bin/minegpt-bridge
    • Windows:bin/minegpt-bridge.bat
  3. 启动所选 Minecraft 实例一次。MineGPT 仅在客户端运行;无需在多人游戏服务器上安装任何内容。

连接 ChatGPT Desktop

  1. 在 ChatGPT Desktop 中,打开 设置 -> MCP 服务器,并添加一个名为 minegpt 的 STDIO 服务器。
  2. 将其命令设置为上一节中 Bridge 脚本的绝对路径(从 GitHub 下载)。不要添加参数或 API 密钥。
  3. 重启 ChatGPT Desktop,然后在对话中运行 /mcp 以确认 minegpt 已连接。
  4. 在该对话中,要求 ChatGPT 调用 minegpt_pairing_code,然后复制返回的 token。
  5. 在 Minecraft 中运行:
   /minegpt pair <token>
  1. 告诉 ChatGPT 监听你的游戏内问题。以下提示词是一个有用的起点:
   开始监听 Minecraft。对于每一条 MineGPT 玩家消息,请作答,使用准确的 message_id 调用 minegpt_reply,然后立即使用 wait_seconds 45 再次调用 minegpt_next_message。持续执行,直到我告诉您停止。

在监听期间,请保持此 ChatGPT 对话处于打开状态。Minecraft 无法自行打开或唤醒对话。

退出 Minecraft 世界或返回标题画面会保持 MineGPT Bridge 会话开启。只有当 Minecraft 客户端退出时,Bridge 才会关闭。

在游戏中使用

  • 在正常的 Minecraft 聊天框中输入 @gpt <消息>。例如:
  @gpt 我可以使用我物品栏中的物品制作什么?
  • ChatGPT 的回复将以本地的 [MineGPT] 系统消息形式出现。没有 @gpt 前缀的普通聊天不会改变。
  • 运行 /minegpt status 以检查配对、桥接连接和队列消息状态。
  • 运行 /minegpt github <github_url> 可将一个公开的 GitHub Markdown 技能安装到该 Minecraft 实例中。使用普通的 GitHub 文件页面 URL 或 raw.githubusercontent.com URL。现有技能永远不会被覆盖。