C++ XSLT Java Python QML QMake Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.tx Added Transifex configuration Jan 27, 2013
dist Qbs: Ship OpenSSL DLLs with Windows releases Aug 18, 2018
docs Merge branch '1.1' Jul 17, 2018
examples Added unique persistent layer IDs May 2, 2018
man tmxrasterizer: Added --size argument and support local file URLs Sep 26, 2016
mime Rename data files to match app-id Mar 4, 2018
qbs/imports Disabled Qt foreach macro everywhere May 16, 2018
snap snap: Added 'network' interface to be able to read news feed Aug 15, 2018
src Merge branch '1.1' Aug 15, 2018
tests Added Wang tiles documentation (#1702) Aug 28, 2017
translations Update tiled_de.ts (#1986) Jul 26, 2018
util/java libtiled-java: Fixed loading maps with multiple external tilesets Mar 7, 2018
.LICENSE-HEADER Updated copyright year in About dialog Feb 7, 2017
.gitattributes Merge branch '0.9' Jul 26, 2013
.gitignore Ignore generated doctrees Dec 12, 2017
.mailmap Updated AUTHORS file Jun 12, 2017
.travis.yml Travis CI: Install Qt 5.6.3 on macOS Aug 14, 2018
AUTHORS Updated AUTHORS file Jun 12, 2017
CONTRIBUTING.md Tweaked donation link Feb 28, 2017
COPYING Updated license information in COPYING file Aug 16, 2015
Doxyfile Free up 'docs' directory for actual documentation May 20, 2015
LICENSE.APACHE Replica Island plugin: Read and write *.bin files Mar 11, 2012
LICENSE.BSD Changed the license of libtiled and tmxviewer from GPL to BSD Dec 27, 2010
LICENSE.GPL Updated the GPLv2 license to its latest version Sep 2, 2012
NEWS.md macOS: Added a small tool to fixup install names Jul 17, 2018
README.md README.md: Removed non-functional LiveEdu.tv badge Jun 5, 2018
appveyor.yml Merge branch '1.1' Jul 19, 2018
org.mapeditor.Tiled.appdata.xml Rename data files to match app-id Mar 4, 2018
org.mapeditor.Tiled.desktop Add an application icon to the snap package Mar 21, 2018
tiled.pri Bumped version to 1.1.6 and updated NEWS.md file Jul 17, 2018
tiled.pro Lowered the minimum supported version of Qt to 5.5 Mar 17, 2018
tiled.qbs Bumped version to 1.1.6 and updated NEWS.md file Jul 17, 2018

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.