コマンドビルダーの概要と使い方

コマンドビルダーは、ブロック(ノード)を線でつなぐだけで、プログラミングの知識がなくてもオリジナルのスラッシュコマンドを組み立てられるビジュアルエディタです。「ユーザーがこのコマンドを実行したら → こう動く」という流れを、エディタの開き方から保存までの基本操作とあわせて、画面上で目に見える形で作っていきます。

コマンドビルダーとは

ふつう、Discord の Bot にコマンドを追加するにはプログラムを書く必要があります。コマンドビルダーは、その代わりに「ブロックを置いて、線でつなぐ」という直感的な操作でコマンドの動きを作れるしくみです。

• ノード(ブロック) … 1 つひとつの動作や条件を表す箱です。たとえば「メッセージを送信」「ロール付与」「比較による条件分岐」などがあります。
• エッジ(線) … ノードどうしをつなぐ線です。線でつないだ順番に、上から下へと動作が実行されていきます。

つまり「スラッシュコマンドが実行されたら、まずメッセージを送って、次にロールを付ける」といった流れを、ブロックと線で表現するわけです。

エディタを開く

画面の構成

エディタは大きく 4 つの領域でできています。

上部ヘッダーの操作

ヘッダーには、左から順に次の操作が並んでいます。

コマンド切替セレクター

ヘッダー中央のセレクターをクリックすると、コマンドの一覧がポップアップで開きます。

• 上部の「コマンドを検索…」に文字を入力すると、コマンドを絞り込めます。
• 一覧からコマンドを選ぶと、そのコマンドの編集画面へ切り替わります。
• 「新規コマンド」をクリックすると、新しいコマンドの編集を始められます。

最終保存の表示と保存状態

保存ボタンの左の表示は、保存状態に応じて次のように変わります。

左サイドバーの 5 つのパネル

画面左端のアイコンをクリックすると、その内容のパネルが横に開きます。利用できるパネルは次の 5 つです。

「解析」アイコンには、未解決のエラーや警告があるときに件数のバッジ(赤または黄色の小さな丸)が付きます。

ブロックパネルの 4 カテゴリ

「ブロック」パネルのカテゴリは次の 4 つです。

タブを切り替えると、そのカテゴリのブロックが小カテゴリ(「メッセージ応答」「ロール操作」など)ごとに並びます。目的のブロックが見つからないときは、上部の「検索…」にブロック名の一部を入力すると一覧を絞り込めます。該当がない場合は「検索結果がありません…」と表示されます。

ノードの追加方法

ブロックは 2 通りの方法でキャンバスに追加できます。

ノードのつなぎ方

ノードどうしは、ノードの縁にある小さな丸い「接続点(ハンドル)」を線でつないで連結します。

線でつないだ順序が、コマンドが実行されたときの動作の順番になります。

起点となる 2 つの固定ノード

エディタを開いた時点で、すでに次の 2 つのノードが置かれています。

コマンドの基本の流れは、まず「スラッシュコマンド」ノードを選んで、右パネルでコマンド名と説明を入力するところから始めます(Discord 上で表示されるコマンド名になります)。

ノードの編集

ノードの細かい設定は、右側の設定パネルで行います。

ノードの複製・削除

選択中のノードは、右パネルの下部にあるボタンから操作できます。

「スラッシュコマンド」「エラーハンドラー」などの固定ノードや、条件分岐・ループに自動で付いてくる枝(分岐の合流点など)は、単独では複製・削除できません。これらのボタンがクリックできない(うすく表示される)場合は、その種類のノードが対象であることを意味します。条件分岐やループの親ノードを削除すると、それに付いている枝もまとめて削除されます。

やり直し操作

操作を間違えたときは、キーボードショートカットで元に戻したり、やり直したりできます。

キャンバスの操作

中央のキャンバスは自由に拡大・移動できます。

• ズーム … マウスホイールや、キャンバス上のコントロールボタンで拡大・縮小します。
• 移動(パン) … 何もない場所をドラッグすると、表示範囲を動かせます。
• ノードを整列 … キャンバス右上のコントロールにある「ノードを整列」ボタンをクリックすると、ノードが自動で見やすく並べ直されます。条件分岐は「条件が成立したときの枝」「成立しなかったときの枝(Else)」「合流点」の順に左から右へ整列します。

グリッドと背景の設定

ヘッダーの歯車アイコンから開く「設定」モーダルで、キャンバスの表示を細かく調整できます。グリッドや背景のほか、ミニマップやノードの説明文を表示するかどうかも切り替えられます。

設定し終えたら、モーダル下部の「閉じる」をクリックします。

保存と未保存警告

編集した内容は、ヘッダー右側の保存ボタン(フロッピーのアイコン)をクリックすると保存されます。

• 未保存の編集があるときは、保存ボタンの右上に赤い丸が付きます。表示も「未保存の変更」に変わります。
• 保存に成功すると赤い丸は消え、「最終保存: たった今」と表示されます。

解析パネルでエラー・警告を確認する

コマンドを作っている途中で、設定の不足や問題がないかを「解析」パネルで確認できます。

解析にエラーが残っていると、コマンドが正しく動かない原因になります。保存する前に、エラーが 0 件になっているか確認することをおすすめします。

操作の流れ(まとめ)

作ったコマンドが実行されるときの流れ

保存したコマンドは、Discord 上でスラッシュコマンドとして実行できるようになります。ユーザーがコマンドを実行すると、Bot は「スラッシュコマンド」ノードを起点に、線でつないだノードを順番にたどっていきます。

条件分岐(If)の動き

条件ブロックは、つないだ枝のうち成立した方へ進みます。動き方には次のような特徴があります。

• 条件が成立すると「成立したときの枝」へ、成立しなければ「成立しなかったときの枝(Else)」へ進みます。
• 分岐の合流点(条件のあとに必ず通る枝)は、どちらの枝を通ったあとでも実行されます。
• 確率による分岐(チャンス)を複数並べた場合は、それぞれに設定した確率(0〜100%)に応じて、どれか 1 つがくじ引きのように選ばれます。確率の合計が 100% に満たないときは、残りの割合のぶんだけ「成立しなかったときの枝(Else)」へ進みます。つまり、確率分岐だけで作ると、同じコマンドを実行しても結果が毎回変わることがあります。
• 条件の判定中に問題が起きた場合は、その条件は「成立しなかった」ものとして扱われ、コマンド全体が止まらないようになっています。

ループ(反復処理)の動き

ループブロックは、中身を指定した回数だけくり返します。

• くり返しの中では、回数を表す値を変数として参照できます。今が何回目かを表す {ループ変数.count}(1 から数えた回数)と {ループ変数.index}(0 から数えた番号)が使えます。
• くり返し回数が 0 以下や正しく数値にならない値だった場合は、中身は実行されず、ループのあとの流れへ進みます。
• ループの中身は順番に実行され、メッセージ送信などの結果がくり返しのぶんだけ積み重なります。

ボタン・選択メニューを付けたメッセージ

メッセージ送信ブロックにボタンや選択メニューを付けると、そのメッセージは「ユーザーの操作を待つ」状態になります。

• ユーザーがボタンをクリックしたり、選択メニューを選んだりすると、その操作に対応する枝へ進みます。選択メニューの選択結果は変数として受け取れます。
• 一定時間ユーザーが操作しなかった場合は、ボタンや選択メニューが押せない状態(うすい表示)になり、その先の処理は進みません。

上限とクールダウン

作ったコマンドが無限に動き続けたり、重くなりすぎたりしないように、実行時にはいくつかの上限が設けられています。

クールダウン

コマンドごとに、連続実行を防ぐクールダウンを設定できます。

• クールダウンは「クールダウンを有効にする」設定をオンにし、時間(0 より大きい値)を指定したときだけ有効になります。単位は秒・分・時間から選べます。
• クールダウンはユーザーごと・コマンドごとに管理されます。誰かが実行しても、ほかのユーザーのクールダウンには影響しません。
• クールダウン中のユーザーが実行しようとすると、残り時間が秒単位で知らされ、コマンドは実行されません。
• クールダウンは Bot の再起動までの一時的なものです(再起動するとリセットされます)。

オプション(入力項目)の扱い

コマンドに入力項目(オプション)を付けると、ユーザーは実行時に値を入力できます。入力された値は、メッセージや条件の中で変数として使えます。

• ユーザーが入力した値は、設定した初期値より優先されます。
• 必須でない項目をユーザーが入力しなかった場合、初期値を設定していればその値が使われます。初期値もない場合は空の値として扱われます。
• ユーザー・ロール・チャンネル・添付ファイルを受け取る項目は、それぞれ名前やメンション、ID などの情報を持つまとまり(オブジェクト)として扱われ、{項目名.mention}・{項目名.name}・{項目名.id} のように個別の情報を取り出せます。メッセージ内では、ユーザーのメンションは <@ユーザーID>、ロールは <@&ロールID>、チャンネルは <#チャンネルID> の形で表示されます。
• 選択肢(候補から選ぶ項目)に同じ値を重複して登録した場合は、最初の 1 つだけが残り、重複は自動的に取り除かれます。

変数の扱い

コマンドの中では、一時的に値を覚えておく変数を使えます。

• 変数の作成・更新は、変数を設定するブロックで行います。同じ名前で設定し直すと、前の値は上書きされます。
• 計算結果を変数に入れることもできます。メッセージの中で {変数名} のように書くと、その値が差し込まれて表示されます。
• 永続変数(BSVAR_ で始まる、保存され続ける変数)は、コマンドの実行開始時点の値が読み取り専用で使えます。コマンドの実行中に永続変数を新しく作ることはできません。
• メッセージや式の中で存在しない変数を参照した場合は、エラーで止まるのではなく空の値として扱われ、処理は続きます。

表示されるメッセージ

コマンドが実行されなかったときや、途中で止まったときには、本人にだけ見えるメッセージ(他の人には見えません)で理由が知らされます。Bot が表示する文言は次のとおりです。

注意点・うまくいかないとき

実行時にうまく動かないときは、次の点を確認してみてください。

• 無効化したコマンドは実行できません。 コマンドを無効にすると、Discord のスラッシュコマンド一覧から外れます。無効にしたコマンドが実行された場合は このコマンドは利用できません。 と表示されます。
• 実行順は線のつながりで決まります。 ノードがどこに置かれているかではなく、線でどうつながっているかで実行順が決まります。どこからも線がつながっていない孤立したノードは、実行されません。
• 30 秒以内に終わるように作ります。 待機ブロックを長く入れすぎたり、ループの中で重い処理を多くくり返したりすると、上限を超えてタイムアウトすることがあります(上の上限表も踏まえて組み立ててください)。
• 確率分岐は結果が毎回変わります。 チャンスによる分岐を使うと、同じコマンドでも実行のたびに通る枝が変わります。意図した割合になっているか確認してください。
• 権限はサーバー内でのみ判定されます。
• 式の計算でエラーが起きたときは、その部分は計算されずに書いたままの文字として残り、コマンド全体は止まらずに続きます。意図した値が表示されないときは、式の書き方を見直してください。

コマンドの実行権限

作ったコマンドを誰が実行できるかは、コマンドごとに細かく決められます。

• コマンドごとに権限を設定でき、設定がない場合はカスタムコマンド全体の既定の権限設定が使われます。
• 管理者権限を持つメンバーは、通常は権限の確認を通り越してコマンドを実行できます(コマンド側で厳格な権限設定を選んだ場合を除きます)。
• 権限は、ロールや Discord の権限による「許可リスト」「拒否リスト」で指定できます。拒否リストに当てはまると実行できず、許可リストに当てはまると実行できます。
• 権限がないユーザーが実行しようとすると Botの権限設定により、このコマンドを実行する権限がありません。 と表示され、コマンドは実行されません。

次のステップ / 関連ページ

• ストレージ — コマンドで使うデータの保存場所について
• レベリング — 既製のモジュール機能を使う場合