ノード一覧に戻る

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_export の TiledV1 profileを推奨します。

使い方のポイント

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

関連ノード

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

何をするノードか

このノードは、RuleRender や TileMapCanvas から出た完成配置を、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 ノード解説