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)

Searching Database…

13K ·GitHub
这是什么?Tiled 是一款免费、通用的瓦片地图编辑器,适用于 RPG、平台跳跃游戏或打砖块类等基于瓦片的游戏。它非常灵活,可以在所有主流操作系统上运行。
它是一个游戏引擎,还是我的游戏只用来读取地图的工具?都不是——Tiled 是一个独立的桌面关卡编辑器。你在里面绘制地图并保存为 TMX 文件,这种格式设计得易于理解,你的基于瓦片的游戏随后就能读取它。
地图大小、瓦片尺寸或图层数量有限制吗?没有——地图可以是任意大小,瓦片尺寸以及可以使用的图层和瓦片数量都不受限制。
它能在 Windows、macOS 和 Linux 上运行吗?可以,三个平台都支持。macOS 和 Windows 的下载文件都经过代码签名——macOS 版本由维护者签名,Windows 安装包则通过 SignPath.io 签名。
我能给地图、图层、瓦片或对象附加自己的数据吗?可以——地图、图层、瓦片和对象都可以设置任意属性,这样你就能把游戏相关的数据直接存进地图文件里。
TMX 格式是什么样的?TMX 是 Tiled 自带的地图格式,设计得易于理解。一张地图可以使用多个图块集(tileset),而且图块集随时都可以修改。
从源码编译 Tiled 最简单的方法是什么?在 Qt Creator 中打开 tiled.qbs 并直接运行该项目即可。也可以在命令行中先运行 qbs setup-toolchains --detect,然后再运行 qbs 来构建;Qbs 还能生成 Visual Studio 2017 项目。
官方下载的文件可以放心使用吗?可以。macOS 版本由维护者 Thorbjørn Lindeijer 以注册 Apple 开发者身份签名,Windows 安装包使用 SignPath.io 提供的免费代码签名,证书来自 SignPath Foundation。
Creator
mapeditor
Size
102.8 MB
Stars
13K
Age
15y
Commits · 90 Days