Back to Node List

Tile Asset Builder

tile_asset_builder

Builds one TileAsset (static / animated / auto / rule / stamp brushes) from images, sprite sheets, and rule tile assets.

Reviewed
Guide available
The node name and summary are available in English. Port, parameter, and article details are currently shown in Japanese.

Input Ports

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

Output Ports

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

Parameters

NameTypeDefaultRangeDescription / Options
ビルダーデータ
builder_data
CustomData

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

Overview

The entry point for building tile assets. Bulk-slice a sheet image into static tiles, swap some slots to animations, define multi-cell stamps such as a 2×2 house, and merge existing auto/rule tile assets — all into one TileAsset. Slicing, selection, and naming are edited in the dedicated editor (Tile Asset Builder); the node itself only evaluates the recipe (builder_data).

Usage tips

  • For bulk registration connect either image (you specify margin/spacing yourself) or sprite_sheet (columns and cell size carry over). No per-cell wiring is needed.
  • For animations, setting a "target brush ID" swaps a static tile to an animation while keeping its public brush ID (and thus its palette slot). Frames come from the images input (all frames the same size) or from cells on the same sheet.
  • Save the finished asset with tile_asset_save as a self-contained .pxntile — it loads even after the original input nodes are deleted.
  • While warnings reports "live source" issues, resolve them before saving anything meant for distribution.

Common pitfalls

  • Animation frames with mixed sizes — pad/crop them to one size explicitly before feeding images; no implicit correction is applied.
  • Transparent cells get registered — set the slice recipe's transparent-cell policy to exclude_fully_transparent to skip fully transparent cells (row/column positions are preserved).
  • A connected auto-tile isn't imported — the recipe's "include rule asset" toggle (a checkbox in the editor) must be enabled.

Related nodes

  • tile_asset_save / tile_asset_load — saving to and loading from .pxntile
  • autotile_from_template / autotile_from_parts — producing auto-tile assets to import here
  • rule_set_editor — low-level editing of rule brushes
Back to Node List
Tile Asset Builder — PixPipeline Node Reference