TiledReader

TiledReader

TiledReader is a simple Java library for reading information from files created with the map editor Tiled. TiledReader makes the internal structure of Tiled map, tileset, and template files easy to navigate, but it cannot load image data (only report paths to image files), and it cannot render Tiled maps by itself. Thus, TiledReader is most appropriate when you want to use Tiled in combination with existing graphics code.

Download

  • TiledReader (version 1.1.0, for Tiled version 1.4.x) with source and javadoc included
    • Changelog
      • Version 1.1.0
        • Changed the TiledReader class into an instantiable class with abstract methods for back-end tasks like I/O and interaction with the resource cache. Added the FileSystemTiledReader subclass to replicate the old TiledReader class' back-end behavior.
        • Added support for Tiled's "Object Types Editor" feature in the form of the TiledObjectTypes and TiledObjectType classes.
        • Added support for tile objects inheriting their types from their tiles.
        • Added support for terrain types without representative tiles.
        • Added the TiledCustomizable interface.
        • Added the TiledFile class, replacing exposure of java.io.File instances.
        • Added the TieredMap utility class.
        • Added the getNonDefaultProperties() method to the TiledObject and TiledTile classes.
        • Gave TiledReader its own Logger and exposed it as a static field of the TiledReader class.
        • Made it so TiledResource.getReader() returns the TiledReader that read the object even if the object does not represent a file's top-level structure. Whether a TiledResource represents a top-level structure can still be checked by checking if its getPath() method does not return null.
        • Fixed a bug in which objects' type strings would always be reported as equal to their name strings.
        • Fixed a bug in which TiledReader would be unable to parse a tile with terrain types set at only some of its corners.
        • Removed TiledReader's dependency on JavaFX.
        • Various internal code tweaks and documentation improvements
      • Version 1.0.1
        • Updated to match version 1.4 of the TMX format.
          • Added support for object-type properties.
          • Added support for tileset object alignments.
          • Added support for layer tint colors.
          • Made it so the default Tiled display color for object layers is #A0A0A4.
      • Version 1.0.0
        • Initial release.
    • Older versions
TiledReader is also available from the Central Repository.

Links