Skip to content

deepnight/ldtk-haxe-api

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
January 12, 2023 14:50
January 13, 2023 14:33
January 11, 2023 15:16
April 16, 2021 09:33
September 25, 2020 13:17
January 13, 2023 14:33
April 21, 2021 14:15

About

What is this?

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

Unit tests

Features

  • Compatible with all Haxe based frameworks and engines.
  • Dedicated API for the following frameworks:
  • 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.

Usage

Install

haxelib install ldtk-haxe-api

Documentation

Please check the full documentation and tutorials here:

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

Samples

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.

Requirements

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

Building samples

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

Rebuild samples HXMLs

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

haxe genSamples.hxml

Unit tests

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

JS/WebGL target

You will need Node interpreter to run the tests.

haxe tests\js.hxml

Neko target

You will need Neko VM interpreter to run the tests.

haxe tests\neko.hxml

About

LDtk level editor Haxe API (available on HaxeLib)

Resources

License

Stars

Watchers

Forks

Sponsor this project