본문으로 건너뛰기

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으로 실행됩니다.
  • 실행 정책과 대기열은 그대로 적용됩니다. → 수동 실행과 복구