Back to Node List

Tile Palette Save

tile_palette_save

Saves TilePalette refs/layout and project fallback snapshots.

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
タイルパレット
tile_palette
TilePalette
Required
タイルパレットの参照・配置です。解決済み素材はexact snapshotへ固定し、未解決参照はplaceholderのまま保持します。

Output Ports

NameTypeDescription
概要
summary
Text
保存結果の短いまとめです。

Parameters

NameTypeDefaultRangeDescription / Options
保存先
path
FilePath

保存先の .pxntilepalette ファイルです。

保存モード
save_mode
Enum
Disabled

新規のみは既存の通常ファイルを内容を読まずに保護します。上書きは解析可能な対応形式だけを置換します。

  • 無効Disabled
  • 新規のみCreateIfMissing
  • 上書きOverwrite

Overview

Saves a TilePalette's references and layout, pinning the referenced assets into the project's content-addressed snapshots.

Usage tips

  • Connect the palette to tile_palette, and choose Overwrite or CreateIfMissing when saving with the project.
  • Snapshots are stored without duplicates under assets/tiles/snapshots/<contentHash>.pxntile, and index.json is updated.
  • Unresolved requirements are retained as refs-only entries with a warning. Only resolved assets are embedded in snapshots, so references are not lost while the exact asset is unavailable.

Common pitfalls

  • When an exact asset is unresolved, inspect the warning. The palette can still be saved, but that asset has no bundled snapshot and must be restored before use in another environment.
  • Handing someone only the .pxntilepalette file does not include the asset bodies — distribute the project assets along with it.

Related nodes

  • tile_palette_load
  • tile_asset_save
  • tile_canvas_save
Back to Node List
Tile Palette Save — PixPipeline Node Reference