Tile Bundle Export

Input Ports

Name	Type	Description
タイルマップ canvas	TileCanvas	native / tiled profile 用のタイルマップです。
タイルパレット tile_palette	TilePalette	追加素材テーブルを持つパレット(任意)です。
フレーム一覧 frames	List<Image>	images_v1 profile 用のフレーム画像一覧です。

Name	Type	Description
概要 summary	Text	保存結果の短いまとめです。
レポート report	Text	capability レポートと警告です。

Name

Type

Description

概要

summary

Text

保存結果の短いまとめです。

レポート

report

Text

capability レポートと警告です。

Parameters

Name Type Default Range Description / Options

Name	Type	Default	Range	Description / Options
保存先 path	FilePath	—	—	保存先の . ファイルです。
保存モード save_mode	Enum	Disabled	—	保存実行と既存ファイルの上書きを制御します。無効`Disabled` 新規のみ`CreateIfMissing` 上書き`Overwrite`
プロファイル profile	Enum	pixpipeline_native_v1	—	出力フォルダへ書くバンドル形式です。画像列`images_v1` 汎用ランタイム`pixpipeline_native_v1` Tiled`tiled_v1`

保存先

path

FilePath

—

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

保存モード

save_mode

Enum

Disabled

—

保存実行と既存ファイルの上書きを制御します。

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

プロファイル

profile

Enum

pixpipeline_native_v1

—

出力フォルダへ書くバンドル形式です。

画像列images_v1
汎用ランタイムpixpipeline_native_v1
Tiledtiled_v1

Overview

Exports a tile map as a game-ready folder. Profiles: an image sequence (PNGs), a generic runtime bundle (atlas + tileset + map JSON), or Tiled (.tmj/.tsj + atlas). Writing is a staged → verified → atomically swapped transaction that never leaves a half-written folder.

Usage tips

pixpipeline_native_v1 / tiled_v1 take canvas (the output of tile_studio); images_v1 takes frames from tile_canvas_animation_render.
The authoritative spec for the native runtime format is docs/contracts/tile-runtime-v1/README.md (coordinates, animation phase, half-open rects, …). Custom engines can read bundles against that contract.
Tiled assumes uniform cell-size tiles. Tiles larger than a cell (overhang) make the export fail with an error — nothing is silently transformed.
The report output aggregates capability losses and warnings; review it whenever it is non-empty.

Common pitfalls

Tiled: "raster does not match the cell size" — a tile's image differs from the cell size. Re-bake the asset or use the native profile.
images_v1 errors out — the frames input (List) is not connected.

Related nodes

tile_canvas_render / tile_canvas_animation_render — producing the inputs
tiled_map_export / tiled_tileset_export — existing single-JSON exports (kept for compat)