tiled

A flexible level editor

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 Status
Build status
Snap 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 as well as the Qbs build tool:

  • On Ubuntu/Debian: sudo apt install qt5-default qttools5-dev-tools zlib1g-dev qtdeclarative5-dev qbs
  • On Fedora: sudo dnf builddep tiled
  • On Arch Linux: sudo pacman -S qt qbs
  • On macOS with Homebrew:
    • brew install qbs
    • brew link qt5 --force

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:

  • On Ubuntu/Debian: sudo apt install build-essential zlib1g-dev libgl1-mesa-dev
  • On Windows: Choose "MinGW" Qt version, or install Visual Studio
  • On macOS: Install Xcode

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 setup-qt --detect             # setup Qt (not needed since Qbs 1.13)
qbs                               # build Tiled

You can now run Tiled as follows:

qbs run -p tiled

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

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.

主要指标

概览
名称与所有者mapeditor/tiled
主编程语言C++
编程语言QMake (语言数: 9)
平台
许可证Other
所有者活动
创建于2011-02-27 15:18:22
推送于2025-04-17 19:22:54
最后一次提交2025-04-09 14:12:46
发布数97
最新版本名称v1.11.2 (发布于 2025-01-28 10:49:41)
第一版名称v0.1.0 (发布于 )
用户参与
星数11.7k
关注者数352
派生数1.8k
提交数6.9k
已启用问题?
问题数2484
打开的问题数695
拉请求数811
打开的拉请求数48
关闭的拉请求数302
项目设置
已启用Wiki?
已存档?
是复刻?
已锁定?
是镜像?
是私有?