Below are described the changes/additions that were made to the :doc:`tmx-map-format` for recent versions of Tiled.
A new :ref:`tmx-chunk` element was added for infinite maps which contains the similar content as :ref:`tmx-data`, except it stores the data of the area specified by its
x
,y
,width
andheight
attributes.:doc:`Templates </manual/using-templates>` were added, a template is an :ref:`external file <tmx-template-files>` referenced by template instance objects:
<object id="3" template="diamond.tx" x="200" y="100"/>
Tilesets can now contain :doc:`Wang tiles </manual/using-wang-tiles>`. They are saved in the new :ref:`tmx-wangsets` element.
- A new :ref:`tmx-group` element was added which is a group layer that can have other layers as child elements. This means layers now form a hierarchy.
- Added Text objects, identified by a new :ref:`tmx-text` element which is used as a child of the :ref:`tmx-object` element.
- Added a :ref:`tile.type <tmx-tileset-tile>` attribute for supporting :ref:`typed-tiles`.
No file format changes.
- Added
color
andfile
as possible values for the :ref:`property.type <tmx-property>` attribute. - Added support for editing multi-line string properties, which are written out differently.
- The :ref:`tmx-property` element gained a
type
attribute, storing the type of the value. Currently supported types arestring
(the default),int
,float
andbool
.
- The
offsetx
andoffsety
attributes are now also used for :ref:`tmx-imagelayer` elements, replacing thex
andy
attributes previously used. This change was made for consistency with the other layer types. - The tiles in an image collection tileset are no longer guaranteed to be consecutive, because removing tiles from the collection will no longer change the IDs of other tiles.
- The pure XML and Gzip-compressed tile layer data formats were deprecated, since they didn't have any advantage over other formats. Remaining formats are CSV, base64 and Zlib-compressed layer data.
- Added
columns
attribute to the :ref:`tmx-tileset` element, which specifies the number of tile columns in the tileset. For image collection tilesets it is editable and is used when displaying the tileset. - The
backgroundcolor
attribute of the :ref:`tmx-map` element will now take the format#AARRGGBB
when its alpha value differs from 255. Previously the alpha value was silently discarded.
- Added optional
offsetx
andoffsety
attributes to thelayer
andobjectgroup
elements. These specify an offset in pixels that is to be applied when rendering the layer. The default values are 0.
- Added an optional
tilecount
attribute to thetileset
element, which is written by Tiled to help parsers determine the amount of memory to allocate for tile data.
- Previously tile objects never had
width
andheight
properties, though the format technically allowed this. Now these properties are used to store the size the image should be rendered at. The default values for these attributes are the dimensions of the tile image.
- Added
hexagonal
to the supported values for theorientation
attribute on themap
element. This also addsstaggerindex
(even
orodd
) andstaggeraxis
(x
ory
) andhexsidelength
(integer value) attributes to themap
element, in order to support the many variations of staggered hexagonal. The newstaggerindex
andstaggeraxis
attributes are also supported when using thestaggered
map orientation. - Added an
id
attribute to theobject
element, which stores a map-unique ID of the object. - Added a
nextobjectid
attribute to themap
element, which stores the next available ID for new objects. This number is stored to prevent reuse of the same ID after objects have been removed.
Tile objects can now be horizontally or vertically flipped. This is stored in the
gid
attribute using the same mechanism as for regular tiles. The image is expected to be flipped without affecting its position, same way as flipped tiles.Objects can be rotated freely. The rotation is stored in degrees as a
rotation
attribute, with positive rotation going clockwise.The render order of the tiles on tile layers can be configured in a number of ways through a new
renderorder
property on themap
element. Valid values areright-down
(the default),right-up
,left-down
andleft-up
. In all cases, the map is drawn row-by-row. This is only supported for orthogonal maps at the moment.The render order of objects on object layers can be configured to be either sorted by their y-coordinate (previous behavior and still the default) or simply the order of appearance in the map file. The latter enables manual control over the drawing order with actions that "Raise" and "Lower" selected objects. It is controlled by the
draworder
property on theobjectgroup
element, which can be eithertopdown
(default) orindex
.Tiles can have an
objectgroup
child element, which can contain objects that define the collision shape to use for that tile. This information can be edited in the new Tile Collision Editor.Tiles can have a single looping animation associated with them using an
animation
child element. Each frame of the animation refers to a local tile ID from this tileset and defines the frame duration in milliseconds. Example:<tileset ...> ... <tile id="[n]"> <animation> <frame tileid="0" duration="100"/> <frame tileid="1" duration="100"/> <frame tileid="2" duration="100"/> </animation> </tile> </tileset>
Per-object visibility flag is saved (defaults to 1):
<object visible="0|1">
Terrain information was added to tileset definitions (this is generally not very relevant for games):
<tileset ...> ... <terraintypes> <terrain name="Name" tile="local_id"/> </terraintypes> <tile id="local_id" terrain="[n],[n],[n],[n]" probability="percentage"/> ... </tileset>
There is preliminary support for a "staggered" (isometric) projection (new value for the
orientation
attribute of themap
element).A basic image layer type was added:
<imagelayer ...> <image source="..."/> </imagelayer>
Added ellipse object shape. Same parameters as rectangular objects, but marked as ellipse with a child element:
<object ...> <ellipse/> </object>
Added map property for specifying the background color:
<map ... backgroundcolor="#RRGGBB">
Added initial (non-GUI) support for individual and/or embedded tile images (since there is no way to set this up in Tiled Qt but only in Tiled Java or with pytmxlib, this is not very important to support at the moment):
<tileset ...> <tile id="[n]"> <!-- an embedded image --> <image format="png"> <data encoding="base64"> ... </data> </image> </tile> <tile id="[n]"> <!-- an individually referenced image for a single tile --> <image source="file.png"/> </tile> ... </tileset>
Tilesets can now have custom properties (using the
properties
child element, just like everything else).Tilesets now support defining a drawing offset in pixels, which is to be used when drawing any tiles from that tileset. Example:
<tileset name="perspective_walls" tilewidth="64" tileheight="64"> <tileoffset x="-32" y="0"/> ... </tileset>
Support for tile rotation in 90-degree increments was added by using the third most significant bit in the global tile id. This new bit means "anti-diagonal flip", which swaps the x and y axis when rendering a tile.