Bot 機能(モジュール)

ボット情報(/about)

「ボット情報」は、Bot の概要や統計などを表示する /about コマンドを管理する機能です。サーバーのメンバーが /about を実行すると、Bot に関する情報がチャットに表示されます。

この機能は無料で利用できます。メニュー上の表記は「ボット情報」で、「便利機能」グループの中にあります。設定できるのは /about コマンドの有効/無効と、誰が使えるか(権限)だけで、表示される情報のカスタマイズはできません。

/about を実行したときの表示

サーバーのメンバーが /about を実行すると、Bot は 1 つの埋め込み(Embed)で Bot の情報をまとめて返します。

埋め込みの見出しには Bot の名前が入り、説明文には BotShade で作成された Discord Bot です。 と表示されます。Bot にアイコンが設定されている場合は、そのアイコンがサムネイルとして表示されます。

埋め込みには、次の 7 つの項目が並びます。

項目表示される内容
Bot IDBot のユーザー ID(数値)です。
OwnerBot の所有者の名前と ID です。取得できない場合は 取得できませんでした と表示されます。
Plan常に Beta Edition と表示されます。
WS LatencyBot と Discord の間の WebSocket 通信の遅延を、ミリ秒単位で 45ms のように表示します。
UptimeBot が現在の稼働を開始してからの経過時間です(後述)。
Server CountBot が参加しているサーバーの数です。
User Count参加している全サーバーのメンバー数を合計した値です。1,234,567 のように 3 桁ごとの区切りで表示されます。

これらの数値は、/about を実行したその時点で集計されます。値を取得できなかった項目だけが代わりの文言や 0 になり、/about の表示そのものが失敗することはありません。

実際の動作と既定値

  • コマンドの初期状態: /about は既定で有効です。
  • 必要な権限: /about は公開コマンドで、特別な Discord 権限は不要です(個別権限設定を使う場合を除く)。
  • 埋め込みの色: 埋め込みは Discord の標準ブランドカラー(Blurple、#5865F2)で表示されます。
  • 対象範囲: /about は Bot が参加しているすべてのサーバーで共通して利用できます。

Uptime(稼働時間)の表示について

Uptime は、Bot が現在の稼働を開始してからの経過時間を「日・時・分・秒」で表示します。値が 0 の単位は省略され、秒は常に表示されます。たとえば次のように表示されます。

  • 1日 2時間 30分 45秒
  • 2時間 15分 30秒

Bot が再起動・再読み込みされると、Uptime はそこからリセットされて再びカウントが始まります。

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

  • /about が使えない: ページ上部の「機能の有効化」と、「コマンド権限設定」内の「コマンドを有効化」の両方がオンで、かつ保存済みである必要があります。

コマンド一覧

コマンド内容引数使える人
/aboutBot の情報を 1 つの埋め込みで表示します。なし全員(公開コマンド)

設定と保存の流れ

「機能の有効化」をオンにする

ページ上部のスイッチです。オフのままだと /about は使えません。

コマンド権限設定で /about の有効・権限を設定する

「コマンド権限設定」カードで、/about コマンドの有効/無効と、使える対象(権限)を設定します。

保存バーで保存する

「保存」をクリックするまで変更内容は反映されません。保存バーの操作はモジュールの基本と共通操作を参照してください。

コマンド権限設定

「ボット情報」のページに表示される設定は、この「コマンド権限設定」カードだけです。カードの中で /about の行を開くと、次の設定ができます。行の右側に表示されるバッジは、「有効」がコマンドの有効、「無効」が無効、「強制上書き」が Discord 権限より個別設定を優先する設定のオンを示します。

個別権限設定を有効化

「個別権限設定を有効化」のスイッチで、誰がコマンドを使えるかの判定方法を切り替えます。

  • オフ(初期状態): 通常の Discord 権限による判定を使います。
  • オン: BotShade 独自の権限設定(後述のロールリストや権限リスト)を使って、使える対象を細かく指定できます。

詳細権限設定(個別権限設定をオンにしたとき)

「個別権限設定を有効化」をオンにすると、「詳細権限設定」という枠が表示され、次の 4 つの項目を設定できます。

項目内容
「ホワイトロールリスト」許可するロールを指定します。リストに含まれるロールは常にアクセスが許可されます。
「ブラックロールリスト」拒否するロールを指定します。リストに含まれるロールはアクセスが拒否されます。
「ホワイト権限リスト」許可する権限条件を設定します。条件に一致するメンバーはアクセスが許可されます。
「ブラック権限リスト」拒否する権限条件を設定します。条件に一致するメンバーはアクセスが拒否されます。

ロールの登録方法、権限条件の判定方法(AND / OR / STRICT / CONTAINS)、複数リストが競合したときの優先順位はコマンド権限設定の使い方を参照してください。最初は「個別権限設定を有効化」をオフのままにして、Discord の通常の権限判定に任せても問題ありません。

Discord権限より個別設定を優先(上級者向け)

「個別権限設定を有効化」をオンにすると、その下に「Discord権限より個別設定を優先」というスイッチが使えるようになります。これをオンにすると、個別権限設定を Discord の既存権限より優先して強制的に適用します。

「Discord権限より個別設定を優先」は危険な設定です。既存の Discord 権限をバイパスして BotShade 独自の権限設定を優先するため、管理者向けの操作にも影響し、意図しない権限付与や制限につながる可能性があります。仕組みを十分に理解している場合のみ使用してください。このスイッチを操作すると確認ダイアログ「危険な権限上書きの確認」が表示され、「確定する」をクリックすると反映されます。

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

最終更新:

目次