# 뚜봇 (DduBot)

> 치지직(CHZZK) 스트리머를 위한 채팅봇입니다. 2023년 12월 20일부터 운영 중이며,
> 설치 없이 웹 대시보드에서 설정합니다. 무료로 제공됩니다.

주요 규모(2026-08 기준):
- 방송 화면 오버레이 15종
- 명령어에서 쓰는 변수 93개
- 문서화된 명령어 57개
- 게임 전적 연동 6종 (리그 오브 레전드, TFT, 발로란트, 오버워치2, 배틀그라운드, 이터널 리턴)
- 공개 API 읽기 스코프 12종
- 사용 설명서 31페이지

채널 전용 이름의 봇으로 바꿔 운영할 수 있습니다(신청제).
예: 픽셀봇, 스텔라이브 봇, 악몽봇, 람군, 다람쥐 봇.

## 시작하기

- [대시보드 가입 방법](https://chzzk-bot.ddutto.com/docs/getting-started/dashboard-signup): 뚜봇 대시보드에 가입하여 봇 설정을 관리하는 방법을 안내합니다.
- [뚜봇 넣는 방법](https://chzzk-bot.ddutto.com/docs/getting-started/invite-bot): 치지직 채널에 뚜봇을 초대하는 방법을 단계별로 안내합니다. 준비물, 봇 권한, 잘 안 될 때 확인할 것까지 정리했습니다.
- [권한 부여 방법](https://chzzk-bot.ddutto.com/docs/getting-started/permissions): 뚜봇에 권한을 부여하여 더 많은 기능을 사용하는 방법을 안내합니다.

## 기능 전체 목록

- [기능 전체 목록](https://chzzk-bot.ddutto.com/docs/all-features): 오버레이·변수·명령어·게임 연동·API 를 한 페이지에 정리한 목록입니다.

## 명령어

- [기본 명령어](https://chzzk-bot.ddutto.com/docs/commands/basic): 뚜봇의 기본 명령어와 권한 등급을 안내합니다. 시청자용 명령어부터 스트리머 전용 명령어까지 정리했습니다.
- [방송 설정](https://chzzk-bot.ddutto.com/docs/commands/broadcast): 방제·카테고리·태그 변경부터 채팅모드, 저속모드, 금칙어, 매크로, 타이머까지 방송 운영 명령어 전체를 안내합니다.
- [커스텀 명령어](https://chzzk-bot.ddutto.com/docs/commands/custom): 나만의 명령어를 만들고 관리하는 방법을 안내합니다.
- [시스템 설정](https://chzzk-bot.ddutto.com/docs/commands/system): 뚜봇 !설정 명령어 전체 안내. 입장안내, 채팅 제한, 룰렛 후원 감지, 매크로 출력 방식, 광고 필터 등을 다룹니다.
- [변수](https://chzzk-bot.ddutto.com/docs/commands/variables): 뚜봇 명령어에서 사용할 수 있는 변수를 안내합니다.

## 기능

- [출석 체크](https://chzzk-bot.ddutto.com/docs/features/attendance): 뚜봇 출석 체크 전체 안내. 연속 출석이 이어지는 규칙과 $attendance·$att_add 등 출석 변수 11종을 다룹니다.
- [채팅 오버레이](https://chzzk-bot.ddutto.com/docs/features/chat-overlay): 치지직 채팅을 방송 화면에 띄우는 방법. 폰트·색상·TTS·게임 티어 표시·커스텀 CSS까지 모든 설정을 안내합니다.
- [후원 알림](https://chzzk-bot.ddutto.com/docs/features/donation-alert): 치즈 후원이 들어오면 방송 화면에 알림을 띄우고 메시지를 읽어주는 방법. 표시 형식·이미지·효과음·TTS 설정을 안내합니다.
- [이모티콘 뿌리기](https://chzzk-bot.ddutto.com/docs/features/emoticon-spread): 시청자가 채팅에 쓴 이모티콘을 방송 화면에 흩날리게 하는 방법. 애니메이션·크기·중력 설정과 구독티콘 필터를 안내합니다.
- [팔로우 알림](https://chzzk-bot.ddutto.com/docs/features/follow-alert): 새 팔로워가 생기면 채팅과 방송 화면에 알림을 띄우는 방법. 명령어 설정부터 오버레이 꾸미기까지 안내합니다.
- [게임 전적 · 티어 연동](https://chzzk-bot.ddutto.com/docs/features/game-tier): 리그 오브 레전드, TFT, 발로란트, 오버워치2, 배틀그라운드, 이터널 리턴 티어를 채팅 명령어로 보여주는 방법을 안내합니다.
- [오버레이](https://chzzk-bot.ddutto.com/docs/features/overlay): 뚜봇이 제공하는 오버레이 15종 전체 목록과 OBS에 추가하는 방법. 채팅·룰렛·팔로우 알림·타이머 등을 방송 화면에 띄웁니다.
- [가위바위보](https://chzzk-bot.ddutto.com/docs/features/rock-paper-scissors): 뚜봇과 가위바위보를 하는 방법. 하루 판수 제한 설정, 별명 인식, 전적·승률 변수까지 안내합니다.
- [룰렛](https://chzzk-bot.ddutto.com/docs/features/roulette): 치지직 뚜봇 룰렛을 처음부터 끝까지 따라 만드는 방법. 후원 감지, 연차, 확률 설정, 권한, 제한, 오버레이 연동을 사진과 함께 안내합니다.
- [단축 링크](https://chzzk-bot.ddutto.com/docs/features/short-link): 긴 주소를 ddu.to 짧은 주소로 줄이는 방법. 채팅 명령어에 넣기 좋은 형태로 만들 수 있습니다.
- [신청곡](https://chzzk-bot.ddutto.com/docs/features/song-request): 치지직 뚜봇으로 시청자 노래 신청을 받는 방법. 명령어 만들기, 변수, 플레이어·목록 오버레이 설정까지 안내합니다.
- [타이머 · 카운터](https://chzzk-bot.ddutto.com/docs/features/timer-counter): 방송 화면에 카운트다운 타이머와 숫자 카운터를 띄우는 방법. 명령어로 조작하고 룰렛 당첨과 연동할 수 있습니다.
- [시청자 참여 (시참)](https://chzzk-bot.ddutto.com/docs/features/viewer-participation): 채팅으로 참여자를 모으고 랜덤 추첨하는 시참 기능. 참여·취소·보기·추첨·초기화·삭제·켜기·끄기 전체 사용법을 안내합니다.

## API

- [출석 명단 API](https://chzzk-bot.ddutto.com/docs/api/attendances): 채널의 시청자 출석 집계를 조회하는 API입니다.
- [인증 방법](https://chzzk-bot.ddutto.com/docs/api/authentication): 뚜봇 API 인증 방법과 API 키 발급 방법을 안내합니다.
- [노래방 API](https://chzzk-bot.ddutto.com/docs/api/karaoke): 노래방 대기열/완료 목록 및 오늘 통계를 조회하는 API입니다.
- [API 개요](https://chzzk-bot.ddutto.com/docs/api/overview): 뚜봇 API를 사용하여 외부에서 봇 기능을 연동하는 방법을 안내합니다.
- [룰렛 API](https://chzzk-bot.ddutto.com/docs/api/roulette): 룰렛 목록과 결과 기록을 조회하는 API입니다.
- [신청곡 API](https://chzzk-bot.ddutto.com/docs/api/song-requests): 현재 신청곡 대기열을 조회하는 API입니다.
- [시청자 정보 API](https://chzzk-bot.ddutto.com/docs/api/user-info): 시청자의 활동 통계와 출석 정보를 조회하는 API입니다.

## 그 외

- [설명서 홈](https://chzzk-bot.ddutto.com/docs)
- [자주 묻는 질문](https://chzzk-bot.ddutto.com/docs/faq)
- [대시보드](https://chzzk-bot.ddutto.com/dashboard)
- [지원 디스코드](https://discord.com/invite/QftHRJCTPZ)