QQ机器人命令执行说明
一、基本命令格式
所有命令需要在QQ群中@机器人后发送,格式为:
@机器人 <命令> [参数]
二、核心功能命令
1. 服务器状态查询
命令: /查询
功能: 查询MCSEO服务器状态,包括在线人数、地址等信息
示例: @机器人 /查询
命令: /查询
功能: 查询MCSEO服务器状态,包括在线人数、地址等信息
示例: @机器人 /查询
2. 随机二次元图片
命令: /随机图片
功能: 发送一张随机的二次元动漫图片
示例: @机器人 /随机图片
命令: /随机图片
功能: 发送一张随机的二次元动漫图片
示例: @机器人 /随机图片
3. 每日运势
命令: /每日运势
功能: 生成并发送用户当天的运势信息,每天更新一次
示例: @机器人 /每日运势
命令: /每日运势
功能: 生成并发送用户当天的运势信息,每天更新一次
示例: @机器人 /每日运势
4. 系统信息查询
命令: /系统信息
功能: 查看机器人运行时间和系统信息
示例: @机器人 /系统信息
命令: /系统信息
功能: 查看机器人运行时间和系统信息
示例: @机器人 /系统信息
5. 向游戏发送消息
命令: /mc <消息内容>
功能: 将QQ群消息发送到游戏内,需要先绑定游戏名称
示例: @机器人 /mc 大家好
注意: 需要先使用 /bind <游戏名称> 命令绑定游戏名称
命令: /mc <消息内容>
功能: 将QQ群消息发送到游戏内,需要先绑定游戏名称
示例: @机器人 /mc 大家好
注意: 需要先使用 /bind <游戏名称> 命令绑定游戏名称
6. 解绑游戏名称
命令: /unbind <游戏名称>
功能: 解绑指定的游戏名称(管理员功能)
示例: @机器人 /unbind Steve
命令: /unbind <游戏名称>
功能: 解绑指定的游戏名称(管理员功能)
示例: @机器人 /unbind Steve
三、MCDR命令转发
1. 玩家管理命令
- ● 封禁玩家: @机器人 /ban <玩家名>
- ● 解封玩家: @机器人 /pardon <玩家名>
- ● 查看玩家信息: @机器人 /pinfo <玩家名>
2. 白名单管理命令
- ● 显示帮助: @机器人 /wr help
- ● 显示全部白名单: @机器人 /wr list
- ● 添加白名单: @机器人 /wr add <玩家名>
- ● 移除白名单: @机器人 /wr remove <玩家名>
- ● 打开白名单: @机器人 /wr on
- ● 关闭白名单: @机器人 /wr off
3. 服务器管理命令
- ● 查看在线玩家: @机器人 /list
- ● 查看服务器TPS: @机器人 /tps
- ● 开启伪和平: @机器人 /开启伪和平
- ● 关闭伪和平: @机器人 /关闭伪和平
- ● 关闭侦测器: @机器人 /关侦测器
- ● 开启侦测器: @机器人 /开侦测器
四、命令执行流程
1. 消息接收与解析
- 机器人接收群聊消息
- 检查是否@机器人
- 解析命令内容,提取命令和参数
2. 命令处理与执行
- 根据命令类型选择相应的处理函数
- 执行命令逻辑,如:
- ◦ 调用API获取数据
- ◦ 生成图片
- ◦ 转发命令到MCDR
- ◦ 处理回调和响应
3. 结果反馈
- 将执行结果发送回QQ群
- 对于需要确认的操作(如/mc命令),在操作成功后发送确认消息
- 对于失败的操作,发送错误提示信息
五、注意事项
- 权限限制: 某些命令(如/unbind)需要管理员权限
- 消息格式: 所有命令需要正确的格式,否则会收到错误提示
- 网络延迟: 部分命令需要调用外部API,可能会有一定的网络延迟
- 绑定要求: 使用/mc命令前需要先绑定游戏名称
- 命令频率: 避免频繁发送相同命令,以免触发API限制
六、错误处理
当命令执行失败时,机器人会返回相应的错误提示,常见错误包括:
- ● 命令格式错误
- ● 缺少必要参数
- ● API调用失败
- ● 网络连接错误
- ● 权限不足
七、示例使用场景
场景1:查询服务器状态
@机器人 /查询
→ 机器人会返回所有服务器的在线状态、人数等信息
场景2:向游戏发送消息
@机器人 /bind Steve
@机器人 /mc 大家好,我是Steve
→ 机器人会将消息发送到游戏内,并返回”已发送到游戏”的确认
场景3:管理白名单
@机器人 /wr add Alex
→ 机器人会执行白名单添加操作,并返回结果
八、命令执行流程图
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ 接收消息 │────>│ 解析命令 │────>│ 执行命令 │
└─────────────┘ └─────────────┘ └─────────────┘
│
▼
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ 显示结果 │<────│ 处理响应 │<────│ 调用API/ │
│ 给用户 │ │ 或生成结果 │ │ 转发命令 │
└─────────────┘ └─────────────┘ └─────────────┘
九、常见问题解答
Q: 为什么/mc命令提示”您尚未绑定游戏名称”?
A: 使用/mc命令前需要先使用 /bind <游戏名称> 命令绑定您的游戏名称
A: 使用/mc命令前需要先使用 /bind <游戏名称> 命令绑定您的游戏名称
Q: 为什么服务器查询失败?
A: 可能是网络问题或API暂时不可用,请稍后重试
A: 可能是网络问题或API暂时不可用,请稍后重试
Q: 为什么随机图片加载失败?
A: 可能是图片API暂时不可用,请稍后重试
A: 可能是图片API暂时不可用,请稍后重试
评论(0)
暂无评论