3. Discord 联动

连接官方 Saba-chan 机器人,并为每个 Discord 服务器设置可用的服务器和命令权限。

3. Discord 联动

Saba-chan Discord 机器人是运行在 Saba-chan 云端的官方机器人。你不需要自己创建机器人或管理令牌,也不需要端口转发(路由器的一项设置,用来把外部连接转交给你的电脑)。电脑上的 Saba-chan 会主动连接云端,把 Discord 命令取回来。

联动分三步:连接机器人(配对),为每个 Discord 服务器选择可用的服务器,再决定谁能用哪些命令。


第 1 步:连接机器人(配对)

Saba-chan
服务器Discord设置
守护进程机器人已关闭
连接未连接
Discord 服务器
基本设置
连接 Discord获取一个代码并在你的 Discord 服务器中输入即可。连接后,就能在该服务器中通过机器人启动和停止游戏服务器。
连接 Discord 服务器邀请机器人
#综合我们的服务器
kimchi12:00
机器人邀请好了!
给 #综合 发消息
  1. 在应用上方的 Discord 页面打开连接,点 连接 Discord 服务器。
  2. 如果 Discord 服务器里还没有 Saba-chan 机器人,先用 邀请机器人 邀请进来。
  3. 出现连接代码和要输入的命令(/saba connect code:…)后,点 复制。
  4. 粘贴到 Discord 聊天框发送。只有在该 Discord 服务器拥有管理服务器权限的人才能使用这条命令。
  5. 如果是第一次使用 Saba-chan 的 Discord 账号,机器人会先引导你注册。点 注册,在网站上确认条款并注册后,那条回复会变成连接确认。代码会在这期间等待。
  6. 机器人询问是否连接时,点 连接。只有代码是你在 Saba-chan 应用里亲自获取的才可以点。如果是别人给你的代码,那个人的电脑就会连接到你的账号。
  7. 机器人会告知连接完成,应用也会变成 已连接。

代码只在 5 分钟内有效。过期后请点 获取新代码。已经连接过的 Discord 账号,在其他 Discord 服务器上可以不带代码只发送 /saba connect,这样我账号下的所有电脑都会立即连接到那个 Discord 服务器。这时同样需要该 Discord 服务器的管理服务器权限;这样连接的 Discord 服务器起初一台游戏服务器都看不到,请在应用里选择要开放的服务器(见下面的第 2 步)。用代码连接的 Discord 服务器,遵循应用 Discord → 连接 界面中的 对新 Discord 服务器直接开放我的服务器 设置。

一个 Discord 账号可以连接多台电脑。用已经连接过电脑的账号发送新代码时,机器人会显示 作为新电脑连接 和 重新连接 <电脑名> 按钮。第一次连接的电脑选 作为新电脑连接;如果是重新连接以前连过的电脑,就选那台电脑(它以前的连接会断开)。已连接的电脑可以用 /mysaba my-pcs 查看、改名或删除。

一个 Discord 服务器也可以接入多台电脑。朋友把自己的电脑连接到同一个 Discord 服务器后,两台电脑的服务器会一起显示,命令会发到拥有该服务器的电脑。服务器名称重复时,后接入的电脑的服务器名称后会加上 -电脑名。语言、前缀、音乐、频道分配等共同设置,由最先连接的电脑的主人和 Discord 服务器的所有者修改。每台电脑的服务器和权限由那台电脑的主人决定。


第 2 步:为每个 Discord 服务器选择服务器

连接好的 Discord 服务器会出现在 Discord → Discord 服务器列表里。选中一个就会打开标签页。

Saba-chan
服务器Discord设置
守护进程机器人在线
连接已连接
Discord 服务器
G我们的服务器
基本设置
我们的服务器
实例成员命令称呼频道机器人设置
此 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 网页。