Skip to main content
View

Install and configure Tiled

Pokémon Studio does not bundle Tiled: it launches the copy installed on the machine, both to open a map and to render the map overviews it displays. It therefore needs the exact path to that installation, and what it expects there differs on Windows, Linux and macOS. This page covers installing Tiled and declaring its path correctly.

Install Tiled​

Tiled is downloaded from its official website. It is free, and available for Windows, Linux and macOS.

Install it in its default location. A portable copy extracted to a temporary folder works until that folder is cleaned up, at which point Pokémon Studio loses the editor without any obvious explanation.

Why Pokémon Studio needs the path​

Three features depend on it:

  • Opening a map. The Open with Tiled action launches the editor on the .tmx file of the selected map.
  • Updating maps. Update modified maps re-reads your .tmx files and rebuilds what the engine loads. Without the path, its button is greyed out, and with it the whole edit-and-test loop.
  • Rendering map previews. The image shown in a map's Map tab is produced by a tool that ships with Tiled, not by Studio. Without the path, the Generate map overview button is greyed out too.

A greyed-out button shows Tiled installation path must be specified in the application settings. when you hover it. A wrong path is worse than no path: the buttons stay active and the failures say nothing useful.

Declare the path in Pokémon Studio​

The setting lives in Settings, under Integrations, on the Map management page. Drop the file on the Tiled installation path field, or click it to browse.

Windows​

Point at the Tiled executable itself, not at its folder. The file must be tiled.exe, typically:

C:\Program Files\Tiled\tiled.exe

Studio checks the filename and rejects anything else with The Tiled installation path chosen is invalid.

Linux​

Point at the Tiled AppImage if that is how Tiled was installed, or at the tiled binary for a package-manager installation.

macOS​

Point at the Tiled application in the Applications folder.

Check that it works​

Open any map with Open with Tiled. If the editor starts on the right .tmx, the path is valid. If Studio reports The Tiled installation path has not been configured., the field is still empty and the Configure installation path button takes you straight to the right settings page.

Conclusion​

  • Tiled is installed separately and downloaded from mapeditor.org; Pokémon Studio only launches it.
  • The path is declared in Settings, Integrations, Map management, field Tiled installation path.
  • On Windows the field expects the tiled.exe file, on Linux the AppImage or the binary, on macOS the application bundle.
  • Without the path, opening a map, updating maps and generating previews are all disabled.
  • Installing in a temporary or portable folder works until that folder disappears.