변수

$nick과 $name은 똑같이 동작해요. 편한 걸로 쓰세요. 익명 사용자(후원 익명처럼)의 경우 익명이 출력돼요.

$args 로 들어온 값 안에 $nick 같은 변수가 있어도 치환되지 않고 글자 그대로 나와요.

예시: !테스트 $nick님 안녕하세요! → 내용: $nick님 안녕하세요!

시청자가 채팅으로 변수를 넣어 남의 정보를 뽑아내지 못하게 막아둔 거예요. $nick · $name 으로 들어온 값도 마찬가지예요.

팔로우하지 않은 사용자는 [팔로우하지 않음]이 출력돼요.

팔로우하지 않은 사용자는 [팔로우하지 않음]이 출력돼요.

봇에 채널 관리자 권한 또는 대시보드 연동이 필요해요. 권한이 없으면 [오류, 봇 권한 필요]가 출력돼요.

봇에 채널 관리자 권한 또는 대시보드 연동이 필요해요. 권한이 없으면 [오류, 봇 권한 필요]가 출력돼요. 구독자가 아니거나 정보를 찾을 수 없으면 [파악 불가]가 출력돼요.

봇에 채널 관리자 권한이 필요해요. 권한이 없으면 [오류, 봇 권한 필요]가 출력돼요. 구독자가 아니거나 정보를 찾을 수 없으면 [파악 불가]가 출력돼요.

치지직이 집계한 값을 우선 써요. 권한이 없거나 값이 9999 로 막혔을 때만 뚜봇이 직접 센 채팅 수와 비교해 큰 쪽을 보여줘요. 중간에 봇을 추가한 경우, 횟수가 9999에서 멈출 수 있어요.

봇에 채팅 운영자 권한이 있으면 치지직이 집계한 값이 나와요. 권한이 없어도 동작은 하지만, 뚜봇이 직접 감지한 채팅 수만 세어 보여줘요.

(같은 권한을 쓰는 $temporaryRestrictCount · $restrictCount 는 폴백이 없어 권한이 없으면 봇에게 권한이 없습니다. 가 나와요)

봇에 채팅 운영자 권한이 필요해요.

봇에 채팅 운영자 권한이 필요해요.

일부 카테고리는 영어로 표시될 수 있어요. (예: talk)

봇에 채널 관리자 권한 또는 대시보드 연동이 필요해요.

방송 중이 아닐 때는 [방송중이 아님]이 출력돼요.

: 이 들어간 변수는 값 뒤에 띄어쓰기 한 개가 필요해요.

✅ $countdown:0000-03-04 남은 시간 (띄어쓰기 있음) ❌ $countdown:0000-03-04남은 시간 (띄어쓰기 없음)

방송마다 초기화되는 하루 카운트가 필요할 때 유용해요.

• $tempvar — 그 명령어 자기 것만 세요
• $tempvar:이름 — 같은 이름 을 쓰는 여러 명령어가 함께 셉니다

$var · $uservar 도 똑같은 규칙이에요.

!멤버 <내용> 처럼 명령어 뒤에 내용을 붙여 고치는 건 매니저 이상만 할 수 있어요. (제거 와 삭제 만 예약어예요. 그 밖의 말은 전부 메모 내용으로 저장돼요.) 저장된 내용이 없으면 [내용 없음]이 출력돼요.

!멤버 에 저장한 메모와 !공지 에 저장한 메모는 서로 다른 메모예요. 명령어 하나당 메모 하나라고 생각하시면 돼요.

시청자마다 자기만의 메모를 남길 수 있어요. 같은 명령어를 쳐도 사람마다 다른 내용이 나와요.

그날 방송에서만 쓰는 공지·목표를 적어둘 때 좋아요. 다음 방송이면 자동으로 지워져요.

$userMemo: · $tempMemo: · $tempUserMemo: 도 비슷하게 동작해요. $userMemo: 와 $tempUserMemo: 는 값 뒤에 |<시청자 UID> 를 붙여 다른 사람 메모를 지정할 수 있고, UID 형식이 틀리면 오류: UID가 올바르지 않습니다. 가 채팅에 나와요. 커스텀 스크립트와 함께 쓰라고 만든 기능이라, 직접 쓸 일은 드물어요.

명령어 뒤에 설명을 붙이면 그 설명도 같이 저장돼요. 나중에 편집할 때 편해요.

마커는 방송 중에만 생성할 수 있어요!

• $marker — 방송이 꺼져 있으면 방송중이 아닙니다. 가 출력돼요.
• $silentMarker — 아무 메시지도 없이 마커 저장만 건너뛰어요.

여러 개를 굴리면 결과가 쉼표로 구분되어 나와요. 다만 봇이 공식 API로 보내는 채팅은 95자에서 잘리니, 너무 많이 굴리면 뒤가 날아갈 수 있어요.

일정 시간 채팅이 불가능해지고, 시간이 지나면 자동으로 풀려요. 지속 시간은 뚜봇이 정하는 게 아니라 치지직이 정합니다 — 같은 사람이 반복해서 걸리면 30초 → 60초 → 180초 → 300초 순으로 늘어나요.

봇에 채팅 운영자 권한이 필요해요.

검(매니저 배지)을 달고 있는 사용자에게는 작동하지 않아요.

봇에 채팅 운영자 권한이 필요해요.

검(매니저 배지)을 달고 있는 사용자에게는 작동하지 않아요.

• 출석 성공: 닉네임님, 이 채널의 42번째 출석입니다! (연속 7일)
• 이미 출석: 닉네임님은 이미 출석하셨습니다! (42회 출석)
• 방송 꺼짐: 방송중이 아닙니다. 방송중에만 출석체크가 가능합니다!

방송 중이 아니면 [방송이 꺼져있습니다.]가 출력돼요.

$att_count는 횟수를 조회만 해요. 출석 처리를 하려면 $att_add나 $attendance를 사용하세요.

• $att_count_month:N 서식이 잘못되면 [오류, 월 서식이 잘못되었습니다.]가 출력돼요.
• $att_count_period 에 ~ 가 없거나 조각이 2개가 아니면 [오류, 기간 서식이 잘못되었습니다.]
• ~ 는 있는데 날짜 형식이 틀리면 [오류, 시작 날짜 파싱 실패] 또는 [오류, 종료 날짜 파싱 실패]
• 날짜 형식은 반드시 YYYY-MM-DD로 입력해주세요!

!설정 신청곡 유저제한 2 로 일반 신청은 2곡까지 막아두고, $song-requests-nolimit 으로 만든 명령어는 대시보드에서 필요 권한을 '구독자' 로 지정하세요. 구독자도 제한 없이 신청할 수 있는 구조가 돼요. (매니저 이상은 원래부터 신청곡 제한을 받지 않아요.)

1 이상 200000000 이하만 돼요. 벗어나면 오류: 올바른 우선순위 숫자를 입력해주세요. 가 나와요.

신청곡(유튜브 재생)과 노래방은 대기열이 서로 달라요. 대시보드에서도 각각 관리해요.

재생 중인 곡이 없으면 재생중인 노래가 없습니다.가 출력돼요.

다음 곡이 없으면 다음곡이 없습니다.가 출력돼요.

$rock-paper-scissors:가위를 사용하면 !가위바위보 가위 대신 !가위만 입력해서 빠르게 게임할 수 있어요!

가위바위보는 방송 중에만 할 수 있어요. 방송 중이 아니면 방송중이 아닙니다.가 출력돼요.

$videoQueueRemainingSec · $videoRemainingSec 를 쓰면 750 처럼 숫자만 나와요. 계산이나 조건 분기에 쓰기 좋아요.

!영상대기 같은 명령어를 만들어두면 시청자가 직접 순번을 확인할 수 있어요.

시청자 참여는 방송 중에만 할 수 있어요. 방송 중이 아니면 방송중이 아닙니다.가 출력돼요.

커스텀 스크립트는 대시보드에서 Python 3.9 로 작성해요. 언어는 만들 때 한 번 고르면 바꿀 수 없고(바꾸려면 삭제 후 다시 생성), 실행 제한은 메모리 128M · 1초예요.

$game_tier:롤|솔랭 또는 $game_tier:롤|자랭으로 특정 큐만 조회할 수 있어요.

롤 · TFT · 오버워치2 · 배그 · 이터널리턴은 채팅창에서 !설정 게임연동 [게임명] [닉네임] 으로 연동해요. 발로란트만 대시보드에서 연동해요. 게임 전적 문서 →

• 연동된 계정이 없으면 [연결된 계정이 없습니다.]가 출력돼요.
• 잘못된 게임 이름을 입력하면 [잘못된 게임이 입력되었습니다.]가 출력돼요.
• 데이터가 없을 때 나오는 문구는 게임마다 달라요.
  • 롤 · TFT — [데이터가 없습니다. 배치중에는 표시되지 않습니다.]
  • 배그 — [데이터가 없습니다.]
  • 발로란트 — [오류: 랭크 정보를 불러올 수 없습니다.]
  • 오버워치 — 탱커: 없음 | 딜러: 없음 | 힐러: 없음

재생 중인 곡이 없으면 재생중인 노래가 없습니다.가 출력돼요.

• !스포신청 열기 / !스포신청 닫기 - 신청곡 열기/닫기 (매니저 이상)
• !스포신청 재생 / !스포신청 정지 - 재생/일시정지 (매니저 이상)

스포티파이 연동은 대시보드에서 설정할 수 있어요. 프리미엄 계정은 필요 없지만, 연동 전에 지원 디스코드로 스포티파이 계정 이메일을 알려주셔야 해요. 스포티파이 정책상 테스트 인원으로 등록해야 연동이 열립니다.

스포티파이 관련 변수는 방송 중에만 동작해요. 방송이 꺼져 있으면 변수마다 다른 문구가 나와요.