3. 플랫폼 API 노드와 잇기
이 단계에서 할 일: 방송 플랫폼의 채팅·후원 수신 노드를 MARS 이벤트 입력 노드에 연결해서, 실제 채팅 !Throw로 리액션이 실행되게 합니다.
준비물
- 2단계까지 끝낸 씬 (규칙
Throw활성) - 쓰는 플랫폼의 연동 플러그인과 로그인
- 치지직: 창작마당 CHZZK 플러그인
- SOOP: 창작마당 SOOP 플러그인
- 트위치: Warudo 기본 기능 (Settings → Twitch에서 연결)
따라 하기
- 블루프린트 탭에서 **+**로 새 블루프린트를 만들고 이름을
플랫폼 → MARS로 짓습니다. 리액션 블루프린트와 따로 두는 것이 관리하기 쉽습니다. - 플랫폼 수신 노드를 놓습니다. 예: 치지직이면 치지직 채팅 수신.
- Moraecat 카테고리에서 MARS 이벤트 입력 노드를 놓습니다.
- MARS 이벤트 입력의 이벤트 유형을 고릅니다. 채팅 노드에 연결하면 채팅, 후원 노드면 후원. 이벤트 유형을 바꾸면 아래 칸 이름이 그 유형에 맞게 바뀝니다. (예: 후원 → 금액 · 메시지 · 후원 종류, 구독 → 개월 수 · 메시지 · 티어)
- 아래 표대로 선을 잇습니다. 흐름 출력(→ 모양)은 실행에, 데이터는 같은 뜻의 칸에 연결합니다. 없는 칸은 비워 둬도 됩니다.
- 씬을 저장합니다.
치지직 채팅 수신CHZZK 플러그인
MARS 이벤트 입력이벤트 유형: 채팅
이벤트마다 MARS 이벤트 입력을 하나씩 둡니다. 채팅과 후원을 모두 쓰면 이벤트 입력 노드도 두 개입니다.
치지직 (CHZZK 플러그인)
| 수신 노드 | MARS 이벤트 유형 | 수신 노드 출력 → MARS 이벤트 입력 |
|---|---|---|
| 치지직 채팅 수신 | 채팅 | Exit → 실행 · Nickname → 닉네임 · SenderChannelId → 사용자 ID · Content → 메시지 |
| 치지직 후원 수신 | 후원 | Exit → 실행 · DonatorNickname → 닉네임 · DonatorChannelId → 사용자 ID · PayAmount → 금액 · DonationText → 메시지 · DonationType → 후원 종류 |
| 치지직 구독 수신 | 구독 | Exit → 실행 · SubscriberNickname → 닉네임 · SubscriberChannelId → 사용자 ID · Month → 개월 수 · TierName → 티어 |
SOOP (SOOP 플러그인)
| 수신 노드 | MARS 이벤트 유형 | 수신 노드 출력 → MARS 이벤트 입력 |
|---|---|---|
| SOOP 채팅 메시지 | 채팅 | Exit → 실행 · UserNickname → 닉네임 · UserId → 사용자 ID · Message → 메시지 |
| SOOP 별풍선 선물 | 후원 | Exit → 실행 · UserNickname → 닉네임 · UserId → 사용자 ID · Count → 금액 (별풍선 개수) |
| SOOP 연속 구독 | 구독 | Exit → 실행 · UserNickname → 닉네임 · UserId → 사용자 ID · SubscriptionMonths → 개월 수 |
| SOOP 구독 | 구독 | Exit → 실행 · UserNickname → 닉네임 · UserId → 사용자 ID |
별풍선은 개수로 들어옵니다
SOOP 별풍선의 Count는 원화가 아니라 별풍선 개수입니다. 규칙의 금액 조건도 개수로 적습니다. (예: 별풍선 10개 → 기준 금액 10)
트위치 (Warudo 기본)
| 수신 노드 | MARS 이벤트 유형 | 수신 노드 출력 → MARS 이벤트 입력 |
|---|---|---|
| 트위치 채널 메시지를 받았을 때 | 채팅 | Exit → 실행 · UserDisplayName → 닉네임 · Username → 사용자 ID · Message → 메시지 |
| Twitch 비트를 받았을 때 | 후원 | Exit → 실행 · UserDisplayName → 닉네임 · Username → 사용자 ID · BitsUsed → 금액 · Message → 메시지 |
| Twitch 구독을 받았을 때 | 구독 | Exit → 실행 · UserDisplayName → 닉네임 · Username → 사용자 ID · CumulativeMonths → 개월 수 · Message → 메시지 |
| Twitch 채널포인트를 받았을 때 | 채널 포인트 | Exit → 실행 · UserDisplayName → 닉네임 · Username → 사용자 ID · RewardCost → 포인트 · UserInput → 시청자 글 · RewardTitle → 보상 이름 |
| 트위치 채널 팔로우를 받았을 때 | 팔로우 | Exit → 실행 · UserDisplayName → 닉네임 · Username → 사용자 ID |
| Twitch 레이드를 받았을 때 | 레이드 | Exit → 실행 · RaiderDisplayName → 닉네임 · RaiderUsername → 사용자 ID · RaiderViewerCount → 시청자 수 |
트위치 노드 설명은 Warudo 노드 레퍼런스에도 있습니다.
포트 이름이 다르게 보이면
표의 영어 이름은 플러그인이 내부에서 쓰는 포트 이름입니다. Warudo 언어나 플러그인 버전에 따라 노드 위에는 한국어 이름으로 보일 수 있습니다. 위에서 아래 순서는 같습니다.
방송 없이 확인하기
실제 채팅 없이도 확인할 수 있습니다.
- 치지직: 치지직 수신 테스트 노드의 테스트 버튼으로 가짜 채팅·후원을 보낼 수 있습니다. 내용에
!Throw를 넣고 눌러 보세요. - 공통: 키를 눌렀을 때 노드를 MARS 이벤트 입력의 실행에 잇고, 이벤트 입력의 이벤트 유형을 채팅, 메시지를
!Throw로 직접 적은 뒤 그 키를 누릅니다.
MARS 이벤트 입력의 성공은 "요청을 받았다"는 뜻입니다(리액션이 끝났다는 뜻이 아닙니다). 거절로 나가면 노드의 최근 오류와 허브 MARS 실행 상태의 최근 알림을 확인하세요.
됐는지 확인
- 방송 채팅(또는 테스트)으로
!Throw를 보내면 고양이가 날아옵니다. !throw(소문자)나!Throw!는 실행되지 않습니다. 규칙이 정확히 일치로 되어 있기 때문입니다.- 허브 MARS 실행 상태에서 실행 중·대기 수가 바뀌었다가 0으로 돌아옵니다.
다음 단계: 4. 내 리액션을 MARS 호환으로 만들기