This is a MiniScript LDtk Toolkit — a library for working with LDtk level files inside MiniMicro projects. It contains parsing, loading and several utility helpers and convenient functions to make game development within MiniMicro easier.
This parser was created for use in my upcoming microjam 041, but I decided to share it publicly so others using MiniScript can take advantage of LDtk in their own projects.
I like MiniScript/MiniMicro and plan on using it for many future projects, so this Toolkit will be actively maintained. It’s currently on its early stages, but the core functionality is sufficient to build most types of games. Please notify me of any issue by DMing me on Discord, sending an email, or making a pull request.
- Load LDtk
.ldtkproject files - Access levels by name, IID, or UID
- Query layers, int grid data, and tile data
- Retrieve placed entities and their fields
- Access enum definitions and values
- Supports tiled and grid-based logic
- Several utility functions and helpers
The parser is minimal, but it includes everything needed for most practical use cases:
- No dependencies (Except for MiniMicro sysdisk libraries)
- No loops required to use it
A complete breakdown of available methods and how to use them is available in the docs.md file or as linked above. The parser includes accessors for:
- Project, contains all subsequent classes (
LDtkProject) - Level metadata and contents
- Layer data (tiles, int grids, etc.)
- Entities and their fields
- Enums and enum values
// Ensure project is loaded
project = new LDtkProject
project.loadFile("res/world.ldtk")
level = project.getLevel("Level_1")
player = level.getEntity("Player")
// Get the layers from Level
collisionLayer = level.getLayer("Collision")
environmentLayer = level.getLayer("Environment")
furnitureLayer = level.getLayer("Furnitures")
display(5).mode = displayMode.tile
display(5).tileSet = file.loadImage("/usr/tilesets/environment.png")
// Convenient single function to configure TileDisplay but it is optional
environmentLayer.initTileDisplay display(5)
furnitureLayer.initTileDisplay display(5)
// Convenient single function to directly send tiles to to display
environmentLayer.pushTilesToDisplay display(5)
furnitureLayer.pushTilesToDisplay display(5)
// Ex: Bounds checking using IntGrid
isWall = collisionLayer.getIntGridAt(10, 5) == 1
pprint "Player at: " + player.x + ", " + player.yCOMING SOON
- Full support for entity fields and complex types
- Helper functions for common queries
- Layer type introspection
- Better error handling and validation
Contributions, bug reports, and suggestions are welcome! This project is meant to stay lightweight and MiniScript idiomatic, so keep it simple.
This project is open source and licensed under the MIT License.