MARS 노드 레퍼런스
블루프린트의 Moraecat 카테고리에 있는 MARS 노드 네 가지입니다. 화면의 칸 이름은 MARS 언어 설정을 따릅니다(아래는 한국어).
| 노드 | 어디에 두나요 | 하는 일 |
|---|---|---|
| MARS 링크 | 리액션 블루프린트의 시작 | MARS가 리액션을 실행할 때 흐름이 시작되는 곳, 이벤트 데이터 꺼내기 |
| MARS 완료 | 리액션 블루프린트의 끝 | 리액션이 끝났다고 알려 다음 요청이 실행되게 함 |
| MARS 이벤트 입력 | 플랫폼 연결용 블루프린트 | 방송 이벤트를 허브로 보내 규칙 조건 검사 |
| MARS 수동 실행 | 아무 블루프린트 | 규칙 없이 특정 리액션을 바로 실행 |
전체 흐름
치지직 후원 수신플랫폼 플러그인
MARS 이벤트 입력이벤트 유형: 후원
MARS 링크허브가 고른 리액션
리액션 동작프랍·모션·카메라
MARS 완료다음 요청 시작
이벤트 입력과 링크 사이에는 선을 잇지 않습니다. 허브가 실행 규칙으로 리액션을 골라 그 리액션의 링크를 호출합니다.
MARS 링크
리액션 블루프린트의 시작점입니다. MARS가 이 리액션을 실행하면 호출됨으로 흐름이 나갑니다.
MARS 링크
내부 리액션 ID
자동
리액션 이름
Throw
동일 리액션 중복 실행 허용
NoYes
다른 리액션과 동시 실행 허용
NoYes
▶호출됨
커스텀 매개변수
요청 ID
소스
이벤트 유형
닉네임
사용자 ID
금액
메시지
유형
JSON 데이터
▶ 초록 = 실행(흐름) 포트 · ● 흰색 = 데이터 포트. 왼쪽이 입력, 오른쪽이 출력입니다.
| 입력 | 설명 |
|---|---|
| 내부 리액션 ID | 자동으로 정해지는 ID. 바꾸지 않습니다. |
| 리액션 이름 | 허브와 .mars 파일에 보이는 이름 |
| 동일 리액션 중복 실행 허용 | Yes면 이 리액션이 실행 중이어도 같은 리액션 요청을 겹쳐 실행 → 실행 정책 |
| 다른 리액션과 동시 실행 허용 | Yes면 다른 리액션과 겹쳐 실행 (상대도 Yes여야 함) |
| 출력 | 설명 |
|---|---|
| 호출됨 ▶ | 리액션 실행 시작 |
| 커스텀 매개변수 | 규칙에 적은 정수. 같은 리액션을 규칙마다 다르게 → 커스텀 매개변수 |
| 요청 ID · 소스 · 이벤트 유형 | 이 실행을 부른 요청 정보 |
| 닉네임 · 사용자 ID · 금액 · 메시지 · 유형 | 이벤트 데이터. 유형은 후원 종류·구독 티어·채널 포인트 보상 이름 등 |
| JSON 데이터 | 플랫폼이 보낸 원본 데이터(있을 때) |
- 한 블루프린트에 링크는 하나만 둡니다.
- 흐름은 반드시 MARS 완료까지 닿아야 합니다.
MARS 완료
리액션이 끝났다고 MARS에 알립니다. 이 신호가 와야 기다리던 다음 요청이 실행됩니다.
MARS 완료
▶실행
완료 후 추가 대기 시간
0
최근 오류
▶성공
▶거절
▶ 초록 = 실행(흐름) 포트 · ● 흰색 = 데이터 포트. 왼쪽이 입력, 오른쪽이 출력입니다.
| 포트 | 설명 |
|---|---|
| 실행 ▶ | 연출과 정리가 모두 끝나는 지점에 연결 |
| 완료 후 추가 대기 시간 | 완료 뒤에도 이 시간(초)만큼 실행 중으로 잡아 둠. 리액션 사이 간격 |
| 성공 ▶ / 거절 ▶ | 완료 처리 결과. 거절이면 최근 오류에 이유가 남음 |
MARS 링크호출됨
소품 던지기Throw Prop
대기연출이 끝날 때까지
MARS 완료실행
시작하자마자 완료를 부르면 MARS는 리액션이 끝났다고 보고 다음 요청을 바로 시작합니다. 대기·종료 출력 뒤에 연결하세요.
MARS 이벤트 입력
플랫폼 수신 노드의 이벤트를 MARS 허브로 보냅니다. 허브가 규칙 조건을 검사해 맞는 리액션을 실행합니다.
MARS 이벤트 입력
▶실행
이벤트 유형
선택...▾
닉네임
사용자 ID
금액
0
메시지
유형
최근 오류
▶성공
▶거절
▶ 초록 = 실행(흐름) 포트 · ● 흰색 = 데이터 포트. 왼쪽이 입력, 오른쪽이 출력입니다.
| 포트 | 설명 |
|---|---|
| 실행 ▶ | 플랫폼 수신 노드의 흐름 출력(Exit)을 연결 |
| 이벤트 유형 | 채팅·후원·구독·채널 포인트·레이드 등. 바꾸면 아래 칸 이름이 유형에 맞게 바뀜 |
| 닉네임 · 사용자 ID · 금액 · 메시지 · 유형 | 수신 노드의 같은 뜻 출력을 연결. 없는 칸은 비워 둠 |
| 성공 ▶ | 요청을 받았다는 뜻 (리액션이 끝났다는 뜻이 아님) |
| 거절 ▶ | 받지 못함. 이유는 최근 오류와 허브의 최근 알림에 |
치지직 채팅 수신CHZZK 플러그인
MARS 이벤트 입력이벤트 유형: 채팅
이벤트마다 이벤트 입력을 하나씩 둡니다. 플랫폼별 연결표는 방송 플랫폼 연결에 있습니다.
MARS 수동 실행
규칙을 거치지 않고 고른 리액션을 바로 실행합니다. 다른 블루프린트에서 리액션을 부를 때 씁니다.
MARS 수동 실행
▶실행
리액션
선택...▾
소스
이벤트 유형
닉네임
사용자 ID
금액
0
메시지
유형
JSON 데이터
최근 오류
▶성공
▶거절
▶ 초록 = 실행(흐름) 포트 · ● 흰색 = 데이터 포트. 왼쪽이 입력, 오른쪽이 출력입니다.
| 포트 | 설명 |
|---|---|
| 리액션 | 실행할 리액션(규칙이 아니라 리액션을 고름) |
| 소스 · 이벤트 유형 · 닉네임 · … | 리액션의 MARS 링크 출력으로 그대로 전달할 값 |
| 성공 ▶ / 거절 ▶ | 요청을 받았는지 여부 |
- 커스텀 매개변수는 0으로 실행됩니다.
- 실행 정책과 대기열은 그대로 적용됩니다. → 수동 실행과 복구