New in Tiled 1.1

Using Templates

Any created object can be saved as a template. These templates can then be instantiated elsewhere as objects that inherit the template’s properties. This can save a lot of tedious work of setting up the object type and properties, or even just finding the right tile in the tileset.

Templates are organized into template groups. Template groups can be part of your project and are referred to by the map. You can save them in either XML or JSON format, just like map and tileset files.

Templates Overview

Creating Templates

A template can be created by right clicking on any object in the map and selecting “Save as Template”. You will be asked to choose the name and the template group to save the template to. If the object already has a name the name field will be auto-filled with it.

Template groups can be created from the New Template Group button in the Templates view or from the New Template dialog.

New Template Dialog

Note

You can’t create a template from a tile object that uses a tile from an embedded tileset, because the template group format does not support referring to such tilesets.

The Templates View

Working with templates is done through the Templates view. The Templates view is divided into two parts, the left part is a tree view that shows the loaded template groups and their templates, the right part shows a preview of the selected template.

Creating Template Instances

Shortcut: V

Template instantiation works by either dragging and dropping the template from the list of templates to the map, or by using the “Insert Template” tool by selecting a template and clicking on the map which is more convenient when you want to create many instances.

Creating Instances

Editing Templates

Selecting a template will show an editable preview in the Templates view and will show the template’s properties in the Properties view where they can be edited.

All template instances are linked to their template, so all edits will be immediately reflected upon all the template instances on the map.

Editing Templates

If a property of a template instance is changed, it will be internally marked as an overridden property and won’t be changed when the template changes.

Detaching Template Instances

Detaching a template instance will disconnect it from its template, so any further edits to the template will not affect the detached instance.

To detach an instance, right click on it and select Detach.

Future Extensions

  • Resetting overridden properties individually (#1725).
  • Locking template properties (#1726).
  • Handling wrong file paths (#1732).
  • Managing template groups, e.g. removing a template or a template group (#1723, #1724).