3. Discord 連携
公式サバちゃんボットを接続し、Discord サーバーごとに扱うサーバーとコマンド権限を決めます。
3. Discord 連携
サバちゃんの Discord ボットは、サバちゃんクラウドで動く公式ボットです。ボットを自分で作ったりトークンを管理したりする必要はなく、ポート開放(外からの接続を PC に通すルーターの設定)もいりません。PC のサバちゃんが先にクラウドへ接続して、Discord のコマンドを受け取ってくるからです。
連携は三つのステップです。ボットを接続(ペアリング)し、Discord サーバーごとに扱うサーバーを選び、誰がどのコマンドを使えるかを決めます。
ステップ 1: ボットを接続する(ペアリング)
- アプリ上部の Discord 画面で接続を開き、
Discordサーバーを接続を押します。 - Discord サーバーにまだサバちゃんボットがいなければ、先に
ボットを招待で招待します。 - 接続コードと入力するコマンド(
/saba connect code:…)が出たらコピーを押します。 - Discord のチャット欄に貼り付けて送ります。このコマンドは、その Discord サーバーでサーバー管理権限を持つ人だけが使えます。
- サバちゃんを初めて使う Discord アカウントなら、ボットがまず登録を案内します。
登録するを押してウェブサイトで規約を確認して登録すると、その返信が接続の確認に切り替わります。コードはその間待っています。 - ボットが接続するかどうかを尋ねたら、
接続を押します。サバちゃんアプリで自分で受け取ったコードのときだけ押してください。他人から渡されたコードだと、その人の PC が自分のアカウントに接続されます。 - ボットが接続完了を知らせ、アプリも
接続済みに変わります。
コードは 5 分間だけ使えます。過ぎたら 新しいコードを取得 を押してください。一度接続した Discord アカウントなら、別の Discord サーバーではコードなしで /saba connect だけを送れば、自分のアカウントの PC がすべてその Discord サーバーにすぐつながります。この場合もその Discord サーバーのサーバー管理権限が必要で、こうしてつないだ Discord サーバーには最初はゲームサーバーが 1 つも表示されないので、アプリで開くサーバーを選んでください(下のステップ 2)。コードで接続した Discord サーバーは、アプリの Discord → 接続 画面の 新しい Discord サーバーに自分のサーバーをすぐ開く 設定に従います。
1 つの Discord アカウントに複数の PC を接続できます。すでに PC を接続したアカウントで新しいコードを送ると、ボットが 新しいPCとして接続 と <PC 名> を再接続 のボタンを出します。初めて接続する PC なら 新しいPCとして接続 を、以前に接続した PC をつなぎ直すならその PC を選んでください(その PC の以前の接続は切れます)。接続した PC は /mysaba my-pcs で確認し、名前の変更や削除ができます。
1 つの Discord サーバーにも複数の PC がつながれます。友だちが自分の PC を同じ Discord サーバーに接続すると、両方の PC のサーバーが一緒に表示され、コマンドはそのサーバーがある PC に届きます。サーバー名が重なると、あとからつないだ PC のサーバー名の後ろに -PC名 が付きます。言語、プレフィックス、うたうサバちゃん、チャンネル割り当てのような共通設定は、最初に接続した PC の持ち主と Discord サーバーのオーナーが変えます。各 PC のサーバーと権限は、その PC の持ち主が決めます。
ステップ 2: Discord サーバーごとに扱うサーバーを選ぶ
接続した Discord サーバーは Discord → Discordサーバーの一覧に出ます。一つ選ぶとタブが開きます。
インスタンスタブで、この Discord サーバーが扱うゲームサーバーを決めます。インスタンスとは、サバちゃんに登録した 1 台のゲームサーバーです。
- すべてのインスタンス: いまあるサーバーも、これから作るサーバーもすべて見えます。
- 選んだものだけ: オンにしたサーバーだけが、この Discord サーバーで見えて操作できます。友達のグループごとに別のサーバーを任せたいときに使います。
許可していないサーバーは、その Discord サーバーのコマンド、一覧、スラッシュコマンドのどこにも出ません。
ステップ 3: コマンド権限を決める
権限レベルは五段階です。レベルは累積で、上のレベルは下のレベルが使えるコマンドをすべて使えます。
| レベル | 誰 |
|---|---|
| オーナー (3) | この Discord サーバーを接続した人。すべてのコマンドを使え、降格されません |
| 管理者 (2) | 危険なコマンドまで任せる人 |
| ユーザー (1) | サーバーの起動・停止くらいを任せる人。最初は全メンバーの既定レベルです |
| ゲスト (0) | 状態の確認のような安全なコマンドだけを使える人 |
| 禁止 (-1) | うたうサバちゃんとおしゃべりサバちゃんを含め、ボットの機能をまったく使えません |
権限は インスタンス タブでサーバー(インスタンス)をクリックして開きます。すべてのインスタンスの権限 を押すと、すべてのサーバーをまとめて見られます。画面は二つあります。
- レベル別コマンド: コマンドがチップとして置かれた階段です。チップは、そのコマンドを使える最も低いレベルに置かれます。チップを別の段へドラッグするかクリックして、必要なレベルを変えます。上の コマンドプリセット(ゆるめ・標準・厳しめ)は、コマンドを危険度(安全・注意・危険)に従ってまとめて置きます。標準プリセットは、安全 = ゲスト、注意 = ユーザー、危険 = 管理者です。プリセットを変えると、個別に移したチップもプリセットどおりに戻ります。下の おしゃべりサバちゃんの上限 は、おしゃべりサバちゃんを通した依頼が超えられないレベルです(最初はゲスト)。
- メンバー別レベル: 既定のレベル(レベルを個別に持たないメンバーが従うレベル)を決め、メンバーごとにレベルを付けます。
レベルを編集で、レベル名を変えたり段を追加したり順番を変えたりできます。
メンバーのレベルとプリセットは、この Discord サーバーのすべてのサーバーに共通で適用されます。サーバー全体のコマンド(特定のサーバーに属さないコマンド)を移すと、すべてのサーバーの権限画面で一緒に変わります。ヘルプと一覧は、禁止でなければ誰でも使えます。
- チップをクリックして開くウィンドウで、Discord の聞き返し の段階(安全・注意・危険)もコマンドごとに変えられます。この段階は下の聞き返しの設定と比べるときだけ使われ、必要なレベルやアプリ・CLI の確認は変わりません。
- Discord でも、オーナーは
/saba permissionでメンバーのレベルと既定のレベルを変えられます。ユーザーを選ぶとそのメンバーのレベルで(レベル一覧の 解除 を選ぶと既定のレベルに戻ります)、ユーザーを空にすると既定のレベルです。プリセット、おしゃべりサバちゃんの上限、コマンドごとのレベルはアプリでだけ変えます。
実行前に聞き返す
Discord で頼んだコマンドを実行する前にボタンで聞き返すかどうかは、Discord サーバーの ボット設定 タブの 聞き返し カードで決めます。ボタンを押せるのは頼んだ人だけです。
| 項目 | 選べる段階 | 最初の値 |
|---|---|---|
| ボットへの直接の依頼(プレフィックスコマンド・スラッシュコマンド) | すべてのコマンド · 注意以上 · 危険なコマンドのみ · 聞かない | 危険なコマンドのみ |
| おしゃべりサバちゃん | すべてのコマンド · 注意以上 · 危険なコマンドのみ · 聞かない | すべてのコマンド |
- おしゃべりサバちゃんが選んだ管理系の作業と、複数の人が混ざった依頼は、この設定にかかわらず必ず聞き返します。
- アプリ・ウェブ・CLI は、この設定にかかわらず危険なコマンドと停止・再起動を確認します。
- CLI では
saba-chan-cli bot confirmで確認・変更します。
Discord で使ってみる
メッセージコマンドは プレフィックス サーバー コマンド の順です。プレフィックスとは、コマンドの先頭に付ける言葉です。日本語で応答する Discord サーバーの既定のプレフィックスは サバちゃん で、Discord サーバーの ボット設定 タブの コマンドプレフィックス で、Discord サーバーごとに変えたり追加したりできます。
| やりたいこと | 送る言葉 |
|---|---|
| サーバーの一覧と状態 | サバちゃん list |
| サーバーの起動 / 停止 / 状態 | サバちゃん mc start · サバちゃん mc stop · サバちゃん mc status |
| 使い方を見る | サバちゃん help |
サーバーの呼び方には、サーバー名、サーバー画面の Discord タブで決めた呼び名、そしてそのゲームのサーバーが 1 つだけならゲーム名(例: mc、minecraft)が使えます。同じゲームのサーバーが複数あるときは、サーバー名かサーバーごとに決めた言葉で呼んでください。危険なコマンドはゲーム名では実行しないので、サーバー名か決めた呼び名で呼んでください。サーバーごとに /サーバー名 のスラッシュコマンドもできます。
同じ ボット設定 タブの スラッシュコマンド で、/saba status のようにコマンドの前に saba を付けるか(オフにすると /status のようにそのまま表示されます)、サーバーコマンドの名前をサーバー名と最初の呼び名のどちらにするか、照会結果を呼び出した人にだけ見せるかを決めます。
スマホからボタンでもっと細かく操作するには、/saba web でサバちゃんウェブを開きます。