TMXCSharp

A TMX Map parser for Tiled map engine written in C#.

Goal of Library:

• Easy to use
• Use Classes to eliminate the possibility of accidental struct copies
• Reasonably fast

Potential Uses:

• Orthographic (2D looking straight-on) Tile Engines in C#
• Easy to integrate with OpenTK or XNA

Runtime Requirements:

• .net 4, .net 4 client profile, or .net 4.5 (default)

License:

• MIT (see LICENSE.md)

Features Supported:

• Multiple Tile Layers
• Multiple Tile Sets
• Sanity checks on data
• Base64 + zlib/gzip/or no compression
• CSV format
• XML format
• Method for providing a different location for the tile images (instead of the one the map editor was given)

Features Not Yet Supported:

• Properties
• Isometric (I have only attempted orthogonal)
• Object layers
• Flags on tiles. They get dropped and the tile id is corrected. Horizontal, vertical, and diagonal flipping is parsed but no indication is given on the output model.
• Using the path that the map editor gave for each tileset instead of different location provided.
• Needs commenting and refactoring of the code.
• Persisting map data back to a .tmx file

External Links:

Tiled github page - https://github.com/bjorn/tiled

Tiled home page - http://www.mapeditor.org/

List of supported parsers - https://github.com/bjorn/tiled/wiki/Support-for-TMX-maps

Getting Started:

SORRY! This section is undergoing a rewrite due to recent refactoring. A new open source tile engine will be released soon including support for TmxCSharp.

That said, the library is pretty straight-forward. Look here first:

https://github.com/gwicksted/tmxcsharp/blob/master/TmxCSharp/Loader/TmxLoader.cs