IrrMine / Primitiv — обновление TFG 0.13.1 → 0.13.9

Новый exe лаунчера не нужен. После публикации лаунчер скачает новую сборку.
Новой установке очистка не требуется. Для существующей установки выполните
следующие действия ПЕРЕД запуском игры: старый Helios не удаляет устаревшие
файлы KubeJS, ресурсы и предыдущую версию Crash Assistant автоматически.

1. Закройте Minecraft и IrrMine Launcher.
2. Распакуйте этот ZIP в отдельную папку. Оставьте reconcile-client.ps1 и
   client-obsolete-files.json рядом.
3. Найдите папку данных игры, указанную в настройках лаунчера. Внутри неё нужна
   именно папка instances\primitiv-1.20.1 (не common и не папка exe).
4. Сделайте резервную копию этой папки.
5. Откройте PowerShell в папке распакованного ZIP и выполните, заменив путь:

   powershell -NoProfile -ExecutionPolicy Bypass -File .\reconcile-client.ps1 -InstancePath "C:\YOUR_GAME_DATA\instances\primitiv-1.20.1" -Direction upgrade -WhatIf

   Команда покажет, что будет перемещено, без изменений. Если выбрана правильная
   папка, выполните ту же команду без -WhatIf:

   powershell -NoProfile -ExecutionPolicy Bypass -File .\reconcile-client.ps1 -InstancePath "C:\YOUR_GAME_DATA\instances\primitiv-1.20.1" -Direction upgrade

   ExecutionPolicy Bypass действует только для этого запуска PowerShell и не
   меняет постоянные настройки системы.

6. Помощник переместит существующие устаревшие файлы в соседнюю папку
   primitiv-recovery-<дата>. Файлы не удаляются. Карты, сохранения, скриншоты,
   options.txt и прочие файлы вне точного списка не выбираются.
7. Откройте обычный IrrMine Launcher и дождитесь загрузки обновления.
   Сервер: irrmine.ru:25650.

Ручной способ: client-obsolete-files.json содержит массив upgrade с 91 путём,
относительным к instances\primitiv-1.20.1. При закрытой игре переместите только
существующие файлы из этого списка в резервную папку, сохраняя структуру каталогов.
Не удаляйте целиком папки config, saves, XaeroWaypoints или пользовательские карты.

Откат (ТОЛЬКО после объявления администратора об откате сервера): повторите
очистку с -Direction downgrade, затем запустите лаунчер для загрузки 0.13.1.
Не запускайте downgrade против действующего сервера 0.13.9.

Помощник проверен на тестовых файлах через PowerShell 7.6.5 под Linux:
предпросмотр, перенос в резервную папку, сохранность посторонних файлов и
повторный запуск прошли проверку. Он ещё не проверен на реальной Windows-
установке и с реальным входом в игру. Сначала используйте -WhatIf и резервную копию. Сообщите администратору
о проблемах входа, инвентаря, заданий или механизмов.
