Welcome to the LDtkParser wiki! I started writing this wiki as a more in-depth instructions on how to utilise the parser.

1. Import the LDtkParser project template into Gamemaker.
2. Place the oLDtk object within a room.
3. Save your LDtk file within the datafiles (Included Files) folder of your project.
4. Alter global.ldtk.config to your liking.
5. Call ldtk_load_file() to async load the level into the session.
6. Use either ldtk_generate_world or ldtk_generate_room to finish importing from LDTK.
7. Have fun!

Call ldtk_config() with your custom configuration struct to overwrite their default values found in global.__ldtk_config within the 'LDtkParser' script.

Syntax:
LDtkConfig(struct);

Note:
Check global.__ldtk_config in the 'LDtkParser' script for an updated list of configuration options.

The following options are what you'll most likely require for basic usage.

Example:

// live reload config
LDtkConfig({
	file: project_directory + "datafiles\\LDtkTest.ldtk",
	level_name: "LDtkTest1"
})

Finally you'll need to map the sources from LDtk to their target assets and definitions in Gamemaker.

Syntax:
LDtkMappings(struct);

Note:
Check global.__ldtk_config.mappings in the 'LDtkParser' script for a full list of mappings that can be configured.

The key defines the LDtk source variable being imported with the value being the target in Gamemaker. The following options are what you'll most likely require for basic usage.

Example:

LDtkMappings({
	layers: {
		Tiles: "PlaceholderTiles", // now "Tiles" layer in LDtk = "PlaceholderTiles" layer in GM
	},
	enums: {
		TestEnum: {
			//First: "First", // first is undefined, should just return the name
			Second: "This is second",
			Third: 3
		}
	},
	tilesets: {
		PlaceholderTiles: "tTiles",
	}
});