Skip to content
pubscout

tiled

0.12.0, released 2 months ago by flame-engine.org

A Dart library to parse Tiled TMX and JSON map files into useful representations.

WASM-ready
$ flutter pub add tiled
Source repository

What it does

Parses Tiled map files (TMX and JSON) into Dart objects. It supports external tilesets, object templates, and tile access APIs, and is fully compatible with the Flame game engine.

AI-written summary of version 0.12.0, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You are building a 2D game in Flutter or Dart using Tiled maps.
  • You need to parse TMX or JSON map files generated by the Tiled map editor.
  • You are using the Flame game engine and need map loading capabilities.

Skip it when

  • You are not using Tiled maps for your application or game.

Strengths

  • Supports both TMX and JSON formats.
  • Handles external files, tilesets, and object templates via custom providers.
  • Compatible with the Flame game engine.

Weaknesses

  • Limited to parsing Tiled data representations rather than providing high-level rendering out-of-the-box (rendering is typically handled by flame_tiled).

Setup

Kind
Pure Dart
Effort
Low
Code generation
No
Direct dependencies
4

not documented

final String tmxBody = /* ... */;
final TiledMap mapTmx = TiledMap.parseTmx(tmxBody);

Alternatives

Packages that do the same job and could replace tiled.

  • flame_3d

    Experimental 3D support for the Flame Game Engine using Flutter GPU.

Works with

Packages commonly used together with tiled: ones it builds on, ones built on it, and its own family.