Bot 概要(ステータス・起動/停止・設定)

「概要画面」は、ダッシュボードで作成済みの Bot をクリックすると開きます。Bot をまだ作っていない方は、先に最初の Bot を作成するをご覧ください。

画面の構成

概要画面には、上から順に次のセクションが並びます。

セクション	内容
Bot の基本情報	「Application ID」「内部システム識別子」「作成日時」「最終更新」を表示。ID はコピー可能
「権限と招待リンク」	サーバーへの招待リンクを生成し、付与する権限を選びます
「ランタイムステータス」	Bot の稼働状態・統計を確認し、起動/停止などの操作を行います
「Bot設定」	プロフィール(名前・アイコン)、特権インテント、ステータスを設定します
「デンジャーゾーン」	Bot の削除やトークン変更を行う、取り消せない重要操作です

設定を変更すると、画面下部に未保存の変更を知らせる帯が表示されます。詳しくは変更の保存をご覧ください。

Bot の基本情報

項目	説明
Application ID	Discord 上のアプリケーション ID です。招待リンクなどで使われます
内部システム識別子	BotShade 内部で Bot を管理するための ID です
作成日時	この Bot を BotShade に登録した日時です
最終更新	Bot の情報が最後に更新された日時です

「Application ID」と「内部システム識別子」は、コピーアイコンからクリップボードにコピーできます。

権限と招待リンク

作成した Bot を実際の Discord サーバーで動かすには、必要な権限を選んだ招待リンクを作成し、サーバーに追加します。

権限プリセット

最初は「権限プリセット」から選ぶのが簡単です。次の 4 つが用意されています。ボタンをクリックすると、その用途に合った権限がまとめて選択されます。

プリセット	主な用途
「基本」	チャンネルの閲覧・メッセージ送信・埋め込み・ファイル添付・履歴閲覧など、基本的な動作に必要な権限
「モデレーター」	基本の権限に加え、メッセージ管理・Kick・Ban・Timeout などモデレーション向けの権限
「管理者」	管理者権限(すべての操作が可能になる権限)
「音楽」	チャンネル閲覧・メッセージ送信・埋め込みに加え、ボイスチャンネルへの接続・発言など音楽用の権限

個別に権限を選ぶ

プリセットだけでなく、権限を 1 つずつ細かく選ぶこともできます。「詳細権限設定」を使います。

権限は「一般」「テキスト」「音声」「メンバー管理」のカテゴリーに分かれて一覧表示されます。
各権限のチェックボックスをオン/オフして選びます。プリセットで選んだ状態から追加・削除することもできます。
探したい権限がある場合は、「権限を検索...」の欄に権限名(例: メッセージ)を入力すると絞り込めます。

招待リンクをコピーして招待する

権限を選ぶ

「権限プリセット」のいずれか、または「詳細権限設定」で必要な権限にチェックを入れます。選んだ内容に合わせて「生成された招待リンク」の URL が自動的に作られます。

招待リンクをコピーする

「生成された招待リンク」の横にある「コピー」をクリックします。

Discord でサーバーに招待する

コピーしたリンクをブラウザのアドレスバーに貼り付けて開きます。Discord の画面で Bot を追加したいサーバーを選び、表示された権限を確認して認証すると、Bot がサーバーに追加されます。

招待リンクには、生成した時点で選んでいた権限が含まれます。権限を変えたいときは選び直し、新しいリンクで招待し直してください。招待手順の詳細は Bot を Discord サーバーに招待するをご覧ください。

ランタイムステータス

「ランタイムステータス」セクションでは、Bot が今どのような状態で動いているかを確認できます。

稼働状態と統計の見方

セクション上部の「コンテナ状態」に、現在の状態が表示されます。状態には次のものがあります。

表示	意味
オンライン	正常に稼働しています
起動中	起動処理を行っています
再起動中	再起動処理を行っています(最大 90 秒)
停止処理中	停止処理を行っています
一時停止	一時停止の状態です
失敗	起動に失敗しました(下部に対処の案内が出ます)
停止	停止しています
一時的な問題	一時的に状態を取得できません(しばらく待って再試行してください)
存在しません	Bot が見つかりません
取得中 / 不明	状態を取得中、または取得できていません

その下には、4 つの統計が並びます。

項目	内容
「サーバー」	Bot が参加しているサーバー数
「ユーザー」	Bot が見ているユーザー数
「WS遅延」	Discord との常時接続(WebSocket)における通信遅延(ミリ秒)
「API遅延」	Discord API への応答遅延(ミリ秒)

数値が「-」になっている場合は、まだデータが取得できていないか、Bot が停止していることを意味します。

起動・停止・再起動・強制停止

統計の下に、操作ボタンが「起動」「停止」「再起動」「強制停止」の順に並んでいます。

操作ボタンをクリックする

「起動」「停止」「再起動」「強制停止」のうち、行いたい操作のボタンをクリックします。

確認ダイアログで実行する

確認ダイアログが開くので、ダイアログ内のボタンをクリックすると実行されます。

状態が落ち着くまで待つ

実行後はコンテナ状態が「起動中」「停止処理中」「再起動中」などに変わり、その後は自動的に最新の状態が反映されます。

ボタンは、その状態でできない操作のときはクリックできなくなります(例: すでにオンラインのときは「起動」、停止中のときは「停止」「強制停止」が無効になります)。

「強制停止」は Bot のプロセスを即座に終了させます。通常は「停止」をご利用ください。「強制停止」は、「停止」をクリックしても止まらないときなどに使う最終手段です。

再起動について

「再起動」は、コンテナ状態が「オンライン」または「失敗」のときにクリックできます。それ以外の状態(起動中や停止中など)では、状態が落ち着くまでボタンが無効になります。90 秒を過ぎても完了しないときは、いったん「停止」→「起動」を試すか、失敗ログを確認してください。

起動に失敗したとき

起動に失敗すると、「ランタイムステータス」のすぐ上に「起動に失敗しました」と書かれた赤い案内が表示されます。失敗の理由ごとに、原因と対処の方法が示されます。

失敗の理由(表示例)	対処
Discord トークンが無効です	「トークンを再入力」ボタンからトークンを入力し直します
Privileged Intents が Discord Developer Portal で有効化されていません	Discord Developer Portal 側で特権インテントを有効にします
サーバー数が 2500 を超えました	プランのアップグレードが必要です
Discord の起動回数制限に達しました	24 時間後に自動的に再試行されます(操作は不要)
キャパシティ満杯のため起動できません	自動的に再試行されます(操作は不要)
起動を 5 回試行しましたが失敗しました	「再試行」ボタンで再度起動を試みます
Bot プロセスが繰り返し起動失敗しました / IP がブロックされましたなど	サポートへのお問い合わせが案内されます

Bot設定

「Bot設定」セクションでは、Bot のプロフィール・特権インテント・ステータスを設定できます。

プロフィール設定(名前・アイコン)

「プロフィール設定」では、Bot のアイコンと名前を変更できます。

アイコンを変更する

アイコン画像、またはその下の「変更」をクリックすると、画像を選ぶ画面が開きます。画像を選ぶとトリミング(切り抜き)画面が表示され、範囲を確定すると新しいアイコンが保存されます。設定済みのアイコンは、隣の削除ボタンから消せます。

Bot 名を変更する

「Bot名」の入力欄に新しい名前を入力します(プレースホルダーは「Bot名を入力...」、最大 32 文字)。入力したら横の「保存」ボタンをクリックすると反映されます。名前が今と同じ場合や空欄の場合は「保存」はクリックできません。

Discord から取り込む

「Discordから同期」をクリックすると、名前・アイコンが Discord 側の内容に更新されます。

名前・アイコンの変更は Discord API を通じて行われるため、反映までに時間がかかる場合があります。

特権インテント設定

「特権インテント設定」では、Discord の特権ゲートウェイインテント(Privileged Gateway Intents)を項目ごとに ON / OFF で切り替えます。

項目	用途の目安
「プレゼンスインテント」	メンバーのオンライン状態などを扱う機能で必要です
「サーバーメンバーインテント」	メンバー一覧や参加・退出を扱う機能で必要です
「メッセージコンテントインテント」	メッセージ本文を読み取る機能で必要です

切り替えたあとは変更の保存が必要です。

特権インテントは、Discord Developer Portal 側でも対応するインテントを有効にしておく必要があります。ここで「ON」にしても Discord 側が無効のままだと、起動に失敗することがあります。

表示	表示例
🎮 プレイ中	「プレイ中: (ステータステキスト)」と表示されます
📡 配信中	「配信中」と表示され、視聴用のリンクが付きます

「再生中」「視聴中」「参加中」といった種別は今後対応予定です。

配信 URL

アクティビティタイプで「配信中」を選んだときのみ表示されます。Bot の視聴リンクとして使う配信ページの URL を入力します。

https:// で始まる Twitch(twitch.tv)または YouTube(youtube.com / youtu.be)の URL のみ有効です。
それ以外の URL を入力した場合や、空欄のままの場合は、Discord 上では「プレイ中」表示に切り替わります。無効な URL のときは入力欄の下に警告が表示されます。

ステータステキスト

Bot 名の下に表示する 1 行のテキスト(アクティビティ名)です。最大 128 文字まで入力できます。入力欄の上に、現在の文字数と上限が「N / 128」の形で表示されます。

ステータステキストには変数を埋め込めます。次のような変数が使えます。

変数	意味
`{Bot.name}`	Bot の名前
`{Now.date}` `{Now.time}` など	現在の日付・時刻
`{BSVAR_...}`	サーバー共通で保持している永続変数(グローバル)
`{env.NAME}`	Bot 固有の環境変数(Bot 環境変数)

変数は Bot の稼働中に定期的に評価され、Discord クライアントの表示に反映されます。

変更を反映するときは「保存」をクリックします。
変更をなかったことにするときは「破棄」をクリックします。

プロフィール設定の名前・アイコンや「Discordから同期」、デンジャーゾーンの操作は、それぞれの画面内のボタンをクリックした時点で個別に反映されるため、この帯には含まれません。

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

Bot を Discord サーバーに招待する — 招待リンクからサーバーへ追加する詳しい手順
サーバー — Bot が参加しているサーバーごとの設定
ストレージ — Bot が保存するデータの管理
ログ — Bot の動作ログの確認
全コマンド管理 — この Bot のコマンド一覧と管理
モジュールの基本と共通操作 — Bot に機能を追加する方法

Bot 概要(ステータス・起動/停止・設定)

目次