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 项目包	移动端更适合使用 .zip 包导入，方便一起带上 .tmx、.tsx 和图片资源。
.tsx	Tiled 瓦片集	用于导入或导出单个 Tiled 瓦片集。
.restile	Resprite 瓦片集包	用于在 Resprite 中复用瓦片集，也适合分享给其他 Resprite 用户。

桌面端直接打开 .tmx 时，Resprite 会读取同目录或相对路径中的 .tsx 与图片资源。在移动端，.tmx、.tsx 和图片资源不一定能按原文件夹关系一起读取，因此更适合通过 Tiled 地图 .zip 包导入整个项目。

导入 Tiled 地图

导入 .tmx 或 Tiled 地图 .zip 包后，Resprite 会尽量保留可继续编辑的地图内容，包括：

• 瓦片图层；
• 瓦片集和对应图片；
• 矩形、等距和六边形地图；
• 瓦片翻转、旋转等常见变换；
• 可兼容的地形信息；
• 瓦片出现概率；
• 瓦片动画。

导入后，Resprite 会创建可继续编辑的文档。后续编辑发生在 Resprite 文档中；原 .tmx、.tsx 和 PNG 文件不会被原地改写。

导入 Tiled 地图

导入 .tsx 瓦片集

.tsx 是 Tiled 的瓦片集文件。导入 .tsx 时，Resprite 会把它加入当前文档，作为可用于绘制瓦片图层的瓦片集。

适合以下场景：

• 你只想复用一个 Tiled 瓦片集，而不是导入整张地图；
• 你已经在 Resprite 中新建了文档和瓦片图层；
• 你希望使用 Tiled 生态里的瓦片素材继续绘制。

如果 .tsx 引用的图片文件缺失或路径不正确，导入会失败或产生说明。导入前请尽量保持 .tsx 与图片资源的相对路径不变。

图片集合瓦片集

Tiled 支持每个瓦片来自独立图片的散图瓦片集。Resprite 导入这类瓦片集时，会尝试把这些独立图片整理成可在 Resprite 中使用的瓦片集。

需要注意：

• 图片可以整理成瓦片集时，会直接导入；
• 如果图片数量或尺寸超出限制，Resprite 可能会拆分处理；
• 如果某些内容无法转换，导入说明会列出原因。

导出 Tiled 地图

在含有瓦片图层的文档中，选择 导出 ▸ Tiled 地图 可导出 Tiled 兼容地图。导出结果是一个 .zip 包，通常包含：

• 一个或多个 .tmx 地图文件；
• 对应的 .tsx 瓦片集文件；
• 瓦片集 PNG 图片资源。

如果当前文档里没有瓦片图层，Tiled 地图导出会失败并提示没有可导出的瓦片图层。

Tiled 地图导出选项

地图边界

导出时可以选择地图边界。一般地图可按当前画布范围导出；如果瓦片内容超出画布，或需要保留大范围的稀疏地图，可以选择更大的导出范围。

等距地图导出

当文档包含等距瓦片图层时，导出对话框会提供等距导出模式，用来匹配 Tiled 中的等距地图表达。导出后可在 Tiled 中打开检查画面和图层顺序，确认它符合后续制作流程。

多种瓦片地图配置

如果同一个 .resprite 文档里同时包含网格类型、排列参数或瓦片尺寸不同的瓦片图层，导出时会拆分为多个 .tmx 文件。即使都是矩形瓦片图层，只要瓦片尺寸不同，也会分开导出。

这是 Tiled 软件自身文件模型的限制：单个 Tiled 地图只能使用一套地图方向、排列参数和瓦片尺寸，不能把这些配置不同的地图图层混在同一张 .tmx 中。

Tiled 地图导出包内容

.restile 瓦片集包

.restile 是 Resprite 自己的瓦片集包格式，用来保存和分享可复用瓦片集。把 .restile 发给其他 Resprite 用户后，对方可以导入到自己的文档中继续使用。

.restile 与 .tsx 的定位不同：

• 只在 Resprite 里复用或分享瓦片集时，优先使用 .restile；
• 需要交给 Tiled 或游戏开发工具链时，使用 .tsx 或 Tiled 地图导出；
• 不确定时，可以先保存 .resprite 主文件，再按目标工具另行导出。

导入/导出说明

Tiled 与 Resprite 的功能并不完全相同。导入或导出时，Resprite 会在必要时显示说明，帮助你确认：

• 哪些内容已成功处理；
• 哪些内容需要注意；
• 哪些内容已自动调整；
• 哪些内容无法保留。

说明窗口中的“拷贝技术详情”适合在反馈问题时使用。普通用户通常只需要阅读正文提示。

当前不会完整保留的内容

以下内容不要假定会被完整保留为可编辑结构：

• Tiled 的对象层（Object Layer），例如碰撞框、触发区域或标注对象；
• 自定义属性（Custom Properties）；
• 第三方工具专用字段；

这些内容如果出现在源文件中，可能会在导入说明中标记为跳过或降级处理。

推荐做法

如果你的目标是继续在 Resprite 中编辑，导入 .tmx 后，Resprite 会生成可编辑文档。后续修改会发生在 Resprite 文档中；需要交给 Tiled 或游戏开发工具链时，可以再导出 Tiled 地图。

如果你的目标只是复用瓦片集：

1. 优先在 Resprite 里使用 .restile 或瓦片集库。
2. 需要从 Tiled 引入瓦片集时导入 .tsx。
3. 需要交给 Tiled 时导出 .tsx 或 Tiled 地图。

如果导入或导出结果不符合预期，可通过支持渠道反馈，并附上说明窗口中的技术详情。