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 上限 是經過會說話的 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 網頁。