https://github.com/Cammin/LDtkToUnity
Unity importer for the LDtk level editor
https://github.com/Cammin/LDtkToUnity
2d 2d-game-development importer ldtk ldtk-api level-editor openupm unity unity-editor unity-package-manager unity2d unity2d-game
Last synced: 9 days ago
JSON representation
Unity importer for the LDtk level editor
- Host: GitHub
- URL: https://github.com/Cammin/LDtkToUnity
- Owner: Cammin
- License: mit
- Created: 2020-11-08T11:59:39.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-10-20T02:00:00.000Z (7 months ago)
- Last Synced: 2024-10-29T17:11:59.638Z (6 months ago)
- Topics: 2d, 2d-game-development, importer, ldtk, ldtk-api, level-editor, openupm, unity, unity-editor, unity-package-manager, unity2d, unity2d-game
- Language: C#
- Homepage: https://cammin.github.io/LDtkToUnity
- Size: 57.9 MB
- Stars: 387
- Watchers: 11
- Forks: 39
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-unity3d - LDtkUnity - A package for easy Unity-integration with the Level Designer Toolkit, created by deepnight: https://github.com/deepnight/ldtk (Open Source Repositories / Level Editor)
README
[](https://openupm.com/packages/com.cammin.ldtkunity/)
[](https://unity3d.com/get-unity/download/archive)
[](https://github.com/Cammin/LDtkToUnity)
[](https://openupm.com/packages/com.cammin.ldtkunity/)
[](https://discord.gg/7RPGAW9dJx)
A Unity importer system for [deepnight](https://deepnight.net/)'s [LDtk](https://ldtk.io/).
[](https://discord.gg/7RPGAW9dJx)
[](https://cammin.github.io/LDtkToUnity/documentation/Installation/topic_Install.html)
[](https://cammin.github.io/LDtkToUnity/)
[](Assets/LDtkUnity/CHANGELOG.md)
[](https://forms.gle/a7iRkuBFxpgZpwRd8)
[](https://trello.com/b/YPgO5283)
[](https://openupm.com/packages/com.cammin.ldtkunity/)
[](https://ko-fi.com/cammin41357)
**It's a simple drag and drop!**
## Features
- Uses [ScriptedImporters](https://docs.unity3d.com/Manual/ScriptedImporters.html) to import LDtk files, and re-imports when the LDtk project saves
- Animated Tiles!
- Collision options
- Entity prefab replacements
- Imports fields from entities and levels
- Automatic enum script generation
- Custom Post-import scripting to customize the import result ([API](https://cammin.github.io/LDtkToUnity/documentation/Topics/topic_CustomImporting.html))
- Properties and functions for LDtk data for better Unity context ([API](https://cammin.github.io/LDtkToUnity/api/LDtkUnity.html))
- Separates Tileset generation to optimize import speeds, and pack into a [SpriteAtlas](https://docs.unity3d.com/Manual/class-SpriteAtlas.html)
- Supports separate level files
- Supports Unity's [Configurable Enter Play Mode](https://docs.unity3d.com/Manual/ConfigurableEnterPlayMode.html)
- [Fully documented](https://cammin.github.io/LDtkToUnity/)
**Can add separate level files too!**
If you have any questions/problems then post an issue; I'd gladly take any feedback.
Alternatively, contact me at [email protected], the [Discord server](https://discord.gg/7RPGAW9dJx), or Twitter [@CKrebbers](https://twitter.com/CKrebbers).
If you like this importer, consider signing a [survey](https://forms.gle/a7iRkuBFxpgZpwRd8) for feedback or [donate]().
If you make a game using this, then I'd be happy to check it out! Showcase your work on the [Discord server](https://discord.gg/7RPGAW9dJx) or give me a shout-out on [Twitter](https://twitter.com/CKrebbers).
###### Premise & Review
This importer started as an attempt to produce levels in an easy and streamlined fashion.
When searching for a solution to mass-produce levels, I discovered LDtk, as its really fun to use and is relatively young.
I started working on a personal level importer, but after noticing how convenient and standalone the importer has become, I took it upon myself to make this a public repo as a package!
I enjoy it's production, and learning a lot in the process.
