Bot 機能（モジュール）の基本と共通操作

BotShade では、モデレーションや入退室メッセージ、投票、抽選など、Bot に追加できるさまざまな機能を「モジュール」と呼びます。各モジュールはダッシュボード上の専用の設定ページを持っており、画面で項目を選んだり入力したりするだけで、コードを書かずに Bot の動作を組み立てられます。

このページでは、すべてのモジュールに共通する操作の流れをまとめて説明します。どのモジュールでも「機能を開く → 機能を有効化する → 設定する → 保存する」という流れは同じです。

モジュール設定ページの全体像

Bot のダッシュボードを開くと、画面の左側（パソコンの場合）にメニューが表示されます。このメニューから設定したい機能を選ぶと、その機能の設定ページが開きます。

どのモジュールの設定ページも、おおまかに次の 3 つの部分でできています。

機能の設定ページを開く

ページ上部の「機能の有効化」トグル

すべての機能ページの一番上には、必ず「機能の有効化」というトグル（オン・オフのスイッチ）があります。

このトグルは、その機能全体の ON / OFF を切り替えるメインスイッチです。

設定を保存する

設定ページで何かを変更すると、画面の下に保存バーが現れます。このバーが出ている間は、変更内容がまだ保存されていない状態です。

保存バーには「未保存の変更があります」「変更を保存するか、破棄してください」というメッセージと、次のボタンが表示されます。

コマンドの権限について

多くの機能は、サーバー内で使える「コマンド」を提供します。「どのロールがそのコマンドを使えるか」「どのチャンネルで使えるか」といったコマンドの権限設定は、各機能ページとは別の専用ページで一括して管理します。

詳しい設定方法は、コマンド権限設定をご覧ください。

コマンドが実行される前のチェック

メンバーがスラッシュコマンドやコンテキストメニュー（メッセージ・ユーザーを右クリックして開くメニュー）を使うと、Bot は実際の処理を始める前にそのメンバーが使ってよいかどうかを確認します。確認は次の流れで行われ、いずれかの段階で「使えない」と判断されると、そこで止まってエラーメッセージが返されます。

• まず、Discord 側で必要な権限（例: BAN 系コマンドならメンバーを BAN する権限）を満たしているか
• 次に、コマンド権限設定で決めたロールやメンバー権限の許可・禁止リストに当てはまるか

この 2 つは独立しており、両方を満たしたメンバーだけがコマンドを実行できます。確認はコマンドを使うたびに、そのメンバーのロールや権限をもとにその場で行われます。チェックを通過するとコマンドはそのまま実行され、権限の案内は何も表示されません。

許可・禁止が判定される順序

コマンド権限設定では、ロールやメンバー権限ごとに「許可（ホワイトリスト）」と「禁止（ブラックリスト）」を指定できます。Bot は次の優先順位で判定します。

権限がないときに表示されるメッセージ

権限を満たさないメンバーがコマンドやコンテキストメニューを使おうとすると、本人にだけ見える（ephemeral な）メッセージで実行できないことが案内され、処理は行われません。

管理者でも実行できないケース

コマンドによっては、誤操作を防ぐために「サーバー管理者であっても、コマンド権限設定の許可・禁止をそのまま適用する」設定になっていることがあります。この場合、管理者であっても許可リストに入っていなかったり禁止リストに入っていたりすると、コマンドを実行できません。重要な操作を限られたメンバーだけに任せたいときに役立ちます。

一部のコマンドは常に使える

about（ボット情報）や、リマインダーの編集など、ごく一部のコマンドは権限チェックの対象外で、機能が有効であれば誰でも使えます。

カスタムコマンドの権限とクールダウン

ダッシュボードで作成した独自のコマンド（カスタムコマンド）にも、実行前のチェックが入ります。

• 有効・無効: コマンドを無効にすると、Discord のコマンド一覧や入力候補にも表示されなくなり、使えなくなります。

• 権限: コマンドごとに使えるロールや権限を指定できます。コマンドごとに指定がない場合は、カスタムコマンド全体に対する共通の権限設定が使われます。どちらも指定がない場合は、既定では誰でも使えます。権限を満たさないと、Botの権限設定により、このコマンドを実行する権限がありません。 というメッセージが本人にだけ表示されます。

• クールダウン: コマンドごとに「一度使ったら次に使えるまでの待ち時間」を設定できます。単位は秒・分・時のいずれかから選べます。待ち時間中に同じコマンドを使おうとすると、本人にだけ次のメッセージが表示され、実行されません。

  クールダウン中です。あと {remaining:.0f}秒 お待ちください。

  上の {remaining:.0f}秒 の部分には、残りの待ち時間（秒）が入ります。クールダウンはメンバーごと・コマンドごとに数えられます。既定ではクールダウンは設定されていません。

機能や個別コマンドを止めたいとき

機能やコマンドが動かない・使わせたくないときは、止め方が段階的に分かれています。

プレミアム限定機能・近日提供の機能について

メニューに並ぶ機能のうち、一部は分類としてプレミアム向け、または近日提供予定です。

プレミアム向けの機能（例: バックアップ、サーバー保護、サーバー情報、認証、絵文字コピー、レベリング、ミニゲーム、経済、Make it a Quote）には、メニューの右側に「Premium」と表示されます。プレミアムが付与されていない通常の状態では、メニューでうすく表示され、クリックするとプレミアムのご案内が開きますが、ベータ中はその案内が表示されることは通常ありません。

プレミアムとコマンドの権限は別のものです

ベータ版の現在は全ユーザーにプレミアムが付与されているため、機能そのものはどなたでも無料で利用できます。一方で、サーバー内でどのメンバーがどのコマンドを使えるかは、プレミアムの有無とは関係なく、前述のコマンドの権限についてで説明したロール・権限のチェックで決まります。プレミアムが付与されていても、コマンド権限設定で許可していなかったり禁止していたりするメンバーは、そのコマンドを実行できません。サーバーごとの運用に合わせて、コマンド権限設定で許可・禁止を調整してください。

機能が見つからないとき

メニューにないアドレスを直接開いたり、対応していない機能名を指定したりすると、設定ページの代わりに「モジュールが見つかりません」と表示されることがあります。その場合は、左のメニューから正しい機能を選び直してください。

機能の一覧

提供している機能を、目的別のカテゴリに分けて一覧にしました。各機能名のリンクから、その機能の設定方法を説明する個別ページへ進めます。

コミュニティ

サーバーを盛り上げたり、メンバーとの交流を活発にしたりする機能です。

• 入退室メッセージ — メンバーの参加・退出時にメッセージを送る
• ウェルカムメッセージ — 新しく参加したメンバーへの歓迎メッセージ
• ロールパネル — ボタンなどでロールを自分で付け外しできるパネル
• 投票 — メンバーに投票をしてもらう
• 抽選 — プレゼント企画などの抽選を行う
• 自動応答 — 特定のメッセージに自動で返信する
• レベリング — 発言量に応じてレベルが上がる仕組み（プレミアム限定）
• ミニゲーム — チャットで遊べるミニゲーム（プレミアム限定）
• 経済 — 通貨や所持金などの経済システム（プレミアム限定）
• Make it a Quote — メッセージを画像の名言風に加工する（プレミアム限定）
• ゲーム支援ツール — ゲーム向けの便利ツール

管理・保護

サーバーの安全を守り、運営を助ける機能です。

• モデレーション — 警告・タイムアウト・キックなどの管理機能
• サーバー保護 — 荒らしや不正な操作からサーバーを守る（プレミアム限定）
• 認証 — 参加者に認証を求めて安全を高める（プレミアム限定）
• チケット — 個別の問い合わせ対応用チャンネルを作成する
• バックアップ — サーバー構成のバックアップ（プレミアム限定）
• コマンド権限設定 — 各コマンドを使えるロールやチャンネルを設定する

ユーティリティ

メッセージ作成や情報表示など、運営を便利にする機能です。

• 埋め込み — 見栄えの良い埋め込みメッセージを作成する
• リマインダー機能 — 指定した時間にリマインドを送る
• サーバー情報 — サーバーの情報を表示する（プレミアム限定）
• 絵文字コピー — 他サーバーの絵文字をコピーする（プレミアム限定）
• ボット情報 — Bot 自身の情報を表示する

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

• コマンド権限設定 — コマンドを使えるロールやチャンネルの設定方法
• モデレーション — まず使ってみたい代表的な管理機能
• 入退室メッセージ — メンバーの参加・退出を知らせる基本機能
• ウェルカムメッセージ — 新規メンバーへの歓迎メッセージ