Skip to content
Reads files from the Tiled editor into Rust
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets Parse imagelayer Dec 24, 2017
examples Rustfmt pass and slight macro stylistic changes Dec 18, 2018
.travis.yml update travis.yml to post-1.0 Nov 1, 2015
Cargo.toml Bump version number Aug 23, 2017



Read maps from the Tiled Map Editor into rust for use in video games. It is game engine agnostic and pretty barebones at the moment. Documentation is available on

Code contributions are welcome as are bug reports, documentation, suggestions and criticism.

There is a package on, to use simply add:

tiled = "0.7.2"

to the dependencies section of your Cargo.toml.


extern crate serialize;
extern crate tiled;

use std::fs::File;
use std::io::BufReader;
use std::path::Path;

use tiled::parse;

fn main() {
    let file = File::open(&Path::new("assets/tiled_base64_zlib.tmx")).unwrap();
    println!("Opened file");
    let reader = BufReader::new(file);
    let map = parse(reader).unwrap();
    println!("{:?}", map);
    println!("{:?}", map.get_tileset_by_gid(22));

Things missing

There are a few things missing at the moment:

  • Terrain
  • Tile flipping
  • Image layers
  • A nice API. At the moment you can access attributes and properties, find tilesets by GID and loop through the tiles. This leaves a user of the library with a bit to do.


assets/tilesheet.png by Buch (

Licenced under MIT

You can’t perform that action at this time.