⚔️ 보스 알리미(보알)

디스코드 서버에 추가 대시보드 열기 추가 후 아래 3단계를 반드시 진행하세요

시작하기 — 관리자 (서버에 처음 넣을 때 한 번)

1	봇을 서버에 추가합니다. 권한 요청에 메시지 보내기·TTS 메시지 보내기·연결·말하기가 포함됩니다.
2	/보알 게임 설정 — 추적할 게임을 고릅니다. 고르지 않으면 보스 명령이 동작하지 않습니다.
3	/보알 채널 설정 — 알림을 보낼 채널을 지정합니다. 이걸 안 하면 알림이 한 건도 나가지 않습니다.

확인은 /보알 설정 보기 · 명령 안내는 /도움말. 2·3단계는 서버 관리 권한이 필요합니다.

시작하기 — 일반 멤버 (봇이 이미 있는 서버라면 여기부터)

설치할 것이 없습니다. 관리자가 봇을 넣어 뒀다면 디스코드에서 / 를 치는 것만으로 바로 씁니다.

1	디스코드에서 바로 사용 — /컷 으로 컷을 넣고, 알림 메시지의 참여 버튼을 누릅니다. 따로 로그인할 필요가 없습니다.
2	알림을 받으려면 관리자가 지정한 알림 채널을 볼 수 있어야 합니다. 알림이 안 오면 그 채널이 보이는지 먼저 확인하세요. 멘션(핑)까지 받으려면 관리자가 /보알 역할 설정 으로 지정한 역할이 있어야 합니다 — 관리자에게 요청하세요.
3	음성 알림을 들으려면 관리자가 지정한 음성 채널(또는 사람이 가장 많은 음성 채널)에 들어가 있어야 합니다. 디스코드 내장 TTS 방식이면 내 클라이언트 설정에서 텍스트 음성 변환을 켜고 그 채널을 보고 있어야 들립니다.
4	(선택) 대시보드 로그인 — 남은 시간·로그·기여도 순위를 웹에서 보려면 위 대시보드 에서 디스코드로 로그인하고 서버를 고릅니다.

대시보드 로그인 — 무엇을 허용하게 되나

디스코드 로그인 시 봇이 요청하는 것은 두 가지뿐입니다.

identify	내 디스코드 사용자 이름·ID (본인 확인용)
guilds	내가 속한 서버 목록 — 어느 서버의 대시보드를 열 수 있는지 판단하는 데만 씁니다

메시지·DM·이메일은 요청하지 않습니다. 목록에 없는 서버는 URL 을 직접 입력해도 열리지 않습니다.

일반 멤버가 볼 수 있는 것

기록으로 남는 것: 참여를 누른 회차·시각과 그 시점의 표시 이름, 아이템 획득을 입력했다면 그 아이템명입니다. 닉네임을 바꿔도 당시 기록의 이름은 그대로 남습니다.

보스 시간 입력 — 누구나

컷 지역 좁히기(/보알 설정 컷지역 또는 대시보드 > 설정, 기본 꺼짐) — 켜면 /컷 의 보스명에 지역/보스 로 쳐서 후보를 좁힐 수 있습니다. 예: 오염된 강줄기/베나투스 · 오염/베나(부분 일치) · 오염/(그 지역 전체). 이름이 비슷한 보스가 많을 때 고르기 쉬워집니다. 지역 때문에 후보가 0건이 되면 좁히기 전 목록으로 되돌려 보여주므로 "그런 보스 없음"으로 막히지는 않습니다. 꺼진 상태에서 지역을 넣으면 지역만 무시하고 이름으로 찾은 뒤, 무시했다고 응답에 알려줍니다 (조용히 버리지도, 없는 보스로 거절하지도 않습니다).

보스명은 자동완성됩니다 — 몇 글자만 치면 가레스 — Lv.98 · 죽은 자의 대지 1구역 처럼 레벨·지역이 함께 뜨고, 별칭으로도 찾힙니다(달리아 → 레이디 달리아).
모든 명령이 슬래시 커맨드입니다 — / 를 치면 목록이 뜹니다. 컷은 급하게 치는 입력이라 /컷만 최상위에 두고, 나머지는 /보알 아래에 모았습니다.

시각 해석 규칙 — 헷갈리기 쉬운 부분

컷은 과거로	새벽 3시에 /컷 가레스 2330 → 어제 23:30. 오늘로 읽으면 등장이 하루 늦게 잡혀 그날 보스를 놓칩니다.
등장은 미래로	23:03 에 /보알 타이머 젠 벤지 0032 → 내일 00:32.
고정 보스	컷과 무관하게 시간표를 따릅니다(예: 토 22:00). 컷을 넣어도 시간표 기준으로 잡히고, 응답에 그 사실을 표시합니다.

등장 방식

방식	필수값	계산
주기	주기(시간)	컷 시각 + 주기
고정	요일 + 시각	시간표상 다음 시각

자동 재예약 — 등장 시각이 지나고 유예시간(기본 10분) 안에 컷 입력이 없으면 그 시각에 등장한 것으로 보고 다음 주기를 자동으로 잡습니다. 안 그러면 목록이 과거 시각으로 굳어 알림이 영영 오지 않습니다. 자동으로 넘어간 회차는 목록에 (자동 N회)로 표시됩니다.

구글 시트 연동 — 관리자 (선택)

참여 기록·득템·멤버 집계를 본인 구글 시트로 내보냅니다. 대시보드에서 보는 것으로 충분하다면 안 쓰셔도 됩니다 — 시트는 직접 가공·수식·공유가 필요할 때 값어치가 있습니다.

시트는 본인 소유로 남습니다 — 봇은 편집자로 쓰기만 하고, 공유를 해제하면 즉시 끊깁니다. 다만 편집자로 들어가 있는 동안에는 봇 운영자도 기술적으로 그 시트에 접근할 수 있다는 점은 알고 계세요.
내보내기는 단방향(봇 → 시트)이고 탭을 통째로 갈아끼웁니다 — 시트에서 직접 고친 값은 다음 내보내기에 덮어써집니다. 가공은 별도 탭에서 하세요.

서버 점검 — 관리자

/보알 점검 시작 [시각] — 점검 들어가기 전에 실행합니다. 알림 발송과 자동 재예약이 멈춥니다(보스 시간표 자체는 그대로 둡니다 — 점검 중 게임 시간이 멈추므로 미리 지울 필요가 없습니다). 값을 안 주면 지금 즉시 시작합니다.

/보알 점검 종료 [시각] — 점검이 끝나면 실행합니다. 주기형 보스 전체를 그 시각을 컷으로 본 것처럼 한 번에 재설정합니다(/컷 을 보스마다 반복할 필요가 없습니다). 고정 보스는 시간표(절대 시각)를 그대로 따르므로 건드리지 않습니다.

시각 입력 형식 — 두 명령 공통

구분자를 넣어도 됩니다 — 2026-08-24 06:00 처럼 써도 같은 값입니다. 날짜를 함께 주면 절대 시각이라 두 명령에서 같은 문자열이 같은 시각을 뜻합니다(방향 추정이 없습니다).

예약

두 명령 모두 미래 시각을 주면 예약이 됩니다.

시작 예약	그 시각까지는 평소대로 알림이 나가다가, 시각이 되면 따로 명령 없이 점검 상태로 전환됩니다.
종료 예약	그 시각이 되면 주기형 보스 전체를 그 시각 기준으로 재설정하고 점검을 풉니다. 기준이 '실행된 순간'이 아니라 '예약한 시각'이라, 봇이 잠깐 늦게 처리해도 젠이 밀리지 않습니다.

예약을 바꾸려면 같은 명령을 새 값으로 다시 실행하면 마지막 값으로 덮어씁니다. 점검을 새로 시작하면 이전 종료 예약은 지워집니다 — 남겨 두면 옛 예약 시각에 새 점검이 제멋대로 풀립니다.

대시보드 보스 일정 화면 상단에 점검 중임을 알리는 배너가 뜹니다.

타이머 전체 삭제

/보알 타이머 초기화 — 이 서버의 보스 시간을 모두 지웁니다(재설정이 아니라 삭제). 되돌릴 수 없어서 확인 버튼을 한 번 더 누르게 되어 있습니다(5분 안에). 점검 후 일괄 재설정이 목적이면 위 점검 종료 가 더 낫습니다 — 이건 데이터를 아예 지워야 할 때만 씁니다.

주기 보스	보스 명단으로 돌아가 컷 입력을 기다립니다.
고정 보스	시간표가 절대 시각이라 잠시 뒤 자동 복구됩니다.

컷 버튼 — 등장 1분 전부터

등장 1분 전 알림과 등장 정각 알림에 컷 버튼이 붙습니다. 보스를 잡은 뒤 버튼만 누르면 /컷 을 치지 않아도 지금 시각으로 컷이 들어갑니다.

디스코드 버튼은 보낸 뒤 스스로 활성화되지 못하기 때문에, "1분 전 활성화"는 1분 전 알림에 버튼을 붙이는 방식으로 동작합니다(10분·5분 전 알림에는 없습니다). 알림 시점에 1분 이하가 없으면 가장 늦은 알림에 붙습니다.
지난 회차의 버튼은 눌러도 거부됩니다 — 어제 알림의 버튼으로 오늘 타이머가 갱신되는 것을 막습니다.

참여 · 아이템 획득

컷을 입력하면 응답에 버튼 3개가 붙습니다.

참여	그 회차 참여자로 기록합니다(중복 클릭은 무시).
참여자 확인	현재 참여자 명단을 본인에게만 보여줍니다.
아이템 획득	아이템명을 입력하면 그 회차 기록에 남습니다. 로그·통계에서 확인합니다.

기록은 /보알 로그·/보알 통계 또는 대시보드에서 봅니다. 대시보드에서는 관리자가 잘못 눌린 참여를 취소할 수 있습니다.

알림

기본은 10분 전 · 5분 전 · 1분 전 · 등장 정각 4회입니다. /보알 알림 시점 으로 바꿉니다(예: 30,10,0, 0=정각). /보알 역할 설정 으로 멘션할 역할을 지정할 수 있습니다.

음성 알림

대시보드 → 설정에서 고릅니다. 음성 채널 재생은 목소리도 선택할 수 있습니다(서버에 TTS 키가 있을 때 목록이 자동으로 채워집니다). 내장 TTS 는 받는 사람의 클라이언트 목소리를 쓰므로 선택 대상이 아닙니다.

보스 점수 — 기여도·우선순위

보스마다 점수를 매기면 멤버 기여도가 자동 계산됩니다 — 포인트 = Σ(참여한 보스 점수). 통계의 멤버 순위가 이 포인트 기준으로 정렬되고, 보스 목록에도 점수가 표시돼 우선순위를 판단할 수 있습니다.

/보알 보스 점수	보스 하나의 점수 설정. 점수를 비우면 게임 기본값으로 되돌립니다.
대시보드 → 점수	표에서 한눈에 편집. 레벨 구간 일괄 적용으로 수십 종을 한 번에 채울 수 있습니다.

점수는 이 서버에만 적용됩니다 — 같은 게임을 쓰는 다른 서버에 영향이 없습니다. 0 은 "점수 없음"이라는 의도적 값이고, 비우는 것(기본값 복귀)과 다릅니다.

관리자 명령 — 서버 관리 권한 필요

목록에는 모두에게 보이지만 실행은 관리자만 됩니다(설명에 [관리자] 표기). 디스코드 권한은 최상위 명령 단위라 /보알 전체를 잠그면 조회 기능까지 막히기 때문입니다.

⚠️ /보알 보스 삭제 와 /보알 타이머 삭제 는 다릅니다. 앞의 것은 보스 자체를 없애고(같은 게임을 쓰는 모든 서버에서), 뒤의 것은 그 보스의 입력된 시간만 지웁니다.

보스 카탈로그 — 봇 관리자(운영자)만

보스 카탈로그(등록·수정·삭제·별칭)는 같은 게임을 쓰는 모든 서버가 공유합니다. 한 서버에서 보스를 지우거나 주기를 고치면 다른 서버의 타이머·참여 기록까지 함께 바뀌기 때문에, 서버 관리 권한이 아니라 봇 관리자만 바꿀 수 있습니다. 실행하면 «봇 관리자만 바꿀 수 있습니다» 안내가 뜹니다 — 변경이 필요하면 봇 운영자에게 요청하세요. 점수는 이 서버에만 적용되므로 서버 관리자가 바꿀 수 있습니다.

대시보드

보스 일정	남은 시간이 한눈에. 30초마다 자동 새로고침
로그	날짜별 회차 · 참여자 · 획득 아이템
통계	멤버별/보스별 참여 순위, 기간 선택, 멤버 상세
점수	보스별 점수 · 레벨 구간 일괄 적용 (관리자)
보스 관리	이 게임의 보스 설정(주기·고정 시간표·레벨·등장 지역) 확인 (관리자 · 편집은 봇 관리자만)
설정	게임·채널·역할·알림 시점·음성 알림 (관리자)

대시보드 열기