(Super)Tiled2Unity Documentation
Tiled is a great tiled-based 2D map editor, and used to be super essential for Unity projects until recently, as there wasn’t native support for tile maps.
However, Tiled is still a great option, as it allows map files to be authored outside of Unity, allowing artists and level designers to concurrently work on the same scene as developers without merging issues, while making it easier to port the game in the future (should Unity ever become an unideal platform for development).
Thankfully, Seanba has developed a wonderful tool, SuperTIled2Unity that automatically imports Tiled maps into Unity, with tons of bells and whistles to boot. The problem is that it’s documentation is fragmented, with most of the ST2U’s information being buried in Seanba’s blogposts, comments, and forum responses regarding 2T2U’s deprecated predecessor, Tiled2Unity. Yikes!
To untangle this confusing mess, I’ve compiled the links to this fragmented documentation, for posterity. One day I might even build a wiki for this assuming Seanba doesn’t get to it first. (Continuously update)
Seanba’s Official Documentation. As of this writing, only Sorting, and Object Type and Custom Properties are documented. The Legacy documentation for Object Type support is here.
Tutorial for the original Tiled2Unity, although many of the lessons still apply, including setting up a character controller and how to handle sloping collisions and customer importers.
Retrieving Tile Information At Runtime.
Dealing with scale in unity, and defining the Tag and Layer of the layers of your tile map. An update to this post can be found here.
Additional tileset support.
Edge-Colliders support.
Tile Animations. And an update to this here.
Isometric and hex maps.
Importing maps as a Resource (ignore the top section of this post).
Convex Polygon Output (scroll to the bottom. beware that this is untested if this is still how it works in ST2U)