Skip to content
A generic tile map editor
C++ XSLT Java Python QML QMake Other
Branch: master
Clone or download
Pull request Compare This branch is 23 commits ahead, 761 commits behind bjorn:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.tx
dist
docs
examples
man
mime
qbs/imports
snap
src
tests
translations
util/java
.LICENSE-HEADER
.gitattributes
.gitignore
.mailmap
.travis.yml
AUTHORS
CONTRIBUTING.md
COPYING
Doxyfile
LICENSE.APACHE
LICENSE.BSD
LICENSE.GPL
NEWS.md
README.md
appveyor.yml
org.mapeditor.Tiled.appdata.xml
org.mapeditor.Tiled.desktop
tiled.pri
tiled.pro
tiled.qbs

README.md

Tiled Map Editor - http://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 Status Build status Bountysource Translation status

About the Qt Version

Tiled was originally written in Java. In 2008, work began to develop a faster, better looking, and easier-to-use version of Tiled based on the Qt framework. This decision was made as the Qt framework has a greater feature set than is offered by the standard Java libraries.

Compiling

Before you can compile Tiled, you must ensure the Qt (>= 5.6) development libraries have been installed:

  • On Ubuntu/Debian: apt-get install qt5-default qttools5-dev-tools zlib1g-dev
  • On Fedora: sudo dnf builddep tiled
  • On Arch Linux: pacman -S qt
  • On Mac OS X with Homebrew:
    • brew install qt5
    • brew link qt5 --force
  • Alternatively, you can download Qt here

Next, compile by running:

$ qmake (or qmake-qt5 on some systems)
$ make

To perform a shadow build, run qmake from a different directory and refer it to tiled.pro. For example:

$ mkdir build
$ cd build
$ qmake ../tiled.pro
$ make

You can now run Tiled using the executable in bin/tiled.

Installing

To install Tiled, run make install from the terminal. By default, Tiled will install itself to /usr/local.

The installation prefix can be changed when running qmake, or by changing the install root when running make install. For example, to use an installation prefix of /usr instead of /usr/local:

$ qmake -r PREFIX=/usr

Note: The -r recursive flag is required if you've run qmake before, as this command will affect nested pro files)

To install Tiled to a packaging directory:

$ make 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 a Tiled map for distribution, the Rpath should be disabled by appending RPATH=no to the qmake command.

You can’t perform that action at this time.