Botの一覧と新規作成

Bot 一覧に専用のページはありません。ログイン後に表示されるホーム画面(ダッシュボードのトップ) にそのまま表示されます。

プロジェクトとBotの関係

Bot 一覧は、画面上部で選択中のプロジェクトごとに表示されます。BotShade では、Bot を「プロジェクト」という単位でまとめて管理します。

Bot が見当たらない場合は、まずプロジェクト選択メニューで選んでいるプロジェクトを確認してください。プロジェクトが 1 つも選択されていない状態では、Bot の表示も作成もできません。プロジェクトがまだない場合は、先にプロジェクトを作成してください。

一覧の見方

一覧には、各 Bot がカード(またはリストの行)として表示されます。

表示項目	内容
アイコン	Bot のアイコン画像
Bot 名	Bot の名前
稼働ステータス	現在の状態
プロジェクト名	その Bot が属するプロジェクト。未割り当ての場合は「未割り当て」
コマンド	登録されているコマンドの数
エラー率	直近 24 時間のエラーの割合(%)
p95	直近 24 時間の応答時間の目安(95% のリクエストがこの時間内に収まる値。ミリ秒または秒で表示)
最新ログ	直近の動作ログ 1 件と、その発生からの経過時間

直近 24 時間にエラーが発生している場合は、その件数もあわせて表示されます。

稼働ステータスの種類

表示	意味
「オンライン」	Bot が正常に稼働しています
「起動中」	Bot を起動している最中です
「停止中」	Bot が一時停止しています
「失敗」	起動や稼働に失敗しました
「停止」	Bot が停止しています
「不明」	状態を取得できませんでした

「起動中」の Bot は状態が自動で更新され、しばらく待つと「オンライン」などの確定した状態に変わります。

表示の切り替え・検索・並び替え

表示方法の切り替え

パソコンでは、グリッド表示(カード形式)とリスト表示を切り替えられます。リスト表示では、Bot の ID を含めた各項目が 1 行にまとめて表示されます。

検索

検索ボックスに Bot 名または Bot の ID を入力すると、一致する Bot だけが絞り込まれて表示されます。

並び替え(ソート)

「ソート」ボタンから、Bot 名・ID・プロジェクト・作成日のいずれかで並び替えられます。同じ項目をもう一度選ぶと、昇順と降順が切り替わります。

Botカードのメニュー

各 Bot の「︙」メニューから、ログ・コマンドビルダー・イベントビルダー・サーバー一覧の各画面へ移動できます。カード本体(メニュー以外の部分)をクリックすると、その Bot の詳細画面が開きます。

「サーバーに招待」: Bot をサーバーに招待するための Discord のページを開きます。招待用のリンクが用意されている Bot でのみ選択できます。
「プロジェクトに移動」: 移動先のプロジェクトを選んで「確定」をクリックすると、Bot が別のプロジェクトに移動します。プロジェクトから外したい場合は「プロジェクトから解除」を選びます。

新しいBotを作成する

新しい Bot の作成は、Discord Developer Portal(Discord の開発者向けサイト)での操作を含む7 ステップのガイドに沿って進めます。

ベータ版では、1 アカウントにつき Bot を最大 1 台までしか作成できません。すでに 1 台作成している場合、作成メニューは「Bot(上限に達しました)」と表示され、選択できなくなります。

作成画面を開く

プロジェクトを選ぶ

画面上部のプロジェクト選択メニューで、Bot を作成したいプロジェクトを選びます。プロジェクトを選んでいないと Bot を作成できません。

「新規作成...」をクリックする

パソコンでは画面右上の「新規作成...」ボタンをクリックし、表示されるメニューから「Bot」を選びます。スマートフォンでは、検索ボックスの横にある「+」アイコンをタップし、メニューから「Bot」を選びます。

まだ Bot が 1 台もない場合は、一覧の代わりに表示される「最初のBotを作成」ボタンからも作成画面を開けます。

7ステップのガイド

作成画面が開いたら、次の手順で進めます。

Step 1: Discord Developer Portalを開く

「Discord Developer Portalを開く」ボタンをクリックすると、ブラウザの新しいタブで Discord の開発者向けサイトが開きます。

Step 2: アプリケーションの作成

Discord Developer Portal の画面右上にある「New Application」ボタンをクリックし、Bot の名前を入力して作成します。作成できたら、BotShade の画面に戻って「次へ」をクリックします。

Step 3: Botセクションの選択

Discord Developer Portal の左側のメニューから「Bot」を選びます。

Step 4: Intentsの有効化

「Privileged Gateway Intents」(特権インテント)というセクションまで画面をスクロールし、3 つの項目をすべて ON にします。ON にしたら、BotShade の画面で対応する 3 つのチェックボックスにチェックを入れます。

「PRESENCE INTENT をONにしました」
「SERVER MEMBERS INTENT をONにしました」
「MESSAGE CONTENT INTENT をONにしました」

3 つすべてにチェックを入れるまで「次へ」ボタンはクリックできません。1 つでも ON になっていないと、Bot の作成や起動に失敗します。

Step 5: Tokenのリセット

Discord Developer Portal の「Build-A-Bot」セクションにある「Reset Token」ボタンをクリックして、Bot トークン(Bot を動かすための鍵となる文字列)を生成します。

Step 6: Tokenのコピー

画面に表示されたトークンをコピーします。

Step 7: Tokenの入力と作成

「Botトークン」の入力欄に、コピーしたトークンを貼り付けます。次に「BotShadeによるAPIアクセスを許可し、利用規約に同意します」のチェックボックスにチェックを入れ、「作成」ボタンをクリックします。トークンが入力され、同意のチェックが入っていないと「作成」はクリックできません。

Discord のトークンは「Reset Token」をクリックした直後に一度しか表示されません。必ずコピーしてから Discord の画面を閉じてください。閉じてしまった場合は、もう一度「Reset Token」をクリックして新しいトークンを生成し直してください。

入力したトークンは強力な暗号化によって安全に保管されますが、トークンそのものを第三者と共有しないでください。トークンが漏えいすると、Bot を乗っ取られる恐れがあります。

手順を把握している場合

すでに Discord 側の準備が済んでいる場合や、操作に慣れている場合は、作成画面下部の「Token 入力へスキップ →」をクリックすると、Step 1〜6 を飛ばして Step 7(トークンの入力)へ直接移動できます。

作成に失敗したときの対処

「作成」をクリックしたあとにエラーが表示された場合は、内容に応じて次のように対処してください。

エラーの内容	対処方法
Tokenが不正です	トークンを正しくコピーできているか確認し、もう一度貼り付け直してください。不安な場合は「Reset Token」でトークンを生成し直します。
既に該当のBotは存在します	その Bot はすでに BotShade に登録されています。一覧で確認してください。
特権インテントが不足しています	不足しているインテント名と「Discord Developer Portalで確認」リンクが表示されます。リンク先の Bot 設定で、そのインテントを ON にしてください。
Bot作成上限に達しています	ベータ版の作成上限(1 台)に達しています。新しく作るには既存の Bot を整理する必要があります。