tiled README

The project's README from github.com/mapeditor/tiled. As one markdown file: README.md.

Tiled Map Editor - https://www.mapeditor.org/

About Tiled

Tiled is a general purpose tile map editor for all tile-based games, such as RPGs, platformers or Breakout clones.

Tiled is highly flexible. It can be used to create maps of any size, with no restrictions on tile size, or the number of layers or tiles that can be used. Maps, layers, tiles, and objects can all be assigned arbitrary properties. Tiled's map format (TMX) is easy to understand and allows multiple tilesets to be used in any map. Tilesets can be modified at any time.

Build Packages Build status Snap Translation status Open Source Helpers

Installing Tiled

Tiled is available for all major operating systems and can be downloaded either from GitHub Releases or from itch.io. Most Linux distributions also package Tiled, but these packages are usually out of date so you might prefer to use the AppImage or install Tiled through Flatpak or snap, both of which are official releases.

Signed Releases for macOS and Windows

macOS builds are signed by the maintainer, Thorbjørn Lindeijer, who registered as Apple Developer.

Windows installers are using free code signing provided by SignPath.io, and a free code signing certificate by the SignPath Foundation.

Compiling Tiled

Before you can compile Tiled, you must ensure the Qt (>= 6.2) development libraries have been installed as well as the Qbs build tool:

If you want to build the Python plugin, you additionally need to install the Python 3 development libraries:

Alternatively, you can download Qt here. You will still need to install a development environment alongside and some libraries depending on your system, for example:

The easiest way to compile and run Tiled is to open tiled.qbs in Qt Creator and run the project from there.

From the command-line, you may need to set up Qbs before you can build Tiled (you will also need to make sure the version of Qt you want to use is in your path):

qbs setup-toolchains --detect     # setup toolchains
qbs                               # build Tiled

You can now run Tiled as follows:

qbs run -p tiled

Qt 6

For compiling libtiledquick (not built by default) you'll need to install the Vulkan headers:

Working with Visual Studio 2017

Once Qbs is set up (see previous instructions), it is possible to generate a Visual Studio 2017 project with it that allows you to code, compile and run using that IDE. This can be done with the following command:

qbs generate -g visualstudio2017

Installing Self-Compiled Tiled

To install Tiled, run qbs install from the terminal. By default, Tiled will be installed to <build-dir>/install-root.

The installation prefix can be changed when building Tiled. For example, to use an installation prefix of /usr:

qbs qbs.installPrefix:"/usr"

To install Tiled to a packaging directory:

qbs install --install-root /tmp/tiled-pkg

By default, Tiled and its plugins are compiled with an Rpath that allows them to find the shared libtiled library immediately after being compiled. When packaging Tiled for distribution, the Rpath should be disabled by appending projects.Tiled.useRPaths:false to the qbs command.

tiled (mapeditor/tiled)

qt
Searching Database…

13K ·GitHub
Tiled
What is this?Tiled is a free, general-purpose tile map editor for tile-based games such as RPGs, platformers, or Breakout clones. It is highly flexible and runs on all major operating systems.
Is it a game engine, or something my game just loads maps from?Neither — Tiled is a standalone desktop level editor. You draw maps in it and save them as TMX files, a format designed to be easy to understand, which your tile-based game then reads.
Are there limits on map size, tile size, or layer count?No — maps can be of any size, with no restrictions on tile size or the number of layers and tiles you can use.
Does it work on Windows, macOS, and Linux?Yes, all three. The macOS and Windows downloads are code-signed — macOS builds by the maintainer, Windows installers via SignPath.io.
Can I attach my own data to maps, layers, tiles, or objects?Yes — maps, layers, tiles, and objects can all be assigned arbitrary properties, so you can store game-specific data directly in the map file.
What is the TMX format like?TMX is Tiled's own map format, designed to be easy to understand. A single map can use multiple tilesets, and tilesets can be modified at any time.
What is the easiest way to compile Tiled from source?Open tiled.qbs in Qt Creator and run the project from there. From the command line, run qbs setup-toolchains --detect and then qbs to build; Qbs can also generate a Visual Studio 2017 project.
Are the official downloads safe to trust?Yes. macOS builds are signed by maintainer Thorbjørn Lindeijer as a registered Apple Developer, and Windows installers use free code signing from SignPath.io with a certificate from the SignPath Foundation.
What are similar projects?OpenRCT2, openage, luanti, tdesktop, Cataclysm-DDA, aseprite, buzz, ytDownloader
Which topics is it in?snap, 2d, appimage, flatpak, qt, c-plus-plus, game-development, editor, game, cpp, c++, hacktoberfest
Creator
mapeditor
Size
102.8 MB
Stars
13K
Updated
CommitOct 18Releasev1.12.2May 27
Age
15y
Commits · 90 Days