FanHeav 教程

FanHeav 是连接 QQ 群和 Minecraft 的多服务器互通机器人。它先登录 QQ，再绑定群号和超级管理员，然后连接服务器、山头、本地联机或联机大厅，并把群聊、游戏聊天、管理命令和多服互通统一交给主程序处理。

使用顺序 先扫码登录 QQ，再配置 Cookie、目标服务器、QQ群和超级管理员

推荐流程：启动实例 → 扫码登录 QQ → 回车使用默认存储目录 → 继续或注册 Cookie → 选择目标类型 → 填 QQ 群号和超级管理员 → 进服后授权操作员。 默认目录：FanHeav_storage 保存 fanheav_config.json、local_cookie、违禁词、违规名称、运行数据和日志。不要公开 Cookie、服务器密码、QQ群管理信息。

QQ 登录必须先完成

终端出现二维码后，用 QQ 扫码并确认登录。扫码成功后才会进入 FanHeav 配置流程。

超级管理员决定谁能管机器人

首次配置时填写一个超级管理员 QQ。后续管理命令、添加管理员、天下大同等权限都从这里开始。

启动实例并扫码登录 QQ

启动 FanHeav 后，终端会先启动 NapCat 并输出 QQ 登录二维码。用手机 QQ 扫描二维码并在手机上确认登录。

如果终端二维码显示异常，打开文件管理里的 /workspace/qrcode.png 扫描。二维码每次启动都会刷新，旧图失效后要重新扫当前图片。

选择 FanHeav 存储目录

出现“FanHeav 存储目录”时，直接回车使用默认 /workspace/FanHeav_storage。MCSM 容器环境推荐使用默认目录，方便在文件管理里找到配置。

只有你明确要把配置放到其他位置时，才手动输入路径。普通用户直接回车是推荐操作。

登录 Cookie 管理菜单怎么选

如果已经保存过可用 Cookie，推荐直接选择 继续启动。首次使用推荐选择 注册 4399 账号获取 Cookie，按提示完成注册、实名和昵称。

Cookie 是 Minecraft 租赁服登录凭据，不要发给别人。如果昵称设置时遇到“服务器维护中”，可以继续保存 Cookie，后续进服流程会继续尝试。

没有保存 Cookie 时注册入口可能显示为 7

选择要进入的目标类型

重新配置服务器时，会出现 1 到 4 的目标类型选择。租赁服选 1 服务器；山头选 2 山头；本地联机选 3 本地联机；联机大厅选 4 联机大厅。

山头码不是完整链接，是山头链接里等号后面的那段码。密码没有就直接回车。

绑定 QQ 群和超级管理员

目标信息填完后，输入要互通的 QQ 群号，再输入超级管理员 QQ 号。群号只填数字，不带空格、不带群名。

超级管理员拥有最高管理权限，可以添加管理员、开启天下大同、修改功能开关、执行封禁和多服务器管理。

启动成功后先看菜单

FanHeav 就绪后，在绑定 QQ 群里发送菜单或 #菜单 查看当前状态和所有指令。开启图片菜单后，菜单会以图片形式发送。

如果机器人提示缺少操作员权限，请在 Minecraft 服务器里给机器人操作员权限，否则踢人、封禁、传送、执行命令等功能会失败。

命令总览 没有写目标时默认作用于全部已连接目标；写了目标时只作用于指定服务器、山头或联机房间

目标写法

服务器号例如 9499721

山头[山头码]例如山头abc123，山头码取链接等号后内容

本地联机[房间号]例如本地联机123456

联机大厅[房间号]例如联机大厅888888

菜单与显示

菜单 / #菜单查看当前状态和指令说明

#图片菜单开/关切换文字菜单和图片菜单

#图片菜单分离开/关把状态面板和命令面板拆开发送

#服号显示开/关多服互通时显示消息来源目标

基础功能

#玩家列表列出所有已连接目标的在线玩家、等级和身份

#权限查询查询机器人在所有目标里的身份和权限

#[目标]#玩家列表只查指定目标的玩家列表

#[目标]#权限查询只查指定目标的权限状态

全局开关

#群服互通开/关总开关，控制群和游戏是否互通

#游戏到群开/关控制 Minecraft 消息是否转发到 QQ 群

#群到游戏开/关控制 QQ 群消息是否转发到 Minecraft

#服务器消息过滤开/关/列表过滤命令消息、死亡、进退服、宠物死亡等服务器消息

#服务器消息过滤开进入交互选择：1 指令消息，2 玩家死亡，3 登录退出，4 宠物死亡；可回复多个编号

多服务器互通

#多服互通列表查看当前互通目标列表

#服服互通增加/删除 [服务器号] [密码]添加或删除租赁服互通目标，密码可留空

#山头互通增加/删除 [山头码]添加或删除山头互通目标

#本地联机互通增加/删除 [房间号] [密码]添加或删除本地联机目标

#联机大厅互通增加/删除 [房间号] [密码]添加或删除联机大厅目标

旧写法提示#服服互通开/关、#多服互通开/关/增加/删除属于旧入口，新教程推荐使用分类命令

多目标功能设置

#刷屏检测开/关全部目标同步设置；带目标则只改指定目标

#入服欢迎开/关控制新人进服欢迎

#入服欢迎设置 [欢迎词]修改欢迎词，设置后 QQ 群会返回新欢迎词

#玩家互传开/关开启服务器内玩家互传申请功能

检测与限制

#违规名称检测开/关控制玩家名违规检测

#违规名称检测列表/添加/删除 [词]查看、添加或删除违规名称词条

#违禁词检测开/关控制聊天违禁词检测

#违禁词检测列表/添加/删除 [词]查看、添加或删除聊天违禁词

#等级限制开/关控制网易账号等级门槛

#等级限制帮助查看等级限制的设置格式、当前等级和白名单用法

#等级限制设置 [等级]设置最低允许等级

#等级限制白名单添加/删除 [玩家名]白名单玩家即使等级不足也允许进入

封禁管理

#封禁 [玩家名] [秒/永久] [原因]封禁在线玩家，原因可选但建议填写

#离线封禁 [玩家名] [秒/永久] [原因]封禁离线玩家，支持模糊搜索

#封禁列表 [玩家名可选]查看封禁列表或指定玩家封禁记录

#解封 [玩家名]解除玩家封禁

管理命令

#增加管理 [QQ号]添加一个 QQ 管理员

#删除管理 [QQ号]删除一个 QQ 管理员

#管理员列表查看当前管理员列表

#天下大同开/关开启后所有群成员都能使用管理菜单；关闭后保留手动添加的管理员

命令执行

/命令对所有已连接目标执行 Minecraft 命令

/服务器号/命令只对指定服务器执行命令

/山头[山头码]/命令只对指定山头执行命令

/本地联机[房间号]/命令只对指定本地联机房间执行命令

/联机大厅[房间号]/命令只对指定联机大厅房间执行命令

游戏内功能 玩家互传和离线提醒是在 Minecraft 里使用或显示的

玩家互传

互传在服务器聊天栏输入，查看当前可申请玩家

互传玩家名向指定玩家发送互传申请

互传同意 / 互传拒绝被申请人输入，同意后申请人传送到对方位置；30 秒未处理自动拒绝

消息格式

QQ群文字会转发到游戏，显示群昵称，不显示一串 QQ 号

QQ 表情普通 emoji 会变成 [表情]，QQ face 会尽量翻译成 [得意]、[崇拜] 等名称

引用消息按“消息 + 引用内容 + 被引用人 + 被引用消息”的格式转发到游戏

QQ 离线如果 QQ 下线，玩家进服时会看到“当前群服账号已下线，请咨询服主”

常见问题 这些情况优先按下面处理

二维码扫了没反应确认手机 QQ 已点登录；如果仍无反应，重启实例重新生成二维码，再扫 /workspace/qrcode.png。

提示缺少操作员权限给机器人账号操作员权限，否则管理命令、封禁、踢人和传送会失败。

服务器维护中 code 32通常是 Minecraft 登录服务返回的临时错误，先重启实例重试。

# 开头命令格式错不要写错目标前缀。纯数字、山头[]、本地联机[]、联机大厅[] 才是目标；普通 #命令写错会提示正确格式。

多服发送失败FanHeav 会汇总失败目标，不会每个目标刷一条成功日志。

服务器消息太吵开启 #服务器消息过滤，默认不转发指令消息，只保留玩家消息和进退服等必要信息。

FanHeav 推荐操作顺序 扫码登录 QQ → 使用默认 FanHeav_storage → 继续或注册 4399 Cookie → 选择目标类型 → 填目标编号和密码 → 填 QQ 群号和超级管理员 → 授权机器人操作员 → 群里发送菜单检查状态。

继续查看 FanHeav 配置完成后，可以继续看基础教程和旧 EmptyDea 资料

基础教程

兑换码使用教程面板实例基础 导入前共识文件和导入规则