빠른 시작 가이드
시청자들이 매일 출석 체크하고, 연속 기록을 쌓을 수 있는 기능이에요. 출석 변수를 명령어에 넣으면 나만의 출석 시스템을 만들 수 있어요.
출석 체크 만들기
출석 체크 명령어를 만들려면 $attendance 변수를 사용해요.
$attendance출석 체크 완전판. 자동으로 출석 메시지를 생성해요.
!추가 !출첵 $attendance마지막남은뚜또: !출첵마지막남은뚜또님, 이 채널의 42번째 출석입니다! (연속 7일)명령어에 $nick이나 $name이 없으면 자동으로 닉네임을 포함해요. $att_combo가 없고 연속 출석이 2일 이상이면 자동으로 연속 일수를 포함해요.
!추가 [원하는명령어] $attendance
명령어 이름은 자유롭게
!출첵, !출석, 뚜하 등 원하는 이름으로 만들 수 있어요.
예시:
!추가 !출첵 $attendance→!출첵으로 출석!추가 !출석 $attendance→!출석으로 출석!추가 뚜하 $attendance→뚜하로 출석
시청자가 명령어를 입력하면 이렇게 나와요.
- 처음 출석:
마지막남은뚜또님, 이 채널의 1번째 출석입니다! - 이미 출석함:
마지막남은뚜또님은 이미 출석하셨습니다! (1회 출석) - 다음 날 출석:
마지막남은뚜또님, 이 채널의 2번째 출석입니다! (연속 2일)
출석은 매일 자정(00:00, 한국 시간)에 초기화돼요. 하루에 한 번만 출석할 수 있어요!
방송 중에만 가능
$attendance는 방송 중에만 출석 가능해요!
방송 중이 아니면 방송중이 아닙니다. 방송중에만 출석체크가 가능합니다!가 출력돼요.
연속 출석 규칙
매일 방송하지 않아도 연속 기록이 유지돼요
뚜봇은 직전 방송을 기준으로 판단해요. 그래서 주 2~3회만 방송해도 시청자의 연속 출석이 끊기지 않아요.
아래 중 하나라도 해당하면 연속 일수가 1 올라가요.
| 조건 | 설명 |
|---|---|
| 마지막 출석일 = 직전 방송 시작일 | 지난 방송에 출석했으면 유지 |
| 마지막 출석일 = 직전 방송 종료일 | 새벽까지 이어진 방송도 인정 |
| 마지막 출석일 = 어제 | 하루 있어도 이어져요 |
| 마지막 출석일 = 그저께 | 2일까지 봐줘요 |
전부 해당하지 않으면 연속 일수가 1로 초기화돼요.
예시 — 화요일과 금요일에만 방송하는 채널
- 화요일 방송에서 출석 → 연속 1일
- (수·목 방송 없음)
- 금요일 방송에서 출석 → 마지막 출석일이 직전 방송 시작일(화요일) 과 같으므로 → 연속 2일 ✅
봇이 직전 방송 시각을 모를 때
봇을 처음 붙였거나 방송 기록이 없는 상태에서는 연속을 끊지 않고 그대로 이어줘요. 시청자가 손해 보지 않도록 하기 위해서예요.
출석 메시지 커스터마이징
$attendance 대신 개별 변수를 조합하면 원하는 메시지를 만들 수 있어요!
인사말 추가하기
!추가 !출첵 $nick님! 반가워요! $attendance
명령어에 $nick이나 $name이 있으면, $attendance에서 닉네임을 중복으로 안 나타내요.
출석 변수 상세
$att_add - 출석 횟수 추가
$att_add출석 횟수를 1 올리고, 출석 횟수를 출력해요.
!추가 !출석업 $nick님 $att_add번째 출석하셨습니다!마지막남은뚜또: !출석업마지막남은뚜또님 42번째 출석하셨습니다!당일에 이미 출석했으면 횟수를 올리지 않고 현재 횟수만 출력해요.
방송이 꺼져 있으면
$att_add 는 [방송이 꺼져있습니다.]를 출력해요. 방송 중에만 쓸 수 있어요.
$att_count - 출석 횟수 확인
$att_count현재 총 출석 횟수를 출력해요. (횟수를 올리지 않음)
!추가 !내출석 $nick님의 총 출석 횟수: $att_count번!내출석마지막남은뚜또님의 총 출석 횟수: 42번$att_combo - 연속 출석
$att_combo연속 출석 횟수를 출력해요.
!추가 !연속출석 $att_combo번째 연속 출석이에요!!연속출석7번째 연속 출석이에요!$att_last - 마지막 출석 날짜
$att_last마지막으로 출석한 날짜를 출력해요.
!추가 !마지막출석 마지막 출석: $att_last!마지막출석마지막 출석: 2024-11-18$att_check - 출석 가능 여부
$att_check오늘 출석 가능 여부를 출력해요. 가능하면 True, 이미 했으면 False
!추가 !출석가능 출석 가능 여부: $att_check!출석가능출석 가능 여부: True조건부 출석
$att_check와 삼항 연산자를 조합하면, 출석 여부에 따라 다른 메시지를 보여줄 수 있어요!
!추가 !출석 #ternary:$att_check==True?$nick님 $att_add번 출석!:$nick님 오늘은 이미 출석하셨어요!
$att_silent - 조용한 출석
$att_silent출석 처리만 하고 아무것도 출력하지 않아요.
!추가 !조용한출석 $att_silent!조용한출석(아무것도 출력되지 않음)다른 변수와 조합해서 커스텀 메시지만 출력하고 싶을 때 유용해요!
방송이 꺼져 있으면
$att_silent 는 방송 중이 아닐 때 출석 처리를 하지 않고 조용히 넘어가요. 에러 메시지도 나오지 않아요.
$att_time - 마지막 출석 시간
$att_time마지막 출석 날짜와 시간을 함께 출력해요.
!추가 !출석시간 마지막 출석: $att_time!출석시간마지막 출석: 2024-11-18 15:30:42출석 기록이 없으면
$att_last 는 2005-03-04, $att_time 은 2005-03-04 00:00:00 이 나와요.
빈칸이 아니라 이 날짜가 "기록 없음" 표시예요.
$att_count_month - 이번 달 출석
$att_count_month이번 달 출석 횟수를 출력해요.
!추가 !이달출석 이번 달 출석: $att_count_month 번!이달출석이번 달 출석: 15 번변수 뒤에 글자를 바로 붙이지 마세요. $att_count_month번 처럼 붙여 쓰면 $att_count 가 먼저 걸려 값이 깨질 수 있어요.
$att_count_month:N - N개월 전 출석
$att_count_month:NN개월 전의 출석 횟수를 출력해요.
!추가 !지난달출석 지난달 출석: $att_count_month:1 번!지난달출석지난달 출석: 20 번$att_count_month:1은 지난달, $att_count_month:2는 2달 전 출석 횟수예요.
1~12만 입력할 수 있어요
1 부터 12 까지(또는 01~09)만 인식해요. 그 밖의 값을 넣으면 이렇게 나와요.
[오류, 월 서식이 잘못되었습니다.]
13개월 이상 거슬러 올라가려면 아래 $att_count_period: 를 쓰세요.
$att_count_period - 기간별 출석
$att_count_period:시작~끝특정 기간의 출석 횟수를 출력해요.
!추가 !올해출석 올해 출석: $att_count_period:2024-01-01~2024-12-31 번!올해출석올해 출석: 150 번날짜 형식
날짜는 YYYY-MM-DD 형식으로, 물결(~)로 이어서 입력해주세요.
2024-01-01~2024-12-31 처럼 띄어쓰기 없이 붙여 씁니다.
| 잘못 입력하면 | 나오는 메시지 |
|---|---|
| 물결이 없거나 두 개 이상 | [오류, 기간 서식이 잘못되었습니다.] |
| 시작 날짜 형식이 틀림 | [오류, 시작 날짜 파싱 실패] |
| 종료 날짜 형식이 틀림 | [오류, 종료 날짜 파싱 실패] |
종료일 당일도 포함돼요
2024-01-01~2024-12-31 로 조회하면 12월 31일의 출석까지 포함해서 세어줘요.
하루 모자라게 나오지 않으니 그대로 쓰시면 돼요.
이번 달·기간 조회는 서버 기록을 씁니다
$att_count_month, $att_count_month:N, $att_count_period: 세 개는 서버에 쌓인 출석 로그를 조회해요.
아주 드물게 조회가 실패하면 [오류, 조회 실패] 가 나올 수 있어요. 잠시 뒤 다시 시도해보세요.
변수 비교표
| 변수 | 기능 | 횟수 증가 | 방송 중에만 |
|---|---|---|---|
$attendance | 출석 완전판 (자동 메시지) | ✅ | ✅ |
$att_add | 출석 처리 + 횟수 출력 | ✅ | ✅ |
$att_silent | 조용한 출석 (출력 없음) | ✅ | ✅ |
$att_count | 출석 횟수만 출력 | ❌ | ❌ |
$att_combo | 연속 출석 횟수 출력 | ❌ | ❌ |
$att_last | 마지막 출석 날짜 | ❌ | ❌ |
$att_time | 마지막 출석 날짜+시간 | ❌ | ❌ |
$att_check | 출석 가능 여부 (True/False) | ❌ | ❌ |
$att_count_month | 이번 달 출석 횟수 | ❌ | ❌ |
$att_count_month:N | N개월 전 출석 횟수 | ❌ | ❌ |
$att_count_period: | 기간별 출석 횟수 | ❌ | ❌ |
조회용 변수(❌ 표시) 는 방송이 꺼져 있어도 쓸 수 있어요.
!내출석, !연속출석 같은 확인 명령어는 방송 밖에서도 잘 동작해요.
예시: 나만의 출석 명령어
기본 출석
!추가 !출석 $nick님 $att_add 번째 출석! (연속 $att_combo 일)
결과: 마지막남은뚜또님 42 번째 출석! (연속 7 일)
이름이 겹치는 변수끼리는 뒤에 글자를 바로 붙이지 마세요. $att_count_month번 처럼 쓰면 $att_count 가 먼저 걸려 값이 깨질 수 있어요.
어느 쪽이 먼저 걸릴지는 매번 달라서, 잘 나오다가 갑자기 깨지기도 합니다.
($att_add번째 는 이름이 겹치는 변수가 없어 안전해요.)
조건부 출석 (중복 방지)
!추가 !출석 #ternary:$att_check==True?$nick님 $att_add 번 출석! 연속 $att_combo 일!:$nick님 오늘은 이미 출석하셨어요!
처음 출석: 마지막남은뚜또님 42 번 출석! 연속 7 일!
중복 출석: 마지막남은뚜또님 오늘은 이미 출석하셨어요!
출석 확인
!추가 !내출석 $nick님의 출석 정보 - 총 $att_count번 / 연속 $att_combo일 / 마지막: $att_last
결과: 마지막남은뚜또님의 출석 정보 - 총 42번 / 연속 7일 / 마지막: 2024-11-18
자주 겪는 문제
| 증상 | 원인 | 해결 |
|---|---|---|
방송중이 아닙니다. 방송중에만 출석체크가 가능합니다! | 방송이 꺼져 있음 | 방송을 켠 뒤 다시 시도 |
숫자 대신 [방송이 꺼져있습니다.] 가 나옴 | $att_add 를 방송 밖에서 사용 | 방송 중에만 쓰거나, 조회는 $att_count 사용 |
| 연속 일수가 안 나와요 | $attendance 는 연속이 2일 이상일 때만 자동 표시 | 항상 보이게 하려면 $att_combo 를 직접 넣으세요 |
| 닉네임이 두 번 나와요 | $nick 과 $attendance 를 같이 쓰면 자동으로 하나만 나와요 | 정상 동작 — $name 도 동일 |
| 연속이 자꾸 1로 돌아가요 | 마지막 출석이 직전 방송·어제·그저께 중 어디에도 안 걸림 | 위 연속 출석 규칙을 확인해보세요 |
[오류, 조회 실패] | 서버 조회 일시 실패 | 잠시 뒤 다시 시도 |
출석 현황은 대시보드에서
대시보드 출석 현황 페이지에서 시청자별 출석 횟수와 연속 일수를 한눈에 볼 수 있어요.
출석 횟수 옆에 (2일 연속) 처럼 연속 일수가 함께 표시돼요. 연속이 끊긴 시청자는 횟수만 나와요.
다음 단계
출석 체크를 익혔다면, 다른 시청자 참여 기능도 확인해보세요!