A downloadable tool

Download NowName your own price


(Last updated Dec 24th, 2022. Online documentation available on Read the Docs.)

Note: Please report any bugs to my Github page.

SuperTiled2Unity is a collection of C# Unity scripts that can automatically import Tile Map Editor files directly into your Unity projects.

The goal of SuperTiled2Unity is simple: Tiled files saved to your Unity project are automatically converted to prefabs you can drop into your scenes. That's it.

SuperTiled2Unity it a complete rewrite of my popular Tiled2Unity tool, first released in 2014. Unity has seen many improvements in that time and SuperTiled2Unity takes advantage of Scripted Importers to support Tiled files directly within Unity. There is no longer any need for a separate exporter tool which means SuperTiled2Unity is supported on every OS right out-of-the-box.

SuperTiled2Unity uses tile-based classes now native to Unity (like Tilemap) so that built prefabs are closer to Unity's vision of such assets.

This tool is currently available for free but donations (or even a kind word) are always appreciated.

Rated 4.9 out of 5 stars
(36 total ratings)
Tags16-bit, 2D, 8-Bit, tiled, Tilemap, tool, Unity


Download NowName your own price

Click download now to get access to the following files:

SuperTiled2Unity.1.10.7.unitypackage 427 kB
SuperTiled2Unity.1.1.7.unitypackage (latest for Unity 2018.2) 844 kB

Development log

View all posts


Log in with itch.io to leave a comment.

Viewing most recent comments 2 to 41 of 81Next pageLast page

Amazing program. As a young dev student, I appreciate this enormously.

I'm getting errors about needing to persevere relative path. Might want to add something to the docs.

Thank you much for your work.

M. D.

Hi, one question, how can I get a custom property of tiles?

finally, read some of your asset codes and I got a way to deal with this. cool!

(1 edit)

Thank you for building and maintaining this project - it's magical <3

(1 edit)

Need help, I got to import the file like normal and manage to put it in unity but when I press play, the pixels are all messy, and they're no settings to make it look like normal pixels again that pls help,t


Sorry for the late reply here but chances are your textures were imported with bilinear filtering. Go to the the import settings of your texture in the inspector window and re-import your textures using point filtering.

I'm struggling to get this to work properly. I do all the steps mentioned in this video and when I drag the .tmx file onto the scene only the collisions boxes show up 

How can I fix this to make sure it all shows up? 


Absolutely awesome! Thanks for your hard work and dedication to this project!


I've used right now and have succeeded to use it with Tiled and Unity; i am now really happy with this and cannot thank you enough for the help!

Thank you so much for  Prefab Replacements! I tried using a Tile in an Object Layer with collision and it created too many nested GameObjects for my liking. Now I can just set markers and have Unity place the Prefabs in the right spot! Thank you thank you thank you!


can i use this with LDtk ?

unfortunately no. LDtk uses a different method to integrate with engines like Unity. In theory you could probably write a scripted importer to process the LDtk file but as of last year this was not something anyone had done. I haven't checked in a while but i don't think it was on their roadmap to integrate with Unity this tightly.

Thx or taking the time to replay even if it was an old comment 馃槄

You are right ! Thankfully I was lucky, there is a developer called cammin, he made an integration for that, it is called "Ldtk to unity" and it worked well with my project


oh nice! i think i chatted with him about how SuperTiled2Unity works on the LDtk discord so awesome to see it happened. I've added it to my list to check out at some point. thanks!

is there a larger tileset import? my tileset is almost 1200px by 4048

Thanks for this awesome plugin Seanba. :)

Hey i have a problem because i am trying to import some tiles of "Tiled" but when i put all i need that say "We can't find the X sprite and all sprites i use...and i need something like a guide of this because i don't know how use it and i think some people have this problem too please help me (anyone) :c

Is this can be used to import maps at runtime?

(1 edit)

I am using the latest versions of SuperTiled2Unity, Tiled, and Unity, and I am having a problem with importing an isometric map.

This is the map I made using Tiled:

This is what it looks like in Unity (the name of my project has been blacked out):

I even tried doing a custom axis as linked to in a previous comment made over a year ago by someone else.

Can you please help me?


I鈥檓 here to just say: I looove this Plugin it has quite deep integration in Unity and brings a new level of working with tiled and unity. I鈥檓 also happy, that the source is available. I had scaling issues, because I wanted to have a specific kind of parallaxing and was able to implement it in the Plugin.

Keep up the awesome work!


Hi, i just downloaded this and I am new to unity, how do I use this? Is there some documentation or instruction tutorial. (preferably written).

I saw they have a doc https://supertiled2unity.readthedocs.io/


That's nice but what do I do with the file I just downloaded? How do I add it to Unity?

I don't know馃槕


with unity open you either doubleclick the unitypackage file or drag and drop it into the assets folder in Unity editor. it will open an install dialog

oh that was simple. Thanks.

Hi @Seanba - how can I get access to the Tilemap image to change it at runtime? I want to change the sky tileset gradually as you move through the level, but I can't find any way to access and change the tilemap graphics.

Hey there. I'd recommend copy/pasting your response here https://seanba.itch.io/supertiled2unity/devlog/231859/supertiled2unity-version-1... or on whichever version you're currently using. I think you'll get a faster response! Cheers and good luck

Ah cool - thank you. Will do :)

no problem! Good luck

Hey @Seanba I recently upgraded to Unity 2020.3.0f1. I'm using the Universal Render Pipeline and created a WebGL project with SuperTiled2Unity. The Tiled Map renders fine on Desktop Chrome but is just blacked out on Android. Would love some feedback! Thanks again for all your work

Thank you so much for your hard work, it is really appreciated! :)

Hey, I'm having some issues with the custom sorting axis. I followed all directions to a T, values are x0 y1 z0, custom sorting layer is selected, etc. But this is happening - https://gfycat.com/scentedwiltedkrill

This may be more of a Unity thing, but I'm not sure how to deal with colliders in 2D in top down, is there a way to "layer" colliders? When you go up stairs, it activates X colliders, when you go down the stairs, it activates others? As shown in this gif here - https://gfycat.com/heavyacrobaticlhasaapso

Thank you!

Hi there, @aricl. It looks like your character is sorting against those trees as I would expect. The problem is that those trees are made up of separate tiles. What you want is for your character's root position (at his feet I guess?) to always sort against the bottom of the tree. If you change your tree tiles so that they are twice as tall then it should work. Note that this is what the example that comes with SuperTiled2Unity does.

As for your second question that is more of a Unity issue. My advice is to get your collisions working as desired without using ST2U first (i.e. just using stock colliders). Once that is working to taste then you can take the lessons learned from that and apply that to your maps exported from Tiled.

Thanks a bunch for the reply. I didn鈥檛 know using different sized tiles was a thing I could do!

Hey @Seanba . Any updates? I have a jam to submit due in 7 days. would love some advice as to why the map disappears when dragging past a certain value. thanks

My guess is that the map is being culled. I took a look on the Unity forums and see that other people are running into similar issues with Unity Tilemaps, which SuperTiled2Unity uses.


Try going to one of the Tilemap Renderer components on one of your layers in the map and play with the chunk culling values to see if that makes a difference. You want a culling size that large enough that it won't be culled out. If that "works" then perhaps you can add a custom importing script that will help set those values for you automatically.

In any case it sounds like a Unity bug. They won't be able to fix in time for your jam but when you have time it would be good to enter a bug with them. There's probably something special about objects that are part of a canvas that is failing to automatically update the bounding chunks. What is your runtime target? It could be a bug there too.

Hey Seanba. We spoke on Twitter. I fixed the issue by setting Detect Chunk Culling Bounds to Auto in my Tile Layer. Thanks for the speedy response on Twitter

Hey @Seanba I have a Screen Space Camera Canvas in my Unity game. When I drag my Tiled Map in using SuperTiled2Unity, it seems to disappear if I move past a certain value. It shows in the Editor but not in Runtime.

Is there anyway to add support for normal maps to this? I'd like to use normal maps from Sprite DLight on my tilemaps


Hi there. It's a bit dated now and uses an older version of SuperTiled2Unity but this Github repository is an example of ST2U using normal maps that should be helpful.

thanks for the tool :)
How do we report Bugs? Tilemap collisions do not work in Unity 2020.1.7 latest. Is this a missing feature or a bug?

Hi there, Sam. SuperTiled2Unity does not use Unity's TilemapCollider2D class but instead uses its own collection of PolygonCollider2D objects to help with collision. This is so we can use the collision geometry created on the tilesets within Tiled.

There is an example provided with SuperTiled2Unity that should give some clues. Thanks.

love tiled love unity

Hey I used SuperTiled2Unity in 2020.1. When, I Import a "Tiled" file then it has no animation. In "Tiled" it looks fine with all animation, but in Unity its not animated! So i started the example map but its totally black, only the Player is visible. Did I do something wrong with the animated tiles?

Hi there, nova234. The animations don't work until the user presses "play" in the editor. Is that perhaps the issue?
Are there any errors generated in the Console window in Unity?

Hey there, Seanba. Thanks for the reply. Programming is like magic a failure comes and mystically disappears. I slept overnight and its now working. I don't know why. Thanks Seanba for your Time.

HI, does anybody know how to I instantiate a tiled map via code? I am trying and nothing.... Also I am using the light system made by unity to iluminate 2d games, does it work along with this?

Hi there, marcospdsf. You should be able to instantiate the prefab created by the Tiled map importer the same you would any other prefab. (Note that most users just drag the prefab into their scene hierarchy though.) Are you getting any errors?

(2 edits)

I need to store it in a variable, Wich I don't know the type, like is it a Image, a GameObject, or there is something like SuperTiled, need to call any method or import anything? The to instantiate, is it just instantiate(gameobject-tiled-image)? 

I already tried some of those, but it didn't let me use, obviously 'cause it thinks it is not the type.

And I am really thankful for the answer

(2 edits)

The prefab should be able to be stored or referenced as a GameObject like other prefab instances. It's possible I'm not understanding you fully, however, so it may be best to send me your project and point me to the code that is attempting the instantiation. (sean@seanba.com)

Just sent you a email, thank you :D

This is a very useful and simple to use plugin, I like it ! Keep up with the good work ! 

Nevertheless, I have a problem trying to write a custom importer. I asked the question on StackOverflow but I thought I'll post it here in case someone else could try to solve my problem or to help others that face the same issue when the problems will be solved. 


Hi there. I've replied to your stack overflow post but it looks like you have your own assembly definition that is not set up correctly. It is going to need references to the SuperTiled2Unity and SuperTiled2UnityEditor assemblies.


Seanba are you ok man? No more reply since a long time, I hope you are right!

hello, sorry 4 bothering but i need to know how to export my tile as a tsx


Hey Seanba, sorry to bother you again! I'm working with a 2D light System (http://tiny.cc/sphpnz) and I need boxed collision polygons to be generated not triangulate to generate dynamic shadows properly. Can SuperTiled2D generate these kind of colisions without the triangules (check picture). Thanks again for your awesome tool! Be safe.


What a wonderful tool. Quick question about sorting: If I import two walls, each made up of tiles, and one is above another on the Y axis, the custom sort order seems to make my character always show on top of the bottom wall, and below the top wall. Is unity using the Y axis of the wall layer - where the walls are - rather than each wall's Y coordinate for sorting?

Changing the mode to individual didn't fix things either, as now my character shows in front/behind of individual wall tiles. Any help is appreciated.

Also, let me know if you have a donation page. Thank you!

Viewing most recent comments 2 to 41 of 81Next pageLast page