マーダーミステリー進行支援 Discord Bot
秘匿チャンネル・共通チャンネル・専用配役ロールの一括自動構築から、ボタンによるロール＆ニックネーム自動変更、リマインド通知、観戦ロール管理、セッションログのアーカイブ保存までを一括で行えるDiscord Botです。
⚠️ 1. 前提設定（構築を開始する前に）
Botを正しく安全に動作させるため、環境を構築する前に以下の設定およびルールを必ずご確認ください。
📌 【重要】カテゴリー名の重複と命名ルール
Discordの仕様上、同じ名前のカテゴリーを複数作成することは予期せぬエラーやロール付与の誤作動の原因となります。運用方針に合わせて、カテゴリー作成前に必ず以下のルールで名称を決定してください。
-
【セッションごとに使い捨て・アーカイブする場合（パターンA）】
西暦(4桁)月日_タイトル名 としてください。（例：20260328_タイトル名）
※「月日」のみではなく「西暦」から入力していただくことで、年をまたいでも将来にわたって名前の重複を確実に防ぐことができます。 -
【環境を恒常的に再利用する場合（パターンB）】
マダミスタイトル名 のみとしてください。（例：真実の行方）
※再利用時はチャンネル自体は残してログのみを清掃するため、日付を含めない普遍的な名称が適しています。
🔐 権限とシステム保護の設定
-
アプリコマンド権限の制限：
一般の参加者が誤って環境構築や削除などの管理コマンドを実行してしまうことを防ぐため、サーバー設定の [ロール] ＞ [@everyone] にて、「アプリコマンドを使う」の権限をオフ（❌）に設定することを強く推奨いたします。 -
Bot使用権限用ロールの作成：
GM（ゲームマスター）やサーバー管理者など、Botを操作する特定のメンバー向けに「Bot操作用ロール」を別途作成し、そのロールに対してのみ「アプリコマンドを使う」権限を付与して管理を行ってください。 -
システム用カテゴリーの保護：
Botが自動作成する テキストチャンネル カテゴリー内の ロール取得 観戦ロール取得 bot通知 といったチャンネルは、全セッション共通の受付窓口およびシステム管理窓口となります。これらはセッション終了後も削除せずにそのまま維持してください。
📋 2. 機能（コマンド）一覧
重い処理（環境構築や一括削除など）は、キューを経由してバックグラウンドで安全に非同期処理されるサーバレス設計となっています。
/setup_private
機能: 環境自動構築。秘匿チャンネル、共通チャンネル、専用ロールを一括で作成します。
備考: 名前の重複にご注意ください。コマンド実行後に詳細設定を入力するポップアップが開きます。
/setup_buttons
機能: プレイヤーに配役ロールを付与する専用のボタンを設置、または再設置します。
備考: 参加者がボタンを押すと、自動的に専用ロールが付与され、ニックネームも変更されます。
/setup_rename
機能: ニックネーム（表示名）のみを変更するボタンを設置します。
備考: 手動でロール付与を行いたい場合や、表示名のみをリセットしたい場合に便利です。
/setup_common
機能: 参加用（共通）ロールの取得ボタンを設置します。
備考: カテゴリー名を指定することで、別のチャンネルから遠隔で設置することも可能です。
/setup_spectator
機能: 観戦者ロールの取得ボタンを設置します。
備考: カテゴリー名を指定することで、別のチャンネルから遠隔で設置することも可能です。
/update_reminder
機能: セッションのリマインド日時を更新・設定します。
備考: 指定した日時に向けて、参加者に自動で通知を行います。
/cleanup_roles
機能: セッション終了後の整理です。PCロールをすべて削除します。
備考: 同時に、観戦者ボタンを該当の管理チャンネルへ自動設置します。
/delete_category_all
機能: 環境完全削除。対象カテゴリーに関連する全チャンネルとロールを完全に消去します。
備考: 誤って作成してしまった場合や、アーカイブを残さずに完全撤去する場合に使用します。
/clear_new
機能: 指定した件数だけ最新のログを残し、古いメッセージをすべて削除します。
備考: 引数に
all と入力することで、対象チャンネルのメッセージを全消去できます。/clear_old
機能: 最新のメッセージから指定した件数分だけ遡って削除します。
備考: 誤爆の掃除や、直近の不要なログのみを消したい場合に活用できます。
/setup_dice
機能: 1d100 のダイスを振ることができるボタンを設置します。
備考: セッション中の判定などで、誰でも手軽にダイスロールが可能です。
/ping
機能: Botの生存・稼働確認を行います。
備考: サーバレス環境全体の疎通状態と、応答速度を確認することができます。
/archive（追加機能）
機能: セッション（カテゴリー）内の全テキストチャンネルのログを、「アーカイブ」カテゴリーにスレッド形式で転送・保存します。
備考: 当時の発言者の名前とアイコンを完全再現してコピーします。完了後には元カテゴリーの削除確認ボタン（観戦ロール保持）が出現します。
/reset_all_nicknames（追加機能）
機能: サーバー内のメンバーの表示名（ニックネーム）を一括でリセットし、本来のプロフィール名に統一します。
備考: 特定のロールを指定して、その対象者のみ名前をリセットすることも可能です。人数規模が大きい場合にはロール指定をお勧めします。
📖 3. 基本的な使い方
パターンA：セッションのアーカイブ（過去ログ）を残す場合
セッション終了後も、プレイヤーや観戦者が当時のログを見返せるように運用する方法です。
- 🚀 環境作成：/setup_private を実行します。カテゴリー名は 西暦4桁+日付_タイトル名 と設定してください。
- 🎫 参加受付：プレイヤーに「ロール取得」チャンネルにて共通ボタンを押してもらい、対象の会場へ誘導します。
- 🎭 配役付与：共通チャンネル内で /setup_buttons を実行し、プレイヤーに自分の担当する役のボタンを押してもらいます。
- 🗣️ 議論進行：各チャンネルを利用してセッションを進行します。（終わったら、/setup_spectator で参加者全員に観戦ロールをつけてください）
- 🏁 終了・整理：セッション終了後、カテゴリー内で /cleanup_roles を実行します。PCロールがお掃除され、観戦準備が整います。
- 📦 アーカイブ化：乱雑にならないよう、/archive でアーカイブ化しておくことをお勧めします。
- 🏷️ 名前リセット：/reset_all_nicknames でニックネームを元に戻します。
- 👁️ アーカイブ閲覧：後日ログを読みたい人は、「観戦ロール取得」チャンネルから該当のロールを取得します。
パターンB：環境を再利用し、使い回す場合
1つのカテゴリーを固定のタイトル名で維持し、セッションごとにログを消去しながら何度も運用する方法です。
- 🚀 環境作成：/setup_private を実行します。カテゴリー名は マダミスタイトル名（日付なし）と設定してください。
- 🎫 参加受付：プレイヤーに「ロール取得」チャンネルにて、固定されたタイトル名のボタンを押してもらいます。
- 🎭 配役付与：共通チャンネル内で /setup_buttons を実行し、配役を決定します。
- 🏁 終了後の掃除：感想戦などが終了した後、/setup_spectator で参加者全員に観戦ロールをつけた後、/clear_new コマンド（引数に
allまたは残したい件数）を使用してログを清掃します。 - 🏷️ 名前リセット：/reset_all_nicknames でニックネームを元に戻します。
- 🔄 次回セッション：次回の参加者も「ロール取得」チャンネルの既存ボタンを押すことで、全く同じ環境でゲームを開始できます。
💡 4. その他の機能とトラブル対応
-
⚠️ 間違えて環境を作成してしまった時：
該当のカテゴリー内で /delete_category_all を実行してください。関連する専用ロールも含めて、一括でクリーンアップ（完全削除）されます。 -
🔘 配役ボタンなどがログで流れて消えてしまった時：
各種 /setup_*** コマンドを使用していただければ、いつでもその場にボタンを再設置することが可能です。過去のボタンを探す必要はありません。
🛑 5. 運用上の重要注意事項
-
カテゴリー名の重複について：
DiscordとBotの仕様上、全く同じ名前のカテゴリーを複数作ることはできません。特に西暦を含めた命名ルールを徹底していただき、システムエラーを未然に防いでください。 -
観戦ロール取得チャンネルの設定：
未プレイの方への重大なネタバレを防止するため、「観戦ロール取得」チャンネルは必ず「プライベートチャンネル（管理者とBotのみ閲覧可）」の設定のまま運用してください。 -
Botのロール順位（最重要）：
Discordのサーバー設定にて、マダミスBotに付与されているロールを、必ず各配役ロールよりも上位に配置してください。順位が下になっていると、Botの権限が不足し、参加者のニックネーム変更やロール付与が実行できなくなります。