ノード一覧に戻る

タイルパレット保存

tile_palette_save

タイルパレットの参照・配置とプロジェクトfallback snapshotを保存します。

確認済み
解説あり

入力ポート

名前説明
タイルパレット
tile_palette
TilePalette
必須
タイルパレットの参照・配置です。解決済み素材はexact snapshotへ固定し、未解決参照はplaceholderのまま保持します。

出力ポート

名前説明
概要
summary
Text
保存結果の短いまとめです。

パラメータ

名前既定値範囲説明・選択肢
保存先
path
FilePath

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

保存モード
save_mode
Enum
Disabled

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

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

概要

TilePaletteの参照とレイアウトを保存し、参照素材をprojectのcontent-addressed snapshotへ固定します。

使い方のポイント

  • TilePaletteを tile_palette へ接続し、project保存時に Overwrite または CreateIfMissing を選びます。
  • CreateIfMissing は既存内容を解析せず already-exists を返し、snapshot/indexも更新しません。
  • Overwrite は解析可能な対応 .pxntilepalette だけを置換し、破損・別形式・将来versionは拒否します。
  • snapshotは assets/tiles/snapshots/<contentHash>.pxntile へ重複なしで保存され、index.json が更新されます。
  • 未解決requirementもrefs-onlyのままwarning付きで保持できます。解決できた素材だけを snapshotへ固定するため、後でexact assetを復元しても参照情報を失いません。

よくある失敗

  • 未解決素材がある場合はwarningを確認してください。palette自体は保存できますが、その素材の snapshotは含まれないため、別環境で使う前にexact assetを復元する必要があります。
  • 外部へ .pxntilepalette だけを渡しても素材本体は含まれません。project assetsも一緒に配布してください。

関連ノード

  • tile_palette_load
  • tile_asset_save
  • tile_canvas_save
ノード一覧に戻る
タイルパレット保存 — PixPipeline ノード解説