Tiled マップ互換性

Resprite は Tiled 関連のタイルマップ形式とタイルセット形式のインポート／エクスポートに対応しています。既存の Tiled マップを Resprite に読み込んで続きを描くことも、Resprite で作成したタイルマップを Tiled やゲーム開発ツールチェーンへ渡すこともできます。

Tiled マップとタイルセットの相互運用は、DA 1.32.0、iOS R59 以降で利用できます。

注記

Resprite は Tiled の元プロジェクトファイルを直接編集するエディターではありません。Tiled プロジェクトを読み込むと、Resprite は編集可能な .resprite ドキュメントを作成します。再度書き出すと、新しい Tiled ファイルが生成されます。

対応ファイル形式

種類	用途	説明
.tmx	Tiled マップ	デスクトップ版では直接開けます。インポート後は .resprite ドキュメントとして生成・編集されます。
Tiled マップ .zip	Tiled プロジェクトパッケージ	モバイルでは .tmx、.tsx、画像リソースをまとめて扱える .zip パッケージでの読み込みが向いています。
.tsx	Tiled タイルセット	単体の Tiled タイルセットをインポート／エクスポートするための形式です。
.restile	Resprite タイルセットパッケージ	Resprite 内でタイルセットを再利用したり、他の Resprite ユーザーへ共有したりするための形式です。

デスクトップ版で .tmx を直接開く場合、Resprite は同じフォルダーまたは相対パスにある .tsx と画像リソースを読み取ります。モバイルでは .tmx、.tsx、画像リソースを元のフォルダー関係のまま一緒に読み取れないことがあるため、Tiled マップ .zip パッケージでまとめて読み込むのが適しています。

Tiled マップをインポートする

.tmx または Tiled マップ .zip パッケージを読み込むと、Resprite は編集を続けられるマップ内容をできるだけ保持します。対象には次のような内容が含まれます。

• タイルマップレイヤー
• タイルセットと対応する画像
• 矩形、等角、六角形マップ
• 反転や回転などの一般的なタイル変形
• 互換性のある Terrain 情報
• タイルの出現確率
• タイルアニメーション

インポート後、Resprite は編集可能なドキュメントを作成します。その後の編集は Resprite ドキュメント内で行われ、元の .tmx、.tsx、PNG ファイルはその場で書き換えられません。

Tiled マップのインポート

.tsx タイルセットをインポートする

.tsx は Tiled のタイルセットファイルです。.tsx をインポートすると、Resprite はそれを現在のドキュメントに追加し、タイルマップレイヤーで使えるタイルセットとして扱います。

次のような場合に向いています。

• マップ全体ではなく、Tiled タイルセットだけを再利用したい
• Resprite ですでにドキュメントとタイルマップレイヤーを作成している
• Tiled エコシステムのタイル素材を使って描き続けたい

.tsx が参照する画像ファイルが見つからない場合やパスが正しくない場合、インポートに失敗したり、説明が表示されたりします。可能な限り、.tsx と画像リソースの相対パスを保ってください。

画像コレクション型タイルセット

Tiled は、各タイルが個別画像から構成される画像コレクション型タイルセットにも対応しています。Resprite はこの種類のタイルセットを読み込む際、個別画像を Resprite で使えるタイルセットに整理しようとします。

注意点：

• タイルセットとして整理できる画像はそのまま読み込まれます。
• 画像数やサイズが制限を超える場合、Resprite が分割して処理することがあります。
• 変換できない内容がある場合、インポート時の説明に理由が表示されます。

Tiled マップを書き出す

タイルマップレイヤーを含むドキュメントでは、Export ▸ Tiled Map から Tiled 互換マップを書き出せます。書き出し結果は通常 .zip パッケージになり、次の内容を含みます。

• 1 つ以上の .tmx マップファイル
• 対応する .tsx タイルセットファイル
• タイルセット用の PNG 画像リソース

現在のドキュメントにタイルマップレイヤーがない場合、Tiled マップ書き出しは失敗し、書き出せるタイルマップレイヤーがないことを通知します。

Tiled Map 書き出しオプション

マップ範囲

書き出し時にはマップ範囲を選べます。通常のマップは現在のキャンバス範囲で書き出せます。タイル内容がキャンバス外にある場合や、大きく疎なマップを保持したい場合は、より広い書き出し範囲を選んでください。

等角マップの書き出し

ドキュメントに等角タイルマップレイヤーが含まれる場合、書き出しダイアログに等角書き出しモードが表示されます。これは Tiled での等角マップ表現に合わせるためのモードです。書き出し後は Tiled で開き、見た目とレイヤー順が後工程に合っているか確認できます。

複数のタイルマップ設定

同じ .resprite ドキュメント内に、グリッド種類、配置パラメータ、タイルサイズが異なるタイルマップレイヤーがある場合、書き出し時に複数の .tmx ファイルへ分割されます。すべて矩形タイルマップレイヤーであっても、タイルサイズが異なれば別々に書き出されます。

これは Tiled 側のファイルモデルによる制限です。単一の Tiled マップは、1 種類のマップ方向、1 組の配置パラメータ、1 種類のタイルサイズしか持てません。異なる設定のレイヤーを同じ .tmx に混在させることはできません。

Tiled マップ書き出しパッケージの内容

.restile タイルセットパッケージ

.restile は Resprite 独自のタイルセットパッケージ形式です。再利用できるタイルセットを保存・共有するために使います。.restile を他の Resprite ユーザーに送ると、相手は自分のドキュメントにインポートして使い続けられます。

.restile と .tsx は用途が異なります。

• Resprite 内でタイルセットを再利用・共有するだけなら .restile を優先します。
• Tiled やゲーム開発ツールチェーンへ渡す必要がある場合は、.tsx または Tiled マップ書き出しを使います。
• 迷う場合は .resprite の元ファイルを残し、必要なツール向けにあとから書き出します。

インポート／エクスポート時の説明

Tiled と Resprite は完全に同じ機能を持つわけではありません。インポートまたはエクスポート時に必要がある場合、Resprite は説明を表示し、次の内容を確認できるようにします。

• 正常に処理された内容
• 注意が必要な内容
• 自動調整された内容
• 保持できなかった内容

説明内の Copy Technical Details は、問題を報告する際に役立ちます。通常は本文の説明だけを読めば十分です。

完全には保持されない内容

次の内容が、編集可能な構造として完全に保持されるとは限りません。

• Tiled のオブジェクトレイヤー（衝突判定枠、トリガー領域、注釈オブジェクトなど）
• カスタムプロパティ
• サードパーティツール専用のフィールド

これらが元ファイルに含まれる場合、インポート時の説明でスキップまたは簡略化された内容として表示されることがあります。

おすすめの使い方

Resprite で編集を続けることが目的なら、.tmx をインポートし、生成された Resprite ドキュメントで作業を続けます。Tiled やゲーム開発ツールチェーンへ渡す必要があるときは、Tiled マップとして書き出してください。

タイルセットだけを再利用したい場合：

1. Resprite 内では .restile またはタイルセットライブラリを優先します。
2. Tiled からタイルセットを取り込む場合は .tsx をインポートします。
3. Tiled へ渡す場合は .tsx または Tiled マップを書き出します。

インポートやエクスポート結果が想定と異なる場合は、サポート窓口まで連絡し、説明に表示される技術詳細も添えてください。