Release Stable Build v2.0.11 (#119)

* Add electron-updater auto-update support - Install electron-updater package - Configure GitHub releases publish settings - Create AppUpdater class with full update lifecycle - Integrate auto-update into main.js - Add comprehensive documentation (AUTO-UPDATES.md, TESTING-UPDATES.md) - Set up dev-app-update.yml for testing * Add cache clearing documentation for electron-updater - Introduced CLEAR-UPDATE-CACHE.md to guide users on clearing the electron-updater cache across macOS, Windows, and Linux. - Added programmatic method for cache clearing in JavaScript. - Enhanced update handling in main.js and preload.js to support new update events. - Updated GUI styles for download buttons and progress indicators in update.js and style.css. * Update auto-update UI and configuration - Fix version display (newVersion field) - Add download progress bar with real-time updates - Reorder buttons: Install & Restart (primary), Manually Download (secondary) - Update dev-app-update.yml to point to fork - Update package.json version to 2.0.2 * Add installation effects and draggable progress bar Introduces animated installation effects overlay and makes the progress bar draggable. Adds maximize window support, improves window controls styling, and enforces a single app instance. Removes the unused Skins page and related translations. Refines various UI details for a more polished user experience. * Adjust news card aspect ratio and add Play tab style Set a default aspect ratio for .news-card and add a specific style for the LATEST NEWS section in the Play tab to override the aspect ratio and use full height. * Add splash screen to launcher startup Introduced a new splash screen (splash.html) and updated main.js to display it on startup before loading the main window. The splash screen is shown for 2.5 seconds as a placeholder for future loading logic, improving user experience during application launch. * Display launcher version in UI Adds a version display element to the bottom right of the UI, fetching the version from package.json via a new IPC handler. Updates main.js, preload.js, and ui.js to support retrieving and displaying the version, and adds relevant styles in style.css. * Custom Mod loading fix (#92) * feat: Add Repair Game functionality including UserData backup and cache clearing * feat: Add In-App Logs Viewer and Logs Folder shortcut * feat: Add Open Logs feature * disable dev tools * Fix Settings UI * Implement custom mod loading, autoimport, auto repair * Fixed Custom Mod loading issues and merge issues * feat: Externalize sensitive API keys and Discord client ID into environment variables using dotenv. * feat(mods): add profile-based mod management and auto-repair * feat: add 'Close launcher on game start' option and improve app termination behavior (#93) * update main branch to release/v2.0.2b (#86) * add more linux pkgs, create auto-release and pre-release feature for Github Actions * removed package-lock from gitignore * update .gitignore for local build * add package-lock.json to maintain stability development * update version to 2.0.2b also add deps for rpm and arch * update 2.0.2b: add arm64 support, product and executable name, maintainers; remove snap; * update 2.0.2b: add latest.yml for win & linux, arm64 support; remove snap * fix release build naming * Prepare release v2.0.2b * feat: add 'Close launcher on game start' option and improve app termination behavior - Added 'Close launcher on game start' setting in GUI and backend. - Implemented automatic app quit after game launch if setting is enabled. - Added Cmd+Q (Mac) and Ctrl+Q/Alt+F4 (Win/Linux) shortcuts to quit the app. - Updated 'window-close' handler to fully quit the app instead of just closing the window. - Added i18n support for the new setting in English, Spanish, and Portuguese. --------- Co-authored-by: Fazri Gading <fazrigading@gmail.com> Co-authored-by: Arnav Singh <hi.arnavsingh3@gmail.com> * Update publish config to point to chasem-dev fork * Fix Linux metadata files in workflow and improve error handling * Bump version to 2.0.5 * Bump version to 2.0.6 * Fix update popup showing for same version - add version comparison checks * Bump version to 2.0.7 * Fix SHA512 checksum mismatch handling - clear cache and retry automatically * Bump version to 2.0.8 * Bump version to 2.0.9 * Fix: Use explicit latest-linux.yml to prevent yml file collision The glob pattern latest*.yml was matching both latest-linux.yml AND latest.yml from the Linux build, causing the Windows latest.yml to be overwritten with incorrect checksums. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> * Bump version to 2.0.10 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> * Fix: Remove portable target to fix SHA512 checksum mismatch The portable and nsis targets both produced x64.exe files with the same name, causing one to overwrite the other. The latest.yml contained the checksum from one build while the actual file was from the other build. Removed portable target - nsis installer is sufficient. Bump version to 2.0.11 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> * Remove outdated documentation files related to auto-updates, build instructions, and testing updates. Update `dev-app-update.yml` and `package.json` to reflect the correct GitHub owner. This cleanup streamlines the project and ensures accurate configuration for future updates. * Add semantic versioning policy documentation - numerical versions only * Update package-lock.json to include new dependencies and versions, enhancing project stability and compatibility. * fixed imgur restriction for UK * fix: adds EGL env var to detect installed NVIDIA GPU * Update release.yml * patch v2.0.11-beta: fix env issue in GA release, warn Intel Mac users, add com templates. (#115) * fix: throw error for Intel Mac user * docs: first draft of issue and PR template * fix: env of curseforge API key and discord client ID * implemented late patch should be in #115 * Final patch for release.yml v2.0.11 --------- Co-authored-by: chasem-dev <myers.a.chase@gmail.com> Co-authored-by: AMIAY <letudiantenrap.collab@gmail.com> Co-authored-by: Rahul Sahani <110347707+Rahul-Sahani04@users.noreply.github.com> Co-authored-by: Arnav Singh <72737311+ArnavSingh77@users.noreply.github.com> Co-authored-by: Arnav Singh <hi.arnavsingh3@gmail.com> Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-26 10:21:45 -03:00 · 2026-01-24 00:07:59 +08:00
parent 71974e031f
commit b46ce93af7
47 changed files with 8337 additions and 5365 deletions
--- a/GUI/js/install.js
+++ b/GUI/js/install.js
@@ -39,6 +39,19 @@ export function setupInstallation() {
      }
    });
  }
+
+  // Setup installation effects listeners
+  if (window.electronAPI && window.electronAPI.onInstallationStart) {
+    window.electronAPI.onInstallationStart(() => {
+      showInstallationEffects();
+    });
+  }
+
+  if (window.electronAPI && window.electronAPI.onInstallationEnd) {
+    window.electronAPI.onInstallationEnd(() => {
+      hideInstallationEffects();
+    });
+  }
 }

 export async function installGame() {
@@ -78,12 +91,19 @@ export async function installGame() {
    }
  } catch (error) {
    const errorMsg = window.i18n ? window.i18n.t('progress.installationFailed').replace('{error}', error.message) : `Installation failed: ${error.message}`;
+    
+    // Hide installation effects on error
+    if (window.hideInstallationEffects) {
+      window.hideInstallationEffects();
+    }
+    
+    // Reset button state on error
+    resetInstallButton();
+    
    if (window.LauncherUI) {
      window.LauncherUI.updateProgress({ message: errorMsg });
-      setTimeout(() => {
-        window.LauncherUI.hideProgress();
-        resetInstallButton();
-      }, 3000);
+      // Don't hide progress bar, just update the message
+      // User can see the error and close it manually
    }
  }
 }
--- a/GUI/js/mods.js
+++ b/GUI/js/mods.js
@@ -1,5 +1,5 @@

-const API_KEY = '$2a$10$bqk254NMZOWVTzLVJCcxEOmhcyUujKxA5xk.kQCN9q0KNYFJd5b32';
+let API_KEY = null;
 const CURSEFORGE_API = 'https://api.curseforge.com/v1';
 const HYTALE_GAME_ID = 70216;

@@ -11,6 +11,15 @@ let modsPageSize = 20;
 let modsTotalPages = 1;

 export async function initModsManager() {
+  try {
+    if (window.electronAPI && window.electronAPI.getEnvVar) {
+      API_KEY = await window.electronAPI.getEnvVar('CURSEFORGE_API_KEY');
+      console.log('Loaded API Key:', API_KEY ? 'Yes' : 'No');
+    }
+  } catch (err) {
+    console.error('Failed to load API Key:', err);
+  }
+
  setupModsEventListeners();
  await loadInstalledMods();
  await loadBrowseMods();
@@ -417,10 +426,10 @@ async function deleteMod(modId) {
  const mod = installedMods.find(m => m.id === modId);
  if (!mod) return;

-  const confirmMsg = window.i18n ? 
+  const confirmMsg = window.i18n ?
    window.i18n.t('mods.confirmDelete').replace('{name}', mod.name) + ' ' + window.i18n.t('mods.confirmDeleteDesc') :
    `Are you sure you want to delete "${mod.name}"? This action cannot be undone.`;
-  
+
  showConfirmModal(
    confirmMsg,
    async () => {
--- a/GUI/js/settings.js
+++ b/GUI/js/settings.js
@@ -3,9 +3,11 @@ let customJavaCheck;
 let customJavaOptions;
 let customJavaPath;
 let browseJavaBtn;
-let settingsPlayerName;
-let discordRPCCheck;
-let gpuPreferenceRadios;
+let settingsPlayerName;
+let discordRPCCheck;
+let closeLauncherCheck;
+let gpuPreferenceRadios;
+

 // UUID Management elements
 let currentUuidDisplay;
@@ -159,9 +161,11 @@ function setupSettingsElements() {
  customJavaOptions = document.getElementById('customJavaOptions');
  customJavaPath = document.getElementById('customJavaPath');
  browseJavaBtn = document.getElementById('browseJavaBtn');
-  settingsPlayerName = document.getElementById('settingsPlayerName');
-  discordRPCCheck = document.getElementById('discordRPCCheck');
-  gpuPreferenceRadios = document.querySelectorAll('input[name="gpuPreference"]');
+  settingsPlayerName = document.getElementById('settingsPlayerName');
+  discordRPCCheck = document.getElementById('discordRPCCheck');
+  closeLauncherCheck = document.getElementById('closeLauncherCheck');
+  gpuPreferenceRadios = document.querySelectorAll('input[name="gpuPreference"]');
+

  // UUID Management elements
  currentUuidDisplay = document.getElementById('currentUuid');
@@ -190,9 +194,14 @@ function setupSettingsElements() {
    settingsPlayerName.addEventListener('change', savePlayerName);
  }

-  if (discordRPCCheck) {
-    discordRPCCheck.addEventListener('change', saveDiscordRPC);
-  }
+  if (discordRPCCheck) {
+    discordRPCCheck.addEventListener('change', saveDiscordRPC);
+  }
+
+  if (closeLauncherCheck) {
+    closeLauncherCheck.addEventListener('change', saveCloseLauncher);
+  }
+

  // UUID event listeners
  if (copyUuidBtn) {
@@ -335,18 +344,43 @@ async function saveDiscordRPC() {
  }
 }

-async function loadDiscordRPC() {
-  try {
-    if (window.electronAPI && window.electronAPI.loadDiscordRPC) {
-      const enabled = await window.electronAPI.loadDiscordRPC();
-      if (discordRPCCheck) {
-        discordRPCCheck.checked = enabled;
-      }
-    }
-  } catch (error) {
-    console.error('Error loading Discord RPC setting:', error);
-  }
-}
+async function loadDiscordRPC() {
+  try {
+    if (window.electronAPI && window.electronAPI.loadDiscordRPC) {
+      const enabled = await window.electronAPI.loadDiscordRPC();
+      if (discordRPCCheck) {
+        discordRPCCheck.checked = enabled;
+      }
+    }
+  } catch (error) {
+    console.error('Error loading Discord RPC setting:', error);
+  }
+}
+
+async function saveCloseLauncher() {
+  try {
+    if (window.electronAPI && window.electronAPI.saveCloseLauncher && closeLauncherCheck) {
+      const enabled = closeLauncherCheck.checked;
+      await window.electronAPI.saveCloseLauncher(enabled);
+    }
+  } catch (error) {
+    console.error('Error saving close launcher setting:', error);
+  }
+}
+
+async function loadCloseLauncher() {
+  try {
+    if (window.electronAPI && window.electronAPI.loadCloseLauncher) {
+      const enabled = await window.electronAPI.loadCloseLauncher();
+      if (closeLauncherCheck) {
+        closeLauncherCheck.checked = enabled;
+      }
+    }
+  } catch (error) {
+    console.error('Error loading close launcher setting:', error);
+  }
+}
+

 async function savePlayerName() {
  try {
@@ -457,13 +491,15 @@ async function loadGpuPreference() {
  }
 }

-async function loadAllSettings() {
-  await loadCustomJavaPath();
-  await loadPlayerName();
-  await loadCurrentUuid();
-  await loadDiscordRPC();
-  await loadGpuPreference();
-}
+async function loadAllSettings() {
+  await loadCustomJavaPath();
+  await loadPlayerName();
+  await loadCurrentUuid();
+  await loadDiscordRPC();
+  await loadCloseLauncher();
+  await loadGpuPreference();
+}
+

 async function openGameLocation() {
  try {
--- a/GUI/js/ui.js
+++ b/GUI/js/ui.js
@@ -479,6 +479,9 @@ function setupUI() {
  progressSpeed = document.getElementById('progressSpeed');
  progressSize = document.getElementById('progressSize');

+  // Setup draggable progress bar
+  setupProgressDrag();
+
  lockPlayButton(true);

  setTimeout(() => {
@@ -497,10 +500,26 @@ function setupUI() {
  setupSidebarLogo();
  setupAnimations();
  setupFirstLaunchHandlers();
+  loadLauncherVersion();

  document.body.focus();
 }

+// Load launcher version from package.json
+async function loadLauncherVersion() {
+  try {
+    if (window.electronAPI && window.electronAPI.getVersion) {
+      const version = await window.electronAPI.getVersion();
+      const versionElement = document.getElementById('launcherVersion');
+      if (versionElement) {
+        versionElement.textContent = `v${version}`;
+      }
+    }
+  } catch (error) {
+    console.error('Failed to load launcher version:', error);
+  }
+}
+
 window.LauncherUI = {
  showPage,
  setActiveNav,
@@ -510,4 +529,91 @@ window.LauncherUI = {
  updateProgress
 };

+// Make installation effects globally available
+window.showInstallationEffects = showInstallationEffects;
+window.hideInstallationEffects = hideInstallationEffects;
+
+// Draggable progress bar functionality
+function setupProgressDrag() {
+  if (!progressOverlay) return;
+
+  let isDragging = false;
+  let offsetX;
+  let offsetY;
+
+  progressOverlay.addEventListener('mousedown', dragStart);
+  document.addEventListener('mousemove', drag);
+  document.addEventListener('mouseup', dragEnd);
+
+  function dragStart(e) {
+    // Only drag if clicking on the overlay itself, not on buttons or inputs
+    if (e.target.closest('.progress-bar-fill')) return;
+    
+    if (e.target === progressOverlay || e.target.closest('.progress-content')) {
+      isDragging = true;
+      progressOverlay.classList.add('dragging');
+      
+      // Get the current position of the progress overlay
+      const rect = progressOverlay.getBoundingClientRect();
+      offsetX = e.clientX - rect.left - progressOverlay.offsetWidth / 2;
+      offsetY = e.clientY - rect.top;
+    }
+  }
+
+  function drag(e) {
+    if (isDragging) {
+      e.preventDefault();
+      
+      // Calculate new position
+      const newX = e.clientX - offsetX - progressOverlay.offsetWidth / 2;
+      const newY = e.clientY - offsetY;
+
+      // Get window bounds
+      const maxX = window.innerWidth - progressOverlay.offsetWidth;
+      const maxY = window.innerHeight - progressOverlay.offsetHeight;
+      const minX = 0;
+      const minY = 0;
+
+      // Constrain to window bounds
+      const constrainedX = Math.max(minX, Math.min(newX, maxX));
+      const constrainedY = Math.max(minY, Math.min(newY, maxY));
+
+      progressOverlay.style.left = constrainedX + 'px';
+      progressOverlay.style.bottom = 'auto';
+      progressOverlay.style.top = constrainedY + 'px';
+      progressOverlay.style.transform = 'none';
+    }
+  }
+
+  function dragEnd() {
+    isDragging = false;
+    progressOverlay.classList.remove('dragging');
+  }
+}
+
+// Show/hide installation effects
+function showInstallationEffects() {
+  const installationEffects = document.getElementById('installationEffects');
+  if (installationEffects) {
+    installationEffects.style.display = 'block';
+  }
+}
+
+function hideInstallationEffects() {
+  const installationEffects = document.getElementById('installationEffects');
+  if (installationEffects) {
+    installationEffects.style.display = 'none';
+  }
+}
+
+// Toggle maximize/restore window function
+function toggleMaximize() {
+  if (window.electronAPI && window.electronAPI.maximizeWindow) {
+    window.electronAPI.maximizeWindow();
+  }
+}
+
+// Make toggleMaximize globally available
+window.toggleMaximize = toggleMaximize;
+
 document.addEventListener('DOMContentLoaded', setupUI);
--- a/GUI/js/update.js
+++ b/GUI/js/update.js
@@ -10,6 +10,23 @@ class ClientUpdateManager {
            this.showUpdatePopup(updateInfo);
        });

+        // Listen for electron-updater events
+        window.electronAPI.onUpdateAvailable((updateInfo) => {
+            this.showUpdatePopup(updateInfo);
+        });
+
+        window.electronAPI.onUpdateDownloadProgress((progress) => {
+            this.updateDownloadProgress(progress);
+        });
+
+        window.electronAPI.onUpdateDownloaded((updateInfo) => {
+            this.showUpdateDownloaded(updateInfo);
+        });
+
+        window.electronAPI.onUpdateError((errorInfo) => {
+            this.handleUpdateError(errorInfo);
+        });
+
        this.checkForUpdatesOnDemand();
    }

@@ -33,23 +50,46 @@ class ClientUpdateManager {
                    <div class="update-popup-versions">
                        <div class="version-row">
                            <span class="version-label">Current Version:</span>
-                            <span class="version-current">${updateInfo.currentVersion}</span>
+                            <span class="version-current">${updateInfo.currentVersion || updateInfo.version || 'Unknown'}</span>
                        </div>
                        <div class="version-row">
                            <span class="version-label">New Version:</span>
-                            <span class="version-new">${updateInfo.newVersion}</span>
+                            <span class="version-new">${updateInfo.newVersion || updateInfo.version || 'Unknown'}</span>
                        </div>
                    </div>

                    <div class="update-popup-message">
                        A new version of Hytale F2P Launcher is available.<br>
-                        Please download the latest version to continue using the launcher.
+                        <span id="update-status-text">Downloading update automatically...</span>
+                        <div id="update-error-message" style="display: none; margin-top: 0.75rem; padding: 0.75rem; background: rgba(239, 68, 68, 0.1); border: 1px solid rgba(239, 68, 68, 0.3); border-radius: 0.5rem; color: #fca5a5; font-size: 0.875rem;">
+                            <i class="fas fa-exclamation-triangle" style="margin-right: 0.5rem;"></i>
+                            <span id="update-error-text"></span>
+                        </div>
                    </div>

-                    <button id="update-download-btn" class="update-download-btn">
-                        <i class="fas fa-external-link-alt" style="margin-right: 0.5rem;"></i>
-                        Download Update
-                    </button>
+                    <div id="update-progress-container" style="display: none; margin-bottom: 1rem;">
+                        <div style="display: flex; justify-content: space-between; margin-bottom: 0.5rem; font-size: 0.75rem; color: #9ca3af;">
+                            <span id="update-progress-percent">0%</span>
+                            <span id="update-progress-speed">0 KB/s</span>
+                        </div>
+                        <div style="width: 100%; height: 8px; background: rgba(255, 255, 255, 0.1); border-radius: 4px; overflow: hidden;">
+                            <div id="update-progress-bar" style="width: 0%; height: 100%; background: linear-gradient(90deg, #3b82f6, #9333ea); transition: width 0.3s ease;"></div>
+                        </div>
+                        <div style="margin-top: 0.5rem; font-size: 0.75rem; color: #9ca3af; text-align: center;">
+                            <span id="update-progress-size">0 MB / 0 MB</span>
+                        </div>
+                    </div>
+
+                    <div id="update-buttons-container" style="display: none;">
+                        <button id="update-install-btn" class="update-download-btn">
+                            <i class="fas fa-check" style="margin-right: 0.5rem;"></i>
+                            Install & Restart
+                        </button>
+                        <button id="update-download-btn" class="update-download-btn update-download-btn-secondary" style="margin-top: 0.75rem;">
+                            <i class="fas fa-external-link-alt" style="margin-right: 0.5rem;"></i>
+                            Manually Download
+                        </button>
+                    </div>

                    <div class="update-popup-footer">
                        This popup cannot be closed until you update the launcher
@@ -62,6 +102,31 @@ class ClientUpdateManager {

        this.blockInterface();

+        // Show progress container immediately (auto-download is enabled)
+        const progressContainer = document.getElementById('update-progress-container');
+        if (progressContainer) {
+            progressContainer.style.display = 'block';
+        }
+
+        const installBtn = document.getElementById('update-install-btn');
+        if (installBtn) {
+            installBtn.addEventListener('click', async (e) => {
+                e.preventDefault();
+                e.stopPropagation();
+                
+                installBtn.disabled = true;
+                installBtn.innerHTML = '<i class="fas fa-spinner fa-spin" style="margin-right: 0.5rem;"></i>Installing...';
+                
+                try {
+                    await window.electronAPI.quitAndInstallUpdate();
+                } catch (error) {
+                    console.error('❌ Error installing update:', error);
+                    installBtn.disabled = false;
+                    installBtn.innerHTML = '<i class="fas fa-check" style="margin-right: 0.5rem;"></i>Install & Restart';
+                }
+            });
+        }
+
        const downloadBtn = document.getElementById('update-download-btn');
        if (downloadBtn) {
            downloadBtn.addEventListener('click', async (e) => {
@@ -80,7 +145,7 @@ class ClientUpdateManager {
                } catch (error) {
                    console.error('❌ Error opening download page:', error);
                    downloadBtn.disabled = false;
-                    downloadBtn.innerHTML = '<i class="fas fa-external-link-alt" style="margin-right: 0.5rem;"></i>Download Update';
+                    downloadBtn.innerHTML = '<i class="fas fa-external-link-alt" style="margin-right: 0.5rem;"></i>Manually Download';
                }
            });
        }
@@ -99,6 +164,134 @@ class ClientUpdateManager {
        console.log('🔔 Update popup displayed with new style');
    }

+    updateDownloadProgress(progress) {
+        const progressBar = document.getElementById('update-progress-bar');
+        const progressPercent = document.getElementById('update-progress-percent');
+        const progressSpeed = document.getElementById('update-progress-speed');
+        const progressSize = document.getElementById('update-progress-size');
+
+        if (progressBar && progress) {
+            const percent = Math.round(progress.percent || 0);
+            progressBar.style.width = `${percent}%`;
+            
+            if (progressPercent) {
+                progressPercent.textContent = `${percent}%`;
+            }
+
+            if (progressSpeed && progress.bytesPerSecond) {
+                const speedMBps = (progress.bytesPerSecond / 1024 / 1024).toFixed(2);
+                progressSpeed.textContent = `${speedMBps} MB/s`;
+            }
+
+            if (progressSize && progress.transferred && progress.total) {
+                const transferredMB = (progress.transferred / 1024 / 1024).toFixed(2);
+                const totalMB = (progress.total / 1024 / 1024).toFixed(2);
+                progressSize.textContent = `${transferredMB} MB / ${totalMB} MB`;
+            }
+
+            // Don't update status text here - it's already set and the progress bar shows the percentage
+        }
+    }
+
+    showUpdateDownloaded(updateInfo) {
+        const statusText = document.getElementById('update-status-text');
+        const progressContainer = document.getElementById('update-progress-container');
+        const buttonsContainer = document.getElementById('update-buttons-container');
+
+        if (statusText) {
+            statusText.textContent = 'Update downloaded! Ready to install.';
+        }
+
+        if (progressContainer) {
+            progressContainer.style.display = 'none';
+        }
+
+        if (buttonsContainer) {
+            buttonsContainer.style.display = 'block';
+        }
+
+        console.log('✅ Update downloaded, ready to install');
+    }
+
+    handleUpdateError(errorInfo) {
+        console.error('Update error:', errorInfo);
+        
+        // If manual download is required, update the UI (this will handle status text)
+        if (errorInfo.requiresManualDownload) {
+            this.showManualDownloadRequired(errorInfo);
+            return; // Don't do anything else, showManualDownloadRequired handles everything
+        }
+        
+        // For non-critical errors, just show error message without changing status
+        const errorMessage = document.getElementById('update-error-message');
+        const errorText = document.getElementById('update-error-text');
+        
+        if (errorMessage && errorText) {
+            let message = errorInfo.message || 'An error occurred during the update process.';
+            if (errorInfo.isMacSigningError) {
+                message = 'Auto-update requires code signing. Please download manually.';
+            }
+            errorText.textContent = message;
+            errorMessage.style.display = 'block';
+        }
+    }
+
+    showManualDownloadRequired(errorInfo) {
+        const statusText = document.getElementById('update-status-text');
+        const progressContainer = document.getElementById('update-progress-container');
+        const buttonsContainer = document.getElementById('update-buttons-container');
+        const installBtn = document.getElementById('update-install-btn');
+        const downloadBtn = document.getElementById('update-download-btn');
+        const errorMessage = document.getElementById('update-error-message');
+        const errorText = document.getElementById('update-error-text');
+
+        // Hide progress and install button
+        if (progressContainer) {
+            progressContainer.style.display = 'none';
+        }
+
+        if (installBtn) {
+            installBtn.style.display = 'none';
+        }
+
+        // Update status message (only once, don't change it again)
+        if (statusText && !statusText.dataset.manualMode) {
+            statusText.textContent = 'Please download and install the update manually.';
+            statusText.dataset.manualMode = 'true'; // Mark that we've set manual mode
+        }
+
+        // Show error message with details
+        if (errorMessage && errorText) {
+            let message = 'Auto-update is not available. ';
+            if (errorInfo.isMacSigningError) {
+                message = 'This app requires code signing for automatic updates.';
+            } else if (errorInfo.isLinuxInstallError) {
+                message = 'Auto-installation requires root privileges. Please download and install the update manually using your package manager.';
+            } else if (errorInfo.message) {
+                message = errorInfo.message;
+            } else {
+                message = 'An error occurred during the update process.';
+            }
+            errorText.textContent = message;
+            errorMessage.style.display = 'block';
+        }
+
+        // Show and enable the manual download button (make it primary since it's the only option)
+        if (downloadBtn) {
+            downloadBtn.style.display = 'block';
+            downloadBtn.disabled = false;
+            downloadBtn.classList.remove('update-download-btn-secondary');
+            downloadBtn.innerHTML = '<i class="fas fa-external-link-alt" style="margin-right: 0.5rem;"></i>Download Update Manually';
+        }
+
+        // Show buttons container if not already visible
+        if (buttonsContainer) {
+            buttonsContainer.style.display = 'block';
+        }
+
+        console.log('⚠️ Manual download required due to update error');
+    }
+
    blockInterface() {
        const mainContent = document.querySelector('.flex.w-full.h-screen');
        if (mainContent) {
@@ -144,7 +337,12 @@ class ClientUpdateManager {
    async checkForUpdatesOnDemand() {
        try {
            const updateInfo = await window.electronAPI.checkForUpdates();
-            if (updateInfo.updateAvailable) {
+            
+            // Double-check that versions are actually different before showing popup
+            if (updateInfo.updateAvailable && 
+                updateInfo.newVersion && 
+                updateInfo.currentVersion &&
+                updateInfo.newVersion !== updateInfo.currentVersion) {
                this.showUpdatePopup(updateInfo);
            }
            return updateInfo;