LDtkToUnity icon indicating copy to clipboard operation
LDtkToUnity copied to clipboard

Unity importer for the LDtk level editor

LDtkToUnity
OpenUPM Compatibility GitHub Repo stars Hits

A Unity importer system for deepnight's Level Designer Toolkit.

Install
Documentation
Discord
Changelog
Survey
Trello
OpenUPM

It's a simple drag and drop!
DragNDrop

Features

  • Uses ScriptedImporters to import an LDtk project
    • Automatically re-imports whenever the LDtk project is saved
  • TileLayers, AutoLayers, and level backgrounds work out of the box
  • IntGridValue assets used for collision
    • Optionally GameObjects too
  • Entities from prefabs
  • Entities and levels have all field data available
  • Automatic enum script generation
  • Many properties and functions that extend onto LDtk data for better context in Unity (API)
  • Works with/without separate level files
    • Can also add individual levels for modularity (ex. dungeon rooms)
  • Custom scripted postprocessor to customize the import result (API)
  • Supports Unity's Configurable Enter Play Mode
  • Fully documented

Can add separate level files too!
Drag-N-Drop

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, or Twitter @CKrebbers.

If you like this importer, consider signing a survey for feedback.
If you make a game using this, then I'd be happy to check it out! Showcase your work on the Discord server or give me a shout-out on Twitter.

Disclaimer

This project has stabilized development! :tada:
There may still be some new features, but development is calming down.
The changelog documents any breaking changes, but feel free to post issues regarding any problems.

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.

Opacity