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 上限 是經過會說話的 Saba-chan 的請求無法超過的等級(一開始是訪客)。
  • 各成員等級:設定預設等級(沒有單獨設定等級的成員所依循的等級),並給每個成員等級。在 編輯等級 中可以變更等級名稱、增加階段並更改順序。

成員等級與預設組會同時套用到此 Discord 伺服器的所有伺服器。移動伺服器全域指令(不屬於特定伺服器的指令)時,所有伺服器的權限畫面也會一併改變。說明與清單只要不是禁止,任何人都能使用。

  • 在點選標籤開啟的視窗中,也可以依指令變更 Discord 再確認 階段(安全、注意、危險)。這個階段只用於和下方的再確認設定比較,不會改變所需等級,也不會改變應用程式與 CLI 的確認。
  • 在 Discord 裡,所有者也可以用 /saba permission 修改成員等級和預設等級。選擇使用者時是該成員的等級(在等級清單中選 解除 會回到預設等級),不選使用者則是預設等級。預設組、會說話的 Saba-chan 上限和各指令的等級只能在應用程式裡修改。

執行前再確認

在 Discord 拜託的指令,執行前是否再用按鈕詢問,在 Discord 伺服器的 機器人設定 分頁的 再確認 卡片中設定。按鈕只有提出請求的人能按。

項目可選擇的階段初始值
直接對機器人的請求(前綴指令、斜線指令)所有指令 · 注意以上 · 僅危險指令 · 不詢問僅危險指令
會說話的 Saba-chan所有指令 · 注意以上 · 僅危險指令 · 不詢問所有指令
  • 會說話的 Saba-chan 選出的管理作業,以及多人混在一起的請求,無論此設定如何都一定會詢問。
  • 應用程式、網頁、CLI 無論此設定如何,都會對危險指令與停止、重新啟動進行詢問。
  • 用 CLI 時,以 saba-chan-cli bot confirm 查看與變更。

在 Discord 裡試試

#一般我們的伺服器

訊息指令的順序是 前綴 伺服器 指令。前綴是指令開頭的詞。以中文回覆的 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 直接顯示)、伺服器指令名稱要用伺服器名稱還是第一個稱呼詞,以及查詢結果是否只讓呼叫的人看到。

想在手機上用按鈕更細緻地管理,可以用 /saba web 開啟 Saba-chan 網頁。