This is the Haxe API to load LDtk Project JSON files.

LDtk is a modern and open-source 2D level editor.

Issue tracker (shared) | API documentation | LDtk official page

• Compatible with all Haxe based frameworks and engines.
• Dedicated API for the following frameworks:
  • Heaps.io
  • HaxeFlixel
• Completely typed at compilation: if you rename any element in your project (ie. level, layer, entity, etc.), the corresponding references in your code will break accordingly, avoiding typical errors or mistypings.
• Full completion in VScode: if you have vs-haxe installed, you will get full completion while exploring your project file, based on its actual content, right from VScode.

haxelib install ldtk-haxe-api

Please check the full documentation and tutorials here:

https://deepnight.net/docs/ldtk/haxe-api/

You can check some examples in samples folder.

Samples are built to WebGL (Javascript) and Hashlink targets, but you can try them on other compatible platforms too.

You need a standard Haxe install, and the following libraries installed: heaps (from source), deepnightLibs (from source), hlsdl:

haxelib git heaps https://github.com/HeapsIO/heaps.git

haxelib git deepnightLibs https://github.com/deepnight/deepnightLibs.git

haxelib install hlsdl

Open a folder in the samples folder (eg. samples\Generic - Generic - Read project) and run:

haxe build.hxml

You can also build all samples in one go. Go in samples folder and run:

haxe buildAll.hxml

If you modify the API, you might need to rebuild samples HXMLs files themselves. In the root of the repo, run:

haxe genSamples.hxml

You can build and run unit tests manually using the following commands from the repository root.

You will need Node interpreter to run the tests.

haxe tests\js.hxml

You will need Neko VM interpreter to run the tests.

haxe tests\neko.hxml