Warudo 플러그인 설치 및 연동
잼쿠봇 플러그인을 깔고 채팅·후원·명령어·룰렛을 Warudo 이벤트로 받아요.
목차
잼쿠봇 플러그인 2.0을 깔면 Warudo 블루프린트에서 치지직 채팅·후원·구독과 잼쿠봇 명령어·룰렛을 이벤트로 받아요. 이벤트마다 물건 던지기 같은 연출을 이어 붙이면 돼요.
치지직 채팅·후원·구독 노드는 로그인만 하면 와요. JamKu 명령어 받기와 JamKu 룰렛 받기는 잼쿠봇이 채널에 입장해 있어야 와요. 따라 할 연출은 애니메이션 세팅 예제에 있어요.
플러그인 설치하기
- Steam 창작마당의 잼쿠봇 플러그인 2.0을 열고 구독을 눌러요.
- Steam에서 다운로드가 끝나면 Warudo를 켜요.
채널 연결하기
-
왼쪽 Assets(상자 아이콘)에서 Add Asset 창을 열고 JamkuApi → JamKu 연결을 골라요.
-
추가한 JamKu 연결에서 로그인 페이지 열기를 눌러요.
- 브라우저에서 방송하는 치지직 계정으로 로그인하면 64자리 코드가 나와요. 사람마다 다른 코드예요.
-
코드를 Auth String 칸에 붙여 넣고 Connect를 눌러요. 상태 칸의
연결 안됨이 바뀌는지 봐요. 끊을 땐 Disconnect를 눌러요.
앞 32자는 채널 UID, 뒤 32자는 채널 공통 토큰이에요. 방송 화면이나 채팅, 캡처에 코드가 비치지 않게 하세요.
이벤트 노드 쓰기
플러그인이 노드 다섯 개를 줘요. 노드마다 Connection에서 앞에서 만든 JamKu 연결을 골라야 이벤트가 들어와요.
초록색 Exit는 이벤트가 들어올 때 실행할 흐름에 이어요. 흰 점은 닉네임·금액 같은 값이라 다른 노드의 입력에 이어요. 값이 궁금하면 Inspect Value 노드에 이어서 보면 돼요.
치지직 채팅·후원·구독
| 노드 | 출력 | 뜻 |
|---|---|---|
| 치지직 채팅 받기 | User Uid, User Name | 채팅 친 사람의 UID·닉네임 |
| 치지직 채팅 받기 | User Role Code | 역할. streamer(스트리머), streaming_channel_manager·streaming_chat_manager(매니저), common_user(일반 시청자) |
| 치지직 채팅 받기 | Content | 채팅 내용 |
| 치지직 채팅 받기 | Emojis Json | 채팅에 들어간 이모티콘 정보 |
| 치지직 후원 받기 | User Uid, User Name | 후원한 사람 |
| 치지직 후원 받기 | Pay Amount | 후원 금액 (치즈) |
| 치지직 후원 받기 | Donation Type | CHAT(채팅 후원) 또는 VIDEO(영상 후원) |
| 치지직 후원 받기 | Donation Text | 후원 메시지 |
| 치지직 구독 받기 | User Uid, User Name | 구독한 사람 |
| 치지직 구독 받기 | Tier No | 구독 티어 번호 |
| 치지직 구독 받기 | Tier Name | 스트리머가 정한 구독 이름 |
| 치지직 구독 받기 | Month | 몇 개월째 구독인지 |
명령어로 움직이기
JamKu 명령어 받기는 시청자가 잼쿠봇 명령어를 쓸 때마다 실행돼요. 커스텀 명령어와 기본 명령어 !sr, !문방구가 들어와요.
| 출력 | 뜻 |
|---|---|
| User Uid, User Nickname | 명령어를 친 시청자 |
| Used Command | 등록된 명령어 이름. !룰렛 3처럼 숫자를 붙여 쳐도 !룰렛으로 오고, %%로 만든 명령어는 %%가 붙은 이름 그대로 와요 |
| Response | 봇이 채팅에 보낸 대답 |
| Success | 명령어가 성공했으면 참 |
| Amount | 명령어에 걸린 포인트. 연차 룰렛은 횟수를 곱한 값이고, 음수면 포인트를 주는 명령어예요 |
- 채팅 › 명령어에서
!던지기같은 명령어를 만들어요. - JamKu 명령어 받기의 Exit를 If Branch의 Enter에, Success를 Condition에 이어요.
- If True를 Switch On String에 잇고, Used Command를 Input String에 이어요. Cases에
!던지기를 넣어요. !던지기출구에 던지기 같은 연출 노드를 이어요.
포인트 부족, 쿨타임, 개인 하루 사용 횟수 초과로 실패해도 이벤트가 오고 Success만 거짓이에요. Success를 거치지 않고 연출을 이으면 포인트가 모자란 시청자도 던질 수 있어요.
실패로 올 때는 Response에 봇의 실패 대답이 들어 있고, Amount에는 걸린 포인트가 그대로 와요. 이때 포인트는 빠지지 않았어요. 포인트 부족 대답은 명령어의 포인트 부족 / 중복 출석 응답에 적어 둔 문구가 있으면 그걸로 와요.
| 실패 이유 | Response 예시 |
|---|---|
| 포인트 부족 | 시청자닉네임님, 포인트가 부족해요. (필요 100P / 보유 30P) |
| 쿨타임 | 쿨타임중: 30초 남음 |
| 유저별 쿨타임 | 유저별 쿨타임중: 30초 남음 |
| 개인 하루 사용 횟수 초과 | 시청자닉네임님, 오늘 이 명령어 사용 횟수를 모두 소진했어요. |
명령어를 꺼 뒀을 때, 이미 출석한 시청자가 출석 명령어를 쳤을 때, 명령어 전체 하루 사용 횟수를 다 썼을 때, 방송이 켜져있을 때만 사용 가능을 켠 명령어를 방송이 꺼져 있을 때 쳤을 때는 이벤트가 아예 안 와요.
룰렛 결과로 움직이기
JamKu 룰렛 받기는 잼쿠봇 룰렛이 돌 때마다 실행돼요. 명령어 룰렛과 후원 룰렛 둘 다 와요. 연차는 한 번에 묶여서 와요.
| 출력 | 뜻 |
|---|---|
| User Name | 룰렛을 돌린 시청자 닉네임 |
| Roulette Name | 룰렛 이름 |
| Data | 룰렛 항목 이름 전체 목록 |
| Result Data | 당첨된 항목의 순번 목록. 0부터 세요 |
항목이 [사과, 바나나, 포도]이고 Result Data가 [1]이면 바나나예요. 3연차면 [2, 0, 2]처럼 여러 개가 와요. 룰렛이 여러 개면 Roulette Name을 먼저 비교해서 원하는 룰렛만 골라요.
테스트하기
- 채팅에 아무 말이나 쳐서 치지직 채팅 받기가 실행되는지 봐요.
- 후원은 치지직 스튜디오 → 방송 관리 → 알림의 테스트 후원으로 시험해요. 리모컨에서 지난 후원을 다시 재생하는 걸로는 이벤트가 안 와요.
- 명령어는 비용 0으로 만들어 내 채팅으로 쳐 봐요.
- 룰렛은 위젯 · 미니게임 › 룰렛의 룰렛 테스트 → 돌리기로 돌려 봐요. 테스트도 JamKu 룰렛 받기로 들어와요. 테스트유저로 돌리기를 고르면 User Name은
테스트유저예요.
안 될 때
| 이럴 때 | 확인할 것 |
|---|---|
| Add Asset에 JamkuApi가 없어요 | 창작마당 구독과 Steam 다운로드가 끝났는지 보고 Warudo를 다시 켜요 |
| Connect를 눌러도 연결이 안 돼요 | 코드를 앞뒤 공백 없이 64자 그대로 넣었는지 봐요. 로그인 페이지 열기로 다시 받아 넣어요 |
| 연결은 됐는데 노드가 조용해요 | 노드마다 Connection에 JamKu 연결을 골랐는지 봐요 |
| 채팅은 오는데 명령어·룰렛이 안 와요 | 잼쿠봇이 채널에 입장해 있는지, 명령어·룰렛이 켜져 있는지 봐요 |
| 명령어 이벤트는 오는데 연출이 안 나와요 | Success가 참인지, Cases의 글자가 등록한 명령어 이름과 똑같은지 봐요 |
| 이벤트는 오는데 모델이 안 움직여요 | Exit 연결선, 연출 노드의 캐릭터·물건 지정을 봐요 |
로그인 페이지가 안 열리거나 코드를 못 받으면 디스코드에 플러그인 버전과 보이는 오류를 알려 주세요.
이 가이드로 해결이 안 됐나요?
디스코드로 문의하기

