Mioku Minecraft Plugin

Minecraft 服务器与 QQ 群消息互通插件，支持服务器状态监控与 RCON 命令执行，服务器需安装鹊桥模组或插件并配置。

使用到的外部包：@cikeyqi/queqiao-node-sdk

功能特性

• 消息同步：群聊消息同步到 MC 服务器，MC 服务器消息同步到群聊
• 服务器状态推送：玩家加入/退出/死亡/达成进度时自动推送到群聊
• RCON 命令执行：在群聊中发送命令前缀开头的消息即可执行 RCON 命令
• 多服务器支持：可配置多个 MC 服务器，每个服务器独立设置连接方式
• 正向/反向 WebSocket：支持机器人主动连接或 MC 服务器反向连接

安装

将插件放置在 plugins/mc/ 目录下，然后执行：

bun install

配置

插件需要通过 WebUI 配置页面来管理配置项。

全局配置

| 配置项 | 类型 | 说明 | |------------------|--------|----------------------------| | 聊天前缀 | text | QQ 消息转发到 MC 时显示的前缀，默认 "说：" | | 显示服务器名称 | switch | 是否在推送消息中显示服务器名称 | | 启用反向 WebSocket | switch | 启用反向连接（MC 服务器连接到此机器人） | | 反向连接端口 | number | 反向 WebSocket 监听端口 | | 反向连接路径 | text | 反向 WebSocket 路径 | | 反向连接密码 | secret | 反向 WebSocket 连接密码 |

服务器配置

每个服务器可独立配置以下选项：

| 配置项 | 类型 | 说明 | |------------------|--------|-----------------------------| | 服务器名称 | text | 服务器唯一标识，不能与其他服务器重复 | | WebSocket 地址 | text | 服务器 WebSocket 连接地址（正向连接时使用） | | 连接密码 | text | WebSocket 连接密码（可选） | | 关联群聊 | text | 关联的 QQ 群号 | | 机器人账号 | text | 使用哪个机器人 QQ 号发送消息 | | 命令前缀 | text | RCON 命令前缀，默认 "$" | | 命令白名单 | text | 允许执行 RCON 命令的 QQ 号列表 | | RCON 命令白名单 | text | 允许执行的 RCON 命令列表 | | 启用同步 | switch | 是否启用消息同步 | | 最大重连次数 | number | WebSocket 最大重连次数 | | 启用正向 WebSocket | switch | 启用正向连接（连接到 MC 服务器） | | 启用反向连接 | switch | 该服务器是否启用反向连接 | | 启用 RCON | switch | 启用 RCON 命令执行 | | RCON 地址 | text | RCON 服务器地址 | | RCON 端口 | number | RCON 端口 | | RCON 密码 | secret | RCON 密码 |

命令

| 命令 | 描述 | 权限 | |--------------------|----------------------------------------|-----| | /mc 状态 | 查看所有已配置服务器的 WebSocket 连接状态，包括连接中、已断开等 | 主人 | | /mc 开启同步 <服务器名称> | 开启指定服务器的群聊消息同步功能，开启后该服务器可接收和发送群聊消息 | 主人 | | /mc 关闭同步 <服务器名称> | 关闭指定服务器的群聊消息同步功能，关闭后该服务器不再接收和发送群聊消息 | 主人 | | /mc 重连 | 断开并重新建立所有服务器的 WebSocket 连接，用于连接异常时手动恢复 | 主人 |