Skip to content

evolutionleo/LDtkParser

main
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
July 20, 2023 04:09
July 20, 2023 04:09
July 20, 2023 04:09
July 20, 2023 04:09
July 20, 2023 04:09
July 20, 2023 04:09
July 20, 2023 04:09
July 6, 2021 19:17
July 20, 2023 04:09
July 20, 2023 04:09
October 3, 2021 20:52
May 19, 2022 20:27

LDtkParser

A feature-rich parser for .ldtk levels for GameMaker: Studio 2.3

Maintaned by @evolutionleo (me)

❤️ Huge thanks to @FaultyFunctions for his various contributions! ❤️

Features

  • Load LDtk levels with all their contents with one function call!
  • Powerful mapping configuration to map layers/entities/fields/enums names in LDtk to their equivallents in GMS (in case they don't match)
  • Entities fields and Enums support!
  • Live Updating! Reload levels in real time!

Installing

1) Go to Releases and download the latest .yymps

2) Import it to your project via Tools/Import Local Package

3) PROFIT!

Setting Up

  • Put an instance of oLDtk somewhere
  • LDtkConfig() (oLDtk has the basic configuration, you can modify it)
  • (Optional) if any of your objects use Variable Definitions, you'll need to enable the escape_fields config and call LDtkReloadFields() in their Create Event

Live Updating

  • Disable file system sandbox in the settings
  • Enable the macro LDTK_LIVE
  • Change the live config's file path so that it loads the .ldtk file from your project's folder

Contributing

Open an issue or make a pull request