メインコンテンツまでスキップ

MARS ノードリファレンス

ブループリントの Moraecat カテゴリにある MARS ノード 4 種類です。画面上のフィールド名は 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 データプラットフォームから送られた元データ(ある場合)
  • 1 つのブループリントにリンクは1 つだけ置きます。
  • フローは必ず MARS 完了 まで到達させます。

MARS 完了​

リアクションが終わったことを MARS に通知します。このシグナルが来て初めて、待機中の次のリクエストが実行されます。

MARS 完了
▶実行
完了後の追加待機時間
0
最近のエラー
▶成功
▶拒否

▶ 緑 = 実行(フロー)ポート · ● 白 = データポート。左が入力、右が出力です。

ポート説明
実行 ▶演出と後処理がすべて終わった地点に接続
完了後の追加待機時間完了後もこの時間(秒)だけ実行中として保持。リアクション間の間隔調整
成功 ▶ / 拒否 ▶完了処理の結果。拒否の場合は最近のエラーに理由が残る
MARS リンク呼び出された
プロップ投げThrow Prop
待機演出が終わるまで
MARS 完了実行

開始直後に完了を呼び出すと、MARS はリアクションが終わったと見なし次のリクエストをすぐに開始します。待機・終了出力の後に接続してください。

MARS イベント入力​

プラットフォーム受信ノードのイベントを MARS ハブへ送ります。ハブがルール条件を確認し、一致するリアクションを実行します。

MARS イベント入力
▶実行
イベント種別
選択...▾
ニックネーム
ユーザー ID
金額
0
メッセージ
種別
最近のエラー
▶成功
▶拒否

▶ 緑 = 実行(フロー)ポート · ● 白 = データポート。左が入力、右が出力です。

ポート説明
実行 ▶プラットフォーム受信ノードのフロー出力(Exit)を接続
イベント種別チャット・投げ銭・サブスクリプション・チャンネルポイント・レイドなど。変更するとフィールド名が種別に合わせて切り替わる
ニックネーム · ユーザー ID · 金額 · メッセージ · 種別受信ノードの対応する出力を接続。ないフィールドは空欄のまま
成功 ▶リクエストを受け付けたという意味(リアクションが終わったという意味ではない)
拒否 ▶受け付けられなかった。理由は最近のエラーとハブの最近の通知に
チジクチャット受信CHZZK プラグイン
MARS イベント入力イベント種別: チャット

イベントごとにイベント入力を1 つずつ置きます。プラットフォームごとの接続表は配信プラットフォームの接続にあります。

MARS 手動実行​

ルールを経由せず、選んだリアクションを直接実行します。他のブループリントからリアクションを呼び出したいときに使います。

MARS 手動実行
▶実行
リアクション
選択...▾
ソース
イベント種別
ニックネーム
ユーザー ID
金額
0
メッセージ
種別
JSON データ
最近のエラー
▶成功
▶拒否

▶ 緑 = 実行(フロー)ポート · ● 白 = データポート。左が入力、右が出力です。

ポート説明
リアクション実行するリアクション(ルールではなくリアクションを選ぶ)
ソース · イベント種別 · ニックネーム · …リアクションの MARS リンク出力にそのまま渡す値
成功 ▶ / 拒否 ▶リクエストを受け付けたかどうか
  • カスタムパラメーターは 0 で実行されます。
  • 実行ポリシーとキューはそのまま適用されます。 → 手動実行と復旧