외부 프로그램 연동이 뭔가요?
내 PC 에서 돌아가는 VTube Studio · T.I.T.S. · Warudo · VNyan 을 뚜봇과 연결해서, 후원·구독·구독권 선물·팔로우·채팅 명령어·미션 성공이 있을 때 자동으로 핫키를 누르거나, 트리거를 실행하거나, 아이템을 던지게 할 수 있어요.
OBS 에 뚜봇 오버레이 하나(연동 전용 오버레이든, 이미 쓰고 있는 다른 오버레이든)를 브라우저 소스로 넣어 두면, 그 오버레이가 내 PC 의 프로그램들과 뚜봇 서버 사이를 이어줘요.
시작하기 전에
프로그램마다 미리 켜 둬야 하는 설정이 있어요. 대시보드 외부 프로그램 연동 → 연결 탭에도 같은 안내가 나와요.
| 프로그램 | 미리 할 일 | 기본 포트 |
|---|---|---|
| T.I.T.S. | 따로 설정할 게 없어요(기본값 그대로) | 42069 |
| VTube Studio | 설정에서 Allow Plugin API access(플러그인 API 허용)를 켜기 | 8001 |
| Warudo | 블루프린트에 On WebSocket Message Received 노드 만들어 두기(뚜봇이 보낸 문자열이 이 노드로 들어가요) | 19190 |
| VNyan | Settings > Misc > WebSockets 에서 Start Receiver 켜기 | 8000 |
VTube Studio는 처음 연결할 때 허용 창이 떠요
연결 탭에서 VTube Studio 를 켜면 VTube Studio 화면에 연결을 허용할지 묻는 창이 나타나요. 허용을 눌러야 연결돼요.
실수로 거부했다면 연결 탭의 다시 요청 버튼을 누른 뒤 VTube Studio 에서 다시 허용해주세요. 이 버튼은 상태가 거부됨 또는 오류일 때만 눌려요(연동 상태 자체는 연결됨이어야 동작해요).
OBS에 오버레이 넣기
이미 다른 뚜봇 오버레이를 쓰고 있나요?
채팅·카운터·후원 알림 같은 뚜봇 오버레이를 하나라도 OBS 에 이미 넣어뒀다면 그걸로 충분해요. 화면을 그리는 것과 별개로, 뚜봇 오버레이는 전부 이 연동 기능도 함께 처리하기 때문에 새로 추가할 필요가 없어요.
아무 오버레이도 안 쓴다면
대시보드 외부 프로그램 연동 → 연결 탭을 열면, 연동 상태가 없음일 때 연동 전용 오버레이 칸이 나와요. 거기서 주소 보기를 누르고 주소 복사로 주소를 받으세요. 이 오버레이는 화면에 아무것도 그리지 않아요.
OBS에 브라우저 소스로 추가
OBS 소스 패널 → + → 브라우저 → URL 칸에 붙여넣기. 화면에 그려지지 않으니 크기는 상관없어요.
오버레이 주소는 방송에 노출되면 안 돼요
연동 전용 오버레이도 다른 오버레이와 똑같이, 주소만 알면 누구나 열어볼 수 있어요. 방송 화면에 나타나지 않도록 주의해주세요.
연결은 OBS 브라우저 소스 안에서만 동작해요
일반 Chrome 탭이나 대시보드의 오버레이 미리보기 화면에서는 연결이 시작되지 않아요. 반드시 OBS 브라우저 소스로 열어야 해요.
연결 탭 — 연동 상태 확인하기
대시보드 외부 프로그램 연동 메뉴를 열면 맨 위에 연동 상태가 보여요.
| 상태 | 의미 |
|---|---|
| 연결됨 (N초 전) | OBS 의 오버레이가 정상적으로 신호를 보내고 있어요 |
| 없음 | OBS 가 꺼져 있거나, 오버레이를 아직 안 넣었거나, 새로고침이 필요해요 |
| 확인 중… | 페이지를 방금 열어서 아직 판단하기 전이에요 |
연동 상태가 '없음' 일 때
이 기능을 방금 처음 켰거나, 뚜봇 업데이트 전부터 OBS 를 켜 두었거나, 기능이 꺼졌다가 다시 켜졌다면 OBS 의 뚜봇 브라우저 소스를 새로고침하거나 OBS 를 다시 시작해주세요.
프로그램별 켜기 · 포트
각 프로그램 카드에서 사용 스위치와 포트를 설정해요. 포트는 1~65535 사이 숫자여야 하고, 기본값 버튼으로 되돌릴 수 있어요. 프로그램 쪽 포트를 바꿨다면 여기도 같은 값으로 맞춰야 해요.
| 상태 배지 | 의미 |
|---|---|
| 사용 안 함 | 그 프로그램의 스위치가 꺼져 있어요 |
| OBS 중계 없음 | 연동 상태가 '없음'이라 지금 상태를 알 수 없어요 |
| 연결 중 | 프로그램이 켜져 있는지, 포트가 맞는지 확인해보세요 |
| 허용 대기 | VTube Studio 화면에서 허용을 기다리는 중이에요 |
| 거부됨 | VTube Studio 에서 거부했어요. '다시 요청'을 누르고 다시 허용해주세요 |
| 오류 | 연결에 실패했어요. 옆에 뜨는 상세 문구를 확인하세요 |
| 연결됨 | 정상 연결됐어요 |
| 꺼짐 | 저장하면 OBS 가 설정을 다시 읽고 연결을 시작해요 |
같은 네트워크의 다른 기기에서 접속할 수 있어요
T.I.T.S.·VNyan 등은 인증 없이 같은 네트워크(LAN)의 다른 기기에서도 접속할 수 있게 열려 있을 수 있어요. 공용 와이파이 같은 곳에서 방송한다면 PC 방화벽 설정을 확인해주세요.
T.I.T.S. 자동 금액 감지
규칙을 따로 만들지 않아도, 후원 금액과 이름이 같은 T.I.T.S. 트리거를 자동으로 실행할 수 있어요. T.I.T.S. 카드 안의 자동 금액 감지 스위치를 켜고, 감지할 후원 종류(채팅·영상·파티·미션 성공)를 하나 이상 고르세요. T.I.T.S. '사용'도 함께 켜져 있어야 동작해요.
트리거 이름은 아래 규칙으로 읽어요(앞뒤 공백은 무시하고, 이름 전체가 금액이어야 해요).
| 트리거 이름 | 뜻 |
|---|---|
1000 · 1,000 · 1000치즈 | 정확히 1,000치즈일 때 |
1000~2999 | 1,000 이상 2,999 이하일 때(양 끝 포함) |
5000~ | 5,000 이상일 때 |
이름이 맞는 트리거가 여러 개면 전부 실행돼요. 폭탄 1000처럼 다른 글자가 섞였거나, 5000+, 숫자와 치즈·원 사이에 공백이 있는 이름(1000 치즈)은 인식하지 않아요.
규칙 탭과 같이 써도 괜찮아요
자동 금액 감지는 아래 규칙 탭의 규칙과는 완전히 따로 동작해요. 둘 다 조건에 맞으면 둘 다 실행돼요.
카드 아래 지금 인식되는 트리거 목록에서 실제로 어떤 트리거가 얼마로 인식됐는지 미리 볼 수 있어요(연동이 완료된 뒤에만 표시돼요).
프리셋 탭 — 실행할 동작 모음 만들기
프리셋은 이름 붙인 동작 목록이에요. 규칙·시험 발사가 프리셋을 골라 실행하면, 그 안의 동작이 위에서부터 순서대로 실행돼요. 채널당 프리셋 최대 50개, 프리셋 하나에 동작 최대 20개까지 넣을 수 있어요.
넣을 수 있는 동작
| 동작 | 하는 일 |
|---|---|
| T.I.T.S. 트리거 실행 | 목록에서 트리거를 하나 골라 실행 |
| T.I.T.S. 아이템 던지기 | 아이템을 최대 10개 골라, 개수(1 |
| VTube Studio 핫키 | 목록에서 핫키를 하나 골라 실행 |
| VTube Studio 표정 | 목록에서 표정을 골라 켜거나 끄기 |
| Warudo 메시지 | 정해 둔 문자열을 Warudo 로 전송(최대 200자) |
| VNyan 명령 | 정해 둔 명령을 VNyan 으로 전송(최대 200자) |
| 대기 | 다음 동작까지 시간 두기(한 번에 최대 10초, 프리셋 전체 대기 합계 최대 30초) |
트리거·아이템·핫키·표정은 목록에서 골라야 해요(이름을 직접 입력하지 않아요). 이 목록은 연동이 완료되면 T.I.T.S.·VTube Studio 에서 실시간으로 받아와요. 고른 항목이 나중에 그 프로그램에서 지워지면 자동으로 빠지지는 않고 주의 문구만 떠요 — 그대로 두면 실행할 때 실패로 기록돼요.
Warudo · VNyan 문구에 값 끼워 넣기
{amount} 는 후원 금액·구독권 장수·구독 티어로, {nickname} 은 시청자 닉네임(최대 30자)으로 바뀌어 전달돼요.
팔로우·채팅 명령어·시험 발사에서는 {amount} 자리가 빈 칸이 돼요.
VNyan 은 명령어 + 공백 + 숫자 형식으로 숫자를 읽으므로, {amount} 는 명령어 바로 뒤에 두세요(예: Bonk {amount}).
동작 왼쪽의 ⋮⋮ 를 끌거나 ↑↓ 버튼으로 순서를 바꿀 수 있어요.
시험 발사
프리셋 이름 옆 시험 발사로 실제로 실행해볼 수 있어요. 저장하지 않은 변경이 있으면 눌러지지 않아요 — 시험 발사는 항상 저장된 내용으로 실행되기 때문이에요. 연동이 완료되지 않은 상태에서 누르면 전송은 되지만 실행되지 않는다는 안내가 떠요. 결과는 최근 실행 탭에서 확인할 수 있어요.
프리셋 삭제
프리셋을 삭제하면 그 프리셋을 쓰던 규칙도 함께 삭제돼요. 삭제하기 전에 어떤 규칙이 함께 지워지는지 보여주는 확인 창이 떠요.
규칙 탭 — 언제 실행할지 정하기
규칙은 방송 중 특정 사건이 일어나면 지정한 프리셋을 실행해요. 방송 중일 때만 발동하고(시험 발사는 예외), 조건에 맞는 규칙은 전부 실행돼요. 채널당 최대 50개까지 만들 수 있고, 먼저 프리셋 탭에서 프리셋을 하나 이상 만들어야 규칙을 추가할 수 있어요.
사건(트리거) 종류
| 종류 | 조건 |
|---|---|
| 후원 | 후원 종류(채팅·영상·미션 성공·파티), 금액 조건(이상·이하·정확히·범위), 키워드 조건(하나라도/모두 포함·전체 일치), 반복(금액만큼 같은 명령을 여러 번) |
| 구독 | 티어(모든 티어·1티어·2티어) |
| 구독권 선물 | 티어 + 선물 장수 조건. 선물한 사람 기준으로 한 번만 발동해요(받은 사람마다 발동하지 않아요) |
| 팔로우 | 조건 없음. 뉴스피드가 연결된 채널에서만 동작해요 |
| 채팅 명령어 | 명령어 문구(공백 불가, 최대 30자), 사용 권한(누구나·구독자·매니저·스트리머), 규칙 전체·사람별 쿨다운(각각 최대 3600초) |
후원 조건 상세
- 금액·키워드 조건을 둘 다 끄면 고른 종류의 모든 후원에 발동해요.
- 키워드는 후원 문구 앞뒤 공백을 뺀 뒤 비교하고, 영문 대소문자는 가리지 않아요.
- 반복을 켜면 후원 금액을 기준 금액으로 나눈 횟수만큼(최소 1번, 최대 20번) 같은 명령을 한 번에 실행해요.
- 미션 성공은 미션이 성공했을 때 누적 상금 기준으로 한 번만 발동해요. 미션에 참여한 후원 자체에는 발동하지 않아요.
채팅 명령어 규칙은 봇 명령어와 달라요
채팅의 첫 단어가 정한 명령어와 같으면 발동해요(영문 대소문자 무시). 쿨다운은 뚜봇이 재시작하면 초기화돼요.
겹침 경고
같은 사건에 여러 규칙이 함께 발동할 수 있으면(예: 금액 조건이 겹치는 두 규칙, 서로 포함 관계인 키워드) 노란 경고가 떠요. 저장을 막지는 않아요 — 의도한 구성이라면 그대로 저장해도 돼요.
최근 실행 탭
최근 실행된 명령 20건과, 이 페이지를 연 뒤 보낸 명령을 함께 보여줘요. 시각·프리셋·계기(규칙·시험 발사 등)·결과를 볼 수 있어요.
| 결과 | 뜻 |
|---|---|
| 성공 | 프리셋의 모든 동작이 성공했어요 |
| 일부 실패 | 일부 동작만 실패했어요(예: 지워진 트리거를 가리키는 동작) |
| 실패 | 전부 실패했어요 |
| 결과 기다리는 중 | 아직 결과가 오지 않았어요 |
| 미전달 | 보낸 뒤 30초 + 프리셋의 대기·던지기 시간(반복 횟수만큼)이 지나도 결과가 오지 않았어요 |
미전달이 계속 뜬다면
먼저 연동 상태를 확인하세요. 연동이 끊긴 동안 보낸 명령은 실행되지 않고, 나중에 다시 연결돼도 그 명령이 다시 전송되지는 않아요.
누가 설정할 수 있나요
스트리머 본인만 설정할 수 있어요. 매니저 계정으로 들어오면 대시보드로 돌아가요.
바꾼 설정은 저장 버튼을 눌러야 반영돼요. 저장하면 보통 OBS 를 새로고침하지 않아도 자동으로 반영되지만, 이 기능을 방금 처음 켰거나 오래 전부터 OBS 를 켜둔 채였다면 한 번 새로고침해주세요(위 "연동 상태가 '없음'일 때" 참고).
다른 곳에서 먼저 저장했다면
같은 설정을 다른 탭이나 관리자가 먼저 저장하면 화면에 안내가 뜨고 저장 버튼이 잠겨요. 지금 화면의 변경 내용은 사라지니, 안내에 따라 새로고침한 뒤 다시 설정해주세요.
주의할 점
OBS를 두 개 띄우거나 오버레이를 두 번 넣지 마세요
같은 채널의 OBS 를 두 개 동시에 켜두거나, 뚜봇 오버레이(연동 전용 오버레이 포함)를 여러 개 브라우저 소스로 넣으면 명령이 두 번 실행될 수 있어요. 이 기능을 쓰는 OBS 는 하나만 켜두세요.
다음 단계
디스코드에서 편하게 문의해주세요!