Show / Hide Table of Contents

Level Importer

In addition to the imported project, separate level files can also be imported.
Drag-N-Drop

The file format for imported separate level files is .ldtkl.
To enable separate level files, toggle on the checkbox in LDtk's project settings.
Separate Level Files

There are many benefits to using separate level files:

  • Helps enable modular level design. (ex. randomly-generated dungeon with levels for dungeon pieces)
  • Only modified level files will reimport instead of the project and all levels, resulting in quicker import speeds when applicable
  • Only the dependencies involved in a particular level will reimport the level instead of involving all possible dependencies (Entities, IntGrid tiles)
  • Only the level assets in the scene are loaded into memory during runtime.

For speed reasons, using separate level files is preferable, especially for any larger scale game projects.

Inspector

The importer inspector displays a reference to the level's project which can be clicked to locate the project in the hierarchy window.
The project can also be re-imported from here with a quick button.
Level Importer

Depend On Dependencies

Used by all LDtk assets. See here.

Nested Prefabs

Imported LDtk levels can be nested in prefabs.
Nested Levels Nested Levels Variant

  • Improve this Doc
In This Article
Back to top Generated by DocFX