bornengine import tiled converts a Tiled orthogonal TMX map into the versioned .world2d.json format used by BornEngine’s 2D world loader.
bornengine import tiled maps/level.tmx --output maps/level.world2d.jsonThe --output path is required and must end in .world2d.json. Run the command from the game project root. The input map, referenced external TSX tilesets, and tileset images must be files inside the project; paths in the output document are normalized relative to that root.
The importer reads tile layers, object layers, tilesets, tile and object properties, tile collision rectangles, layer offsets, visibility, opacity, and supported tile flips. It emits diagnostics and stops on unsupported or invalid map data instead of writing a partial world file. The importer does not copy or convert source assets; keep the referenced image files in the project and load them through the game asset manager.
After import, validate the generated document and asset inventory before loading it in a scene:
bornengine assets validateUse World2DLoader to resolve atlas frames and instantiate the document. See the 2D production workflow for a complete Tiled-to-runtime example.
Command reference
Import a Tiled map
Convert an orthogonal Tiled TMX map into BornEngine World2D JSON.
bornengine import tiled <map-file> --output <file.world2d.json>Options
<map-file> is a Tiled TMX file inside the project--output <file.world2d.json> is required-v, --verbose (repeatable)
Behavior
Reads supported TMX, external TSX, tileset images, tile layers, object layers, and typed properties from project files, then writes a versioned World2D document with project-relative asset paths.
Examples
bornengine import tiled maps/level.tmx --output maps/level.world2d.json