권한

LFG Hub가 채널을 만들고, 멤버를 이동하고, 그룹을 관리하려면 알맞은 디스코드 권한과 충분히 높은 역할이 필요합니다. 이 페이지에서 정확히 무엇이 필요한지, 그리고 가장 자주 놓치는 설정 한 가지를 설명합니다.

필요한 봇 권한

초대 링크는 관리자와 아래의 각 권한을 요청하며, 각각 디스코드 화면에서 별도의 체크박스로 표시됩니다. 봇은 서버에 들어올 때, 역할이 바뀔 때, 설정 중에 권한을 다시 확인하고 부족하면 알려 줍니다. 초대만으로 충분하다고 보장할 수는 없습니다. 디스코드는 승인 중에 권한 체크를 해제할 수 있게 하고, 역할은 나중에 수정될 수도 있기 때문입니다.

게시와 읽기

권한	필요한 이유
채널 보기	채널을 보고 게시하고 관리하기 위해
메시지 기록 읽기	자신이 올린 이전 게시물을 찾아 수정하기 위해
메시지 전송/게시물 생성	팀원 모집 메시지와 상태 업데이트를 올리기 위해
스레드/게시물에 메시지 전송	그룹 채팅에서 대화하기 위해
링크 임베드	그룹 카드를 표시하기 위해 — 없으면 디스코드가 카드를 버튼만 남기고 지워 버립니다
외부 이모지 사용	게임과 상태 아이콘을 표시하기 위해
메시지 관리	팀원 모집 채널을 깔끔하게 유지하고, 멤버의 글을 그룹 메모로 바꾸기 위해
슬로우 모드 우회	슬로우 모드가 켜진 채널에서도 그룹 업데이트를 올리기 위해

그룹 채팅

권한	필요한 이유
공개 스레드 생성	비공개 스레드를 쓸 수 없을 때 그룹 채팅을 열기 위해
비공개 스레드 생성	그룹의 비공개 채팅을 열기 위해 — 스레드 권한이 없으면 그룹에 참여할 곳이 없습니다
스레드/게시물 관리	끝난 그룹 채팅을 보관하고 정리하기 위해

음성

권한	필요한 이유
연결	음성 채널에 들어가기 위해
말하기	게임 채널에서 음성 상태를 표시하기 위해
음성 활동 사용	푸시 투 토크 없이 음성 상태를 표시하기 위해
멤버 이동	플레이어를 그룹의 음성 채널로 옮기기 위해
음성 채널 상태 설정	음성 채널의 상태 문구를 설정하기 위해

서버 관리

권한	필요한 이유
채널 관리	그룹 음성 채널과 카테고리를 만들고 삭제하기 위해
역할/권한 관리	그룹별 핑 역할을 만들어 부여하고, 자신의 채널 접근 권한을 복구하기 위해
웹훅 관리	팀원 모집 카드를 그룹장 이름으로 올리기 위해
초대 생성	다른 서버의 플레이어를 내 서버 그룹에 초대하기 위해
감사 로그 보기	누가 봇을 초대했는지 확인해, 설정 안내가 서버 주인뿐 아니라 그 사람에게도 가도록 하기 위해

권장

관리자 권한을 주면 위의 모든 권한이 해결되고 권한 문제도 피할 수 있습니다. 아래에서 설명하는 채널 권한 덮어쓰기도 관리자에게는 적용되지 않습니다. 최소 권한 원칙이 필요한 커뮤니티라면 봇을 추가할 때 관리자 체크를 해제하고 나머지는 그대로 체크해 두세요. 다만 권한 하나만 빠져도 음성 자동화가 조용히 실패할 수 있습니다.

채널 권한 덮어쓰기가 모든 것에 우선합니다

서버 설정 → 역할에서 LFG Hub 역할에 권한을 주는 것만으로는 부족합니다. 채널에서 거부된 권한(대개 @everyone에 대한 거부)은 봇이 서버 전체에서 그 권한을 갖고 있어도 그 채널에서는 거부됩니다. 관리자만 예외입니다.

팀원 모집 채널에서 특히 문제가 되는데, 관련된 두 권한은 조용히 실패하기 때문입니다.

• 링크 임베드 거부 → 디스코드가 그룹 카드 내용을 지웁니다. 멤버에게는 그룹 정보 없이 버튼만 있는 메시지로 보입니다.
• 비공개 스레드 생성과 공개 스레드 생성 모두 거부 → 음성 채널이 없는 그룹은 그룹 채팅도 없어서, 참여 버튼이 보낼 곳이 없습니다.

봇은 가능하면 스스로 고칩니다. 그 채널에서 역할/권한 관리 권한이 있으면 덮어쓰기로 빠진 권한을 스스로 다시 부여합니다. 할 수 없으면 그 채널에서 /팀원모집-설정을 끝내지 않고 어떤 권한이 없는지 정확히 알려 줍니다.

해결 방법: 채널 열기 → 채널 편집 → 권한 → 멤버 또는 역할 추가 → LFG Hub 역할 선택 → 안내된 권한 허용. 역할별 덮어쓰기는 @everyone 뒤에 적용되므로 우선합니다.

역할 순서

가장 자주 놓치는 요건입니다.

봇에게 관리자 권한이 없다면, 봇의 가장 높은 역할이 서버의 관리자 아닌 역할 상위 5개 안에 있어야 합니다. 디스코드는 봇이 자신의 역할보다 아래에 있는 역할과 멤버만 관리하게 하므로, 봇의 역할이 너무 낮으면:

• 그룹의 핑 역할을 부여할 수 없고,
• 멤버를 음성 채널 사이에서 옮길 수 없으며,

…이런 실패는 조용히 일어납니다. 봇이 이를 감지하면 관리자에게 역할을 올리라고 알립니다. 신고 채널이 있으면 그곳에, 없으면 DM으로 보냅니다.

해결 방법: 서버 설정 → 역할을 열고 봇의 역할을 목록 맨 위 가까이로 끌어 올리세요.

명령어 사용 권한 다시 부여하기

관리자 명령어(/setup, /팀원모집-설정)는 기본적으로 서버 관리 권한이 있는 멤버에게만 보입니다. 대시보드도 같은 규칙을 따릅니다. 다른 역할이나 멤버가 명령어를 쓰게 하려면 서버 설정 → 연동 → LFG Hub에서 명령어별로 접근 권한을 조정하세요.

다음: 설정 →