disabled downloads when no mirrors + official account present, notification for users that they need mirrors to download the game, and name improvement

Author: yyyumeniku

Docs/English/Technical/ServicesReference.md

@@ -16,7 +16,6 @@ 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:**
@@ -136,4 +135,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 `sessions.hytale.com`.
+- **Official profile auth routing:** switching to an official profile automatically sets auth domain to `sessionserver.hytale.com`.

Docs/English/User/Configuration.md

@@ -74,6 +74,7 @@ Access settings through the **Settings** page (gear icon in sidebar).
 - If official download is unavailable, launcher automatically tests available mirrors and uses the best reachable one.
 - Mirror choice is not persisted as a user setting.
 - Mirrors are defined by JSON meta files in the `Mirrors/` folder (see [Custom Mirrors](#custom-mirrors) below).
+- If no download sources are available, the Dashboard will show a **No Download Sources** warning when you click **Download** or **Play**.
 
 ## Custom Mirrors
 

Docs/Russian/User/Configuration.md

@@ -72,6 +72,7 @@ HyPrism хранит свою конфигурацию в файле `config.jso
 - Если official-загрузка недоступна, лаунчер автоматически тестирует доступные зеркала и выбирает лучшее.
 - Выбор зеркала не сохраняется как пользовательская настройка.
 - Зеркала определяются JSON мета-файлами в папке `Mirrors/` (см. [Пользовательские зеркала](#пользовательские-зеркала) ниже).
+- Если доступных источников нет, на Dashboard при нажатии **Download** или **Play** будет показано предупреждение **No Download Sources**.
 
 ## Пользовательские зеркала
 

Frontend/src/App.tsx

@@ -204,7 +204,21 @@ const App: React.FC = () => {
   const officialServerBlocked = isOfficialServerMode && !isOfficialProfile;
 
   // Download sources state
-  const [hasDownloadSources, setHasDownloadSources] = useState<boolean>(true);
+  const [enabledMirrorCount, setEnabledMirrorCount] = useState<number>(0);
+  const [hasOfficialAccount, setHasOfficialAccount] = useState<boolean>(false);
+  const hasDownloadSources = enabledMirrorCount > 0 || (hasOfficialAccount && isOfficialProfile);
+
+  const refreshDownloadSources = useCallback(async () => {
+    try {
+      const sourcesResult = await ipc.settings.hasDownloadSources();
+      setEnabledMirrorCount(typeof sourcesResult.enabledMirrorCount === 'number' ? sourcesResult.enabledMirrorCount : 0);
+      setHasOfficialAccount(!!sourcesResult.hasOfficialAccount);
+    } catch (e) {
+      console.error('Failed to check download sources:', e);
+      setEnabledMirrorCount(0);
+      setHasOfficialAccount(false);
+    }
+  }, []);
 
   // Background, news, and accent color settings
   // Initialize as null to prevent flash — don't render background until config is loaded
@@ -392,6 +406,8 @@ const App: React.FC = () => {
     setAvatarRefreshTrigger(prev => prev + 1);
     // Update official profile status
     await refreshOfficialStatus();
+    // Refresh download source availability (mirrors / official)
+    await refreshDownloadSources();
   };
 
   // Refresh official server/profile status for play-button blocking
@@ -499,13 +515,7 @@ const App: React.FC = () => {
         }
 
         // Load download sources status
-        try {
-          const sourcesResult = await ipc.settings.hasDownloadSources();
-          setHasDownloadSources(sourcesResult.hasDownloadSources);
-        } catch (e) {
-          console.error('Failed to check download sources:', e);
-          setHasDownloadSources(false);
-        }
+        await refreshDownloadSources();
       } catch (e) {
         console.error('Failed to load settings:', e);
       }
@@ -689,6 +699,12 @@ const App: React.FC = () => {
     };
   }, []);
 
+  // Re-check download sources when navigating back from Settings (e.g. mirrors added/removed)
+  useEffect(() => {
+    if (currentPage === 'settings') return;
+    void refreshDownloadSources();
+  }, [currentPage, refreshDownloadSources]);
+
   const handlePlay = async () => {
     // Prevent launching if game is already running or download is in progress
     if (isGameRunning) {
@@ -1077,7 +1093,10 @@ const App: React.FC = () => {
               rosettaWarning={rosettaWarning}
               onBackgroundModeChange={(mode) => setBackgroundMode(mode)}
               onInstanceDeleted={handleInstanceDeleted}
-              onAuthSettingsChange={refreshOfficialStatus}
+              onAuthSettingsChange={async () => {
+                await refreshOfficialStatus();
+                await refreshDownloadSources();
+              }}
               onNavigateToMods={() => {
                 setCurrentPage('instances');
               }}

Frontend/src/assets/locales/be-BY.json

@@ -492,11 +492,11 @@
       "authError": "Падчас уваходу адбылася памылка. Калі ласка, паспрабуйце яшчэ раз.",
       "noHytaleProfile": "Ваш уліковы запіс Hytale яшчэ не мае гульнявых профіляў. Гульнявы профіль будзе створаны пры першым доступе да гульні.",
       "nameTitle": "Выберыце мянушку",
-      "nameDesc": "Выберыце імя для вашага афлайн-профілю (3-13 сімвалаў, англійскія літары, лічбы, - і _)",
+      "nameDesc": "Выберыце імя для вашага афлайн-профілю (3-16 сімвалаў, англійскія літары, лічбы, - і _)",
       "namePlaceholder": "Увядзіце мянушку...",
       "characters": "сімвалаў",
       "nickRules": "Толькі A-Z, 0-9, - і _",
-      "nickInvalid": "Мянушка павінна мець 3-13 сімвалаў: англійскія літары, лічбы, дэфіс або падкрэсленне.",
+      "nickInvalid": "Мянушка павінна мець 3-16 сімвалаў: англійскія літары, лічбы, дэфіс або падкрэсленне.",
       "create": "Стварыць профіль",
       "createFailed": "Не ўдалося стварыць профіль. Калі ласка, паспрабуйце яшчэ раз.",
       "createError": "Падчас стварэння профілю адбылася памылка."

Frontend/src/assets/locales/de-DE.json

@@ -492,11 +492,11 @@
       "authError": "Bei der Anmeldung ist ein Fehler aufgetreten. Bitte versuche es erneut.",
       "noHytaleProfile": "Dein Hytale-Konto hat noch keine Spielprofile. Ein Spielprofil wird beim ersten Spielzugang erstellt.",
       "nameTitle": "Spitznamen wählen",
-      "nameDesc": "Wähle einen Namen für dein Offline-Profil (3-13 Zeichen, englische Buchstaben, Ziffern, - und _)",
+      "nameDesc": "Wähle einen Namen für dein Offline-Profil (3-16 Zeichen, englische Buchstaben, Ziffern, - und _)",
       "namePlaceholder": "Spitznamen eingeben...",
       "characters": "Zeichen",
       "nickRules": "Nur A-Z, 0-9, - und _",
-      "nickInvalid": "Spitzname muss 3-13 Zeichen lang sein: englische Buchstaben, Ziffern, Bindestrich oder Unterstrich.",
+      "nickInvalid": "Spitzname muss 3-16 Zeichen lang sein: englische Buchstaben, Ziffern, Bindestrich oder Unterstrich.",
       "create": "Profil erstellen",
       "createFailed": "Profil konnte nicht erstellt werden. Bitte versuche es erneut.",
       "createError": "Beim Erstellen des Profils ist ein Fehler aufgetreten."

Frontend/src/assets/locales/en-US.json

@@ -511,11 +511,11 @@
       "authError": "An error occurred during sign-in. Please try again.",
       "noHytaleProfile": "Your Hytale account has no game profiles yet. A game profile will be created when you first access the game.",
       "nameTitle": "Choose a Nickname",
-      "nameDesc": "Pick a name for your offline profile (3-13 characters, English letters, digits, - and _)",
+      "nameDesc": "Pick a name for your offline profile (3-16 characters, English letters, digits, - and _)",
       "namePlaceholder": "Enter nickname...",
       "characters": "characters",
       "nickRules": "A-Z, 0-9, - and _ only",
-      "nickInvalid": "Nickname must be 3-13 characters: English letters, digits, dash or underscore.",
+      "nickInvalid": "Nickname must be 3-16 characters: English letters, digits, dash or underscore.",
       "create": "Create Profile",
       "createFailed": "Failed to create profile. Please try again.",
       "createError": "An error occurred while creating the profile."

Frontend/src/assets/locales/es-ES.json

@@ -492,11 +492,11 @@
       "authError": "Ocurrió un error durante el inicio de sesión. Por favor, inténtalo de nuevo.",
       "noHytaleProfile": "Tu cuenta de Hytale aún no tiene perfiles de juego. Se creará un perfil de juego cuando accedas al juego por primera vez.",
       "nameTitle": "Elige un Apodo",
-      "nameDesc": "Elige un nombre para tu perfil sin conexión (3-13 caracteres, letras inglesas, dígitos, - y _)",
+      "nameDesc": "Elige un nombre para tu perfil sin conexión (3-16 caracteres, letras inglesas, dígitos, - y _)",
       "namePlaceholder": "Introduce apodo...",
       "characters": "caracteres",
       "nickRules": "Solo A-Z, 0-9, - y _",
-      "nickInvalid": "El apodo debe tener 3-13 caracteres: letras inglesas, dígitos, guion o guion bajo.",
+      "nickInvalid": "El apodo debe tener 3-16 caracteres: letras inglesas, dígitos, guion o guion bajo.",
       "create": "Crear Perfil",
       "createFailed": "Error al crear el perfil. Por favor, inténtalo de nuevo.",
       "createError": "Ocurrió un error al crear el perfil."

Frontend/src/assets/locales/fr-FR.json

@@ -492,11 +492,11 @@
       "authError": "Une erreur s'est produite lors de la connexion. Réessaie.",
       "noHytaleProfile": "Ton compte Hytale n'a pas encore de profils de jeu. Un profil de jeu sera créé lorsque tu accéderas au jeu pour la première fois.",
       "nameTitle": "Choisis un Pseudo",
-      "nameDesc": "Choisis un nom pour ton profil hors ligne (3-13 caractères, lettres anglaises, chiffres, - et _)",
+      "nameDesc": "Choisis un nom pour ton profil hors ligne (3-16 caractères, lettres anglaises, chiffres, - et _)",
       "namePlaceholder": "Entre un pseudo...",
       "characters": "caractères",
       "nickRules": "A-Z, 0-9, - et _ uniquement",
-      "nickInvalid": "Le pseudo doit contenir 3-13 caractères : lettres anglaises, chiffres, tiret ou underscore.",
+      "nickInvalid": "Le pseudo doit contenir 3-16 caractères : lettres anglaises, chiffres, tiret ou underscore.",
       "create": "Créer le Profil",
       "createFailed": "Échec de la création du profil. Réessaie.",
       "createError": "Une erreur s'est produite lors de la création du profil."

Frontend/src/assets/locales/it-IT.json

@@ -493,11 +493,11 @@
       "authError": "Si è verificato un errore durante l'accesso. Riprova.",
       "noHytaleProfile": "Il tuo account Hytale non ha ancora profili di gioco. Un profilo di gioco verrà creato al primo accesso al gioco.",
       "nameTitle": "Scegli un nickname",
-      "nameDesc": "Scegli un nome per il tuo profilo offline (3-13 caratteri, lettere inglesi, numeri, - e _)",
+      "nameDesc": "Scegli un nome per il tuo profilo offline (3-16 caratteri, lettere inglesi, numeri, - e _)",
       "namePlaceholder": "Inserisci il nickname...",
       "characters": "caratteri",
       "nickRules": "Solo A-Z, 0-9, - e _",
-      "nickInvalid": "Il nickname deve essere di 3-13 caratteri: lettere inglesi, numeri, trattino o underscore.",
+      "nickInvalid": "Il nickname deve essere di 3-16 caratteri: lettere inglesi, numeri, trattino o underscore.",
       "create": "Crea profilo",
       "createFailed": "Impossibile creare il profilo. Riprova.",
       "createError": "Si è verificato un errore durante la creazione del profilo."