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 连接，用于连接异常时手动恢复	主人