Tiled 地图兼容性

与 Tiled 交换可编辑的瓦片地图和可复用瓦片集。地图导入后会成为 .resprite 项目；在其中编辑和保存，再按需要导出新的 Tiled 文件交给其他工具。

支持的文件类型

类型	用途	使用方式
.tmx	完整 Tiled 地图	桌面端可打开，并读取关联的 .tsx 与图片。
Tiled 地图 .zip	地图及其资源	将 .tmx、瓦片集和图片一起打包，移动端使用此流程。
.tsx	单个 Tiled 瓦片集	导入文档或瓦片集库；移动端选择包含 .tsx 和图片的 ZIP。
.restile	Resprite 瓦片集包	在 Resprite 中复用，或分享给其他 Resprite 用户。

打包时保留资源名称与相对路径。地图文件本身不一定包含显示瓦片所需的图片。

导入 Tiled 地图

1. 选择 Tiled 地图导入，选取 .tmx 或地图 ZIP。
2. 查看导入说明，确认缺失资源和转换内容。
3. 打开并保存生成的 Resprite 项目。

支持范围包括瓦片图层与瓦片集，矩形、等距和六边形布局，以及可兼容的翻转、旋转、地形信息、瓦片概率和瓦片动画。具体转换取决于源数据，发生调整时请查看说明。

导入 Tiled 地图

导入文档与原 .tmx、.tsx 和 PNG 资源相互独立，保存项目不会覆盖这些文件。

导入 .tsx 瓦片集

打开目标作品，通过瓦片集面板的 Tiled 瓦片集导入入口添加；也可以导入瓦片集库，供之后复用。桌面端可选择 .tsx，移动端使用包含瓦片集与关联图片的 ZIP。

只需要一个瓦片集、不需要整张地图时，使用此流程。如果图片缺失或相对路径无法解析，请修正资源包后重新导入。

图片集合瓦片集

散图瓦片集使用独立图片作为瓦片。Resprite 会将兼容图片整理为可用瓦片集，并按图片尺寸或数量限制拆分处理。无法转换的图片请在导入说明中确认。

导出 Tiled 地图

打开包含瓦片图层的文档，选择 导出 ▸ Tiled 地图。ZIP 结果包含一个或多个 .tmx、对应 .tsx 和 PNG 资源。交给 Tiled 时，请将这些文件一起保留。

Tiled 地图导出选项

地图边界

选择能覆盖所需瓦片的导出边界。内容位于画布内时可使用画布范围；内容超出画布或地图较稀疏时，应选择能包含这些内容的更大范围。

等距地图导出

等距图层可选择适合目标流程的等距导出模式。导出后在 Tiled 中检查位置和图层顺序。

多种瓦片地图配置

瓦片图层的网格类型、排列参数或瓦片尺寸不同时，Resprite 会分别导出 .tmx；矩形图层的瓦片尺寸不同也会拆分。一个项目生成多张地图时，交接时保留完整资源包。

Tiled 地图导出包内容

.restile 瓦片集包

使用 .restile 保存可复用瓦片集，供 Resprite 文档或瓦片集库使用。它是瓦片集资源，不是完整作品项目。

接收方需要 Tiled 瓦片集时使用 .tsx；需要连同瓦片排列和图层一起交换时，导出 Tiled 地图。继续编辑完整作品时，保留 .resprite 项目。

导入/导出说明

查看结果说明中的缺失资源、自动转换、跳过内容或失败项目。正文概括实际结果，拷贝技术详情 则提供反馈问题时所需的补充信息。

当前不会完整保留的内容

Tiled 对象层、自定义属性和第三方工具专用字段，不保证保留为可编辑结构。例如碰撞框、触发区域和标注对象。工作流依赖这些内容时，请查看说明，并与源地图比较。

推荐做法

• 编辑完整地图：导入后在 .resprite 中工作，需要交接时再导出 Tiled 地图。
• 复用瓦片：将 .tsx 或 .restile 导入文档或瓦片集库。
• 资源缺失：先检查图片与相对路径，再重新导入。

结果不符合预期时，可通过支持渠道反馈，并附上技术详情与相关资源。编辑工具见瓦片集与瓦片图。