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

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

どのモジュールでも「機能を開く → 機能を有効化する → 設定する → 保存する」という流れは同じです。機能ごとの設定項目は機能の一覧の個別ページで説明しています。

機能の設定ページを開く

メニューにないアドレスを直接開くと「モジュールが見つかりません」と表示されるため、その場合はメニューから正しい機能を選び直してください。

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

すべての機能ページの一番上には「機能の有効化」トグルがあり、その機能全体の ON / OFF を切り替えるメインスイッチです。オフのままだと、コマンドやチャンネルなどの細かい設定を済ませていても機能全体が動作しません。

トグルをオンにしたうえで、その下に続く各セクションで詳しい内容（対象のチャンネル、メッセージ内容、ロールなど）を設定します。設定できる項目は機能ごとに異なります。

設定を保存する

設定を変更すると保存バーが現れます。「保存」をクリックするまで、変更内容は Bot に反映されません。「破棄」をクリックすると、その機能ページで行った変更が保存前の状態に戻ります。保存が完了すると「保存しました」、通信エラーなどで保存できなかったときは「保存に失敗しました」と表示されるため、失敗した場合はしばらく時間をおいてからもう一度「保存」をクリックしてください。

コマンドの権限について

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

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

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

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

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

この 2 つは独立しており、両方を満たしたメンバーだけがコマンドを実行できます。確認はコマンドを使うたびに、そのメンバーのロールや権限をもとにその場で行われます。

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

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

ロールごとの許可・禁止に加えて、Discord のメンバー権限（例: メッセージの管理）を条件にすることもできます。複数の権限を指定したときの当てはめ方には、「指定したすべての権限を持つ場合」「指定したいずれかの権限を持つ場合」など複数のモードがあり、コマンド権限設定のページで選べます。

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

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

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

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

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

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

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

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

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

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

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

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

  上の {remaining:.0f}秒 の部分には、残りの待ち時間（秒）が入ります。クールダウンはメンバーごと・コマンドごとに数えられます。既定ではクールダウンは設定されていません。クールダウンの確認は権限の確認のあとに行われるため、このメッセージが表示された時点ではそのコマンドを使う権限は満たしています。

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

止め方は範囲ごとに分かれています。機能全体を止めるなら「機能の有効化」をオフに、特定のコマンドだけを止めるならそのコマンドを個別に無効に、特定のロール・権限のメンバーにだけ使わせたくないならコマンド権限設定の禁止リストに追加します。

無効にしたコマンドは Discord の入力候補から消えるため、実行しようとしたメンバーには Discord から This command does not exist. と表示されることがあります。

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

プレミアム向けの機能（例: バックアップ、サーバー保護、サーバー情報、認証、絵文字コピー、レベリング、ミニゲーム、経済、Make it a Quote）には「Premium」と表示されます。近日提供予定の機能には「Soon」と表示され、提供開始までは設定できません。

現在 BotShade はベータ版で、新規登録者全員に一律でプレミアムが付与されているため、プレミアム向けの機能も含めてすべての機能を無料でご利用いただけます（ベータ期間中の措置で、予告なく変更・終了される場合があります）。

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

サーバー内でどのメンバーがどのコマンドを使えるかは、プレミアムの有無とは関係なく、コマンドの権限についてで説明したロール・権限のチェックで決まります。プレミアムが付与されていても、コマンド権限設定で許可していなかったり禁止していたりするメンバーは、そのコマンドを実行できません。

機能の一覧

コミュニティ

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

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

管理・保護

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

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

ユーティリティ

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

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