Back to Node List

Tiled Tileset JSON Fragment

tiled_tileset_export

Builds a legacy standalone Tiled tileset JSON fragment. Use Tile Bundle Export for a complete map, tileset, and atlas bundle.

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_set
RuleTileSet
Required
Tiled用JSONに変換するルールタイルセットです。
ルールタイルアトラス
atlas
RuleTileAtlas
タイルを1枚に並べた情報です。接続すると画像サイズや列数に使います。

Output Ports

NameTypeDescription
JSON
json
Text
Tiledで読むためのタイルセットJSON文字列です。

Parameters

NameTypeDefaultRangeDescription / Options
保存先
path
FilePath

JSONをファイル保存する場合の保存先です。空なら文字列出力だけ行います。

画像パス
image_path
Text
tiles.png

Tiled側で参照するタイル画像ファイル名です。このノード自体はPNGを保存しません。

保存モード
save_mode
Enum
Disabled

JSONファイルを保存するか、既存ファイルを上書きするかです。

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

Overview

Exports a tile set as Tiled tile-set JSON (.tsj). Use it together with tiled_map_export to complete a map package that opens in Tiled. This is the legacy JSON-fragment route. Prefer the TiledV1 profile of tile_bundle_export when you want images, map data, and tilesets validated and written as one complete bundle.

Usage tips

  • This node writes only JSON. Save the atlas from rule_tile_pack separately as a tile-image PNG with batch_export or a similar node, then put that filename in image_path. All three pieces must agree.
  • tileset_source in tiled_map_export must point to the filename of this JSON.
  • The atlas must match the tile set's grid, count, entry IDs, and fill order. Because Tiled GIDs assume row-major placement, this legacy route explicitly rejects column-major atlases.

Related nodes

  • tiled_map_export — the map counterpart
  • rule_tile_pack / autotile_from_parts — supply the tile set and atlas
  • batch_export — exports the atlas-image PNG

What this node does

Converts a tile set built in PixPipeline into a form that is easy to pass to the Tiled map editor.

The output is a JSON string for a tile set. When a destination is specified, the node can also save it as .tsj or .json.

This node does not save the tile-image PNG. It only records in JSON which image file Tiled should reference. Prepare the tile image through a separate image-export path.

Key settings

ID Name Description
path Save destination Destination when saving JSON to a file. An empty value outputs only the string.
image_path Image path Filename of the tile image referenced by Tiled.
save_mode Save mode Whether to save the JSON file and overwrite an existing file.

When to use it

  • To take a tile set built in PixPipeline into Tiled
  • To create a .tsj or .json tile-set file
  • To prepare the tile-set JSON referenced by map JSON from TiledMapExport

Reference: Tiled JSON Map Format

Back to Node List
Tiled Tileset JSON Fragment — PixPipeline Node Reference