YAWBDB의 각 기능이 동작하려면 특정 Discord 권한이 필요해요. 이 페이지는 기능별로 봇에 필요한 권한을 정리해요.
⚠️ 중요: YAWBDB 초대 링크는 어떤 권한도 미리 부여하지 않아요. 봇을 추가한 뒤에 아래 권한을 봇의 역할에 부여해야 해요(간단하게 설정하고 싶다면 Administrator를 부여해도 돼요). 문제 해결은 봇 권한을 참고하세요.
🔑 기본 권한(모든 기능)
봇이 동작하려면 최소한 다음이 필요해요.
| 권한 | 이유 |
|---|---|
| View Channels | 봇이 활동하는 채널을 읽어요 |
| Send Messages | 답장, 로그 게시, 확인 메시지를 보내요 |
| Embed Links | 봇의 대부분의 응답이 임베드를 써요 |
| Attach Files | 내보내기, 녹음, 텍스트 변환 결과 파일을 보내요 |
| Read Message History | 모더레이션과 AI 기능의 맥락으로 써요 |
🗝️ 기능별 권한
| 기능 | 추가 권한 |
|---|---|
| 모더레이션 | Ban Members, Kick Members, Moderate Members (타임아웃) |
| Automod | Manage Messages (필터링된 메시지 삭제), Moderate Members |
| Anti-Raid | Ban Members, Kick Members, Moderate Members |
| Anti-Nuke | View Audit Log (필수 - 각 동작을 누가 했는지 식별해요), 그리고 선택한 대응에 따라 Manage Roles / Kick Members / Ban Members. 봇 역할이 보호 대상인 관리자보다 높아야 해요 |
| 허니팟 | Manage Messages (함정 메시지 삭제), 그리고 조치에 따라 Ban Members / Kick Members / Moderate Members. 선택 사항인 경고 임베드에는 Manage Messages (고정) |
| 서버 로그 | 기본 권한만 (더 풍부한 실행자 데이터를 위해 View Audit Log 권장) |
| 반응 역할 | Manage Roles, Add Reactions |
| 경품 추첨 | 기본 권한만 (임베드를 게시하고, 멤버 역할을 읽고, 필요하면 당첨자에게 DM을 보내요) |
| 건의 | 기본 권한만 - 토론 스레드를 켜면 Create Public Threads도 필요해요 |
| 스타보드 | 기본 권한만 (반응을 읽고, 자신의 메시지를 다시 게시하고 업데이트해요) |
| 예약 메시지 | 기본 권한만 (예약된 시각에 대상 채널에 게시해요) |
| 소셜 알림 | 기본 권한만 (공지 임베드를 게시해요). 역할을 멘션하려면 그 역할을 멘션 가능하게 하거나 Mention @everyone, @here, and All Roles를 부여하세요 |
| 임베드 빌더 | 기본 권한만 (작성한 임베드를 선택한 채널에 게시해요) |
| 생일 | 공지에는 기본 권한만. 생일 역할을 쓴다면 봇의 역할이 그 위에 있도록 Manage Roles도 필요해요. 역할을 멘션하려면 그 역할을 멘션 가능하게 하거나 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 (규칙 채널을 깔끔하게 유지) |
| Auto Responder / AI 응답 / Random Bot Interactions | 기본 권한만 |
| 투표 | 기본 권한만 |
| 아웃고잉 웹훅 | 없음 - Discord를 전혀 건드리지 않아요. 패널 기능이고, 필요한 것은 패널 권한 팀에서 서버 제거 또는 팀 소유권이에요 |
🪜 역할 계층이 중요해요
Discord는 봇이 자신의 가장 높은 역할보다 아래에 있는 멤버와 역할에만 동작할 수 있게 해요.
- 가장 높은 역할이 봇의 역할보다 위에 있는 멤버는 봇이 밴, 킥, 타임아웃, 경고를 할 수 없어요.
- 역할 목록에서 봇 자신의 역할보다 위에 있는 보상 역할은 봇이 부여할 수 없어요.
모더레이션 동작이나 역할 보상이 아무 알림 없이 실패한다면, Server Settings → Roles에서 YAWBDB 역할을 더 위로 끌어 올리세요.
✅ 간단 체크리스트
- Server Settings → Roles를 열고 YAWBDB 역할을 선택하세요.
- 켜 둔 기능에 필요한 권한을 부여하세요(위 표 참고).
- 봇이 관리해야 하는 모든 역할보다 위로 역할을 옮기세요.
- 채널별 권한 덮어쓰기를 확인하세요. 채널 수준의 거부는 역할 수준의 허용보다 우선해요.