当前位置：首页 > news >正文

SuperTiled2Unity扩展指南：创建自定义导入器的高级技巧与实践

news 2026/7/13 15:55:13

SuperTiled2Unity扩展指南：创建自定义导入器的高级技巧与实践

【免费下载链接】SuperTiled2UnityImports Tiled files to Unity. Better than regular Tiled2Unity.项目地址: https://gitcode.com/gh_mirrors/su/SuperTiled2Unity

SuperTiled2Unity是一款强大的工具，能够将Tiled地图编辑器的文件无缝导入到Unity中，为开发者提供了比常规Tiled2Unity更好的体验。本文将深入探讨如何创建自定义导入器，帮助你充分发挥SuperTiled2Unity的潜力，实现更灵活、高效的地图导入流程。

为什么需要自定义导入器？

在游戏开发过程中，每个项目都有其独特的需求。标准的导入流程可能无法满足特定的功能要求，比如自定义属性处理、特殊对象生成或与其他系统的集成。自定义导入器允许你在Tiled地图导入Unity的过程中插入自己的逻辑，从而实现个性化的导入效果。

![Tiled地图示例](https://raw.gitcode.com/gh_mirrors/su/SuperTiled2Unity/raw/1861abd9ee0f8ec5cd545841a6243135132bfd87/SuperTiled2Unity/Assets/Samples/Super Tiled2Unity/2.3.1/Overhead/Maps/Zoria Tileset/mockups.png?utm_source=gitcode_repo_files)

图：使用SuperTiled2Unity导入的多样化Tiled地图示例，展示了自定义导入器可能实现的丰富效果

准备工作：安装SuperTiled2Unity

在开始创建自定义导入器之前，确保你已经在Unity项目中正确安装了SuperTiled2Unity。你可以通过Unity的Package Manager来安装该插件。

图：Unity Package Manager中显示已安装的SuperTiled2Unity插件

如果尚未安装，可以通过以下步骤进行安装：

打开Unity Package Manager
点击"Add package from git URL..."
输入仓库地址：https://gitcode.com/gh_mirrors/su/SuperTiled2Unity
等待安装完成

自定义导入器基础：了解CustomTmxImporter类

SuperTiled2Unity提供了CustomTmxImporter抽象类，作为创建自定义导入器的基础。该类位于SuperTiled2Unity/Editor/CustomImporters/CustomTmxImporter.cs文件中。

要创建自定义导入器，你需要创建一个继承自CustomTmxImporter的类，并实现其抽象方法TmxAssetImported。这个方法会在Tiled资产导入完成后被调用，你可以在这里添加自己的处理逻辑。

创建你的第一个自定义导入器

步骤1：创建新的C#脚本

在Unity项目中创建一个新的C#脚本，命名为MyFirstCustomImporter.cs。

步骤2：继承CustomTmxImporter

在脚本中，让你的类继承自CustomTmxImporter，并实现TmxAssetImported方法。

using SuperTiled2Unity.Editor; public class MyFirstCustomImporter : CustomTmxImporter { public override void TmxAssetImported(TmxAssetImportedArgs args) { // 在这里添加你的自定义导入逻辑 var map = args.ImportedSuperMap; UnityEngine.Debug.LogFormat("自定义导入器：地图 '{0}' 已成功导入！", map.name); } }

步骤3：在Unity中应用自定义导入器

选择你的Tiled地图文件（.tmx）
在Inspector窗口中，找到"Custom Importers"部分
点击"+"按钮，选择你创建的自定义导入器类

现在，当你重新导入Tiled地图时，你的自定义导入器将会被执行，并在控制台输出日志信息。

高级技巧：使用自定义属性

SuperTiled2Unity允许你在Tiled中定义自定义属性，并在导入过程中通过自定义导入器进行处理。这为实现复杂的游戏逻辑提供了极大的灵活性。

在Tiled中添加自定义属性

打开Tiled地图编辑器
选择你想要添加属性的对象、图层或地图本身
在属性面板中添加自定义属性，例如"unity:SortingLayer"

图：在Tiled中为对象添加自定义属性，用于控制Unity中的排序层

在自定义导入器中处理属性

public override void TmxAssetImported(TmxAssetImportedArgs args) { var map = args.ImportedSuperMap; var objects = map.GetComponentsInChildren<SuperObject>(); foreach (var obj in objects) { // 检查对象是否有自定义排序层属性 if (obj.TryGetCustomProperty("unity:SortingLayer", out string sortingLayer)) { // 获取对象的渲染组件 var renderer = obj.GetComponent<UnityEngine.SpriteRenderer>(); if (renderer != null) { // 设置排序层 renderer.sortingLayerName = sortingLayer; UnityEngine.Debug.LogFormat("已为对象 '{0}' 设置排序层: {1}", obj.name, sortingLayer); } } } }

自动运行的导入器：使用AutoCustomTmxImporterAttribute

如果你希望某个自定义导入器自动应用于所有Tiled地图导入，可以使用AutoCustomTmxImporterAttribute。这个特性可以添加到你的自定义导入器类上，使其自动运行，无需在Inspector中手动添加。

[AutoCustomTmxImporter] public class AutoRunImporter : CustomTmxImporter { public override void TmxAssetImported(TmxAssetImportedArgs args) { // 这个导入器会自动运行在所有Tiled地图导入过程中 UnityEngine.Debug.Log("自动导入器正在运行..."); } }

你还可以通过指定order参数来控制多个自动导入器的执行顺序：

[AutoCustomTmxImporter(1)] public class FirstAutoImporter : CustomTmxImporter { // 实现代码... } [AutoCustomTmxImporter(2)] public class SecondAutoImporter : CustomTmxImporter { // 实现代码... }