原创 开源 工具 KuroBridge 新一代MC与社交聊天平台互通插件 1.0.0

你可以看看我的github，项目有点多，精力分配不太开！本项目还在早期测试阶段！

Kuro-Bridge的所有源代码都是MIT开源的！

KuroBridge 是一款服务端 Paper 插件，用于将 Minecraft 服务器与聊天平台连接起来。它作为一个 WebSocket 服务端运行：聊天端接入后，即可双向转发聊天消息、加入/离开/死亡事件以及指令。单个 JAR 文件即可兼容 Paper 1.12.2 至 26.3 版本。
这是一个实验性发布版本，目前仍不够完善，存在许多细节粗糙之处和已知的功能缺失。预计会出现 Bug，且版本更新之间可能会有破坏性变更（不兼容更新）。请勿将其部署在生产环境（正式服）中；请在私人测试服中进行测试，并做好备份。
目标受众： 内嵌模式（Embedded mode）捆绑了 QQ 客户端 napuketto，因此本版本主要面向中国的 QQ 社区。外部模式（External mode）支持与 Koishi 及其他平台配合使用，无需 QQ；虽然需要更多配置，但可在全球范围内使用。

功能特性​

• Minecraft 与绑定的聊天频道之间的双向互通聊天
• 玩家加入、离开和死亡事件通知
• 频道绑定：仅将来自已配置频道的消息转发至游戏内
• 群管理员执行服务器指令，并将输出结果返回至聊天频道
• 状态查询与配置重载
• 支持带注释和尾随逗号的 JSONC 配置文件（config.jsonc），首次启动时会自动生成并附带随机 Token

运行模式​

内嵌模式（QQ，Windows x64） — JAR 文件内已包含 napuketto 和 Node.js 26.7.0。只需启用 embedded.napuketto.enabled，设置你的 QQ 号，然后扫描二维码即可。内嵌客户端需要 Node.js 24 或更高版本；Windows 构建版本已内置该环境，且当前版本的内嵌模式仅支持 Windows x64 系统。
外部模式（Koishi、Discord、Telegram 等） — 禁用内嵌模式，设置固定的 ws.port，并使用你选择的平台适配器连接 koishi-plugin-kurobridge。此模式无需 QQ 账号，但配置过程更为复杂。桥接进程仍然需要 Node.js 24+ 运行时环境；Windows 构建版本已内置 26.7.0，其他系统平台则需自行安装提供。

环境要求​

• Paper 1.12.2–26.3，Java 8+
• 仅限 Paper 或 Purpur 服务端。不支持 Spigot 和 Bukkit：因为本插件调用了 Bukkit.getTPS()、AsyncChatEvent 以及 Adventure 组件等 Paper 专属 API。
• 供桥接进程使用的 Node.js 24+ 运行时环境
• 聊天对接端：用于 QQ 的 napuketto，或配有对应适配器的 Koishi

已在 Paper 26.3、26.2、1.21.11 和 1.16.5 版本上完成测试。更早的旧版本及中间过渡版本已通过通用字节码/API 兼容层覆盖支持，但尚未逐一进行测试。

KuroBridge Pure（计划中）​

https://github.com/Kuro-Bridge/KuroAdapter-Pure
目前计划推出一个纯 Java 构建版本（Pure 版）。它将仅作为协议桥接器，用于将服务器消息转发至 Discord 等类似平台，不包含任何内嵌客户端，也完全不依赖 QQ。虽然本项目现有的外部模式已经能够实现这一功能，但配置较为繁琐；对于此类使用场景，未来的 Pure 版将是更精简的选择。

相关链接​

• 源码与文档：https://github.com/Kuro-Bridge/KuroAdapter
• 通信协议：https://github.com/Kuro-Bridge/KuroProtocol
• 问题反馈 (Issues)：https://github.com/Kuro-Bridge/KuroAdapter/issues