履歴コマンド

サーバー上でメンバーにどんなモデレーション記録があるかを調べ、メンバー自身にも確認してもらい、処分が終わったメンバーの記録をきれいに消去できます。

これには3つのコマンドがあります。/history(スタッフ用)、/my-history(誰でも)、/clear-history(スタッフ用、削除します)です。

🔎 メンバーの記録を見る: /history

1. メンバーのDiscordユーザーIDをコピーします。Discordで 開発者モード(Developer Mode)をオンにし(ユーザー設定の詳細設定)、メンバーを右クリックして ユーザーIDをコピー(Copy User ID)を選びます。
2. /history と入力し、user_id にIDを貼り付けてEnterキーを押します。
3. ボットは、あなただけに見える形で、新しい順に直近10件の記録を返します。

各行は次のような形です。

1. BAN 🔴 (3d) - spamming invites - 2 hours ago #418

• 種類は大文字(BAN、MUTE、KICK、WARN、SOFTBAN、UNBAN、UNMUTE)
• 記録がまだ有効なときは🔴
• BAN、ミュート、ソフトBANでは括弧内に期間
• 理由、または「No reason」
• 発生した時期
• # の後ろのケース番号。記録の文言を変更する /reason で使う番号です

コマンドを表示するには、Discordの Kick Members 権限が必要です。同じ一覧は、より詳しい内容でパネルにもあります。モデレーション → 履歴タブ で、記録1件につき1行の表になっており、種類とステータスで絞り込めます。

🙋 メンバーが自分の記録を見られるようにする: /my-history

誰でも /my-history と入力できます。ボットは、サーバーが保持している本人についての直近10件のモデレーション記録を、本人だけに見える形で表示します。「何で警告されたんだっけ?」をスタッフに聞かずに解決できる手軽な方法です。

• サーバーで モデレーション 機能が有効になっている必要があります。オフの場合、メンバーにはその旨のメッセージが表示されます。
• 許可されたモデレーターロール の設定は無視されます。ロールは不要です。
• テキストコマンドのプレフィックスを設定していれば !my-history も使えますが、テキストでの返信は本人だけに見せることができません。ボットはチャンネルに投稿し、30秒後に削除します。
• 記録のないメンバーには「You have no moderation records on this server.」(このサーバーにモデレーション記録はありません。)と表示されます。

パネル上の本人のページ私の制裁には、すべてのサーバーにわたる同じ記録が一覧されます。

🧹 メンバーの終了済みの記録を消去する: /clear-history

/clear-history は、サーバー上の1人のメンバーについて、もう有効ではない記録をすべて削除します。処分を終えた人の記録をきれいにしたいときに使います。

1. そのメンバーに有効なものが残っていないことを確認します(下記を参照)。
2. /clear-history と入力し、メンバーのユーザーIDを user_id に貼り付けてEnterキーを押します。
3. ボットは Cleared N inactive records for @member(@member の無効な記録をN件消去しました)または No inactive records found for @member(無効な記録は見つかりませんでした)と答えます。

この操作は取り消せません。 記録は非表示ではなく、削除されます。

無効とみなされるもの

有効な記録はそのまま残ります。メンバーの警告も消したい場合は、先にパネルで削除してから /clear-history を実行してください。

使える人

次のすべてを満たす必要があります。

• サーバーでモデレーション機能が有効になっている
• その人がDiscordの Ban Members 権限を持っている(注意: /history が必要とする Kick Members より上位です)
• モデレーション設定で 許可されたモデレーターロール(スラッシュコマンド) を設定している場合は、そのロールのいずれかも持っている

パネルでの同じ操作

モデレーション → 履歴タブ で、そのメンバーの終了済み(有効でない)記録の すべてクリア をクリックし、再度クリックして確認 と表示されたらもう一度クリックします。そのメンバーの終了済みの記録がすべて削除されます。コマンドと同じ削除です。

パネルのボタンは、サーバーの操作ログに1行("Cleared N inactive sanction(s)...")を書き込み、モデレーションのログチャンネルを設定していればそこにも投稿します。/clear-history コマンドはどちらも行いません。操作ログにも記録が残らず、ログチャンネルにも何も投稿されません。チームで履歴を目に見える形で残したい場合は、パネルのボタンを使うか、ログチャンネルに手動で1行書いてください。

💡 例

あるメンバーが3月に2回警告を受け、4月に1日のミュートを受けました。今は10月で、その後は問題なく過ごしています。

1. /history user_id:123456789012345678 の結果は MUTE(1d、点なし、終了済み)、WARN 🔴、WARN 🔴 です。
2. 2件の警告はまだ🔴なので、/clear-history だけではミュートしか消えません。
3. パネルで モデレーション → 履歴タブ を開き、そのメンバーを探して、各警告の行で 削除 をクリックします。
4. 次に /clear-history user_id:123456789012345678 を実行します。ボットが Cleared 3 inactive records と答え、そのメンバーの記録は空になります。

🔧 うまくいかないときは

🚨 「The Moderation feature is not enabled for this server」

パネルで機能をオンにしてから、もう一度試してください。メッセージにリンクが含まれています。

🚨 「You do not have a role that is allowed to use moderation commands on this server」

サーバーが、モデレーションコマンドを特定のロールに限定しています。管理者に、許可されたモデレーターロール(スラッシュコマンド) にあなたのロールを追加するか、その一覧を空にするよう頼んでください。

🚨 コマンド一覧に /clear-history が見当たらない

Discordは Ban Members を持たない人には表示しません。サーバー管理者は サーバー設定 → 連携サービス → YAWBDB(Server Settings → Integrations → YAWBDB)で、誰に表示するかを変更することもできます。

🚨 「No inactive records found」と出るのに /history には記録がある

それらの記録はまだ有効です。先にパネルで解除するか削除してください(警告とソフトBANは手動でしか削除されません)。

🚨 「Failed to clear history」または「Server not registered in panel」

ボットがパネルに接続できなかったか、サーバーがパネルに接続されていません。1分ほど待って再度試してください。サーバーが新しい場合は、先に接続を完了してください。

🚨 間違ったメンバーを消去してしまった

元に戻せません。ご自身のメモや操作ログから記録を作り直してください。操作ログに残るのは、パネルから消去した場合の1行だけです。

🚨 /my-history がサーバーは登録されていないと言う

上記と同じ原因です。サーバーがパネルに接続されていません。