뚜봇이 무엇인가요?

뚜봇은 2023년 12월 20일부터 시작된 치지직 채팅봇입니다. 최초로는 '픽셀봇'으로 시작되었지만, 다른 스트리머분들도 사용할 수 있게 '채팅 봇'이라는 이름을 사용하다, '뚜봇'이라는 이름으로 변경되었습니다.

뚜봇을 어떻게 사용할 수 있나요?

뚜봇 대시보드(https://chzzk-bot.ddutto.com)에 로그인한 후 절차에 따라 진행하시면 바로 사용이 가능합니다. 별도의 설치 없이 웹에서 모든 설정이 가능합니다.

뚜봇 대신 다른 이름의 봇을 사용할 수 있나요?

네, 가능합니다. 픽셀봇, 스텔라이브 봇, 악몽봇 등 커스텀 이름의 봇을 신청할 수 있습니다. 대시보드 상단의 지원 디스코드에서 신청하시면 관리자 검토 후 적용됩니다.

뚜봇의 주요 기능은 무엇인가요?

뚜봇은 채팅 명령어, 룰렛 이벤트, 노래신청, 출석체크, 방송 제목/카테고리 변경, 금지어 설정, 매크로 메시지 등 다양한 방송 관리 기능을 제공합니다.

치지직 룰렛·돌림판 만들기

룰렛이 뭔가요?

시청자가 후원하면 방송 화면에서 룰렛이 돌아가고, 당첨된 항목에 맞춰 채팅 메시지가 나가는 기능이에요.

벌칙 정하기 · 게임 결과 뽑기 · 선물 추첨 · 시참 순서 정하기 등에 쓸 수 있습니다.

처음이시라면 아래 순서대로만 따라오시면 10분 안에 완성됩니다.

시작하기 전에 — 딱 두 가지만 확인

🚨 1. 치지직에서 후원 금액이 공개되어 있어야 합니다

뚜봇은 치지직 채팅창에 올라오는 후원 메시지를 읽어서 동작합니다.

그래서 치지직 설정에서 후원 금액을 가려두면 룰렛이 전혀 돌아가지 않습니다. 또 '익명의 후원자' 는 누구인지 알 수 없어 당첨 기록에 이름이 남지 않아요.

해결 방법 — 아래 중 하나만 하시면 됩니다.

사용 중인 뚜봇에게 채널 관리자 권한을 주기
우회 권한(채널 관리자) 신청하기
지원 디스코드에서 #팔로우알림-우회-신청 작성하기

"후원했는데 룰렛이 안 돌아요"의 가장 흔한 원인입니다. 먼저 확인해주세요.

2. 룰렛 오버레이를 OBS에 추가해야 화면에 보입니다

룰렛을 만들기만 하면 채팅으로 결과만 나갑니다. 방송 화면에 돌아가는 모습을 보여주려면 오버레이를 따로 추가해야 해요. (아래 오버레이 섹션 참고)

1단계 — 룰렛 만들기

① 룰렛 목록에서 새로 만들기

대시보드 왼쪽 메뉴에서 룰렛을 누른 뒤, 오른쪽 위 룰렛 생성하기 버튼을 눌러주세요.

룰렛 관리 화면에서 룰렛 생성하기 버튼 위치

이 화면 위쪽의 노란 안내문 두 개는 꼭 한 번 읽어보세요. 위에서 설명한 후원 금액 공개 문제와 룰렛이 안 돌아갈 때 확인할 것이 적혀 있습니다.

편집 화면은 이렇게 생겼습니다

룰렛 편집 화면 전체 구성

영역	하는 일
왼쪽 위 — 룰렛 설정	이름, 금액, 권한, 회전 시간 등 기본 정보
왼쪽 아래 — 연차 설정	많이 후원하면 여러 번 돌리기
오른쪽 위 — 룰렛 미리보기	방송에 어떻게 보일지 확인 · 이미지 교체
오른쪽 아래 — 룰렛 제한 설정	하루 횟수, 기간 등 제한
아래 — 아이템 표	당첨 항목과 확률

② 룰렛 금액 정하기

시청자가 얼마를 후원하면 룰렛이 돌아갈지 정합니다. 단위는 치지직 후원 화폐인 치즈예요.

룰렛 금액 입력란

룰렛 이름도 알아보기 쉽게 지어주세요. (예: 벌칙룰렛, 가챠) 나중에 여러 개를 만들면 구분하기 편합니다.

처음이라면 1,000치즈로 시작해보세요. 부담 없이 참여할 수 있는 금액이라 반응을 보기 좋습니다.

③ 누가 돌릴 수 있는지 정하기

룰렛 필요 권한 선택

선택한 등급 이상이면 참여할 수 있어요.

권한	참여 가능한 사람
시청자 이상 (누구나)	제한 없음
팔로워 이상	채널을 팔로우한 시청자
구독자 이상	채널 구독자
매니저 이상	채널 매니저
스트리머 이상	본인만

④ 당첨 항목과 확률 넣기

화면 맨 아래 아이템 추가 버튼으로 항목을 하나씩 추가합니다.

아이템 추가와 확률 합계 표시

항목마다 세 가지를 정해주세요.

아이템 이름 — 당첨 항목 이름 (예: 대성공, 실패)
확률 — 이 항목이 나올 확률 (%)
메시지 — 당첨됐을 때 채팅에 나갈 문구

시뮬레이션으로 미리 확인하세요

왼쪽의 시뮬레이션 버튼을 누르면 지정한 횟수(기본 1000번)만큼 돌려본 결과를 보여줍니다. 확률이 의도한 대로 나오는지 저장 전에 확인할 수 있어요.

⑤ 저장하기

저장 버튼 위치

저장을 누르지 않으면 아무것도 반영되지 않습니다. 설정을 마쳤으면 화면 왼쪽 위의 파란 저장 버튼을 꼭 눌러주세요.

⚠️ 확률 합계는 반드시 100%여야 합니다

아이템 표 오른쪽 아래에 전체 확률이 표시됩니다.

모자라면 → "아직 N% 부족해요..!"
정확히 맞으면 → "확률이 정확해요!"

"확률이 정확해요!"가 뜰 때까지 맞춰주세요.

100%로 자동으로 맞추기

합계가 안 맞으면 "100%로 맞추기" 버튼이 나타납니다. 누르면 지금 넣은 값의 비율을 그대로 유지한 채 합계만 100%로 조정해줍니다.

예를 들어 40 / 40 (합계 80) 이면 → 50 / 50 으로, 100 / 100 (합계 200) 이면 → 50 / 50 으로 바뀝니다.

100%가 아니면 어떻게 되나요?

저장이 되지 않습니다. 합계가 맞지 않으면 저장 단계에서 막히므로, 잘못된 룰렛이 방송에 올라가는 일은 없습니다.

상황	결과
합계가 100이 아님	저장 거부 — "확률의 총합이 100이 되어야 합니다"
개별 확률이 0 미만 또는 100 초과	저장 거부 — 0~100 사이의 값만 허용됩니다
정확히 100%	✅ 정상 저장

혹시 저장된 뒤에 문제가 생긴다면

드물게 데이터가 어긋나 합계가 맞지 않는 룰렛이 남아 있으면, 룰렛을 돌릴 때 봇이 채팅으로 알려줍니다.

룰렛에 오류가 있습니다: 룰렛의 아이템 확률의 합이 100이 아닙니다. (현재: 80)

이 메시지가 보이면 대시보드에서 확률을 다시 맞추고 저장해주세요.

2단계 — 룰렛 돌리는 방법 정하기

세 가지 방법이 있고 함께 쓸 수도 있습니다.

방법	난이도	이럴 때 좋아요
① 후원 감지	⭐ 가장 쉬움	후원 이벤트, 벌칙 룰렛 — 대부분 이걸 쓰면 됩니다
② 채팅 명령어	보통	무료로 아무나 돌리게 하고 싶을 때
③ 사용권 ^베타	고급	당첨권을 나눠주고 원할 때 쓰게 할 때

① 후원 감지 — 가장 쉬운 방법 (권장)

"룰렛 금액에 맞는 후원 감지시 즉발" 스위치만 켜면 끝입니다. 명령어를 만들 필요가 없어요.

후원 감지 스위치 위치

이제 시청자가 1,000치즈를 후원하면 룰렛이 1번 돌아갑니다.

금액이 '정확히' 일치해야 합니다

룰렛 금액이 1,000치즈면 정확히 1,000치즈를 후원해야 발동합니다.

1,500치즈를 후원하면 아무 일도 일어나지 않습니다. "1,000치즈 이상"이 아니라 "정확히 1,000치즈"예요. 여러 금액을 받고 싶다면 아래 연차 설정을 쓰세요.

같은 금액으로 여러 룰렛을 쓰고 싶다면 — 감지 키워드

"후원과 함께 키워드 감지" 를 켜고 룰렛 감지 키워드를 정하면, 후원 메시지에 그 단어가 있을 때만 이 룰렛이 돌아갑니다.
"시청자 페이지에 키워드 공개" 를 켜면 시청자가 어떤 단어를 써야 하는지 볼 수 있어요.

이 두 설정은 후원 감지를 먼저 켜야 사용할 수 있습니다.

한 번만 돌려도 채팅에 알리기

"한 개만 돌아가도 채팅으로 알림" 을 켜면 1번만 돌려도 결과가 채팅에 올라갑니다.

어떤 후원까지 인식할지 정하기

채팅창에 표시되지 않는 후원까지 인식하게 만들 수 있습니다. 매니저 이상이 채팅에 입력하세요.

!설정 룰렛 후원감지 모두

값	동작
채팅 (기본값)	채팅창에 올라온 후원만 인식
모두	모든 후원을 인식

"후원했는데 룰렛이 안 돌아가요"가 계속된다면 이 설정을 모두로 바꿔보세요. 그래도 안 되면 뚜봇에게 채널 관리자 권한을 주시는 게 가장 확실합니다.

연차 — 많이 후원하면 여러 번 돌리기

"1,000치즈에 1번인데, 10,000치즈 후원하면 10번 돌려주고 싶다" — 이럴 때 씁니다. 후원 감지를 켜야 사용할 수 있어요.

연차 설정 영역

자동 연차 — 최소·최대만 정하면 끝

"자동 연차 기능" 을 켜고 최소 / 최대 횟수만 정하세요.

룰렛 금액 1,000치즈 + 자동 연차 1~10 인 경우:

후원 금액	결과
1,000치즈	1번
2,000치즈	2번
5,000치즈	5번
10,000치즈	10번
2,500치즈	❌ 아무 일도 안 일어남
11,000치즈	❌ 아무 일도 안 일어남

자동 연차가 안 되는 두 가지 경우

1. 나누어떨어지지 않을 때 — 후원 금액이 룰렛 금액의 정확한 배수여야 합니다. 1,000치즈 룰렛에 2,500치즈는 2.5배라서 발동하지 않아요.

2. 최소~최대 범위를 벗어날 때 — 1~10으로 설정했으면 11배(11,000치즈)는 범위 밖이라 발동하지 않습니다. 큰 금액도 받으려면 최대 횟수를 올리거나 아래 수동 연차로 따로 등록하세요.

수동 연차 — 특정 금액에 원하는 횟수 지정

연차 설정에서 추가 버튼을 눌러 감지 금액과 횟수를 직접 넣습니다. 배수 규칙을 무시할 수 있어요.

10,000치즈 → 11번 (보너스 1번 더!)
3,000치즈 → 5번 (이벤트 프로모션)
2,500치즈 → 2번 (배수가 아니어도 OK)

어느 쪽이 먼저 적용되나요?

같은 금액에 여러 설정이 겹치면 위에서부터 검사합니다.

룰렛 금액과 정확히 같은가?

→ 1번 돌립니다.

수동 연차에 등록된 금액인가?

→ 등록한 횟수만큼 돌립니다.

자동 연차 조건에 맞는가?

→ 배수만큼 돌립니다.

어디에도 안 맞으면

→ 아무 일도 일어나지 않습니다.

수동이 자동을 이깁니다

1,000치즈 룰렛 + 자동 연차 1~10이면 10,000치즈는 원래 10번입니다.

여기에 수동 연차로 "10,000치즈 → 11번" 을 등록하면 수동이 먼저 검사되므로 11번이 됩니다. 큰 후원에 보너스를 줄 때 이렇게 쓰세요.

② 채팅 명령어로 돌리기

후원 없이 채팅만으로 돌리게 하려면 명령어를 만듭니다.

!추가 [명령어] $roulette:룰렛ID

만드는 명령	시청자 입력	결과
`!추가 !룰렛 $roulette:my-roulette`	`!룰렛`	1번
`!추가 !뽑기 $roulette:gacha`	`!뽑기`	1번
`!추가 !10연차 $roulette:gacha\|10`	`!10연차`	10번

룰렛 ID는 어디서 보나요

룰렛을 만들 때 정할 수 있고, 룰렛 목록의 각 카드에서도 확인할 수 있습니다. 명령어 이름은 !룰렛, !뽑기, !가챠 등 자유롭게 지으세요.

③ 사용권으로 돌리기 ^베타

베타 기능입니다

사용권은 아직 베타 단계로, 권한이 부여된 채널에서만 설정 화면이 보입니다. 사용을 원하시면 디스코드로 문의해주세요.

시청자에게 "룰렛 당첨권" 을 미리 나눠주고, 원할 때 쓰게 하는 방식입니다.

룰렛 설정에서 사용권 스위치를 켜면, 항목 당첨 시 사용권이 지급되게 만들 수 있습니다.
사용권 직접 지급 — 룰렛을 돌리지 않고 특정 시청자에게 바로 지급 (이벤트 보상 등)
사용권 일괄 만료 — 발급된 사용권을 한 번에 만료

일괄 만료는 되돌릴 수 없습니다

이 룰렛만이 아니라 채널 전체의 사용권이 대상입니다. '사용 가능'·'승인 대기' 상태의 모든 사용권이 만료되며 복구할 수 없습니다.

남용 막기 — 제한 설정

"룰렛에 제한 걸기" 를 켜면 네 가지 제한을 걸 수 있습니다.

룰렛 제한 설정 네 가지 항목

항목	설명
이 룰렛은 총 N회까지만	누적 총 횟수. 한정 이벤트에 유용합니다
이 룰렛은 하루에 N회까지만	하루 전체 횟수
시청자당 하루에 N회까지만	한 사람이 하루에 돌릴 수 있는 횟수
이 룰렛은 (날짜)까지만	종료 기한. 이 날짜가 지나면 안 돌아갑니다

-1은 '제한 없음'입니다

기본값 -1은 제한이 없다는 뜻이에요. 제한할 항목에만 숫자를 넣으세요.

경품이 걸린 룰렛이라면 한 사람이 독식하지 않도록 시청자당 하루 횟수를 걸어두세요. 기간 이벤트라면 종료 날짜도 함께 넣으면 깜빡하고 계속 돌아가는 일을 막을 수 있습니다.

항목 고급 설정

기록 / 자동 사용

항목마다 기록/자동 사용 을 켜면 당첨 결과가 기록으로 남아, 나중에 처리했는지 체크할 수 있습니다. 벌칙처럼 "나중에 이행해야 하는" 항목에 유용해요.

카운터 · 타이머 연동

당첨됐을 때 카운터나 타이머를 자동으로 조작할 수 있습니다. 오버레이와 함께 쓰면 방송 화면이 실시간으로 바뀝니다.

카운터 연동

항목	설명
대상 카운터	조작할 카운터 이름
조작 대상	현재값 또는 목표값
연산	더하기 / 빼기 / 곱하기 / 나누기 / 초기화
값	연산에 쓸 숫자

타이머 연동

항목	설명
대상 타이머	조작할 타이머 제목
연산	더하기 / 빼기
초	조작할 시간(초)

이렇게 쓰면 좋아요

"방송 연장 10분" 항목 → 타이머에 +600초
"데스 카운트 +1" 항목 → 카운터 현재값에 +1
"목표 달성" 항목 → 카운터 초기화

당첨 메시지에서 쓸 수 있는 변수

$nick

룰렛을 돌린 사람의 닉네임

명령어 추가 예시

🎉 대박! $nick님 축하합니다!

입력

마지막남은뚜또: (룰렛 당첨)

출력

🎉 대박! 마지막남은뚜또님 축하합니다!

$name

룰렛을 돌린 사람의 닉네임 ($nick과 동일합니다)