ノード一覧に戻る

タイル素材ビルダー

tile_asset_builder

画像・スプライトシート・ルールタイル素材から、静的/アニメ/オート/ルール/スタンプのブラシを持つタイル素材を1つ組み立てます。1セルずつピンを繋ぐ必要はありません。

確認済み
解説あり

入力ポート

名前説明
画像
image
Image
余白・間隔レシピで分割するシート画像です。
スプライトシート
sprite_sheet
SpriteSheet
既存シートです。列数・セルサイズが分割レシピの初期値になります。
画像一覧
images
List<Image>
アニメーションのフレームに使う画像一覧です。
ルールタイル素材
rule_tile_asset
RuleTileAsset
既存のオート/ルールタイル素材です。ルールブラシとして取り込みます。
元タイル素材
base_asset
TileAsset
既存タイル素材です。この内容を土台にして編集・追加します。

出力ポート

名前説明
タイル素材
tile_asset
TileAsset
組み立てたタイル素材です。
アトラスプレビュー
atlas_preview
Image
静的タイルを並べた軽量確認画像です。
警告
warnings
Text
未保存ライブ入力や割り当ての診断です。

パラメータ

名前既定値範囲説明・選択肢
ビルダーデータ
builder_data
CustomData

タイル素材ビルダー(エディタ)が編集する作成レシピです。通常は直接編集しません。

概要

タイル素材づくりの入口ノードです。シート画像を一括分割して静的タイルにし、一部スロットをアニメーションへ差し替え、2×2の家のような複数セルスタンプを定義し、既存のオート/ルールタイル素材も同じ1つの素材(TileAsset)へまとめられます。分割・選択・命名は専用エディタ(タイル素材ビルダー)から編集し、ノード自体はレシピ(builder_data)を評価するだけです。

使い方のポイント

  • シートの一括登録は image(余白・間隔を自分で指定)か sprite_sheet(列数・セルサイズを引き継ぐ)のどちらかへ接続します。1セルずつピンを繋ぐ必要はありません。
  • アニメーションは「対象ブラシID」を指定すると、パレット上の位置(公開ブラシID)を保ったまま静止タイルをアニメへ差し替えられます。フレームは images 入力(全フレーム同寸法)か、同じシート上のセル列から選べます。
  • 出来上がった素材は tile_asset_save.pxntile に保存すると自己完結し、元の入力ノードを消しても読み込めます。
  • warnings に「live source」系の警告が出ている間は、配布用の保存前に必ず解消してください。

よくある失敗

  • アニメのフレーム寸法がバラバラ — 明示的にパディング/クロップして同寸法にしてから images へ入れてください。暗黙の補正は行いません。
  • 透明セルまで登録される — 分割レシピの透明セルポリシーを exclude_fully_transparent にすると、完全透明セルを除外できます(元の行・列位置は保持されます)。
  • オートタイルを繋いだのに取り込まれない — レシピ側の「ルール素材を含める」を有効にする必要があります(エディタのチェックボックス)。

関連ノード

  • tile_asset_save / tile_asset_load.pxntile への保存と読み込み
  • autotile_from_template / autotile_from_parts — ここへ取り込むオートタイル素材の生成
  • rule_set_editor — ルールブラシの低レベル編集
ノード一覧に戻る
タイル素材ビルダー — PixPipeline ノード解説