Loading LDtk files
LDtk JSON files can be easily loaded in most common languages and frameworks. If your favorite one isn’t listed below, don’t worry, we’ve got your back.
C#
- LDtk Unity by Cammin
A fully-featured Unity importer for LDtk.
Uses ScriptedImporters to import an LDtk project/levels with many customizations and full documentation. - Monogame by IrishBruse
A C# Monogame renderer. - Monogame for 0.9.3 by realBoubli
A MonoGame importer that loads the values into MonoGame’s types. Support every feature, and doesn’t use anymore the pipeline. Also it’s an importer only, it doesn’t have any render function. - QuickType loader generated by QuickType
Load and parse LDtk files, with full types definitions. Automatically generated from Json Schema using QuickType.
Haxe
- Official Haxe API by deepnight
Load fully typed LDtk projects, check the full documentation for more info. This API will work with any game engine using Haxe language. The API comes with some extra support for HeapsIO and HaxeFlixel engines.
Game Maker Studio
- Game Maker Studio for LDtk 0.9.3 by Evoleo
Loads LDtk levels as GMS2 Rooms and allows updating them in real-time without recompiling the game. Supports loading in Entities with Entity Fields as Instances, as well as Tile Layers and Enums
Löve 2D
- LUA with Löve by Hamdy Elzonqali
An LDtk importer for LÖVE that provides a simple way to load and manage everything in your way.
Go
- LdtkGo by SolarLune
An LDtk loader I made in Golang. Has a renderer pre-made for use with ebiten. - QuickType loader generated by QuickType
Load and parse LDtk files, with full types definitions. Automatically generated from Json Schema using QuickType.
Python
- QuickType loader generated by QuickType
Load and parse LDtk files, with full types definitions. Automatically generated from Json Schema using QuickType.
Rust
- Ldtk-Rust by Estivate
Loads LDtk file into a typed Rust struct, should work with any Rust game framework, include example in Bevy Engine. - bevy_ecs_ldtk/Rust by Trouv
Super ergonomic and ECS-friendly LDtk plugin for Bevy. - Ldtk-Rs by Katharos Technology
Loads LDtk file into a typed Rust struct, should work with any Rust game framework, include example in Bevy Engine. - Ldtk-bevy by Katharos Technology
A Bevy plugin for loading LDtk tile maps. - QuickType loader generated by QuickType
Load and parse LDtk files, with full types definitions. Automatically generated from Json Schema using QuickType.
C++
- C++ Loader by Madour
Use it to load LDtk levels in your game and access any data you need via the API. - Godot by lrgilbert
Basic GDscript for importing LDtk files into the Godot game engine. - Godot by JoshLee0915
An import plugin that allows Godot to treat.ldtkfiles like native resources and uses them to create Godot scenes.
C
- cLDtk by PompPenguin
C99 loader for the LDtk map editor.
Javascript
- JS/TS by Jan Procházka
This library provides an API without all the noise of LDtk “editor-only” values, definitions, etc., combined with many utilities to make usage easier. - QuickType loader generated by QuickType
Load and parse LDtk files, with full types definitions. Automatically generated from Json Schema using QuickType.
Is your favorite framework or language missing?
1. Using the “Super Simple export” method
Enable the “Super Simple export” and just load simple PNGs in your game (see how it works).
2. Using QuickType
QuickType can generate a full JSON parser for many languages including Ruby, Dart, Objective-C etc. It’s based on the official JSON schema, so it’s always guaranteed to work even with latest version (see how it works).
3. Writing your own JSON parser
LDtk Json format was specifically designed to be easy to parse and is well documented.
If you want your work to be listed here, please use this GitHub issue.
4. Use the Tiled TMX export
If you just want to try LDtk in your favorite framework, and it supports Tiled TMX format, you may also use the Tiled export option.