대기열이란
대기열은 내전에 참가하고 싶은 멤버가 미리 등록하고, 운영진이 필요할 때 호출하는 시스템입니다.
| 직접 참가 | 대기열 |
|---|---|
| 열린 내전에 바로 참가 | 미리 등록 → 호출 대기 → 확정 |
| 운영진 개입 없음 | 운영진이 호출 |
| 즉시 확정 | 호출 → 응답 → 확정 과정 |
대기열 상태 전이
📊운영 흐름을 설명하는 다이어그램이 곧 추가됩니다.
상태 설명
| 상태 | 의미 | 다음 가능 상태 |
|---|---|---|
| 대기 중 | 대기열에 등록됨. 호출을 기다리는 중 | 호출됨, 이탈 |
| 호출됨 | 운영진이 호출함. 제한시간 내 응답 필요 | 참가 확정, 대기 중(뒤로 이동) |
| 참가 확정 | 유저가 호출에 응답하여 참가 확정 | 수집 완료 |
| 수집 완료 | 운영진이 배치를 구성하여 내전 시작 준비 완료 | (종료) |
운영 흐름: 4단계
1단계: 멤버가 대기열에 참가
멤버는 두 가지 방법으로 대기열에 참가합니다:
| 방법 | 경로 |
|---|---|
| Discord | 알림판 허브 메시지 → 참가 신청 버튼 / /대기열 → 참가 신청 |
| 웹 | 클랜 페이지 → 대기열 탭 (/clans/[id]/waiting) |
운영진은 웹 QueueBoard에서 현재 대기 인원을 실시간으로 확인할 수 있습니다 (5초 간격 자동 갱신).
2단계: 호출
운영진이 필요한 인원만큼 호출합니다.
웹에서 호출:
- 클랜 페이지 → 대기열 탭으로 이동합니다.
- QueueBoard 관리 패널에서 호출 버튼을 클릭합니다.
- 호출할 인원 수를 입력합니다.
Discord에서 호출:
- 허브 메시지 또는
/대기열에서 호출 버튼을 클릭합니다. - 모달이 열립니다.
- 필요 인원 수(1~99)와 메모(선택)를 입력합니다.
📷이 위치에 실제 화면 예시가 추가될 예정입니다.
호출 시 일어나는 일:
| 대상 | 알림 |
|---|---|
| 호출된 멤버 | Discord DM: "다음 판 참여 요청이 왔습니다" + 응답 링크 |
| 알림판 | 멘션 메시지 + 참가 확정/불참 버튼 |
인원 부족 시:
- 대기 인원이 요청한 인원보다 적으면 호출이 실행되지 않고 경고가 표시됩니다.
- 알림판에 "인원 부족 — 현재 대기 X명 / 필요 Y명" 메시지가 표시됩니다.
📷이 위치에 실제 화면 예시가 추가될 예정입니다.
3단계: 응답 (확정 / 불참)
호출된 멤버가 응답합니다.
| 응답 | 결과 |
|---|---|
| 참가 확정 클릭 | 상태가 "참가 확정"으로 변경 |
| 불참 클릭 | 대기열에서 이탈 |
| 미응답 (타임아웃) | 대기열 뒤로 이동 + DM으로 타임아웃 알림 |
타임아웃 처리:
- 제한시간 내에 응답하지 않으면 자동으로 대기 중 상태의 뒤쪽으로 이동합니다.
- 봇이 30초 간격으로 타임아웃을 확인합니다.
- 탈락이 아니라 순서가 뒤로 밀리는 것이므로, 다음 호출 때 다시 호출될 수 있습니다.
4단계: 수집 (Gather)
충분한 인원이 확정되면 운영진이 배치를 수집합니다.
- 웹 QueueBoard에서 수집 버튼을 클릭합니다.
- 확정된 멤버들에게 DM이 전송됩니다: "이번 판 참가가 확정되었습니다. 준비해주세요!"
배치 관리
호출 → 확정 → 수집의 한 사이클을 배치라고 합니다.
열린 배치 vs 닫힌 배치
| 상태 | 설명 |
|---|---|
| 열린 배치 | 현재 호출 중이거나 응답 대기 중인 배치 |
| 닫힌 배치 | 수집 완료되었거나 운영진이 닫은 배치 |
웹 QueueBoard에서 열린 배치와 닫힌 배치를 탭으로 구분하여 확인할 수 있습니다.
배치 닫기/취소
| 작업 | 결과 |
|---|---|
| 배치 닫기 | 배치를 종료. 확정된 멤버는 유지 |
| 배치 취소 | 배치를 취소. 멤버가 대기열로 복귀 가능 |
운영진 전용 기능
강제 추가
특정 멤버를 대기열에 강제로 추가합니다.
- 웹 QueueBoard 관리 패널 → 강제 추가
강제 제거
특정 멤버를 대기열에서 강제로 제거합니다.
- 웹 QueueBoard 관리 패널 → 강제 제거
순서 변경
대기열의 순서를 수동으로 조정합니다.
- 웹 QueueBoard 관리 패널 → 순서 변경
리셋
대기열의 모든 항목을 초기화합니다.
- 웹 QueueBoard 관리 패널 → 리셋
- 모든 대기자가 제거되므로 주의하세요.
웹 QueueBoard 화면
📷이 위치에 실제 화면 예시가 추가될 예정입니다.
QueueBoard 구성
| 영역 | 설명 |
|---|---|
| 세그먼트 레인 | 확정됨 / 호출됨 / 대기 중으로 구분된 멤버 목록 |
| 관리 패널 | 호출, 확정, 수집, 강제 추가/제거, 순서 변경, 리셋 버튼 |
| 열린 배치 탭 | 현재 진행 중인 배치 |
| 닫힌 배치 탭 | 완료된 배치 이력 |
| 내 상태 | 운영진 본인의 대기열 상태 (참가한 경우) |
대기열 설정
클랜 설정에서 대기열 동작을 조정할 수 있습니다.
| 설정 | 설명 | 기본값 |
|---|---|---|
| 대기 인원 공개 | 현재 몇 명이 대기 중인지 Discord에서 표시 | 클랜 설정에 따름 |
| 취소 쿨다운 | 취소 후 재참가까지 대기 시간 | 클랜 설정에 따름 |
자주 헷갈리는 포인트
-
호출과 수집은 다릅니다.
- 호출: 대기 중인 멤버에게 "참가하겠습니까?" 물어보는 것
- 수집: 확정된 멤버를 모아서 내전 시작 준비를 마치는 것
-
타임아웃 시 탈락이 아니라 뒤로 밀립니다.
- 미응답한 멤버는 대기열 뒤로 이동합니다. 다음 호출에서 다시 호출될 수 있습니다.
-
Discord와 웹 양쪽에서 운영할 수 있습니다.
- 호출은 Discord에서도, 웹에서도 가능합니다.
- QueueBoard는 웹에서만 볼 수 있습니다.
- 실시간 동기화됩니다 (5초 간격).
-
인원 부족 시 호출이 실행되지 않습니다.
- 대기 인원이 요청 인원보다 적으면 호출이 차단됩니다.
-
DM 차단 유저에 주의하세요.
- Discord DM을 차단한 멤버는 호출 알림을 받지 못합니다.
- 이 경우 알림판 채널에 대체 알림이 전송되지만, 해당 멤버가 채널을 보지 않으면 놓칠 수 있습니다.
운영 팁
- 내전 시작 전에 충분한 시간을 두고 호출하세요. 응답 대기 + 타임아웃 처리에 시간이 걸립니다.
- 배치가 꼬이면 리셋보다 배치 취소를 먼저 시도하세요. 리셋은 모든 대기자를 제거합니다.
- 대기 인원 공개 설정을 활용하세요. 멤버들이 현재 몇 명이 대기 중인지 알면 참가율이 올라갑니다.