ノード一覧に戻る

TiledマップJSON断片

tiled_map_export

従来互換の単体TiledマップJSON断片を作ります。完全なマップ・タイルセット・アトラス一式にはTile Bundle Exportを使ってください。

確認済み
解説あり

入力ポート

名前説明
解決済みルール配置
resolved
RuleResolved
必須
Tiled用JSONに変換する、実際に置くタイル画像が決まった状態です。

出力ポート

名前説明
JSON
json
Text
Tiledで読むためのマップJSON文字列です。
警告
warnings
Text
Tiled形式に変換しきれない情報など、気をつける点です。

パラメータ

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

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

タイルセット参照
tileset_source
Text
tiles.tsj

Tiled側でこのマップが参照するタイルセットJSONのファイル名です。

保存モード
save_mode
Enum
Disabled

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

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

概要

解決済みのタイル配置(RuleResolved)をTiled のマップJSON(.tmj)に書き出す ノードです。PixPipeline で作ったマップを、Tiled やそれを読めるゲームエンジンへ 持ち出す出口になります。 これは従来互換のJSON fragment出力で、画像やtilesetを一括保存しません。完全な 成果物一式には tile_bundle_exportTiledV1 profileを推奨します。

使い方のポイント

  • 3点セットで書き出す: tiled_map_export(.tmj) + tiled_tileset_export(.tsj) + タイル画像PNG。マップJSONは タイルセットJSONをファイル名で参照するので、tileset_source と 実ファイル名を一致させること
  • 入力は rule_canvas / rule_renderresolved 出力
  • 回転タイルは未変換で warnings に出る(現状の制限)

関連ノード

  • tiled_tileset_export — タイルセット側の相方(ほぼ必須)
  • rule_canvas / rule_render — resolved の供給元
  • batch_export — タイル画像PNGの書き出し

何をするノードか

このノードは、RuleRenderTileMapCanvas から出た完成配置を、Tiledで読み込めるマップJSONへ変換します。

完成配置とは、マップの各マスに「実際にどのタイル画像を置くか」が決まった状態です。地形名やルールのままではなく、Tiledへ渡せるタイル番号の並びに近い形へ変えます。

保存先を指定すれば .tmj.json としてファイル保存もできます。

主な設定

ID 名前 説明
path 保存先 JSONをファイル保存する場合の保存先です。空なら文字列出力だけ行います。
tileset_source タイルセット参照 Tiled側でこのマップが参照するタイルセットJSONのファイル名です。
save_mode 保存モード JSONファイルを保存するか、既存ファイルを上書きするかです。

どういう時に使うか

  • PixPipelineで作ったタイルマップをTiledへ持っていきたい時
  • .tmj または .json のマップファイルを作りたい時
  • Tiled側で編集・確認できる形に変換したい時

注意

左右反転・上下反転はTiled用の値に変換します。P14時点では回転情報を完全には変換しないため、回転が含まれる場合は warnings に出します。

参照: Tiled JSON Map Format

ノード一覧に戻る
TiledマップJSON断片 — PixPipeline ノード解説