왜 Discord 봇이 필요한가
| 기능 | 설명 |
|---|---|
| 내전 자동 공지 | 웹에서 내전을 만들면 Discord에 내전 카드가 자동 게시됩니다 |
| 대기열 참가 | 멤버가 Discord 버튼으로 대기열에 참가할 수 있습니다 |
| 호출 알림 | 운영진이 호출하면 멤버에게 DM이 전송됩니다 |
| 예약 리마인더 | 예약 내전 시작 30분/10분/직전에 자동 알림이 전송됩니다 |
| 마감 배너 | 내전 마감 시 참가자 이미지가 자동 생성됩니다 |
📊운영 흐름을 설명하는 다이어그램이 곧 추가됩니다.
시작 전 확인사항
- ARRA.GG에서 클랜을 생성했는가
- Discord 서버에서 관리자(Administrator) 권한을 가지고 있는가 (
/클랜등록,/채널설정실행에 필요) - 클랜 설정 페이지에서 클랜코드를 확인했는가
1단계: 봇 초대하기
- ARRA.GG 클랜 설정 페이지에서 Discord 봇 초대 링크를 확인합니다.
- 초대 링크를 클릭합니다.
- 봇을 추가할 Discord 서버를 선택합니다.
- 요청되는 권한을 확인하고 승인합니다. 아래 표의 권한만 필요하며, 서버 전체 관리자(Administrator) 권한을 봇에 줄 필요는 없습니다.
📷이 위치에 실제 화면 예시가 추가될 예정입니다.
봇이 필요로 하는 권한
| 권한 | 용도 |
|---|---|
| 채널 보기 | 현황판/알림판 채널 접근 |
| 메시지 보내기 | 내전 카드, 호출 알림 전송 |
| 링크 임베드 | 내전 카드를 임베드 형태로 표시 |
| 메시지 기록 읽기 | 기존 메시지 확인 및 수정 |
| 채널 관리 | 현황판/알림판 채널 자동 생성 |
| 역할 관리 | 채널 권한 자동 설정 |
| 메시지 관리 | 현황판 메시지 정리 (/리프레시) |
2단계: 클랜 등록 (/클랜등록)
봇을 초대한 Discord 서버에서 슬래시 커맨드를 실행합니다.
/클랜등록 클랜코드:여기에_코드_입력
| 옵션 | 필수 | 설명 |
|---|---|---|
클랜코드 | O | ARRA.GG 클랜 설정에서 확인한 코드 |
인증역할 | X | 본인확인 완료 시 자동 부여할 Discord 역할 (선택) |
📷이 위치에 실제 화면 예시가 추가될 예정입니다.
주의사항:
- Discord 서버 관리자(Administrator) 권한이 필요합니다.
- 서버당 1개 클랜만 연결할 수 있습니다. 다른 클랜을 연결하려면 다른 서버를 사용하세요.
- 클랜코드는 ARRA.GG 클랜 설정 페이지에서 확인할 수 있습니다.
3단계: 채널 설정 (/채널설정)
봇이 사용할 채널을 지정합니다. 지정하지 않으면 자동으로 감지합니다.
/채널설정
| 옵션 | 필수 | 설명 |
|---|---|---|
현황채널 | X | 내전 카드가 표시될 읽기전용 채널 |
알림채널 | X | 대기열 허브, 호출 알림이 전송될 채널 |
채널 자동 생성
/클랜등록 실행 시 봇이 서버에 처음 들어오면 두 채널이 자동으로 생성됩니다:
| 채널 | 이름 | 용도 |
|---|---|---|
| 현황판 | 📋-현황판-by-아라지지 | 읽기전용. 열린 내전 카드와 웹 링크 표시 |
| 알림판 | 🔔-알림판-by-아라지지 | 대기열 허브, 호출 알림, 리마인더 표시 |
📷이 위치에 실제 화면 예시가 추가될 예정입니다.
채널 권한 자동 설정:
- 현황판: @everyone은 읽기만 가능, 봇은 전체 관리
- 알림판: @everyone은 읽기+쓰기+슬래시 커맨드 사용 가능, 봇은 전체 관리
4단계: 대기열 허브 게시 (/대기열허브)
알림판 채널에 대기열 참가 버튼이 있는 허브 메시지를 게시합니다.
/대기열허브
📷이 위치에 실제 화면 예시가 추가될 예정입니다.
주의사항:
- 서버 관리(ManageGuild) 권한이 필요합니다. Administrator가 아니어도 이 권한만 있으면 실행 가능합니다.
- 알림채널이 설정되어 있어야 합니다. 설정되지 않았으면 먼저
/채널설정을 실행하세요. - 허브 메시지는 하나만 존재합니다. 다시 실행하면 기존 메시지가 업데이트됩니다.
설정 완료 확인 체크리스트
- 봇이 서버에 있다
-
/클랜등록이 성공했다 - 현황판 채널이 있고, 안내 메시지가 표시된다
- 알림판 채널이 있고, 안내 메시지가 표시된다
-
/대기열허브를 실행하여 허브 메시지가 게시되었다 - 웹에서 테스트 내전을 만들면 현황판에 카드가 표시된다
추가 명령어
/대기열
모든 멤버가 사용할 수 있습니다. 대기열 참가/취소/상태확인/호출 버튼을 표시합니다.
- 응답은 본인에게만 보입니다 (다른 사람에게 보이지 않음).
- 허브 메시지의 버튼과 동일한 기능입니다.
/리프레시
현황판 메시지를 모두 삭제하고 다시 게시합니다.
- 서버 관리(ManageGuild) 권한이 필요합니다.
- 현황판이 꼬였거나 오래된 메시지가 남아있을 때 사용하세요.
- 열린 내전이 없으면 현황판은 비어있는 상태가 정상입니다.
자주 헷갈리는 포인트
-
"Discord로 로그인"과 "Discord 봇 연동"은 다릅니다.
- Discord 로그인: 유저가 ARRA.GG에 접속하는 방법
- Discord 봇 연동: 운영진이 Discord 서버에 봇을 설치하는 것
-
채널 이름을 변경하면 자동감지가 실패합니다.
- 채널 이름을 바꿨다면
/채널설정으로 채널을 다시 지정하세요.
- 채널 이름을 바꿨다면
-
서버당 1개 클랜만 연결됩니다.
- 여러 클랜을 운영하려면 각 클랜마다 별도 Discord 서버가 필요합니다.
-
봇 역할 순서가 중요합니다.
- 서버 설정 > 역할에서 봇 역할이 다른 역할보다 위에 있어야 채널 권한을 자동 설정할 수 있습니다.
문제가 발생했을 때
- 내전 & 대기열 문제 해결 (봇 관련 문제 포함)