Merge pull request #369 from HyPrismTeam/dev

pee-poo-pee check (Bump 3.0.1)

Author: freakdaniel

.github/workflows/build.yml

@@ -105,9 +105,28 @@ jobs:
           sudo apt-get update
           sudo apt-get install -y \
             rpm \
-            libfuse2
-            
+            libfuse2 \
+            flatpak \
+            flatpak-builder
+
+      - name: Prepare Flatpak remotes
+        run: |
+          sudo flatpak remote-add --system --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
+          sudo flatpak remote-add --system --if-not-exists flathub-beta https://dl.flathub.org/beta-repo/flathub-beta.flatpakrepo
+          flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
+          flatpak remote-add --user --if-not-exists flathub-beta https://dl.flathub.org/beta-repo/flathub-beta.flatpakrepo
+
+      - name: Diagnose Flatpak environment
+        run: |
+          echo "=== flatpak --version ==="
+          flatpak --version
+          echo "=== system remotes ==="
+          flatpak remotes --system || true
+          echo "=== system runtimes (25.08 / Electron2) ==="
+          flatpak list --system --runtime | grep -E 'freedesktop|electronjs|25\.08|Electron2' || true
+
       - name: Build Linux ${{ matrix.arch }}
+        continue-on-error: true
         run: |
           chmod +x Scripts/publish.sh
           ./Scripts/publish.sh linux --arch ${{ matrix.arch }}

Docs/English/Development/Contributing.md

@@ -24,7 +24,7 @@
 - Linux package app ID is `io.github.HyPrismTeam.HyPrism`.
 - AppStream metadata is injected for Linux packaging from `Properties/linux/io.github.HyPrismTeam.HyPrism.metainfo.xml`.
 - RPM repack step intentionally strips `/usr/lib/.build-id` payload and does not own system directories (`/`, `/usr`, `/usr/lib`) to avoid install conflicts on Fedora.
-- Flatpak packaging uses runtime/base `24.08`; CI prepares Flathub with `sudo` and installs `org.freedesktop.Platform`, `org.freedesktop.Sdk`, and `org.electronjs.Electron2.BaseApp` at system level before build.
+- Flatpak packaging uses runtime/base `25.08`; CI prepares Flathub remotes at system and user levels so flatpak-builder can install deps, then installs `org.freedesktop.Platform`, `org.freedesktop.Sdk`, and `org.electronjs.Electron2.BaseApp` at system level before build.
 - Linux CI prints Flatpak remotes/runtimes diagnostics to simplify troubleshooting when flatpak-bundler fails.
 
 ## Adding a New Feature

Docs/English/General/Features.md

@@ -6,6 +6,8 @@
 - **Multi-instance support** — Run different game versions, mod configurations, or test setups simultaneously
 - **Instance metadata** — Track installation state, version, patch status, and mod list per instance
 - **Instance deletion** — Clean removal of game files with confirmation
+- **Instance import/export** — Import instances from ZIP archives or PWR patch files, export instances for backup/sharing
+- **PWR file support** — Import full game builds directly from `.pwr` files (official Hytale patch format)
 - **Dashboard quick switcher** — Icon-only current instance selector (left of Play) opens a dropdown with instance icons + names
 
 ## Authentication

Docs/English/Technical/ServicesReference.md

@@ -16,6 +16,7 @@ All services are registered as singletons in `Bootstrapper.cs` and injected via
 - **Mods exact targeting:** mod IPC accepts optional `instanceId`; when provided, it has priority over branch/version to prevent collisions between multiple instances with the same version.
 - **Mods changelog:** `hyprism:mods:changelog` returns the (best-effort) plaintext changelog for a specific CurseForge mod file (`modId` + `fileId`).
 - **Instance operations targeting:** instance delete/saves IPC handlers accept `instanceId` and resolve by GUID first, with branch/version kept only as backward-compatible fallback.
+- **Instance import:** `hyprism:instance:import` supports importing from both ZIP archives and PWR patch files. ZIP files are extracted directly; PWR files are applied using Butler to create a new instance with auto-detected version from filename.
 - **Instance icon refresh:** `hyprism:instance:getIcon` returns a cache-busted file URL (`?v=<lastWriteTicks>`) so updated logos appear immediately after overwrite.
 - **Frontend icon loading rule:** instance list icon requests are executed sequentially (not in parallel) to avoid mixed responses on shared IPC reply channels.
 - **Launcher updater IPC:**
@@ -135,4 +136,4 @@ All services are registered as singletons in `Bootstrapper.cs` and injected via
 - **Mods storage policy:** profile switching does not redirect `UserData/Mods` to `Profiles/.../Mods`; mods remain instance-local.
 - **Profile folder format:** profile folders are stored under `Profiles/{profileId}` (GUID).
 - **Legacy migration:** launcher attempts to migrate legacy name-based profile folders in `Profiles/` to ID-based layout at startup (best-effort, non-destructive merge when both folders exist).
-- **Official profile auth routing:** switching to an official profile automatically sets auth domain to `sessionserver.hytale.com`.
+- **Official profile auth routing:** switching to an official profile automatically sets auth domain to `sessions.hytale.com`.

Docs/Russian/Development/Contributing.md

@@ -24,7 +24,7 @@
 - Linux package app ID: `io.github.HyPrismTeam.HyPrism`.
 - AppStream-метаданные для Linux-пакетов берутся из `Properties/linux/io.github.HyPrismTeam.HyPrism.metainfo.xml`.
 - На этапе repack для RPM намеренно удаляется payload `/usr/lib/.build-id`, а системные директории (`/`, `/usr`, `/usr/lib`) не добавляются как владельцы пакета — это предотвращает конфликты установки на Fedora.
-- Для Flatpak используется runtime/base `24.08`; в CI перед сборкой Flathub подключается через `sudo`, а `org.freedesktop.Platform`, `org.freedesktop.Sdk` и `org.electronjs.Electron2.BaseApp` устанавливаются на system-уровень.
+- Для Flatpak используется runtime/base `25.08`; в CI remotes Flathub добавляются на system и user уровнях, чтобы flatpak-builder мог ставить зависимости, после чего `org.freedesktop.Platform`, `org.freedesktop.Sdk` и `org.electronjs.Electron2.BaseApp` устанавливаются на system-уровень.
 - Linux CI выводит диагностику remotes/runtimes Flatpak, чтобы быстрее разбирать сбои flatpak-bundler.
 
 ## Добавление новой функции

Docs/Russian/General/Features.md

@@ -6,6 +6,8 @@
 - **Поддержка нескольких экземпляров** — Запускайте разные версии игры, конфигурации модов или тестовые сборки одновременно
 - **Метаданные экземпляра** — Отслеживание состояния установки, версии, статуса патчей и списка модов для каждого экземпляра
 - **Удаление экземпляра** — Полное удаление файлов игры с подтверждением
+- **Импорт/экспорт экземпляров** — Импортируйте экземпляры из ZIP-архивов или PWR-файлов, экспортируйте для резервного копирования/обмена
+- **Поддержка PWR-файлов** — Импорт полных сборок игры напрямую из `.pwr` файлов (официальный формат патчей Hytale)
 
 ## Аутентификация
 

Docs/Russian/Technical/ServicesReference.md

@@ -15,6 +15,7 @@
 - **Точное нацеливание модов:** mod IPC принимает опциональный `instanceId`; если он передан, он имеет приоритет над branch/version и исключает коллизии при нескольких экземплярах с одной версией.
 - **Changelog модов:** `hyprism:mods:changelog` возвращает (best-effort) plaintext changelog для конкретного файла модификации CurseForge (`modId` + `fileId`).
 - **Нацеливание instance-операций:** обработчики удаления инстанса и работы с сейвами принимают `instanceId` и в первую очередь резолвят путь по GUID; branch/version сохранён как fallback для обратной совместимости.
+- **Импорт экземпляров:** `hyprism:instance:import` поддерживает импорт из ZIP-архивов и PWR-файлов. ZIP-файлы распаковываются напрямую; PWR-файлы применяются через Butler для создания нового экземпляра с автоопределением версии из имени файла.
 - **Обновление иконок инстанса:** `hyprism:instance:getIcon` возвращает URL файла с cache-busting параметром (`?v=<lastWriteTicks>`), чтобы новый логотип отображался сразу после перезаписи.
 - **Правило загрузки иконок на фронтенде:** в списке инстансов запросы иконок выполняются последовательно (не параллельно), чтобы исключить смешивание ответов в общем IPC reply-канале.
 
@@ -119,4 +120,4 @@
 - **Политика хранения модов:** переключение профиля не перенаправляет `UserData/Mods` в `Profiles/.../Mods`; моды остаются в папке выбранного экземпляра.
 - **Формат папок профилей:** профили хранятся в `Profiles/{profileId}` (GUID).
 - **Миграция legacy-формата:** при старте лаунчер пытается мигрировать старые name-based папки в `Profiles/` в ID-based формат (best-effort, неразрушающее объединение при наличии обеих папок).
-- **Маршрутизация auth для official-профиля:** при переключении на официальный профиль домен аутентификации автоматически устанавливается в `sessionserver.hytale.com`.
+- **Маршрутизация auth для official-профиля:** при переключении на официальный профиль домен аутентификации автоматически устанавливается в `sessions.hytale.com`.

Frontend/package-lock.json

@@ -9,6 +9,7 @@
     "preview": "vite preview"
   },
   "dependencies": {
+    "flag-icons": "^7.5.0",
     "framer-motion": "^11.0.0",
     "i18next": "^25.7.4",
     "lucide-react": "^0.300.0",