モデレーション

モデレーション機能では、/ban や /kick などのモデレーションコマンドを 1 つずつ有効化し、誰が使えるかを細かく設定できます。あわせて、処罰を実行したときの操作ログの記録や、処罰されたユーザーへのダイレクトメッセージ通知、埋め込みメッセージの色などもまとめて設定できます。

この機能でできること

モデレーション機能のページでは、大きく分けて次の設定ができます。

ページを開く

コマンド権限設定

「コマンド権限設定」セクションでは、モデレーションコマンドごとに「使えるようにするか(有効 / 無効)」と「誰が使えるか(権限)」を設定します。

利用できるコマンドは次の 5 つです。いずれもスラッシュコマンドで、サーバー内でのみ実行できます(DM では使えません)。

各コマンドはアコーディオン(折りたたみ)形式で並んでおり、行をクリックすると詳細設定が開きます。行の右側には、現在の状態を示す「有効」または「無効」のバッジが表示されます。強制上書き(後述)を有効にしているコマンドには「強制上書き」バッジも表示されます。

個別設定しない場合の最低Discord権限

各コマンドの詳細設定を開くと、上部に「個別設定しない場合の最低Discord権限」という枠が表示されます。これは、個別権限設定を使わない場合に、そのコマンドを実行するために最低限必要となる Discord の権限を示しています。たとえば「/kick」では「メンバーをキック」相当の権限、「/ban」では「メンバーをBan」相当の権限が目安になります。

より細かく制御したい場合は、次の「個別権限設定を有効化」をオンにしてください。

個別権限設定を有効化する

「個別権限設定を有効化」トグルは、権限の判定方法を切り替えるスイッチです。

• オフのとき: 通常どおり Discord の権限で判定されます。
• オンのとき: BotShade 独自の権限判定に切り替わり、下に「詳細権限設定」(ホワイト / ブラックロールリスト、ホワイト / ブラック権限リスト)が表示されます。

詳細権限設定の使い方はコマンド権限設定の使い方で詳しく説明しています。

Discord権限より個別設定を優先(強制上書き)

詳細設定の一番下には「Discord権限より個別設定を優先」というトグルがあります。これは、Discord 側の既存権限を無視して、BotShade 独自の個別権限設定だけを強制的に適用する設定です。「個別権限設定を有効化」がオフの間は操作できません。

動作設定

「動作設定」セクションでは、モデレーション全体の動作を設定します。

外観設定

「外観設定」セクションでは、処罰やログとして送られる埋め込みメッセージの色を設定します。それぞれカラーピッカー(色の四角)と、# から始まるカラーコードの入力欄が並んでいます。

処罰設定

「処罰設定」セクションでは、処罰を実行したときにユーザーへ送るダイレクトメッセージ(DM)を設定します。

設定を保存する

設定を変更すると、画面下部に「未保存の変更があります」というバー(未保存変更バー)が表示されます。

コマンドの実際の動作

設定したコマンドを実行したときの Bot の動作を説明します。いずれのコマンドも、実行すると操作したユーザーに結果が埋め込みメッセージで返されます。

/kick・/ban

対象メンバーを指定して実行すると、Bot はまず処理を受け付け、(処罰 DM がオンのときは)対象メンバーへ通知 DM を送り、そのうえでキックまたは Ban を行います。完了すると、操作したユーザーに成功の埋め込みメッセージが返されます。タイトルは ✅ | /kick または ✅ | /ban で、対象メンバー・実行者・理由が表示されます。

理由(reason)を省略した場合、埋め込み内の理由欄にはコードブロックで なし と表示されます。

/timeout

duration(分)を指定して実行すると、対象メンバーがその時間だけチャットや操作を制限されます。完了すると ✅ | /timeout のタイトルで、対象メンバー・実行者・理由・タイムアウト時間(分)が表示された成功メッセージが返されます。指定できる時間は 1 分から 40320 分(最大 28 日)までです。

/purge

実行したチャンネルの直近のメッセージをまとめて削除します。結果は実行したユーザーだけに見える形(ephemeral 表示)で返され、削除した件数が表示されます。たとえば 120 件削除した場合は 120件のメッセージを消去しました。 のように表示されます。

limit(走査する件数)を指定しない場合は直近 100 件が対象になり、1 件から 1000 件まで指定できます。指定した件数より実際のメッセージが少ない場合は、実際に削除できた件数だけが表示されます(たとえば 1000 件を指定しても、チャンネルに 47 件しかなければ 47 件が削除・表示されます)。

type(削除する種類)では、削除対象を絞り込めます。type を省略すると all(すべて)になります。主な種類は次のとおりです。

member を指定すると、そのメンバーが送信したメッセージだけを削除できます。type と member を同時に指定した場合は、両方の条件を満たすメッセージだけが削除されます。

選択した消去タイプ (**contains**) には `substrings` 引数が必要です。

/nuke

実行したチャンネルを同じ設定で作り直し、元のチャンネルを削除します。これによりチャンネルの全メッセージが消去されます。新しく作られたチャンネルには ✅ | /nuke のタイトルで チャンネルログを消去しました。 という成功メッセージが送られ、このメッセージは 10 秒後に自動で消えます。

既定値

各コマンドで指定を省略したときの初期値は次のとおりです。

上限

各コマンドで指定できる範囲や、内部的な上限は次のとおりです。

表示されるメッセージ

Bot が表示する主なメッセージは次のとおりです。状況に応じて、成功・エラー・通知の埋め込みメッセージが返されます。

処罰時の DM を独自に作成していない場合、対象メンバーには既定の通知が届きます。タイトルは 処罰通知 で、本文は次のような内容になります({ } の部分はサーバー名・処罰の種類・理由に置き換わります)。

{Moderation.guild.name}から{Moderation.punishmentMethod}されました。
理由: {Moderation.punishmentReason}

「処罰設定」で DM を独自に作成した場合は、その内容が使われます。本文や埋め込みの中で {Moderation.punishmentMethod}(処罰の種類)・{Moderation.punishmentReason}(理由)・{Moderation.targetUser.name}(対象ユーザー名)などの変数を使うと、実際の値に置き換わって送信されます。

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

• 実行したユーザーに必要な権限がない場合、処理は行われず Botの権限設定により、このコマンドを実行する権限がありません。 というメッセージが返されます。
• ユーザー側に権限があっても Bot 自身に権限がない場合は、Botの権限が不足しているため、キックできませんでした。 のようなエラーが返されます。Bot のロールに必要な権限が付いているか確認してください。
• 「Discord権限より個別設定を優先」(強制上書き)をオンにすると、Discord 標準の権限を無視して BotShade 独自の個別権限設定だけで判定されます。意図しない権限付与・制限が起きないよう、確認ダイアログの内容をよく理解したうえで使ってください。
• 対象メンバーがすでにキック / Ban されていたり、コマンド実行までの間にサーバーから抜けていた場合は、エラーにはならず何も起こりません。
• すべてのコマンドはサーバー内でのみ実行できます。DM では使用できません。

コマンド一覧

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

• コマンド権限設定の使い方
• サーバー保護
• 認証
• ログ機能
• 操作ログ(ログの確認)