---
name: konung-tiled-install
description: >
  Ставит или обновляет расширение Tiled «konung», которое открывает
  оригинальные карты «Князя: Легенды Лесной страны» (Konung.N) прямо в Tiled
  вместе с персонажами, отрядами, кладами и переходами из Game.N и сохраняет
  их обратно, и проверяет, что Tiled его подхватил. Использовать, когда
  пользователь хочет открыть или править карту «Князя» в Tiled, поставить или
  обновить расширение, или Tiled не открывает Konung.N.
---

# Расширение Tiled «konung»

Нужен Tiled 1.12. Файлы игры пользователь берёт из своей копии. Все они должны лежать в одной папке с картой, имена — без учёта регистра.

Расширение читает:
- `GRAPH.RES` и `Objects.res` — без них карта не откроется;
- `Game.0`–`Game.2` — персонажи, отряды, клады, переходы; без них нет групп слоёв `game.K`;
- `FLAMES.RES` — огни; без него нет слоя `flames`;
- `LIGHTS.RES` и `LIGHTS.N` карты — свет; без них нет слоя `lights` (у карт 6, 8 и 46 `LIGHTS.N` нет и в игре);
- exe игры (`konung.res` в RUS, `KONUNG.EXE` в ENG) — снаряжение персонажей и анимации огней; без него персонажи без снаряжения и огней нет.

Пишет расширение `Konung.N`, его `LIGHTS.N` и все `Game.N` рядом с сохраняемой картой. `Game.N` общий для всех карт, поэтому перед правками стоит сделать копию папки игры.

1. **Откуда.** Папка `tiled/konung/` в корне плагина: два уровня вверх от папки этого навыка (`<папка навыка>/../../tiled/konung`). Если работа идёт в клоне re-konung, папка та же, в рабочей копии, и вместо шагов 2–3 хватит `just tiled-install`.
2. **Куда.** Папка расширений Tiled, подпапка `konung`:
   - Windows: `%LOCALAPPDATA%\Tiled\extensions\konung`;
   - macOS: `~/Library/Preferences/Tiled/extensions/konung`;
   - Linux: `${XDG_CONFIG_HOME:-~/.config}/tiled/extensions/konung`.

   Старая папка `konung` заменяется целиком. Если в ней есть файл `VERSION` (стояла версия из релиза), сначала сказать пользователю, что она будет заменена.

   PowerShell:

   ```powershell
   $source = '<корень плагина>/tiled/konung'
   $dest = Join-Path $env:LOCALAPPDATA 'Tiled/extensions/konung'
   if (Test-Path $dest) { Remove-Item -Recurse -Force $dest }
   New-Item -ItemType Directory -Force (Split-Path $dest) | Out-Null
   Copy-Item -Recurse $source $dest
   ```

   bash:

   ```bash
   source="<корень плагина>/tiled/konung"
   case "$(uname)" in
       Darwin) dest="$HOME/Library/Preferences/Tiled/extensions/konung" ;;
       *) dest="${XDG_CONFIG_HOME:-$HOME/.config}/tiled/extensions/konung" ;;
   esac
   rm -rf "$dest" && mkdir -p "$(dirname "$dest")" && cp -r "$source" "$dest"
   ```
3. **Проверить копию.** `git diff --no-index --stat <источник> <назначение>`: пустой вывод — файлы совпадают. Без git — сравнить списки файлов и размеры. В назначении должен быть `konung.mjs`.
4. **Проверить, что Tiled подхватил.** Запущенный Tiled перечитывает расширения сам, перезапуск не нужен. Если есть инструменты tiled-mcp (`tiled_status` отвечает), выполнить `run_script`:

   ```js
   return tiled.mapFormats.filter(name => name.startsWith("konung1-")).length
   ```

   Должно быть 50: расширение регистрирует формат «Князь, карта N» на каждый номер карты. 0 — расширение не загрузилось. Без tiled-mcp — попросить пользователя открыть в Tiled консоль («Вид → Панели → Консоль») и посмотреть, нет ли ошибок загрузки `konung.mjs`.
5. **Открыть карту.** `Konung.N` из папки установленной игры, рядом — файлы из списка выше. Открыть через `tiled_open` с путём к файлу или «Файл → Открыть». Первая карта открывается несколько секунд, дальше ресурсы берутся из кэша.

   `LIGHTS.N` и `Game.N` картами не открываются — будет ошибка размера или неизвестного формата, так и должно быть.

   Проверить слои можно через `run_script`:

   ```js
   return Array.from({ length: map.layerCount }, (_, i) => map.layerAt(i).name)
   ```

   Ожидаются `ground`, `overlay`, `decorations`, `shadows`, `objects`, `flames`, группы `game.0`–`game.2`, затем скрытые `lights`, `foot` и `foot-arrows`. Если `flames`, `game.K` или `lights` нет — рядом с картой не хватает `FLAMES.RES`, exe, `Game.N`, `LIGHTS.RES` или `LIGHTS.N`.

   Если игры нет: нужна своя копия (свой диск или покупка в магазине); других источников не предлагать.
6. **Если не работает.** Показать пользователю ошибку из консоли Tiled как есть.

   Если Tiled падает при закрытии карты, а расширение старое — обновить его. Старые версии теряли тайлсеты при сборке мусора ([mapeditor/tiled#4646](https://github.com/mapeditor/tiled/issues/4646)).

   Если похоже на новый баг Tiled или tiled-mcp — сказать, что не так и как воспроизвести, со ссылкой на репозиторий; не обходить молча.

Как карта раскладывается по слоям и что можно править — `docs/k1/tiled.md` в корне плагина.