fledge_tiled library

Tiled tilemap support for the Fledge ECS game framework.

This library provides full integration with Tiled, a popular 2D tilemap editor. It supports:

• TMX/TSX Parsing: Load Tiled maps and external tilesets
• Tile Layers: Efficient rendering with atlas batching
• Object Layers: Spawn entities from Tiled objects
• Animated Tiles: Automatic tile animation support
• Collision Shapes: Generate collision from objects and tiles
• Custom Properties: Type-safe access to Tiled properties
• Infinite Maps: Chunk-based loading for large maps

Quick Start

import 'package:fledge_ecs/fledge_ecs.dart';
import 'package:fledge_tiled/fledge_tiled.dart';

void main() async {
  final app = App()
    .addPlugin(WallTimePlugin())
    .addPlugin(TiledPlugin());

  // Load a tilemap
  final loader = AssetTilemapLoader(
    loadStringContent: (path) => rootBundle.loadString(path),
  );
  final tilemap = await loader.load(
    'assets/maps/level1.tmx',
    (path, w, h) async => await loadTexture(path),
  );

  // Store and spawn
  app.world.getResource<TilemapAssets>()!.put('level1', tilemap);
  app.world.eventWriter<SpawnTilemapEvent>().send(
    SpawnTilemapEvent(assetKey: 'level1'),
  );

  await app.run();
}

Object Spawning

Objects from Tiled can be spawned as entities with custom components:

SpawnTilemapEvent(
  assetKey: 'level1',
  config: TilemapSpawnConfig(
    tileConfig: TileLayerConfig(
      generateColliders: true,
      colliderLayers: {'Collision'},
    ),
    objectTypes: {
      'enemy': ObjectTypeConfig(
        onSpawn: (entity, obj) {
          entity.insert(Enemy(
            health: obj.properties.getIntOr('health', 100),
          ));
        },
      ),
      'collectible': ObjectTypeConfig(
        createCollider: false,
        onSpawn: (entity, obj) {
          entity.insert(Collectible(
            value: obj.properties.getIntOr('value', 10),
          ));
        },
      ),
    },
  ),
)