Contribute on GitHub

# Editing Maps

WIP ⚠️

This guide is still a work in progress!

# How to use Tiled

Tiled (opens new window) is a complicated piece of open source software! It does a lot of powerful things, but there are a few main features you'll need to make use of authoring your first TwilioQuest mission.


TwilioQuest supports Tiled version 1.8.X of lower. The 1.9.X Tiled update changed file formats so is currently incompatible.

This video introduces the basics of editing tiles, objects, and layers in an older version of Tiled. Most of these features have been core to Tiled for a long time and should be similar to the latest version.

This video is part of a multi-part series (opens new window) that you can follow to learn more about advanced Tiled features.

Tiled also has a comprehensive set of documentation (opens new window), an active Discord (opens new window), and forum (opens new window) community you can reach out to with questions.


If you're looking to create a new map, we recommend that you copy the provided one in the twilioquest-extension-template (opens new window) rather than make a new one from Tiled. This will keep all your layers and tilesets configured.

# Layers and Tiles

Tiles are the core of how you'll build the static parts of a TwilioQuest map. In Tiled, these are placed within "tile layers" using a variety of tools. These layers function similarly to layers in painting programs like Adobe Photoshop.

Tiled docs on working with layers (opens new window) and editing tile layers (opens new window).

Layers can have a few special properties that TwilioQuest will consume to treat them differently. These properties are:

  • collision - If this is set to true, then the tiles in this layer will prevent the player from passing through them. There is usually a main Collision tile layer with this property.

  • hidden - When set to true, this tile layer will not be rendered visually to the player. The Collision layer should have this property set as well.

  • useCollisionMasks - This is a more advanced feature that will let the tiles in a tile layer use the Tiled Collision Editor to specify a custom collision box. This can be useful if tiles do not visually sit on the tile grid.

# Tilesets

This is a short video documenting how to create a Tileset in Tiled from a tilesheet image.

# Objects and Properties

Objects are important for accomplishing the various dynamic parts of TwilioQuest. This includes things like non player characters, laser barriers, and more!

Objects live within a special type of layer called an "object layer". Generally, each TwilioQuest map has a single object layer where every object lives. This layer is conventionally called Objects.

Both built-in objects and custom objects can be added to this layer. They will have properties that can be tweaked for different effects depending on the object.

These are a few important built-in objects that essentially every map will use:

  • Player Entry Point - controls player spawn point
  • Terminal - launches an objective for the player to complete
  • Laser Barrier - blocks a player's progression until a specific objective is completed
  • Exit - transports a player between maps, you'll at least need one to take your player back to the Fog Owl after they play your mission.

Tiled docs on working with objects (opens new window) and editing properties of objects (opens new window).