
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](https://www.mapeditor.org). 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:

```bash
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.
