3. Discord 联动
连接官方 Saba-chan 机器人,并为每个 Discord 服务器设置可用的服务器和命令权限。
3. Discord 联动
Saba-chan Discord 机器人是运行在 Saba-chan 云端的官方机器人。你不需要自己创建机器人或管理令牌,也不需要端口转发(路由器的一项设置,用来把外部连接转交给你的电脑)。电脑上的 Saba-chan 会主动连接云端,把 Discord 命令取回来。
联动分三步:连接机器人(配对),为每个 Discord 服务器选择可用的服务器,再决定谁能用哪些命令。
第 1 步:连接机器人(配对)
- 在应用上方的 Discord 页面打开连接,点
连接 Discord 服务器。 - 如果 Discord 服务器里还没有 Saba-chan 机器人,先用
邀请机器人邀请进来。 - 出现连接代码和要输入的命令(
/saba connect code:…)后,点复制。 - 粘贴到 Discord 聊天框发送。只有在该 Discord 服务器拥有管理服务器权限的人才能使用这条命令。
- 如果是第一次使用 Saba-chan 的 Discord 账号,机器人会先引导你注册。点
注册,在网站上确认条款并注册后,那条回复会变成连接确认。代码会在这期间等待。 - 机器人询问是否连接时,点
连接。只有代码是你在 Saba-chan 应用里亲自获取的才可以点。如果是别人给你的代码,那个人的电脑就会连接到你的账号。 - 机器人会告知连接完成,应用也会变成
已连接。
代码只在 5 分钟内有效。过期后请点 获取新代码。已经连接过的 Discord 账号,在其他 Discord 服务器上可以不带代码只发送 /saba connect,这样我账号下的所有电脑都会立即连接到那个 Discord 服务器。这时同样需要该 Discord 服务器的管理服务器权限;这样连接的 Discord 服务器起初一台游戏服务器都看不到,请在应用里选择要开放的服务器(见下面的第 2 步)。用代码连接的 Discord 服务器,遵循应用 Discord → 连接 界面中的 对新 Discord 服务器直接开放我的服务器 设置。
一个 Discord 账号可以连接多台电脑。用已经连接过电脑的账号发送新代码时,机器人会显示 作为新电脑连接 和 重新连接 <电脑名> 按钮。第一次连接的电脑选 作为新电脑连接;如果是重新连接以前连过的电脑,就选那台电脑(它以前的连接会断开)。已连接的电脑可以用 /mysaba my-pcs 查看、改名或删除。
一个 Discord 服务器也可以接入多台电脑。朋友把自己的电脑连接到同一个 Discord 服务器后,两台电脑的服务器会一起显示,命令会发到拥有该服务器的电脑。服务器名称重复时,后接入的电脑的服务器名称后会加上 -电脑名。语言、前缀、音乐、频道分配等共同设置,由最先连接的电脑的主人和 Discord 服务器的所有者修改。每台电脑的服务器和权限由那台电脑的主人决定。
第 2 步:为每个 Discord 服务器选择服务器
连接好的 Discord 服务器会出现在 Discord → Discord 服务器列表里。选中一个就会打开标签页。
在实例标签页决定这个 Discord 服务器能操作哪些游戏服务器。实例是在 Saba-chan 中注册的一个游戏服务器。
- 所有实例:现有的和以后新建的服务器全部可见。
- 仅限选定的实例:只有你打开的服务器在这个 Discord 服务器里可见、可操作。想给不同的朋友群分配不同服务器时使用。
没有允许的服务器,在那个 Discord 服务器的命令、列表和斜杠命令里都不会出现。
第 3 步:设置命令权限
权限分五个级别。级别是累加的,上面的级别可以使用下面级别能用的所有命令。
| 级别 | 谁 |
|---|---|
| 所有者 (3) | 连接这个 Discord 服务器的人。能用所有命令,不会被降级 |
| 管理员 (2) | 连危险命令也可以交给的人 |
| 用户 (1) | 可以开关服务器的人。一开始是所有成员的默认级别 |
| 访客 (0) | 只能用查看状态这类安全命令的人 |
| 禁止 (-1) | 包括音乐和会说话的 Saba-chan 在内,完全不能使用机器人功能 |
权限在实例标签页中点击服务器(实例)打开。点 所有实例权限 可以一次查看所有服务器。界面有两种:
- 各级别命令:命令以标签形式放在台阶上。标签放在能使用该命令的最低级别上。把标签拖到其他台阶,或点击它来修改所需级别。上方的命令预设(宽松・默认・严格)会按风险等级(安全・注意・危险)一次性摆放命令。默认预设是 安全 = 访客,注意 = 用户,危险 = 管理员。更改预设后,单独移动过的标签也会回到预设的位置。下方的会说话的 Saba-chan 上限是经过会说话的 Saba-chan 的请求不能超过的级别(起初为访客)。
- 各成员级别:设置默认级别(没有单独获得级别的成员所遵循的级别),并为每个成员分配级别。在
编辑级别中可以修改级别名称、增加台阶、调整顺序。
成员级别和预设会同时应用到这个 Discord 服务器的所有服务器。移动服务器通用命令(不属于特定服务器的命令)时,所有服务器的权限界面会一起改变。帮助和列表只要不是禁止,任何人都可以使用。
- 在点击标签打开的窗口中,也可以为每个命令修改 Discord 确认步骤(安全・注意・危险)。这个步骤只用于和下面的确认设置作比较,不会改变所需级别或应用・CLI 的确认。
- 在 Discord 里,所有者也可以用
/saba permission修改成员级别和默认级别。选择用户则是该成员的级别(在级别列表中选 Remove 会恢复为默认级别),不选用户则是默认级别。预设、会说话的 Saba-chan 上限和各命令的级别只能在应用里修改。
执行前再次确认
在 Discord 中请求的命令,执行前是否用按钮再次询问,在 Discord 服务器的 机器人设置 标签页的 确认 卡片中设置。只有发出请求的人才能按按钮。
| 项目 | 可选步骤 | 初始值 |
|---|---|---|
| 直接向机器人请求(前缀命令・斜杠命令) | 所有命令 · 注意及以上 · 仅危险命令 · 不询问 | 仅危险命令 |
| 会说话的 Saba-chan | 所有命令 · 注意及以上 · 仅危险命令 · 不询问 | 所有命令 |
- 会说话的 Saba-chan 选定的管理类操作,以及混有多人的请求,不论此设置如何都会询问。
- 应用・网页・CLI 不论此设置如何,都会对危险命令以及停止・重启进行询问。
- 在 CLI 中用
saba-chan-cli bot confirm查看和修改。
在 Discord 里试试
消息命令的顺序是 前缀 服务器 命令。前缀是命令开头的词。中文应用的默认前缀是 Saba-chan,可以在 Discord 服务器的 机器人设置 标签页的 命令前缀 中按 Discord 服务器分别修改或添加。
| 想做的事 | 发送内容 |
|---|---|
| 服务器列表和状态 | Saba-chan list |
| 启动 / 停止 / 状态 | Saba-chan mc start · Saba-chan mc stop · Saba-chan mc status |
| 查看用法 | Saba-chan help |
称呼服务器时,可以用服务器名称、在服务器界面的 Discord 标签页设置的称呼,以及该游戏只有一台服务器时的游戏名(例如 mc、minecraft)。同一个游戏有多台服务器时,请用服务器名称或为每台服务器设置的词来叫。危险命令不会通过游戏名执行,请用服务器名称或设置的词来叫。每台服务器还会有自己的 /服务器名 斜杠命令。
在同一个 机器人设置 标签页的 斜杠命令 中,可以设置是否像 /saba status 那样在命令前加上 saba(关闭后会直接显示为 /status)、服务器命令的名称使用服务器名称还是第一个称呼,以及查询结果是否只让发起者看到。
想在手机上用按钮更细致地管理,可以用 /mysaba web 打开 Saba-chan 网页。