指令手册
约 607 字大约 2 分钟
UniBot 的指令基于 Alconna 解析，跨平台表现一致。默认命令前缀为 .（可在 .env 的 COMMAND_START 中修改）。
所有指令均受 Config.toml 中的 command_groups（指令群）与 command_enabled（启用列表）控制。
指令总览
| 指令 | 功能 | 权限 |
|---|---|---|
.list | 查询所有服务器的在线玩家 | 所有用户 |
.server | 查看当前连接的服务器列表 | 所有用户 |
.luck | 每日运势占卜（仅供娱乐） | 所有用户 |
.send | 向游戏内发送消息 | 所有用户 |
.command | 远程执行 Minecraft 指令 | 管理员 |
.bound | 绑定 / 解绑 / 查询游戏白名单 | 所有用户 |
.help | 查看命令帮助 | 所有用户 |
.about | 关于本机器人 | 所有用户 |
详细说明
.list — 在线玩家
查询所有已连接服务器的在线玩家列表，支持通过参数指定服务器。
.list # 查询所有服务器
.list <服务器名称> # 查询指定服务器- 玩家按「玩家」与「假人」分类展示（根据
bot_prefix判断）。 - 启用图片模式时，会渲染为带玩家头像的精美图片。
.server — 服务器列表
查看当前连接的服务器列表与状态。
.server.luck — 每日运势
每日运势占卜，仅供娱乐。
.luck.send — 消息发送
往游戏内发送消息（在 sync_all_qq_message 关闭时可用）。
.send <消息内容>.command — 远程指令
远程执行 Minecraft 指令（需管理员权限）。
.command <服务器> <指令>- 受
command_minecraft_whitelist与command_minecraft_blacklist控制。 - 例如
.command server1 say hello会在 server1 上执行say hello。
.bound — 白名单绑定
绑定 / 解绑 / 查询游戏白名单。
.bound # 查看自己的绑定
.bound <玩家名称> # 绑定白名单
.bound remove <玩家名称> # 解绑
.bound remove --all # 解绑全部- 玩家名称只能包含字母、数字、下划线，长度不超过 16 个字符。
- 绑定数量受
qq_bound_max_number限制。
.help — 帮助
查看可用命令列表，或查看指定命令的详细帮助。
.help # 列出所有命令
.help <命令名称> # 查看指定命令详情.about — 关于
查看版本、更新状态与项目信息。
.about # 查看关于信息
.about check # 主动检测新版本平台前缀
指令在不同平台响应相同的群格式，通过前缀区分平台：
| 平台 | 前缀 |
|---|---|
| QQ 客户端 | qq_client |
| QQ 频道 | qq_guild |
| QQ API | qq_api |
| Telegram | telegram |
| Discord | discord |
| Kook | kook |
在 command_groups / message_groups 中按 "{平台}:{群ID}" 格式填写。