Goodluck / API Reference

Tiled TMJ to Map

Convert Tiled's JSON map representation to a TypeScript source file, which can then be imported and used by the tiled.ts module to instantiate a map.

Supported Tiled Features

The following Tiled features are supported:

  • Map width and height
  • Map background color
  • Any number of tile layers
  • Layer width and height

Tiled's render order is ignored. The converter assumes the right-up order, which is compatible with the directions of the world axes in the game.


Tiled encodes tile information by id. Use tiled_tsj2atlas.cjs to convert Tiled's tileset JSON to an atlas definition in TypeScript.


It's recommended to use the Makefile found in the src/maps directory to convert all maps at once:

make -C src/maps