📖 모찌봇 사용 설명서

← 대시보드로

🚀 대시보드 홈에 '처음 시작하기' 체크리스트 다시 보기

메뉴별로 화면 그림과 번호 설명을 붙였습니다. 그림 속 ①②③ 번호는 아래 설명 번호와 같습니다. 대시보드 각 메뉴 맨 위의 '📖 사용법'에서도 같은 내용을 볼 수 있습니다.

홈

봇 켜기·리모콘·봇 계정·채널 연동·데이터 가져오기·백업 같은 기본 설정을 하는 곳입니다.

처음엔 이렇게
  1. 봇 시작을 누릅니다. '방송 감지 모드'면 방송을 켜면 1분 안에 봇이 알아서 들어갑니다.
  2. 방송 채팅에 !핑을 쳐서 봇이 퐁!으로 답하면 연결 완료입니다.
  3. 방송 중엔 왼쪽 리모콘 열기로 작은 창 하나만 띄워 두고 조작하면 편합니다.
채팅 봇리모콘방송 알림채팅 봇 계정채널 연동 (팔로워 · 매니저)데스크톱 룰렛봇에서 데이터 가져오기백업

채팅 봇

채팅 봇 화면
  1. 상태 — 봇이 채팅에 들어가 있는지 보여 줍니다 (🟢 실행 중 / ⚪ 정지).
  2. 방송 감지 모드 — 방송을 켜면 1분 안에 자동으로 들어가고, 방송을 끄고 10분 뒤 나갑니다. 매번 켤 필요가 없습니다.
  3. 봇 시작 · 봇 중지 — 직접 켜고 끕니다. 방송 전에 테스트할 때도 씁니다.
  4. !핑 테스트 — 방송 채팅에 !핑을 치면 봇이 퐁!으로 답합니다. 답이 없으면 아래 '채팅 봇 계정'의 테스트 메시지를 눌러 보세요.

리모콘

리모콘 화면
  1. 작은 창으로 열기 — 대시보드 없이 쓰는 작은 조작 창을 엽니다.
  2. 주소 복사 (OBS 독용) — OBS 안에 붙일 때 쓰는 주소입니다. 로그인 없이 열리니 남에게 보여 주지 마세요.
  3. 주소 재발급 — 주소가 새어 나갔을 때 누르면 기존 주소는 바로 막힙니다.
  4. OBS 안에 붙이기 — OBS 상단 메뉴 독 → 사용자 지정 브라우저 독에 주소를 넣으면 OBS 화면 옆에 붙습니다. 방송 화면에는 나가지 않습니다.
💡 리모콘 화면 자체의 사용법은 리모콘 설명서를 봐 주세요.

방송 알림

방송 알림 화면
  1. 📡 방송 켜짐 — 봇이 방송 시작을 감지해 채팅방에 들어오면 "준비 완료" 한 줄을 보냅니다. 서버가 재시작된 직후엔 다시 인사하지 않습니다.
  2. 🎮 카테고리 변경 — 방송 중에 게임 카테고리가 바뀌면 알립니다 (카테고리 전용 룰렛·파티 적용이 바뀔 수 있어서).
  3. 🎉 파티 룰렛 적용 시작 / 해제 — 카테고리·직접 켬·참가·파티 종료 어느 이유로든 파티 룰렛이 켜지거나 꺼지면 알립니다.
  4. 세 가지 모두 체크로 끄고 켤 수 있고, 문구는 {category} {before} {party} {host}로 바꿔 쓸 수 있습니다.

채팅 봇 계정

채팅 봇 계정 화면
  1. 기본 봇 — 모찌봇이 제공하는 봇 계정 이름으로 응답합니다.
  2. 내 봇 계정 — 직접 만든 봇 계정(네이버 계정)을 연결해 그 이름으로 응답합니다 (유료).
  3. 봇 없이 공식 API로 — 봇 계정 없이 치지직 공식 API로 응답합니다. 치지직은 이 채팅을 앱 등록 계정(모찌봇) 이름으로 표시합니다 — 내 방송 이름으로는 나가지 않습니다.
  4. 봇 오류 시 공식 API로 보조 — 봇 계정에 문제가 생기면 그 메시지를 즉시 공식 API로 대신 보냅니다 (유료).
  5. 테스트 메시지 보내기 — 지금 설정된 계정으로 채팅이 실제로 나가는지 확인합니다.

채널 연동 (팔로워 · 매니저)

채널 연동 (팔로워 · 매니저) 화면
  1. 팔로워 — 봇이 켜져 있는 동안 5분마다 새 팔로워를 받아 옵니다. '팔로워만 출첵·참가' 같은 기능에 쓰입니다.
  2. 매니저 — 10분마다 매니저 목록을 받아 옵니다. 매니저는 !스킵 !재개 !추첨 같은 매니저 전용 명령을 쓸 수 있습니다.
  3. 지금 동기화 — 기다리지 않고 바로 받아 옵니다.

데스크톱 룰렛봇에서 데이터 가져오기

데스크톱 룰렛봇에서 데이터 가져오기 화면
  1. 파일 고르기 — 데스크톱 프로그램을 완전히 종료한 뒤 C:\weflab-stack\stack.db 파일(또는 백업 zip)을 고릅니다.
  2. 올리기 — 시청자 포인트·출첵 횟수, 쌓인 룰렛 결과, 룰렛·명령어·자동 공지·추첨 제외 명단·플레이리스트를 옮깁니다. 같은 파일을 여러 번 올려도 중복되지 않습니다.
  3. 📥 다른 봇에서 가져오기 — 잼쿠봇 시청자 목록을 복사해 붙여 넣으면 미리보기로 누구 포인트가 얼마 바뀌는지 확인한 뒤 가져옵니다. 합치는 방법은 더하기(같은 목록을 다시 넣어도 두 번 더해지지 않음)·큰 쪽으로·바꾸기 중에 고릅니다.

백업

백업 화면
  1. 지금 백업 — 지금 상태를 바로 백업합니다. 서버는 매일 새벽 5시에도 자동으로 백업합니다 (매일 14개 · 직접 10개 보관).
  2. 내 PC 백업 파일 올리기 — '받기'로 내 PC에 보관해 둔 파일을 올리면 그 시점으로 되돌릴 수 있습니다. 서버 백업이 없어져도 됩니다.
  3. 받기 · 되돌리기 — 받기는 내 PC에 저장(로그인 정보는 빠짐), 되돌리기는 그 시점 데이터로 바꿉니다. 되돌리기 직전 상태도 자동으로 백업되니 실수해도 다시 되돌릴 수 있습니다.

룰렛

시청자 후원·포인트로 돌아가는 룰렛을 만들고, 나온 결과(스택)를 관리하는 곳입니다.

처음엔 이렇게
  1. + 새 룰렛을 눌러 종류(후원 / 포인트)를 고르고 항목을 넣은 뒤 저장합니다.
  2. 맨 위 룰렛 오버레이 주소를 OBS 브라우저 소스에 넣고, 목록의 테스트로 화면에 룰렛이 도는지 확인합니다.
  3. 방송 중 나온 결과는 아래 수행 대기 결과에 쌓입니다. 수행했으면 완료를 누릅니다.
룰렛 오버레이 연결룰렛 목록룰렛 시뮬레이션룰렛 만들기 · 편집항목 표시간 · 그룹 · 별칭수행 대기 결과 (스택)확률 공개 페이지룰렛 파티

룰렛 오버레이 연결

룰렛 오버레이 연결 화면
  1. 룰렛 오버레이 주소 — 룰렛이 돌 때 그 룰렛의 연출(원판·슬롯머신)대로 화면 가운데 크게 나오는 주소입니다. OBS → 소스 추가 → 브라우저 → URL에 붙여 넣습니다 (권장 크기 1920×1080).
  2. 주소 복사 — 주소를 복사합니다. 주소에 비밀키가 들어 있으니 화면에 노출되지 않게 주의해 주세요.
  3. 주소 재발급 — 주소가 새어 나갔을 때 누르면 이전 주소는 바로 끊깁니다. OBS에 새 주소를 다시 넣어야 합니다.
  4. 🔊 효과음 · 🗣 결과 읽어 주기 · 🎲 아슬아슬 · ⏱ 회전 시간 — 바늘·릴 '딸깍'과 당첨 소리, 룰렛이 멈춘 뒤 결과 읽기 (둘 다 아래 슬라이더로 볼륨을 따로 조절 · OBS 브라우저 소스의 'OBS를 통해 오디오 제어'를 켜면 브라우저 음성은 안 들리니 서버 음성(관리자에게 문의)이 필요합니다), 가끔 다음 칸으로 넘어갈 듯 말 듯 멈칫하는 연출(결과는 그대로), 기본으로 몇 초 돌지 정합니다. 돌 때는 천천히 출발해 빨라졌다가 끝에 '딱…딱……딱' 느려지며 멈춥니다.
  5. 🔔 알림 오버레이에도 룰렛 결과 띄우기 — 룰렛 오버레이를 쓴다면 끄세요. 켜 두면 작은 알림 토스트가 룰렛보다 먼저 결과를 보여 줍니다.
💡 룰렛마다 연출(🎡 원판 · 🎰 슬롯머신 · ▬ 슬롯(바))과 디자인을 따로 고릅니다 — 룰렛 목록의 편집 → 🎨 연출 · 디자인 (예: 벌칙 룰렛만 호러). 슬롯(바)만 쓴다면 OBS 소스를 작게(예: 800×160) 넣어도 됩니다. 알림·스택·타이머 같은 다른 오버레이는 오버레이 탭에 따로 있습니다.

룰렛 목록

룰렛 목록 화면
  1. 룰렛 이름과 동작 방식이 보입니다. 🎮는 특정 게임 카테고리로 방송할 때만 도는 룰렛, 🎉 파티 전용은 파티 때만 도는 룰렛, 🤝 연대 · ⚔ 공격은 파티용 항목이 들어 있다는 표시입니다. 🎡 / 🎰 칩은 이 룰렛의 연출·디자인입니다.
  2. 테스트 — 저장·포인트 변동 없이 한 번 돌려 OBS 화면 연출만 확인합니다. 아래 '룰렛 결과를 채팅으로 안내'는 끌 수 있고, 켜 두면 기본으로 룰렛 오버레이가 멈춘 뒤에 안내해서 채팅이 결과를 먼저 보여 주지 않습니다.
  3. 📊 시뮬 — 저장 없이 수만 번 돌려 본 통계를 엽니다 (아래 '룰렛 시뮬레이션').
  4. 편집 — 룰렛 설정과 항목을 고칩니다.
  5. 삭제 — 룰렛을 지웁니다. 이미 쌓인 결과 기록은 남습니다.
  6. + 새 룰렛 — 새 룰렛을 만듭니다.

룰렛 시뮬레이션

룰렛 시뮬레이션 화면
  1. 횟수 — 100~200,000회. 저장·포인트 변동 없이 실제 추첨 규칙 그대로 돌려 봅니다.
  2. 표 — 항목별 나온 횟수·실측 %·설정 확률. 파티 룰렛(파티 카드 → 확률 보기 → 📊 시뮬)은 그 아래 └ 이름(연대책임)처럼 일반·연대책임·공격 나누기 실측까지 보입니다.
  3. 리롤 · 최종 결과 분포 — 리롤이 몇 번 발동해 어디로 갔는지, 리롤 대체까지 반영해 실제로 쌓이는 결과의 분포입니다.
💡 확률을 바꾼 뒤엔 시뮬로 한 번 확인해 두면 '설정이랑 다르게 나온다'는 시청자 문의에 바로 답할 수 있습니다.

룰렛 만들기 · 편집

룰렛 만들기 · 편집 화면
  1. 이름 · 종류 — 후원 룰렛은 후원 금액에 맞춰 자동으로, 포인트 룰렛은 시청자가 채팅 명령어로 포인트를 써서, 리롤 룰렛은 다른 룰렛의 특정 결과가 나왔을 때만 이어서 돕니다.
  2. 1회 금액 · 배수 — 1회 금액만큼 후원하면 1번 돕니다. '배수면 연속으로'를 켜면 2배 금액에 2번처럼 연속으로 돕니다 (최대 횟수 제한).
  3. 금액 구간별 회전수 — '10,000원 → 5회'처럼 특정 금액에 횟수를 따로 정합니다. 배수 계산보다 먼저 적용됩니다. 미리보기에 금액을 넣으면 몇 번 도는지 바로 보입니다.
  4. 적용 범위 — 비워 두면 항상 돌고, 카테고리를 넣으면 그 게임으로 방송할 때만 돕니다. 같은 조건이면 카테고리 전용 룰렛이 먼저 돕니다.
  5. 🎨 연출 · 디자인 — 🎡 원판(8종), 🎰 슬롯머신(7종), ▬ 슬롯(바, 9종 — 한 줄만 돌아서 화면 공간이 좁을 때) 중에 고르고 그림을 누르면 이 룰렛의 모양이 됩니다. 회전 ○초로 이 룰렛만 도는 시간을 바꿀 수 있습니다. ▶ 돌려 보기로 바로 확인하세요.
  6. 룰렛 켜기 · 🎉 파티 전용 — 룰렛 켜기를 끄면 이 룰렛은 돌지 않습니다. 파티 전용을 켜면 평소에는 안 돌고, 내가 파티장인 파티 때만 돕니다.
💡 벌칙 전용 룰렛(예: 퀴즈 벌칙)을 만들 때는 룰렛 켜기를 꺼 두세요. 후원으로는 안 돌고 벌칙으로만 쓰입니다.

항목 표

항목 표 화면
  1. 가중치 · 확률 — 숫자가 클수록 잘 나옵니다. 옆에 실제 확률(%)이 바로 계산됩니다.
  2. 포인트 — 이 항목이 나오면 시청자에게 줄 포인트입니다 (꽝 보상 등).
  3. 쌓기 — 체크하면 수행할 결과로 스택에 쌓입니다 (노래, 벌칙 등). 끄면 기록만 남습니다 (꽝, 포인트 지급 등).
  4. 켜기 — 체크를 풀면 이 항목은 나오지 않습니다.
  5. 리롤 — 이 항목이 나오면 정한 확률로 리롤 룰렛을 한 번 더 돌립니다. '대체'를 체크하면 원래 결과 대신 리롤 결과만 남습니다.
  6. 파티 — 내가 파티장일 때 파티 룰렛에서만 적용됩니다. 버튼에 지금 설정이 요약돼 보이고(예: 일반 85% 🤝 10% ⚔ 5%), 누르면 아래 '시간·사용' 칸이 열려 일반·연대책임·공격을 고를 수 있습니다. 위의 '파티 방식 한 번에'로 전체 항목을 한꺼번에 바꿀 수도 있습니다.
  7. 시간·사용 — 누르면 시간·그룹·별칭·사용 응답을 정하는 칸이 열립니다. 정해 둔 값이 버튼에 요약돼 보입니다.

시간 · 그룹 · 별칭

시간 · 그룹 · 별칭 화면
  1. 시간 — 이 결과를 사용(완료)한 순간부터 타이머 오버레이에 카운트다운이 뜹니다 (예: 반말 10분). 파티의 이름(연대책임)·이름(공격) 결과도 원래 항목과 같은 타이머에 이어 붙습니다.
  2. 그룹 — 같은 그룹 이름끼리는 누가 뽑았든 시간이 이어 붙습니다 (탈것금지 5분 + 10분 → 15분). 비우면 같은 시청자의 같은 항목끼리만 이어 붙습니다.
  3. 타이머 따로 — 체크하면 합치지 않고 쓸 때마다 각자 카운트다운합니다. 그룹보다 우선합니다.
  4. 별칭 — 시청자가 !룰렛 별칭으로 바로 쓰거나, 사용 패널에서 이름 대신 칠 수 있는 짧은 이름입니다 (쉼표로 여러 개).
  5. 사용 응답 — 이 항목을 썼을 때 봇이 채팅에 보낼 문구입니다. 비우면 오버레이 탭의 기본 문구를 씁니다.
  6. 🎉 파티에서 — 일반·🤝 연대책임·⚔ 공격을 체크하고 비율을 넣습니다. 한 항목을 세 번 만들 필요 없이, 이 항목 확률 안에서 비율대로 나뉩니다 (예: 탈것금지 15% 안에서 85·10·5). 균등 배분을 체크하면 체크한 방식끼리 1:1:1. 연대책임은 누가 쓰든 파티원 전체 방에, 공격은 쓴 시청자가 고른 방 하나에 적용됩니다.
  7. 이름으로 구분 — 당첨되면 일반은 이름 그대로, 연대책임·공격은 탈것금지5분(연대책임)·탈것금지5분(공격)처럼 따로 쌓이고 타이머도 따로 돕니다. 룰렛 사용 화면·스택 창·스택 오버레이에서는 파티에서 받은 결과가 주황색으로 맨 뒤에 보입니다.

수행 대기 결과 (스택)

수행 대기 결과 (스택) 화면
  1. 검색 · 정렬 — 룰렛 탭의 📚 스택 열기로 새 창을 엽니다. 닉네임이나 결과 이름으로 찾고, 많이 쌓인 순·오래 기다린 순으로 볼 수 있습니다 (룰렛 탭엔 개수와 많이 쌓인 결과만 보임).
  2. 시청자별 묶음 — 같은 결과는 '×3'처럼 묶어서 보여 줍니다. 시청자는 채팅 !룰렛사용으로 화면에 띄워 고르거나, !룰렛 항목으로 바로 쓸 수 있습니다.
  3. ✓ 완료 — 1개를 수행 처리합니다 (가장 먼저 받은 것부터). 시간 항목이면 이때부터 타이머가 시작됩니다.
  4. ✕ 취소 — 1개를 수행하지 않고 지웁니다.
💡 룰렛 탭의 '닉네임 바로 찾기'에 이름을 넣고 Enter를 누르면 그 시청자 검색 상태로 창이 열립니다. 방송 중에는 리모콘의 '룰렛 스택' 칸에서도 사용 처리할 수 있습니다.

확률 공개 페이지

확률 공개 페이지 화면
  1. 공개하기 — (등급과 상관없이 모든 채널) 켜면 시청자 누구나 로그인 없이 룰렛 확률표를 볼 수 있습니다.
  2. 주소 — 시청자에게 알려 줄 확률표 주소입니다. 짧은 주소(6자)라 채팅에 붙여도 잘리지 않습니다. 아래 버튼으로 복사·미리 보기·재발급(새어 나갔을 때)을 합니다.
  3. 공개할 룰렛 — 체크한 룰렛만 확률표에 나옵니다.
  4. 시청자별 보유 결과 — 켜면 확률표 아래에 시청자별로 아직 안 쓴 결과가 나오고, 닉네임으로 찾을 수 있습니다.
  5. 채팅 명령어 — 시청자가 치면 봇이 확률표 주소를 알려 줍니다 (기본 !확률).

룰렛 파티

룰렛 파티 화면
  1. 초대 코드 — 파티장이 파티를 만들면 나오는 코드입니다. 다른 스트리머가 이 코드로 참가합니다 (무료 채널도 참가 가능).
  2. 지금 적용되는 파티는 하나 — '카테고리 상관없이 지금 내 방송에 이 파티 룰렛 쓰기'를 켠 파티가 우선이고(한 번에 하나만 켜짐), 없으면 내 방송 카테고리가 맞는 파티가 자동으로 적용됩니다. 적용 중인 카드엔 ● 지금 이 파티 룰렛 적용 중이 뜹니다. 파티장·다른 파티원이 방송 중이 아니어도 내 방에선 돌아가고 결과는 내 방에 쌓입니다.
  3. 결과 공유 — 켜면 파티 안 어느 방에서 받은 결과든 다른 방에서도 쓸 수 있습니다. 파티가 끝나거나 나가면 안 쓴 공유 결과는 받은 방으로 돌아가고, 각 방에 쌓인 파티 결과는 그대로 남아 일반 결과처럼 씁니다 (시간·응답 유지, 연대책임·공격은 그 방에만 적용).
  4. 파티에서 쓸 내 룰렛 — 체크한 룰렛만 파티원 방송에 똑같이 돕니다. 파티 전용 룰렛은 항상 들어갑니다.
  5. 규칙 (파티장만) — ⚔ 공격권을 뽑은 방에서도 사용 가능(기본 켜짐)을 끄면 공격은 다른 방에만. 나머지 둘은 연대·공격으로 바꾸기 전에 쌓인 결과·파티 전 각 방 결과에도 적용할지 (기본 꺼짐).
  6. 🎡 룰렛 목록 · 확률 — 파티 카드는 요약 한 줄과 버튼(⚙ 설정 · 🎡 룰렛 · 👥 참가 채널)만 보이고, 누르면 그 부분이 아래에 펼쳐집니다. 룰렛 목록에선 파티장 룰렛의 항목별 확률·나누기 비율·리롤을 파티원도 볼 수 있고, 룰렛마다 테스트(저장 없이 내 OBS 룰렛 오버레이에 어떻게 뜨는지 확인)와 📊 시뮬(수만 번 돌려 본 통계) 버튼이 있습니다.
  7. 파티 중엔 !확률에 파티 확률표로 답하기 — 확률표에는 내 룰렛과 들어가 있는 파티 룰렛이 한 표에 나오고, 파티 룰렛엔 어느 파티(파티장)의 룰렛인지와 적용 조건(🎮 카테고리 방송 때 / 직접 켬, 지금 적용 중)이 붙습니다. 내 확률 페이지를 꺼 둔 채널은 파티 중에만 파티 룰렛 + 파티에서 받은 결과만 보이는 페이지가 열립니다.
  8. + 다른 파티 만들기 · 참가 — 파티장은 등급에 따라 여러 파티를 열 수 있고(유료 3개 · 프리미엄 10개), 파티원도 여러 파티에 동시에 들어갈 수 있습니다. 들어가 있는 파티마다 카드 하나씩 보입니다.
💡 공격할 방 고르기 — 공격권을 쓰면 채팅 안내와 함께 상호작용 오버레이에 지금 방송 중인 파티원 방이 번호로 뜨고, 시청자가 번호·방 이름·0(랜덤)을 치면 그 방에 적용됩니다 (60초 안 고르면 랜덤, 방송 중인 방이 없으면 전부 표시). 고르는 중에 !룰렛취소를 치면 사용을 되돌려 결과를 그대로 보관합니다. 관리자는 '직접 지급'에서 파티 룰렛을 골라 지급할 수 있고, 파티원 대시보드를 대신 보는 중에도 됩니다 (오류 대처용 — 스트리머 본인에겐 보이지 않습니다).

노래 (신청곡 · BGM)

시청자 신청곡을 받아 OBS에서 재생하고, 신청곡이 없을 땐 BGM을 트는 곳입니다.

처음엔 이렇게
  1. OBS 플레이어 주소를 복사해 OBS에 브라우저 소스로 추가합니다. 이 소스에서 소리가 납니다.
  2. 아래 신청곡 설정에서 '채팅 신청 받기'를 켜고 저장합니다.
  3. 시청자가 !신청 노래제목을 치면 리스트에 쌓이고 차례로 재생됩니다.
OBS 플레이어지금 재생신청곡 리스트BGM 플레이리스트신청곡 설정

OBS 플레이어

OBS 플레이어 화면
  1. 플레이어 주소 — OBS 소스 추가 → 브라우저 → URL에 붙여 넣습니다. 룰렛 오버레이와 같은 비밀키를 씁니다.
  2. 화면 표시 — 곡 시작 알림만 / 곡 카드 계속 / 영상 + 카드 / 영상만 / 소리만 중에서 고릅니다. 바꾸면 OBS에 바로 반영됩니다.
  3. 카드·알림 위치 — 곡 카드가 뜨는 화면 모서리를 고릅니다.
  4. BGM일 때 숨기기 — BGM이 나올 때는 화면에 아무것도 안 보이게 합니다.
  5. 연결된 플레이어 — 지금 재생 중인 플레이어 수입니다. 같은 주소를 일반 브라우저에서 열면 그쪽이 재생을 가져가니 주의하세요.
💡 OBS 브라우저 소스의 'OBS에서 오디오 제어'를 켜면 믹서에서 볼륨을 따로 조절할 수 있습니다.

지금 재생

지금 재생 화면
  1. 지금 곡 — 제목·신청자·재생 시간이 보입니다.
  2. 넘기기 · 일시정지 — 지금 곡을 넘기거나 멈춥니다.
  3. 볼륨 — 전체 볼륨을 조절합니다.
  4. 이 곡만 −3dB · +3dB · 원래대로 — 유난히 크거나 작은 곡만 따로 맞춥니다. 다음에 같은 곡이 나와도 그대로 적용됩니다.

신청곡 리스트

신청곡 리스트 화면
  1. 리스트 — ▶는 지금 곡, 번호는 나올 순서, 회색은 지나간 곡입니다. 재생한 곡도 남아 있어 다시 틀 수 있습니다.
  2. 다음 곡으로 · 취소 — 순서를 당기거나 빼냅니다. 지나간 곡은 '여기부터·다음에·맨 뒤'로 다시 틀 수 있습니다.
  3. 처음부터 다시 · 리스트 비우기 — 리스트 처음부터 다시 재생하거나 전부 지웁니다.
  4. 직접 추가 — 유튜브 주소나 제목으로 스트리머가 직접 넣습니다.
  5. 리스트 보관 — 봇을 켤 때 리스트를 비울지, 리스트에 몇 곡까지 남길지 정합니다.

BGM 플레이리스트

BGM 플레이리스트 화면
  1. BGM 자동 재생 — 신청곡이 없을 때 BGM을 틀어 줍니다.
  2. 사용할 플레이리스트 — 아래에서 만든 플레이리스트 중 하나를 고릅니다.
  3. BGM 볼륨 — 신청곡 볼륨 대비 몇 %로 틀지 정합니다.
  4. 신청곡이 오면 바로 끊기 — 끄면 BGM 곡이 끝난 뒤 신청곡이 나옵니다.
  5. 플레이리스트 만들기 · 곡 관리 — 이름을 넣고 만든 뒤 유튜브 주소나 재생목록 주소로 곡을 넣습니다. 신청곡 리스트의 'BGM에 담기'로도 넣을 수 있습니다.

신청곡 설정

신청곡 설정 화면
  1. 채팅 신청 받기 · 신청 명령어 — 켜면 시청자가 !신청 노래제목으로 신청합니다.
  2. 시청자 명령어 — 대기열 보기·현재 곡·본인 취소·넘기기·재개 명령어를 정합니다 (넘기기·재개는 스트리머·매니저만).
  3. 제한 — 1인 최대 곡, 대기열 최대 곡, 곡 최대 길이, 신청 비용(포인트)을 정합니다.
  4. 음량 맞추기 · 채팅 알림 — 작게 녹음된 곡을 키워 주고, 신청 완료나 곡이 바뀔 때 채팅으로 알립니다.
  5. 영상 후원 때 멈추기 — 영상 후원이 오면 금액만큼(1초당 금액 기준) 신청곡을 멈췄다가 이어서 재생합니다. 치지직 영상 후원 설정의 '1초당 금액'과 맞춰 주세요.

포인트 · 출첵

출첵과 후원 적립으로 시청자 포인트를 쌓고, 포인트를 조회·조정하는 곳입니다.

처음엔 이렇게
  1. 포인트 · 출첵 설정에서 '포인트 시스템 사용'을 켭니다.
  2. 출첵 명령어와 포인트, 후원 적립 비율을 정하고 저장합니다.
  3. 아래 시청자 포인트에서 누가 얼마나 있는지 확인하고, 필요하면 조정합니다.
포인트 · 출첵 설정시청자 포인트

포인트 · 출첵 설정

포인트 · 출첵 설정 화면
  1. 포인트 시스템 사용 — 꺼 두면 출첵·적립·포인트 룰렛이 모두 멈춥니다.
  2. 출첵 — 출첵 포인트·명령어, 지급 방식(매일 1회 / 최초 1회), 첫 채팅 자동 출첵, 팔로워만 출첵을 정합니다.
  3. 채팅 응답 — 출첵 성공·이미 출첵 메시지를 정합니다. {Nickname} {amount} {balance} 같은 변수를 쓸 수 있습니다.
  4. 후원 적립 — 후원액의 몇 %를 포인트로 줄지, 일정 금액 이상이면 추가로 얼마를 줄지 정합니다 (1치즈 = 1포인트 기준).
  5. 기타 — 잔액 조회 명령어, 닉네임을 바꾼 시청자에게 채팅 안내를 할지 정합니다.

시청자 포인트

시청자 포인트 화면
  1. 찾기 — 닉네임으로 시청자를 찾습니다.
  2. 연결 안 된 사람만 보기 — 데스크톱에서 옮겨 왔는데 아직 연결 안 된 사람만 봅니다. 첫 채팅 때 같은 닉네임이면 자동으로 연결됩니다.
  3. 조정 · 합치기 — 포인트를 직접 더하거나 빼고, 닉네임을 바꿔 둘로 나뉜 기록을 하나로 합칩니다.

명령어 · 자동 공지

시청자가 채팅에 치면 봇이 자동으로 답하는 명령어와, 정해진 시간마다 보내는 자동 공지를 만드는 곳입니다.

처음엔 이렇게
  1. + 새 명령어를 누르거나 예시로 시작하기에서 하나를 고릅니다.
  2. 명령어와 응답을 넣고, 변수 버튼으로 {Nickname} 같은 값을 넣은 뒤 저장합니다.
  3. 방송 채팅에서 직접 쳐서 확인합니다.
명령어 목록명령어 만들기자동 공지기본 기능 명령어

명령어 목록

명령어 목록 화면
  1. 명령어 · 응답 — 쉼표로 여러 이름을 줄 수 있습니다 (예: !디코 · !디스코드).
  2. 사용 횟수 · 쿨다운 — 지금까지 몇 번 쓰였는지와 쿨다운이 보입니다.
  3. 끄기 · 편집 · 삭제 — 잠깐 끄거나 고치거나 지웁니다.
  4. + 새 명령어 — 빈 명령어를 새로 만듭니다.
  5. 예시로 시작하기 — 링크 안내·주사위·가위바위보·대상 지정·횟수 세기 예시를 바로 가져옵니다.

명령어 만들기

명령어 만들기 화면
  1. 명령어 — '!'로 시작하면 뒤에 글을 붙여도 반응합니다 (예: !때리기 @철수). '!' 없이 쓰면 채팅이 정확히 그 말일 때만 반응합니다.
  2. 응답 — 줄을 바꾸면 메시지를 따로 보냅니다 (최대 3줄 · 줄마다 100자).
  3. 변수 버튼 — 누르면 응답에 들어갑니다. {random:1-6} 주사위, {pick:가위|바위|보} 무작위 선택, {target} 대상 닉네임, {count} 사용 횟수 등.
  4. 미리보기 — 예시 시청자가 쳤을 때 실제로 나갈 문장이 보입니다.
  5. 사용 조건 — 스트리머·매니저만, 비용(포인트), 1인·전체 쿨다운을 정합니다. 쿨다운 중엔 조용히 무시됩니다.

자동 공지

자동 공지 화면
  1. 공지 목록 — 만들어 둔 공지와 간격·조건이 보입니다. 편집·삭제할 수 있습니다.
  2. 공지 내용 — 명령어와 같은 변수({streamer}, {time} 등)를 쓸 수 있습니다.
  3. 간격 · 채팅 조건 — 'N분마다, 그 사이 채팅이 M개 이상일 때' 보냅니다. 채팅이 조용할 땐 보내지 않아 공지만 쌓이지 않습니다.
  4. 사용 · 저장 — 봇이 켜져 있을 때만 보내집니다.

기본 기능 명령어

기본 기능 명령어 화면
  1. 기본 명령어 목록 — 출첵·포인트·룰렛·신청곡·베팅·퀴즈·추첨 같은 기본 기능이 쓰는 명령어입니다. 같은 이름으로 커스텀 명령어를 만들면 기본 기능이 먼저 반응합니다.

추첨

채팅으로 참가자를 모아 당첨자를 뽑는 곳입니다.

처음엔 이렇게
  1. ▶ 참가 받기 시작을 누릅니다.
  2. 시청자가 채팅에 !참가를 치면 참가자 목록에 쌓입니다.
  3. ⏹ 마감 후 인원을 정해 🎉 뽑기를 누르면 룰렛 오버레이에 연출되고 채팅으로 안내됩니다.
참가 받기 · 뽑기참가자 · 제외 명단추첨 설정

참가 받기 · 뽑기

참가 받기 · 뽑기 화면
  1. 상태 — 참가를 받는 중인지, 몇 명이 참가했는지(제외 인원 포함) 보입니다.
  2. 참가 받기 시작 · 새로 시작 · 마감 — 새로 시작은 명단을 비우고 처음부터 받습니다.
  3. 뽑을 인원 · 뽑기 — 여러 명을 한 번에 뽑을 수 있습니다. 제외 명단에 있는 사람은 빠집니다.
💡 방송 중엔 채팅 명령으로도 됩니다: !추첨시작 · !추첨마감 · !추첨 3 (스트리머·매니저만).

참가자 · 제외 명단

참가자 · 제외 명단 화면
  1. 참가자 목록 — 참가한 시청자가 보입니다.
  2. 제외 · 빼기 — 제외는 참가는 그대로 두고 뽑을 때만 빼고, 빼기는 명단에서 지웁니다.
  3. 명단 비우기 · 마블룰렛 목록 복사 — 마블룰렛 같은 외부 추첨 도구에 붙여 넣을 목록을 복사합니다.
  4. 제외 명단 — 닉네임으로 직접 추가하거나 해제합니다. '당첨자 자동 제외'를 켜면 당첨자가 자동으로 여기 들어갑니다.

추첨 설정

추첨 설정 화면
  1. 참가 명령어 — 쉼표로 여러 개를 쓸 수 있습니다.
  2. 여러 번 참가 허용 — 친 횟수만큼 당첨 확률이 올라갑니다.
  3. 팔로워만 참가 — 홈 탭 '채널 연동'에서 팔로워 목록이 받아져 있을 때만 적용됩니다.
  4. 채팅 안내 — 참가할 때마다 응답(사람이 많으면 도배가 되니 기본은 꺼짐), 시작·마감·당첨 안내를 정합니다.
  5. 당첨자 자동 제외 — 다음 추첨에서 이번 당첨자를 자동으로 뺍니다.
  6. 스트리머·매니저 명령어 — 대시보드 없이 채팅으로 시작·마감·뽑기를 하는 명령어입니다.

게임 (베팅 · 사다리 · 퀴즈)

포인트 베팅·사다리게임·시청자 퀴즈로 시청자와 함께하는 게임을 진행하는 곳입니다. 게임 화면은 '룰렛 사용 패널' 오버레이에 뜹니다.

처음엔 이렇게
  1. 오버레이 탭의 룰렛 사용 패널 주소를 OBS에 넣습니다. 게임 화면이 여기 뜹니다.
  2. 원하는 게임 카드에서 시작합니다.
  3. 결과를 고르면 포인트가 자동으로 정산됩니다.
포인트 베팅사다리게임시청자 퀴즈퀴즈 설정

포인트 베팅

포인트 베팅 화면
  1. 진행 상황 — 제목, 남은 시간, 방식(VS / 정답 맞히기), 선택지별 인원·포인트·비율이 실시간으로 보입니다.
  2. 이걸로 정산 — 결과가 나오면 이긴 선택지를 누릅니다. 이긴 쪽이 건 비율대로 나눠 받습니다.
  3. 지금 마감 · 취소 — 시간 전에 마감하거나, 취소하면 전액 환불됩니다.
  4. 참가자 — 누가 어디에 얼마 걸었는지 보입니다.
  5. 베팅 설정 — 베팅·현황·내 베팅 명령어, 최소·최대 포인트, 채팅 안내를 정합니다.
💡 베팅이 없을 땐 같은 자리에 제목·선택지·시간을 넣는 칸이 나오고 ▶ 베팅 시작으로 엽니다. 시청자는 !베팅 1 500처럼 겁니다.

사다리게임

사다리게임 화면
  1. 제목 — 화면에 나올 제목입니다 (선택).
  2. 모집 방식 — 참가 명령어를 친 사람 / 아무 채팅이나 친 사람 / 스트리머가 직접 추가 중에서 고릅니다.
  3. 참가 명령어 · 참가비 — 참가비(포인트)를 받을 수 있습니다.
  4. 모집 시간 — 이 시간이 지나면 자동으로 마감됩니다.
  5. 모집 시작 — 마감 후 결과를 입력하고, 한 명씩(또는 동시에) 내려가며 결과를 공개합니다.

시청자 퀴즈

시청자 퀴즈 화면
  1. 흐름 — 시청자가 제출 페이지에서 문제를 내고 코드를 받음 → 포인트(!퀴즈 코드)나 후원(메시지에 코드)으로 발동 → 스트리머가 시작 → 답 고르기.
  2. 발동됨 · 시작 · 무효 — 발동된 퀴즈가 여기 뜹니다. 시작 전엔 스트리머도 문제를 볼 수 없습니다(공정성).
  3. 제출 페이지 주소 — 짧은 주소라 채팅에 붙여도 잘리지 않습니다. 시청자가 !퀴즈만 쳐도 봇이 알려 줍니다.
  4. 테스트 퀴즈 — 보상 없이 바로 발동된 퀴즈를 만들어 오버레이를 확인합니다.
  5. 🤝 후불 퀴즈 납부 — 후불 퀴즈를 스트리머가 맞히면 '납부 대기'가 되고, 시청자가 후원 메시지에 코드를 넣으면 자동으로 '납부 완료'. 시간이 지나면 '미납'으로 바뀌고 미납자(치지직 닉네임·채널 ID)에 남습니다. 코드 없이 후원했으면 받음, 봐주려면 면제.

퀴즈 설정

퀴즈 설정 화면
  1. 받기 켜기 — 포인트 퀴즈·후원 퀴즈(후불은 아래)를 각각 받을지, 제출 페이지를 열지 정합니다.
  2. 시간 · 코드 · 보기 — 답 제한 시간, 코드 유효 시간, 보기 최대 개수입니다.
  3. 포인트 퀴즈 — 걸 포인트 범위, 스트리머가 틀리면 시청자에게 줄 배율, 무효 시 환불을 정합니다.
  4. 후원 퀴즈 — 최소 금액(나눠 후원 가능), 스트리머가 틀리면 시청자 보상(포인트·룰렛)을 정합니다.
  5. 스트리머 벌칙 — 틀리거나 시간 초과면 스트리머가 벌칙 룰렛을 1회 돌립니다 (후원 퀴즈가 '맞혀도 그만'이 되지 않게).
  6. 🤝 후불 퀴즈 — 치지직 로그인한 시청자만 낼 수 있고, 돈을 먼저 안 내고 바로 발동됩니다. 스트리머가 맞히면 정한 시간 안에 후원해야 하고, 안 내면 이 방송에만 미납으로 기록돼 풀릴 때까지 후불 퀴즈를 못 냅니다. 처음 한도는 작게, 제때 낸 만큼 늘어납니다. 모찌봇은 돈을 받거나 보증하지 않고 기록만 남깁니다.
  7. 무효 처리 — 후원은 현금 환불이 안 되니 그대로 두거나 포인트로 보상합니다.

오버레이

OBS에 넣을 오버레이 주소를 복사하고, 테스트·디자인(CSS)·룰렛 결과 사용 패널을 설정하는 곳입니다.

처음엔 이렇게
  1. 필요한 오버레이의 복사를 누르고 OBS → 소스 추가 → 브라우저 → URL에 붙여 넣습니다 (권장 크기에 맞춰 주세요).
  2. 미리보기로 모양을, 테스트 보내기로 실제 OBS 화면을 확인합니다.
  3. 색·글꼴·위치는 디자인 바꾸기 (CSS)에서 바꿉니다.
오버레이 주소테스트 보내기디자인 바꾸기 (CSS)룰렛 결과 사용진행 중인 시간 타이머

오버레이 주소

오버레이 주소 화면
  1. 알림 — 룰렛 결과·리롤·사용·출첵을 작은 토스트로 띄우고 읽어 줍니다 (1920×1080). 룰렛 오버레이를 쓰면 룰렛 탭에서 알림에 룰렛 결과 띄우기를 끄세요.
  2. 룰렛 오버레이 — 룰렛마다 고른 연출(원판·슬롯머신)과 디자인대로 화면 가운데 크게, 추첨 슬롯 (1920×1080).
  3. 스택 목록 — 아직 수행 안 한 룰렛 결과 목록 (500×1080).
  4. 시간 타이머 — 시간 룰렛을 사용한 뒤 남은 시간 (450×800).
  5. 룰렛 사용 패널 — !룰렛사용 화면, 베팅·사다리·퀴즈 화면도 여기 뜹니다 (1920×1080).
  6. 현재 곡 — 지금 재생 중인 신청곡·BGM 제목 한 줄 (900×120).
  7. 신청곡 플레이어 — 실제로 소리가 나는 소스입니다 (1920×1080).
  8. 🎧 모니터링 TTS — 누가 어떤 룰렛을 돌렸는지·무엇을 사용했는지 스트리머만 듣는 음성. OBS에서 이 소스를 'OBS를 통해 오디오 제어' → 고급 오디오 속성 → 오디오 모니터링 모니터만 (출력 음소거)로 두면 방송엔 안 나갑니다 (화면엔 안 보임).
💡 주소에 비밀키가 들어 있습니다. 새어 나갔으면 룰렛 탭의 '주소 재발급'을 누르세요 (모든 오버레이 주소가 함께 바뀝니다).

테스트 보내기

테스트 보내기 화면
  1. 출첵 알림 — 실제 OBS 알림 오버레이에 출첵 알림을 띄웁니다 (기록·포인트는 안 바뀜).
  2. 사용 알림 — 룰렛 결과 사용 알림을 띄웁니다.
  3. 사용 패널 (15초) — 룰렛 사용 패널을 15초 동안 띄웁니다.
💡 룰렛 결과 알림 테스트는 룰렛 탭 목록의 테스트로 합니다.

디자인 바꾸기 (CSS)

디자인 바꾸기 (CSS) 화면
  1. 오버레이 고르기 — 꾸밀 오버레이를 고릅니다. 오버레이마다 따로 저장됩니다.
  2. 미리보기 (예시 데이터) — 예시 데이터가 나오는 화면에서 바로 확인합니다.
  3. CSS 입력 — 색·크기·위치를 정하는 CSS를 넣습니다. 저장하면 5초 안에 OBS에 반영됩니다.
  4. 저장 · 기본 디자인으로 — 마음에 안 들면 기본 모습으로 되돌립니다.
  5. CSS 설명서 — 꾸밀 수 있는 부분·변수·예시가 정리돼 있습니다.

룰렛 결과 사용

룰렛 결과 사용 화면
  1. 사용 기능 켜기 — 시청자가 쌓인 룰렛 결과를 직접 사용하게 합니다.
  2. 패널 명령어 · 바로 사용 — !룰렛사용은 화면에 목록을 띄워 번호로 고르고, !룰렛 노래처럼 바로 쓸 수도 있습니다.
  3. 패널 시간 · 한 페이지 — 패널이 떠 있는 시간과 한 번에 보일 개수입니다.
  4. 채팅 응답 문구 — 사용·보유 없음·다른 사람 사용 중 같은 상황별 봇 응답을 정합니다.
  5. 지금 떠 있는 패널 닫기 — 화면을 가리는 패널을 바로 닫습니다 (리모콘에서도 됨).

진행 중인 시간 타이머

진행 중인 시간 타이머 화면
  1. 타이머 목록 · 종료 — 지금 돌아가는 시간 룰렛과 남은 시간이 보이고, 종료를 누르면 바로 끝납니다.

후원

치지직 후원(일반·영상) 기록을 모아 보고, 찾고, 엑셀로 내려받는 곳입니다.

처음엔 이렇게
  1. 봇이 켜져 있는 동안 들어온 후원은 자동으로 쌓입니다.
  2. 위에서 오늘·이번 달 합계, 최근 14일 그래프, 이번 달 순위를 봅니다.
  3. 아래에서 종류·닉네임·기간으로 찾고 CSV (엑셀)로 받습니다.
후원 요약후원 찾기 · 내려받기

후원 요약

후원 요약 화면
  1. 합계 — 오늘·이번 달·이번 달 영상 후원·전체 기록의 금액과 건수입니다.
  2. 최근 14일 — 날짜별 후원 금액 그래프입니다.
  3. 이번 달 순위 — 이번 달 후원을 많이 한 시청자 순서입니다.

후원 찾기 · 내려받기

후원 찾기 · 내려받기 화면
  1. 종류 — 전체 / 일반 후원 / 영상 후원.
  2. 닉네임 · 메시지 — 글자로 찾습니다.
  3. 기간 — 시작·끝 날짜를 정합니다.
  4. 찾기 · 초기화 — 조건을 적용하거나 지웁니다.
  5. CSV (엑셀) — 지금 조건으로 찾은 기록을 엑셀에서 열 수 있는 파일로 받습니다.

리모콘

방송 중 대시보드 없이 작은 창(또는 OBS 독) 하나로 봇·신청곡·영상 후원·룰렛·채팅을 조작하는 화면입니다.

처음엔 이렇게
  1. 왼쪽 메뉴 리모콘 열기를 누르거나, 홈의 '주소 복사'로 OBS 독에 붙입니다.
  2. 오른쪽 위 ⚙에서 보일 칸과 순서를 고릅니다.
  3. 방송 중엔 필요한 버튼만 누르면 됩니다. 모든 내용이 실시간으로 바뀝니다.
리모콘 화면보일 기능 고르기 (DIY)

리모콘 화면

리모콘 화면 화면
  1. 봇 — 봇·방송 상태와 켜기/끄기.
  2. 신청곡 — 지금 곡·다음 곡, 일시정지·다음 곡, 신청 받기 켜기/끄기.
  3. 영상 후원 — 영상 후원으로 멈춘 신청곡의 남은 시간. 웹 리모콘은 치지직 영상 스킵을 지원하지 않으니, 영상을 끊으려면 OBS 독으로 연 리모콘에서 '치지직 영상 끊기 (OBS)'를 쓰세요 (끊으면 신청곡도 바로 이어서 재생).
  4. 최근 룰렛 — 방금 돈 룰렛 결과.
  5. 룰렛 사용 화면 — 시청자가 띄운 !룰렛사용 화면을 닫거나, 일부러 가리는 시청자를 10분 동안 막습니다.
  6. 시간 타이머 — 진행 중인 시간 룰렛의 남은 시간이 실시간으로 줄어듭니다. 1분 남으면 빨간색, 종료로 바로 끝냅니다.
  7. 채팅 — 실시간 채팅·후원을 보고, 채팅을 보냅니다. 보낸 채팅은 이 방의 봇 이름(기본 봇·내 봇)으로 나가며, 스트리머가 친 것으로 봐서 !명령어도 평소처럼 반응합니다. 파티 중엔 '파티 채팅 합치기'로 다른 방 채팅도 같이 봅니다.
  8. ⚙ 보일 기능 — 칸을 켜고 끄고 순서를 바꿉니다.

보일 기능 고르기 (DIY)

보일 기능 고르기 (DIY) 화면
  1. 기능 체크 — 추첨·베팅·사다리·퀴즈 시작 버튼, 룰렛 스택, '치지직 영상 끊기 (OBS)' 같은 칸을 골라 넣습니다. 🔒는 지금 등급에서 잠긴 기능입니다.
  2. ▲ ▼ — 순서를 바꿉니다.
  3. 저장 — 이 배치는 스트리머마다 저장돼 다른 PC에서 열어도 같습니다.
💡 '치지직 영상 끊기 (OBS)'는 OBS 웹소켓으로 영상 후원 소스를 새로고침해서 재생 중인 영상을 끊습니다. OBS가 있는 PC에서 연 리모콘에서만 동작합니다.

다른 메뉴

노래·포인트·명령어·추첨·게임·오버레이·후원·리모콘 설명서는 차례로 추가됩니다. 오버레이 디자인(CSS)은 오버레이 CSS 설명서를 봐 주세요.