XML file contents

XML resource files must contain a document-level tag <resource>:

<?xml version="1.0"?>
<resource>
 ...
</resource>

You may draw in other resource files by using the <requires> tag:

<requires file="road-tiles.xml" />

This will load "road-tiles.xml" into the resource's namespace. If you wish to avoid id clashes you may supply a namespace:

<requires file="road-tiles.xml" namespace="road" />

If a namespace is given then the element ids from the "road-tiles.xml" will be prefixed by the namespace and a period, e.g. "road:bitumen".

Other tags within <resource> are:

<image file="" id="">

Loads file with pyglet.image.load and gives it the id which is used by tiles to reference the image.

<imageatlas file="" [id="" size="x,y"]>

Sets up an image atlas for child <image> tags to use. Child tags are of the form:

<image offset="" id="" [size=""]>

If the <imageatlas> tag does not provide a size attribute then all child <image> tags must provide one. Image atlas ids are optional as they are currently not reference directly.

<tileset id="">

Sets up a TileSet object. Child tags are of the form:

<tile id="">
  [<image ...>]
</tile>

The <image> tag is optional; these tiles may have only properties (or be completely empty). The id is used by maps to reference the tile.

<rectmap id="" tile_size="" [origin=""]>

Sets up a RectMap object. Child tags are of the form:

<column>
 <cell tile="" />
</column>