MineClient Bridge

MineClient Bridge

用于检查和通过本地自动化工具控制Minecraft的已验证客户端桥接。

MineClient Bridge

MineClient Bridge 是一个客户端 NeoForge 1.21.1 模组，为经过授权的本地工具提供了一种有界的方式来观察和操作 Minecraft 客户端。它旨在用于自动化测试、辅助功能实验、受控演示以及需要真实客户端输入和帧缓冲证据的开发工作流。

功能特性

  • 将当前呈现的帧缓冲捕获为 PNG。
  • 读取有界的客户端、玩家、世界、物品栏、效果、准星、实体、GUI 控件和容器槽位状态。
  • 发现并操作命名的 Minecraft 键位映射。
  • 支持有界的视角、GUI 鼠标和活跃屏幕文本输入。
  • 释放按住的输入，并可请求优雅地关闭客户端。
  • 源代码仓库中包含可选的 MCP 服务器和 Codex 验收技能。

安全与隐私

该桥接器绑定到 127.0.0.1，并拒绝非回环请求。每个控制端点都需要一个生成的 256 位持有者令牌，该令牌与常规 JSON 配置分开存储，且永远不会被记录。请求和响应具有固定的大小限制，以斜杠为前缀的命令提交被阻止，并且在关闭过程中会释放按住的按键。

MineClient Bridge 没有遥测功能，也不会将客户端数据发送到外部服务。它不暴露任意的 shell、脚本、文件系统或直接的世界编辑 API。经过授权的按键、鼠标和 GUI 输入仍可能导致正常的游戏内操作，因此令牌应被视为本地密码。

安装

  1. 为 Minecraft 1.21.1 安装 NeoForge。
  2. 将 MineClient Bridge JAR 文件放入客户端的 mods 文件夹。
  3. 启动客户端。配置和令牌文件将在首次启动时创建。

该模组仅限客户端使用，没有游戏玩法模组依赖。它默认在 127.0.0.1:38121 上启用，并可在 config/mineclient-bridge.json 中禁用。

兼容性

  • Minecraft 1.21.1
  • NeoForge 21.1.197 或更新版本（21.1 系列内）
  • Java 21
  • 仅限客户端

可选的 MCP 预准备根启动器当前针对 Windows 后台桌面。NeoForge 模组本身不要求 MCP。

实时客户端证据

通过 MineClient Bridge 捕获的实时 Minecraft 客户端帧缓冲

这是在模组兼容性冒烟测试期间捕获的真实 960x540 帧缓冲。游戏模型属于单独的测试模组；MineClient Bridge 不添加任何游戏内覆盖层。

项目头像是一幅原创的 AI 辅助插画，并不代表单独的游戏内 UI。