Variant Record Builder

Name	Type	Description
スナップショット snapshot	VariantSnapshot	任意の基準snapshotです。JSON側に同じキーがあればJSONの値で上書きします。

Name

Type

Description

スナップショット

snapshot

VariantSnapshot

任意の基準snapshotです。JSON側に同じキーがあればJSONの値で上書きします。

Output Ports

Name	Type	Description
レコード record	VariantRecord	名前とsnapshotを持つバリアントレコードです。
レコード一覧 records	List<VariantRecord>	List CreateやBatch Renderへ渡せる、1件入りの一覧です。
スナップショット snapshot	VariantSnapshot	入力とJSONを統合した最終snapshotです。
名前 name	Text	表示や書き出しに使う名前です。

Parameters

Name	Type	Default	Range	Description / Options
内部ID record_id	Text	variant	—	レコードを識別する空でない安定した内部IDです。Unicodeも使えます。
表示名 name	Text	Variant	—	Batch RenderとBatch Exportへ渡す、人が読む名前です。日本語も使えます。
書き出し用スラッグ slug	Text	—	—	任意のportable ASCII書き出し名です（英数字と _ - のみ）。設定すると下流ではこの名前を使います。
注記 note	Text	—	—	レコードに保存する人向けの注記です。
お気に入り favorite	Bool	false	—	レコードをお気に入りとして記録します。
スナップショット値 snapshot_json	CustomData	{"version":1,"snapshot":{}}	—	内部キーと値のJSONオブジェクトです。例: {"moss_strength":1}

Overview

Turns human-meaningful variants such as moss, cracks, or color schemes into explicit VariantRecord values. Display names and internal IDs may use Unicode. Only the portable export slug is restricted to ASCII letters, digits, _, and -.

Usage tips

In snapshot_json, write a JSON object containing internal keys and values for variables or exposed parameters.
name is human-readable; slug is the filename-friendly name passed from Batch Render to Batch Export.
record_id may contain Unicode as long as it is not empty. Leave slug empty to keep using name downstream, or use only letters, digits, _, and -.
Combine several records outputs with List Create, then connect them to Batch Render.items.
Use the snapshot input to inherit existing values and overwrite only keys also present in snapshot_json.

Common pitfalls

Keys in snapshot_json must match internal evaluation keys, not display names. null cannot be a snapshot value; use a Bool, number, string, array, or object.

Related nodes

list_create: collect named records into a list
batch_render: generate one image per record
batch_export: named export using Batch Render.names
variant_select: select one record from the list

Input Ports