봇에 줘야 하는 서버 권한
봇이 어떤 권한을 왜 쓰는지, 빠지면 무엇이 멈추는지, 어떻게 고치는지 알려 드려요.
이 페이지의 목차
먼저 알아 둘 것
초대 링크로 봇을 넣으면 Discord가 봇에 줄 권한을 한 번에 물어요. 여기서 권한을 빼고 승인하면 그 권한이 쓰이는 기능만 멈춰요.
- 서버 관리 권한이 있는 계정 — 권한 진단 명령은 이 권한이 있는 사람만 쓸 수 있어요.
봇이 요청하는 권한
view_channel— 채널을 봐요. 트리거 채널과 관리 허브를 올릴 채널을 볼 수 있어야 해요.manage_channels— 임시 음성 채널을 만들고, 비면 지워요.manage_roles— 방을 연 사람과 초대받은 사람에게 그 채널에서만 쓰는 권한을 줘요. 등급 배지 역할도 이 권한으로 만들어요(음성 마일리지와 등급·배지).move_members— 트리거 채널에 들어온 사람을 새 방으로 옮겨요. 잠수 자동 이동에도 써요.connect— 옮겨 갈 음성 채널에 들어갈 수 있어야 해요. 잠수 자동 이동은 연결과 멤버 이동이 둘 다 있어야 해요.send_messages— 방 패널과 안내 메시지를 올려요.embed_links— 패널과 안내 카드를 카드 모양으로 올려요.read_message_history— 올려 둔 패널이 아직 있는지 확인해요. 쓰지 않는 권한이 아니에요.create_instant_invite— 임시 채널로 사람을 부를 초대 링크를 만들어요.
manage_guild(서버 관리) — 웹 설정에서 서버의 AFK 채널을 정하거나 만들 때만 써요. 없으면 그 기능만 재초대 안내로 바뀌어요.attach_files(파일 첨부) — 내전 결과 카드 이미지를 올려요. 없으면 이미지 없이 결과가 올라가요(공유 카드와 결과 카드).manage_events(이벤트 관리)는 초대 화면에 보여도 지금 쓰는 기능이 없어요.
빠지면 이렇게 보여요
예를 들어 채널 관리가 없으면, 트리거 채널에 들어온 사람에게 이 카드가 DM으로 가요. DM이 막혀 있으면 같은 안내가 트리거 채널(안 되면 리포트 채널·시스템 채널)에 한 번 올라왔다가 10분 뒤 사라져요.
- 명령이나 버튼이 Discord에 거절되면: “봇 권한이 부족해서 처리하지 못했어요. 서버 관리자에게 새 초대 링크로 봇을 다시 추가(Authorize)해 달라고 요청해 주세요. 한 번 다시 추가하면 같은 문제가 반복되지 않아요. 필요한 권한은
/관리 권한진단로 한눈에 확인할 수 있어요.” 명령이 선택창에 아예 안 뜰 때는 콘솔이 잠겨 있어요 · 명령이 안 보여요를 봐요. - 트리거·카테고리를 지정할 때: “봇이 그 카테고리/채널에서 다음 권한이 부족해요: move_members 권한을 준 뒤 다시 설정해 주세요.”
- 웹 콘솔에서 등급 배지를 켜 둔 서버의 봇에 역할 관리 권한이 없을 때: “봇에게 역할 관리 권한이 없어요. 서버 설정 → 역할에서 봇 역할에 역할 관리를 켜 주세요.” 등급 배지는 음성 마일리지와 등급·배지에 있어요.
- 웹 콘솔에서 AFK 채널을 바꾸려는데 봇에 서버 관리 권한이 없을 때: “봇에게 서버 관리 권한이 없어 AFK 채널을 바꿀 수 없어요. 봇을 다시 초대하면 이 권한이 함께 추가돼요.”
권한 확인하고 고치기
진단 명령을 보내요
/관리 권한진단서버 관리 권한이 있는 사람만 쓸 수 있어요.모두 있으면 권한 자가진단 카드에 “필요한 권한이 모두 있어요. ✅”가 떠요. 빠진 게 있으면 이렇게 이름이 나와요: “다음 권한이 없어요: manage_channels”. 이 명령은 위의 꼭 필요한 권한 9가지를 서버 전체 기준으로만 봐요. 있으면 쓰는 권한과 채널·카테고리에서 막힌 것은 보지 않아서, 막힌 곳은 아래 3단계에서 찾아요.
봇 역할에서 빠진 권한을 켜요
빠진 권한을 켜고 저장해요.
채널·카테고리 권한도 봐요
트리거 채널과 임시 채널이 만들어지는 카테고리에서 봇 역할이 막혀 있지 않은지 봐요. 서버 전체 권한이 있어도 채널 권한이 막으면 그 채널에서는 안 돼요.
그래도 비면 봇을 다시 추가해요
초대 링크에서 권한을 하나도 빼지 않고 한 번 더 승인하면 빠진 권한이 채워져요. 채널과 설정은 그대로 남아요. 명령이 안 보일 때는 콘솔이 잠겨 있어요 · 명령이 안 보여요를 봐요.
봇 역할이 등급 역할보다 아래에 있어요. 서버 설정 → 역할에서 봇 역할을 등급 역할 위로 끌어올려 주세요. 그렇지 않으면 이름 변경·역할 주기·삭제가 모두 실패해요.
봇 역할과 매치메이커는 달라요
- 봇 역할: Discord의 서버 역할이에요. Kletoi가 Discord에서 할 수 있는 일을 정해요. 서버 설정 › 역할에서 고쳐요.
- 매치메이커: Kletoi 안에서 내전을 운영할 사람이에요. Discord 역할이 아니라서 서버 설정 › 역할에는 나오지 않아요.
- 매치메이커는 서버 관리 권한 없이 매치 운영만 맡아요. 지정된 매치메이커는 자기가 만든 매치만 운영하고, 서버 관리 권한이 있는 사람은 따로 지정하지 않아도 모든 매치를 운영해요(누가 무엇을 누를 수 있나요 · 매치메이커 지정과 해제).
매치메이커는 /매치메이커 부여로 지정해요. 웹 콘솔의 멤버 & 권한에서도 매치메이커 지정으로 지정할 수 있어요.
다음에 볼 곳
권한을 맞췄다면 관리자 첫 5분으로 돌아가 트리거 채널과 매치메이커를 마쳐요.
잘 됐는지 확인해요
/관리 권한진단에 “필요한 권한이 모두 있어요. ✅”가 뜨면 성공이에요. 트리거 채널에 들어가면 내 방이 생겨요.