YAWBDBの各機能が動作するには、特定のDiscord権限が必要です。このページでは、botが必要とするものを機能ごとに一覧にしています。
⚠️ 重要: YAWBDBの招待リンクでは、権限があらかじめ付与されることはありません。botを追加したあと、そのロールに下記の権限を付与する必要があります（簡単に済ませたい場合は、Administratorを付与してもかまいません）。トラブルシューティングについては、Botの権限をご覧ください。
🔑 基本（すべての機能）
botが動作するために、最低限必要なものです。
| 権限 | 理由 |
|---|---|
| View Channels | 動作するチャンネルを読み取るため |
| Send Messages | 返信、ログ、確認メッセージの投稿のため |
| Embed Links | botのほとんどの応答で埋め込みを使うため |
| Attach Files | エクスポート、録音、文字起こしのため |
| Read Message History | モデレーションとAI機能の文脈のため |
🗝️ 機能ごとの権限
| 機能 | 追加で必要な権限 |
|---|---|
| モデレーション | Ban Members、Kick Members、Moderate Members（タイムアウト） |
| 自動モデレート | Manage Messages（フィルターに該当したメッセージの削除）、Moderate Members |
| アンチレイド | Ban Members、Kick Members、Moderate Members |
| Anti-Nuke | View Audit Log（必須。各操作を行った人を特定するため）、さらに選んだ対応に応じて、Manage Roles／Kick Members／Ban Members。botのロールは、対象とする管理者より上位である必要があります |
| ハニーポット | Manage Messages（トラップのメッセージを削除するため）、さらにアクションに応じて、Ban Members／Kick Members／Moderate Members。任意の警告の埋め込みには、Manage Messages（ピン留め） |
| サーバーログ | 基本のみ（より詳しい実行者のデータのため、View Audit Logを推奨） |
| リアクションロール | Manage Roles、Add Reactions |
| プレゼント企画 | 基本のみ（埋め込みを投稿し、メンバーのロールを読み取り、任意で当選者にDMを送ります） |
| 提案 | 基本のみ。ディスカッションスレッドを有効にする場合は、Create Public Threadsも必要 |
| Starboard | 基本のみ（リアクションを読み取り、自分のメッセージを再投稿・更新します） |
| 予約メッセージ | 基本のみ（予定の時刻に、対象のチャンネルに投稿します） |
| ソーシャル通知 | 基本のみ（お知らせの埋め込みを投稿します）。ロールにメンションするには、そのロールをメンション可能にするか、Mention @everyone, @here, and All Rolesを付与してください |
| 埋め込みビルダー | 基本のみ（作成した埋め込みを、選んだチャンネルに投稿します） |
| 誕生日 | 告知には基本のみ。誕生日ロールを使う場合はManage Rolesが必要で、botのロールはそれより上にある必要があります。ロールにメンションするには、そのロールをメンション可能にするか、Mention @everyone, @here, and All Rolesを付与してください |
| ゲーム | 基本のみ（コマンドが使われたチャンネルに、ゲームの埋め込みとそのボタンを投稿します） |
| フォームビルダー | 基本のみ（回答チャンネルに、送信内容の概要を投稿します）。ロールにメンションするには、そのロールをメンション可能にするか、Mention @everyone, @here, and All Rolesを付与してください |
| 参加認証 | Manage Roles（認証済みロールの付与のため）。自動キックが有効な場合は、Kick Members |
| Discordレポート | Create Public/Private Threads、Send Messages in Threads、Manage Threads |
| Discordチケット | Manage Channelsまたはスレッドの権限（チケットのチャンネル）、Manage Threads |
| レベリング | Manage Roles（ロール報酬のため） |
| 自動参加ロール | Manage Roles |
| 音声録音／AudioToText | Connect、Speak（ボイスチャンネル） |
| ルールチャンネル | Manage Messages（ルールチャンネルをきれいに保つため） |
| 自動応答／AI応答／ランダムなbotの交流 | 基本のみ |
| 投票 | 基本のみ |
| 送信Webhook | なし。Discordには一切触れません。これはパネルの機能で、必要なのは、パネルの権限サーバーをチームから外すか、チームのオーナー権限です |
🪜 ロールの階層が重要です
Discordでは、botが操作できるのは、自分の最上位のロールより下にいるメンバーとロールだけです。
- botは、最上位のロールがbotのロールより上にあるメンバーを、BAN、キック、タイムアウト、警告することはできません。
- botは、ロール一覧で自分のロールより上にある報酬ロールを、付与することはできません。
モデレーションの操作やロール報酬が、何も表示されずに失敗する場合は、Server Settings → Rolesで、YAWBDBのロールをもっと上にドラッグしてください。
✅ クイックチェックリスト
- Server Settings → Rolesを開き、YAWBDBのロールを選びます。
- 有効にした機能に必要な権限を付与します（上の表）。
- botが管理する必要のあるすべてのロールより上に、そのロールを移動します。
- チャンネルごとの権限の上書きを確認します。チャンネル単位の拒否は、ロール単位の許可に優先します。