Xingyue Bot
ℹ服务器信息
👥QQ 群管理
✉消息格式
🔔通知设置
📜QQ 指令设置
/list - 在线玩家
/status - 服务器状态
/say <消息> - 发送公告
/bind <游戏ID> - 绑定
/me - 我的绑定
/cmd <命令> - 执行指令(管理员)
🔒QQ 管理员
🚀快捷测试
🔗QQ-MC 绑定管理
💬实时消息
📅签到设置
/sign 或 /签到 | 查看信息: /signinfo 或 /签到信息需要绑定游戏ID后才能签到，金币通过 SellBox 经济系统发放。
🤖AI 对话设置
⚙生成参数
🌐联网搜索
百度搜索：使用 baidu.com 搜索结果。
自定义接口：传入 URL 和可选 Key，发送
?key=xxx&q=查询词，返回 JSON 需含 items 数组（每项含 title、snippet、link）。搜索失败后自动降级到备用搜索引擎。
DeepSeek 提供商启用搜索时自动使用原生联网搜索能力，不受以上设置影响。
💬AI 对话预览
👥网页管理员
添加新用户
修改密码
📄快速入门
Xingyue Bot 是一个 QQ 群与 Minecraft 服务器的消息互通机器人。通过 QQ 官方机器人 API 连接，实现 QQ 群内消息与游戏内消息双向转发。
基本流程：创建 QQ 机器人 → 配置连接 → 绑定 QQ 群 → 开始使用
⚙一、创建 QQ 机器人
- 打开 QQ 开放平台，登录你的 QQ 号
- 点击「创建应用」→「机器人」，填写应用名称（如"我的服务器助手"）
- 创建完成后，在应用详情页获取以下三项信息：
- AppID — 机器人的唯一标识
- Token — 机器人令牌（又称 Bot Token）
- AppSecret — 应用密钥（用于 OAuth 获取 access_token）
- 在「开发设置」→「事件订阅」中，确保以下事件已开启：
- 消息事件：
GROUP_AT_MESSAGE_CREATE（群 @ 消息） - 消息事件：
GROUP_MESSAGE_CREATE（群消息，建议开启） - 消息事件：
C2C_MESSAGE_CREATE（私聊消息）
- 消息事件：
- 将机器人添加到你的 QQ 群：在 QQ 群管理 →「机器人」→ 搜索并添加你的机器人
- 在 QQ 群设置中找到机器人权限，开启「获取群内全部消息」和「机器人主动发言」
GROUP_AT_MESSAGE_CREATE 事件。如果需要机器人接收所有群消息，请同时开启 GROUP_MESSAGE_CREATE。
🌐二、配置 Web 面板连接
- 启动 Minecraft 服务器（确保已安装本 Mod）
- 在浏览器访问
http://服务器IP:8080（默认端口 8080，可在面板中修改） - 默认登录账号：
admin，密码：admin（登录后建议立即修改密码） - 进入「控制台」页面，填写 QQ 开放平台获取的 AppID、Token、AppSecret
- 点击「连接」按钮，状态变为绿色「已连接」即表示成功
- 连接成功后，在「QQ 群管理」区域可以看到机器人所在群，点击「绑定」将该群加入管理列表
🤖三、配置 AI 对话
Xingyue Bot 支持接入 OpenAI 兼容接口的 AI 对话服务。以下是几种推荐方案：
方案一：硅基流动 (SiliconFlow) — 推荐
- 访问 硅基流动官网 注册账号
- 在控制台获取 API Key（注册送免费额度）
- 在面板「AI 设置」中，接口提供商选择「硅基流动 (SiliconFlow)」
- 填入 API Key，推荐模型：
Pro/deepseek-ai/DeepSeek-V3.2-Exp - 点击「保存」，然后在下方对话预览中测试
方案二：DeepSeek 官方
- 访问 DeepSeek 开放平台 注册账号
- 在 API Keys 页面创建 API Key
- 在面板中选择「DeepSeek 官方」
- 填入 API Key，默认模型
deepseek-v4-flash
方案三：幻城网安公益API
- 访问 幻城网安公益API 注册获取 API Key（公益免费）
- 在面板中选择「幻城网安公益API」
- 填入 API Key 即可使用
方案四：自定义接口
选择「自定义」，手动填写：
- API 地址：兼容 OpenAI 格式的完整 API 地址，如
https://api.openai.com/v1/chat/completions - 模型名称：如
gpt-4o-mini、gpt-3.5-turbo等 - API Key：对应的密钥
系统提示词设置
可以自定义 AI 的角色和行为。例如：
回答要简洁有趣，适当使用表情符号。
如果玩家问服务器问题，如实回答即可。
AI 触发方式
- @机器人：在群内 @ 机器人发送消息会自动触发 AI 回复（需启用 AI 对话）
- 触发前缀：默认
#，消息以#开头也会触发 AI 对话
🔗四、QQ-MC 绑定系统
绑定系统将 QQ 号与游戏 ID 关联，用于签到、查询等操作。
方式一：从 QQ 群发起绑定
- 在 QQ 群发送
/bind 你的游戏ID（如/bind Steve） - 机器人会生成验证码并私信发送给对应游戏玩家
- 游戏内输入
/xingyue confirm 验证码完成绑定
方式二：从游戏内发起绑定
- 游戏内输入
/xingyue bind - QQ 群内输入
/confirm 验证码完成绑定
常用绑定指令
/查询 游戏ID 或 /whois 游戏ID我的信息：
/me 或 /我的信息解绑：
/unbind 或 /解绑
📜五、完整指令列表
通用指令（所有群成员可用）
| 指令 | 别名 | 说明 |
|---|---|---|
/help | /帮助 | 显示帮助信息 |
/list | /在线 | 查看在线玩家列表 |
/status | /状态 | 查看服务器状态 |
/bind <游戏ID> | /绑定 <游戏ID> | 发起绑定请求 |
/confirm <验证码> | /确认 <验证码> | 确认绑定 |
/unbind | /解绑 | 解绑 QQ 与游戏 ID |
/me | /我的信息 | 查看自己的绑定信息 |
/whois <游戏ID> | /查询 <游戏ID> | 查询指定游戏ID的绑定 |
/sign | /签到 | 每日签到获取金币 |
/signinfo | /签到信息 | 查看签到状态 |
/say <消息> | /说 <消息> | 发送公告到游戏（需绑定） |
管理员指令（需在面板中将 QQ 设为管理员）
| 指令 | 说明 |
|---|---|
/cmd <命令> | 在服务器后台执行指令（如 /cmd give Steve diamond 64） |
/givecoins <玩家> <数量> | 给予玩家金币 |
/takecoins <玩家> <数量> | 扣除玩家金币 |
🔒六、管理设置
消息格式
在「控制台」→「消息格式」中可以自定义消息显示格式：
- MC → QQ：游戏消息发到 QQ 群的格式。默认：
[MC] {player}: {message} - QQ → MC：QQ 群消息显示在游戏内的格式。默认：
[QQ] {sender}: {message}
可用变量：{player} 玩家名、{message} 消息内容、{sender} QQ 昵称
通知设置
- 玩家加入：玩家进入游戏时在 QQ 群发送欢迎消息
- 玩家离开：玩家离开游戏时在 QQ 群发送提示
- 玩家死亡：玩家死亡时在 QQ 群发送死亡信息
QQ 管理员
在「控制台」→「QQ 管理员」中，添加群成员的 member_openid 即可赋予管理员权限。管理员可以使用 /cmd 等后台指令。
机器人接收消息后，成员会自动显示在「实时检测到的成员」列表中，方便直接添加。
签到设置
在「签到设置」标签页中配置每日签到参数：
- 普通签到（第 1-4 天）：可设置金币范围
- Bonus 签到（第 5 天）：可设置额外金币范围
- 签到周期：默认 5 天一循环
签到金币通过 SellBox 经济系统发放，需要先绑定游戏 ID。
🔧七、常见问题
Q: 机器人无法连接，提示认证失败
A: 请检查 AppID、Token、AppSecret 是否正确。注意 Token 和 AppSecret 是两项不同的配置，至少需要填写一项。推荐使用 AppID + AppSecret 方式。
Q: 连接成功但没有收到群消息
A: 确保在 QQ 开放平台的事件订阅中开启了相应事件（GROUP_AT_MESSAGE_CREATE 或 GROUP_MESSAGE_CREATE），并且在 QQ 群设置中开启了「获取群内全部消息」权限。
Q: AI 对话没有回复
A: 检查 AI 设置中的 API Key 是否正确，接口提供商是否选择正确。可以在「AI 对话预览」中测试，看是否有错误提示。常见原因：API Key 余额不足、接口地址不对、模型名称错误。
Q: 如何让 AI 只在 @ 机器人时回复？
A: 启用 AI 对话后，机器人默认只回复 @ 消息。如果需要关闭 AI 的 @ 回复，可以在 AI 设置中关闭「启用 AI 对话」。
Q: 绑定验证码无效
A: 验证码有效期为 5 分钟，超时需重新发起绑定。确保游戏内输入的命令格式正确：/xingyue confirm 123456。
Q: 如何远程访问 Web 面板？
A: 在路由器中添加端口映射（端口转发），将面板端口（默认 8080）映射到公网。注意设置强密码以保障安全。
Q: 更换服务器后如何迁移数据？
A: 复制 config/xingyuebot/ 目录下的所有 JSON 文件到新服务器的相同位置即可。