タイルキャンバス保存

概要

TileCanvas documentと使用中素材の固定snapshotを整合保存します。project folderだけでoffline再現できる状態を作る保存口です。

使い方のポイント

• Tile Canvas作成・編集ノードから canvas へ接続し、明示保存時だけ save_mode を有効にします。
• CreateIfMissing は既存内容を解析せず already-exists を返し、snapshot/indexも更新しません。
• Overwrite は解析可能な対応 .pxntilemap だけを置換し、破損・別形式・将来versionは拒否します。
• 保存後の .pxntilemap はproject-relative fallback keyを持ち、snapshot indexと同じexact hashを参照します。
• snapshotとindexの公開は本体ファイルより先に行われる場合があります。本体保存が失敗した時に 未参照snapshotが残ることは安全な既知仕様で、後続保存や整理処理で再利用できます。

よくある失敗

• .pxntilemap 単体はrefs-onlyです。自己完結配布の代わりにはならないため、project assetsを一緒に保管してください。
• exact hashのruntime素材が欠けるとsnapshotを固定できず保存に失敗します。欠損を解決してから再実行してください。

関連ノード

• tile_canvas_load
• tile_palette_save
• tile_asset_save