Merge pull request 'added search bar in "my mods"' (#3 ) from amiay/hytale-f2p:develop into develop

Reviewed-on: https://git.sanhost.net/sanasol/hytale-f2p/pulls/3
added search bar in my mods
2026-02-26 16:21:49 -03:00 · 2026-02-24 16:31:54 +00:00 · 2026-02-24 17:31:13 +01:00 · 2026-02-24 16:22:55 +00:00 · 2026-02-24 17:15:47 +01:00 · 2026-02-24 17:04:46 +01:00
44 changed files with 4377 additions and 393 deletions
--- a/.github/CODE_OF_CONDUCT.md
+++ b/.github/CODE_OF_CONDUCT.md
@@ -36,7 +36,7 @@ This Code of Conduct applies within all community spaces, and also applies when
 ## Enforcement
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at [Discord Server, message Founders/Devs](https://discord.gg/hf2pdc). All complaints will be reviewed and investigated promptly and fairly.
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at [Discord Server, message Founders/Devs](https://discord.gg/Fhbb9Yk5WW). All complaints will be reviewed and investigated promptly and fairly.
 All community leaders are obligated to respect the privacy and security of the reporter of any incident.
--- a/.github/ISSUE_TEMPLATE/support_request.yml
+++ b/.github/ISSUE_TEMPLATE/support_request.yml
@@ -22,7 +22,7 @@ body:
      value: |
        If you need help or support with using the launcher, please fill out this support request.
        Provide as much detail as possible so we can assist you effectively.
-        **Need a quick assistance?** Please Open-A-Ticket in our [Discord Server](https://discord.gg/gME8rUy3MB)!
+        **Need a quick assistance?** Please Open-A-Ticket in our [Discord Server](https://discord.gg/Fhbb9Yk5WW)!
  - type: textarea
    id: question
--- a/.gitignore
+++ b/.gitignore
@@ -17,6 +17,9 @@ dist/
 # Project Specific: Downloaded patcher (from hytale-auth-server)
 backend/patcher/
 # Private docs (local only)
 docs/PATCH_CDN_INFRASTRUCTURE.md
 # macOS Specific
 .DS_Store
 *.zst.DS_Store
--- a/GUI/index.html
+++ b/GUI/index.html
@@ -8,9 +8,10 @@
    <link href="https://cdn.jsdelivr.net/npm/tailwindcss@2.2.19/dist/tailwind.min.css" rel="stylesheet">
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css">
    <link
-        href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap"
+        href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&family=Noto+Sans+Arabic:wght@300;400;500;600;700&display=swap"
        rel="stylesheet">
    <link rel="stylesheet" href="style.css">
    <link rel="stylesheet" href="style-RTL.css">
 </head>
 <body class="bg-black text-white overflow-hidden font-sans select-none" tabindex="-1">
@@ -429,6 +430,68 @@
                                            </div>
                                        </div>
                                    </div>
                                    <div class="settings-section">
                                        <h3 class="settings-section-title">
                                            <i class="fas fa-scroll"></i>
                                            <span data-i18n="settings.wrapperConfig">Java Wrapper Configuration</span>
                                        </h3>
                                        <p class="settings-hint" style="margin-bottom: 12px;">
                                            <i class="fas fa-info-circle"></i>
                                            <span data-i18n="settings.wrapperConfigHint">Configure how the Java wrapper handles JVM flags and arguments at launch time.</span>
                                        </p>
                                        <!-- Strip Flags -->
                                        <label class="settings-label" style="margin-bottom: 6px;">
                                            <span data-i18n="settings.wrapperStripFlags">JVM Flags to Remove</span>
                                        </label>
                                        <div id="wrapperStripFlagsList" class="wrapper-items-list"></div>
                                        <div style="display: flex; gap: 6px; margin-top: 6px;">
                                            <input type="text" id="wrapperAddFlagInput" class="settings-input" style="flex:1;"
                                                data-i18n-placeholder="settings.wrapperAddFlagPlaceholder" placeholder="e.g. -XX:+SomeFlag" spellcheck="false">
                                            <button id="wrapperAddFlagBtn" class="settings-browse-btn">
                                                <i class="fas fa-plus"></i>
                                                <span data-i18n="settings.wrapperAdd">Add</span>
                                            </button>
                                        </div>
                                        <!-- Inject Args -->
                                        <label class="settings-label" style="margin-top: 16px; margin-bottom: 6px;">
                                            <span data-i18n="settings.wrapperInjectArgs">Arguments to Inject</span>
                                        </label>
                                        <div id="wrapperInjectArgsList" class="wrapper-items-list"></div>
                                        <div style="display: flex; gap: 6px; margin-top: 6px;">
                                            <input type="text" id="wrapperAddArgInput" class="settings-input" style="flex:1;"
                                                data-i18n-placeholder="settings.wrapperAddArgPlaceholder" placeholder="e.g. --some-flag" spellcheck="false">
                                            <select id="wrapperAddArgCondition" class="wrapper-condition-select">
                                                <option value="server" data-i18n="settings.wrapperConditionServer">Server Only</option>
                                                <option value="always" data-i18n="settings.wrapperConditionAlways">Always</option>
                                            </select>
                                            <button id="wrapperAddArgBtn" class="settings-browse-btn">
                                                <i class="fas fa-plus"></i>
                                                <span data-i18n="settings.wrapperAdd">Add</span>
                                            </button>
                                        </div>
                                        <!-- Restore Defaults -->
                                        <div style="margin-top: 12px;">
                                            <button id="wrapperRestoreDefaultsBtn" class="settings-browse-btn" style="background: rgba(239, 68, 68, 0.2); border-color: rgba(239, 68, 68, 0.3);">
                                                <i class="fas fa-undo"></i>
                                                <span data-i18n="settings.wrapperRestoreDefaults">Restore Defaults</span>
                                            </button>
                                        </div>
                                        <!-- Script Preview (collapsible) -->
                                        <div style="margin-top: 12px;">
                                            <button id="wrapperPreviewToggle" class="wrapper-preview-toggle">
                                                <i class="fas fa-chevron-right" id="wrapperPreviewChevron"></i>
                                                <span data-i18n="settings.wrapperAdvancedPreview">Advanced: Script Preview</span>
                                            </button>
                                            <div id="wrapperPreviewContainer" style="display: none; margin-top: 8px;">
                                                <pre id="wrapperPreviewContent" class="wrapper-preview-content"></pre>
                                            </div>
                                        </div>
                                    </div>
                                </div>
                                <div class="settings-column">
@@ -574,6 +637,9 @@
                                    <i class="fas fa-folder-open"></i> <span data-i18n="settings.logsFolder">Open
                                        Folder</span>
                                </button>
                                <button class="logs-action-btn logs-send-btn" id="sendLogsBtn" onclick="sendLogs()">
                                    <i class="fas fa-paper-plane"></i> <span data-i18n="settings.logsSend">Send Logs</span>
                                </button>
                            </div>
                        </div>
                        <div id="logsTerminal" class="logs-terminal">
@@ -597,7 +663,11 @@
                    <i class="fas fa-times"></i>
                </button>
            </div>
-            <div class="mods-modal-body">
+            <div class="mods-modal-body" style="padding-top: 0;">
                <div class="mods-search-container" style="margin: 1.5rem; margin-bottom: 1rem;">
                    <i class="fas fa-search"></i>
                    <input type="text" id="myModsSearch" placeholder="Search installed mods..." class="mods-search" />
                </div>
                <div id="installedModsList" class="installed-mods-list">
                </div>
            </div>
@@ -801,6 +871,25 @@
    <script src="js/featured.js"></script>
    <script type="module" src="js/settings.js"></script>
    <script type="module" src="js/update.js"></script>
    <!-- Version Selection Modal (Isolated Container) -->
    <div id="versionSelectModal" class="modal-overlay" style="display: none; position: fixed; inset: 0; z-index: 9999; background: rgba(0, 0, 0, 0.7); backdrop-filter: blur(5px); align-items: center; justify-content: center;">
        <div class="glass-panel" style="width: 100%; max-width: 600px; max-height: 80vh; display: flex; flex-direction: column; border-radius: 12px; overflow: hidden; margin: 20px;">
            <div class="modal-header" style="display: flex; justify-content: space-between; align-items: center; padding: 1.5rem; border-bottom: 1px solid rgba(255, 255, 255, 0.1);">
                <h3 style="margin: 0; font-size: 1.25rem;">Select Version</h3>
                <button id="closeVersionModal" class="modal-close" style="background: none; border: none; color: #a0a0a0; font-size: 1.25rem; cursor: pointer;"><i class="fas fa-times"></i></button>
            </div>
            <div class="modal-body" style="padding: 1.5rem; overflow-y: auto;">
                <div id="versionList" class="version-list-container">
                    <div class="loading-versions" style="display: flex; flex-direction: column; align-items: center; gap: 1rem; color: #a0a0a0;">
                        <i class="fas fa-spinner fa-spin fa-2x"></i>
                        <span>Loading versions...</span>
                    </div>
                </div>
            </div>
        </div>
    </div>
    <!-- updater.js disabled - using update.js instead which has skip button and macOS handling -->
 </body>
--- a/GUI/js/i18n.js
+++ b/GUI/js/i18n.js
@@ -12,9 +12,18 @@ const i18n = (() => {
    { code: 'ru-RU', name: 'Russian (Russia)' },
    { code: 'sv-SE', name: 'Swedish (Sweden)' },
    { code: 'tr-TR', name: 'Turkish (Turkey)' },
-    { code: 'id-ID', name: 'Indonesian (Indonesia)' }
+    { code: 'id-ID', name: 'Indonesian (Indonesia)' },
    { code: 'ar-SA', name: 'Arabic (Saudi Arabia)' }
  ];
    // RTL languages
  const rtlLanguages = ['ar-SA'];
  // Check if current language is RTL
  function isRTL() {
    return rtlLanguages.includes(currentLang);
  }
  // Load single language file
  async function loadLanguage(lang) {
    if (translations[lang]) return true;
@@ -73,6 +82,24 @@ const i18n = (() => {
      const key = el.getAttribute('data-i18n-title');
      el.title = t(key);
    });
    // Update RTL layout
    updateRTL();
  }
  // Update RTL layout
  function updateRTL() {
    const html = document.documentElement;
    const body = document.body;
    if (isRTL()) {
      html.setAttribute('dir', 'rtl');
      html.setAttribute('lang', currentLang);
      body.classList.add('rtl');
    } else {
      html.removeAttribute('dir');
      html.setAttribute('lang', currentLang);
      body.classList.remove('rtl');
    }
  }
  // Initialize - load saved language only
@@ -88,7 +115,8 @@ const i18n = (() => {
    t,
    setLanguage,
    getAvailableLanguages: () => availableLanguages,
-    getCurrentLanguage: () => currentLang
+    getCurrentLanguage: () => currentLang,
    isRTL
  };
 })();
--- a/GUI/js/logs.js
+++ b/GUI/js/logs.js
@@ -66,6 +66,113 @@ async function openLogsFolder() {
    await window.electronAPI.openLogsFolder();
 }
 async function sendLogs() {
    const btn = document.getElementById('sendLogsBtn');
    if (!btn || btn.disabled) return;
    // Get i18n strings with fallbacks
    const i18n = window.i18n || {};
    const sendingText = (i18n.settings && i18n.settings.logsSending) || 'Sending...';
    const sentText = (i18n.settings && i18n.settings.logsSent) || 'Sent!';
    const failedText = (i18n.settings && i18n.settings.logsSendFailed) || 'Failed';
    const sendText = (i18n.settings && i18n.settings.logsSend) || 'Send Logs';
    const originalHTML = btn.innerHTML;
    btn.disabled = true;
    btn.innerHTML = `<i class="fas fa-spinner fa-spin"></i> ${sendingText}`;
    try {
        const result = await window.electronAPI.sendLogs();
        if (result.success) {
            btn.innerHTML = `<i class="fas fa-check"></i> ${sentText}`;
            showLogSubmissionResult(result.id);
        } else {
            btn.innerHTML = `<i class="fas fa-times"></i> ${failedText}`;
            console.error('Send logs failed:', result.error);
            // Show error notification if available
            if (window.LauncherUI && window.LauncherUI.showNotification) {
                window.LauncherUI.showNotification(result.error || 'Failed to send logs', 'error');
            }
        }
    } catch (err) {
        console.error('Send logs error:', err);
        btn.innerHTML = `<i class="fas fa-times"></i> ${failedText}`;
    }
    setTimeout(() => {
        btn.disabled = false;
        btn.innerHTML = originalHTML;
    }, 3000);
 }
 function showLogSubmissionResult(id) {
    // Remove existing popup if any
    const existing = document.getElementById('logSubmissionPopup');
    if (existing) existing.remove();
    const i18n = window.i18n || {};
    const idLabel = (i18n.settings && i18n.settings.logsSubmissionId) || 'Submission ID';
    const copyText = (i18n.common && i18n.common.copy) || 'Copy';
    const closeText = (i18n.common && i18n.common.close) || 'Close';
    const shareText = (i18n.settings && i18n.settings.logsShareId) || 'Share this ID with support when reporting issues';
    const popup = document.createElement('div');
    popup.id = 'logSubmissionPopup';
    popup.style.cssText = `
        position: fixed; top: 50%; left: 50%; transform: translate(-50%, -50%);
        background: rgba(20, 20, 35, 0.98); border: 1px solid rgba(0, 212, 255, 0.3);
        border-radius: 12px; padding: 24px 32px; z-index: 10000;
        box-shadow: 0 20px 60px rgba(0,0,0,0.5); text-align: center;
        min-width: 320px; backdrop-filter: blur(10px);
    `;
    popup.innerHTML = `
        <div style="margin-bottom: 16px;">
            <i class="fas fa-check-circle" style="font-size: 2em; color: #00d4ff;"></i>
        </div>
        <div style="color: #888; font-size: 0.85em; margin-bottom: 8px;">${idLabel}</div>
        <div id="logSubId" style="font-family: monospace; font-size: 1.5em; color: #00d4ff; letter-spacing: 2px; margin-bottom: 12px; user-select: all;">${id}</div>
        <div style="color: #666; font-size: 0.8em; margin-bottom: 20px;">${shareText}</div>
        <div style="display: flex; gap: 10px; justify-content: center;">
            <button onclick="copyLogSubmissionId('${id}')" style="
                background: rgba(0,212,255,0.2); border: 1px solid rgba(0,212,255,0.3);
                color: #00d4ff; padding: 8px 20px; border-radius: 6px; cursor: pointer;
                font-size: 0.9em;
            "><i class="fas fa-copy"></i> ${copyText}</button>
            <button onclick="document.getElementById('logSubmissionPopup').remove()" style="
                background: rgba(255,255,255,0.1); border: 1px solid rgba(255,255,255,0.2);
                color: #ccc; padding: 8px 20px; border-radius: 6px; cursor: pointer;
                font-size: 0.9em;
            ">${closeText}</button>
        </div>
    `;
    document.body.appendChild(popup);
    // Auto-close after 30s
    setTimeout(() => {
        if (document.getElementById('logSubmissionPopup')) {
            popup.remove();
        }
    }, 30000);
 }
 async function copyLogSubmissionId(id) {
    try {
        await navigator.clipboard.writeText(id);
        const btn = event.target.closest('button');
        if (btn) {
            const orig = btn.innerHTML;
            btn.innerHTML = '<i class="fas fa-check"></i> Copied!';
            setTimeout(() => { btn.innerHTML = orig; }, 1500);
        }
    } catch (err) {
        console.error('Failed to copy submission ID:', err);
    }
 }
 function openLogs() {
    // Navigation is handled by sidebar logic, but we can trigger a refresh
    window.LauncherUI.showPage('logs-page');
@@ -77,6 +184,8 @@ function openLogs() {
 window.refreshLogs = refreshLogs;
 window.copyLogs = copyLogs;
 window.openLogsFolder = openLogsFolder;
 window.sendLogs = sendLogs;
 window.copyLogSubmissionId = copyLogSubmissionId;
 window.openLogs = openLogs;
 // Auto-load logs when the page becomes active
--- a/GUI/js/mods.js
+++ b/GUI/js/mods.js
@@ -49,6 +49,18 @@ function setupModsEventListeners() {
    closeModalBtn.addEventListener('click', closeMyModsModal);
  }
  const myModsSearchInput = document.getElementById('myModsSearch');
  if (myModsSearchInput) {
    let myModsSearchTimeout;
    myModsSearchInput.addEventListener('input', (e) => {
      const query = e.target.value.toLowerCase().trim();
      clearTimeout(myModsSearchTimeout);
      myModsSearchTimeout = setTimeout(() => {
        filterInstalledMods(query);
      }, 300);
    });
  }
  const modal = document.getElementById('myModsModal');
  if (modal) {
    modal.addEventListener('click', (e) => {
@@ -78,12 +90,30 @@ function setupModsEventListeners() {
      }
    });
  }
  const browseContainer = document.getElementById('browseModsList');
  if (browseContainer) {
    browseContainer.addEventListener('click', (e) => {
      const installBtn = e.target.closest('[data-install-mod-id]');
      if (installBtn) {
        const modId = installBtn.getAttribute('data-install-mod-id');
        const mod = browseMods.find(m => m.id == modId);
        if (mod) {
          openVersionSelectModal(mod);
        }
      }
    });
  }
 }
 function openMyModsModal() {
  const modal = document.getElementById('myModsModal');
  if (modal) {
    modal.classList.add('active');
    const searchInput = document.getElementById('myModsSearch');
    if (searchInput) {
      searchInput.value = '';
    }
    loadInstalledMods();
  }
 }
@@ -92,6 +122,10 @@ function closeMyModsModal() {
  const modal = document.getElementById('myModsModal');
  if (modal) {
    modal.classList.remove('active');
    const searchInput = document.getElementById('myModsSearch');
    if (searchInput) {
      searchInput.value = '';
    }
  }
 }
@@ -113,19 +147,39 @@ async function loadInstalledMods() {
  }
 }
 function filterInstalledMods(query) {
  if (!query || query === '') {
    displayInstalledMods(installedMods);
    return;
  }
  const filtered = installedMods.filter(mod => {
    const nameMatch = mod.name?.toLowerCase().includes(query);
    const fileNameMatch = mod.fileName?.toLowerCase().includes(query);
    const descriptionMatch = mod.description?.toLowerCase().includes(query);
    const authorMatch = mod.author?.toLowerCase().includes(query);
    return nameMatch || fileNameMatch || descriptionMatch || authorMatch;
  });
  displayInstalledMods(filtered);
 }
 function displayInstalledMods(mods) {
  const modsContainer = document.getElementById('installedModsList');
  if (!modsContainer) return;
  if (mods.length === 0) {
    const searchInput = document.getElementById('myModsSearch');
    const isSearching = searchInput && searchInput.value.trim() !== '';
    modsContainer.innerHTML = `
      <div class=\"empty-installed-mods\">
-        <i class=\"fas fa-box-open\"></i>
+        <i class=\"fas fa-${isSearching ? 'search' : 'box-open'}\"></i>
-        <h4 data-i18n="mods.noModsInstalled">No Mods Installed</h4>
+        <h4 data-i18n="${isSearching ? 'mods.noModsFound' : 'mods.noModsInstalled'}">${isSearching ? 'No Mods Found' : 'No Mods Installed'}</h4>
-        <p data-i18n="mods.noModsInstalledDesc">Add mods from CurseForge or import local files</p>
+        <p data-i18n="${isSearching ? 'mods.noModsFoundDesc' : 'mods.noModsInstalledDesc'}">${isSearching ? 'Try a different search term' : 'Add mods from CurseForge or import local files'}</p>
      </div>
    `;
-    if (window.i18n) {
+    if (window.i18n && !isSearching) {
      const container = modsContainer.querySelector('.empty-installed-mods');
      container.querySelector('h4').textContent = window.i18n.t('mods.noModsInstalled');
      container.querySelector('p').textContent = window.i18n.t('mods.noModsInstalledDesc');
@@ -165,7 +219,7 @@ function createInstalledModCard(mod) {
      <div class="installed-mod-info">
        <div class="installed-mod-header">
          <h4 class="installed-mod-name">${mod.name}</h4>
-          <span class="installed-mod-version">v${mod.version}</span>
+          <span class="installed-mod-version">${mod.fileName || 'v' + mod.version}</span>
        </div>
        <p class="installed-mod-description">${mod.description || (window.i18n ? window.i18n.t('mods.noDescription') : 'No description available')}</p>
      </div>
@@ -295,13 +349,6 @@ function displayBrowseMods(mods) {
  }
  browseContainer.innerHTML = mods.map(mod => createBrowseModCard(mod)).join('');
  mods.forEach(mod => {
    const installBtn = document.getElementById(`install-${mod.id}`);
    if (installBtn) {
      installBtn.addEventListener('click', () => downloadAndInstallMod(mod));
    }
  });
 }
 function createBrowseModCard(mod) {
@@ -350,12 +397,12 @@ function createBrowseModCard(mod) {
          ${window.i18n ? window.i18n.t('mods.view') : 'VIEW'}
        </button>
        ${!isInstalled ?
-      `<button id="install-${mod.id}" class="mod-btn-toggle bg-primary text-black hover:bg-primary/80">
+      `<button data-install-mod-id=\"${mod.id}\" class=\"mod-btn-toggle bg-primary text-black hover:bg-primary/80\">
-            <i class="fas fa-download"></i>
+            <i class=\"fas fa-download\"></i>
            ${window.i18n ? window.i18n.t('mods.install') : 'INSTALL'}
          </button>` :
-      `<button class="mod-btn-toggle bg-white/10 text-white" disabled>
+      `<button class=\"mod-btn-toggle bg-white/10 text-white\" disabled>
-            <i class="fas fa-check"></i>
+            <i class=\"fas fa-check\"></i>
            ${window.i18n ? window.i18n.t('mods.installed') : 'INSTALLED'}
          </button>`
    }
@@ -364,6 +411,104 @@ function createBrowseModCard(mod) {
  `;
 }
 let currentSelectedMod = null;
 function openVersionSelectModal(mod) {
  currentSelectedMod = mod;
  const modal = document.getElementById('versionSelectModal');
  const closeBtn = document.getElementById('closeVersionModal');
  const versionList = document.getElementById('versionList');
  if (modal) {
    modal.style.display = 'flex';
    modal.classList.add('active');
    const closeHandler = () => {
      modal.classList.remove('active');
      setTimeout(() => {
        modal.style.display = 'none';
      }, 300);
      currentSelectedMod = null;
    };
    if (closeBtn) {
      closeBtn.onclick = closeHandler;
    }
    modal.onclick = (e) => {
      if (e.target === modal) closeHandler();
    };
    loadModVersions(mod.id, versionList);
  }
 }
 async function loadModVersions(modId, container) {
  container.innerHTML = `
    <div class="loading-versions">
      <i class="fas fa-spinner fa-spin fa-2x" style="margin-bottom: 10px; display: block;"></i>
      <span>Loading versions...</span>
    </div>
  `;
  try {
    const versions = await window.electronAPI.getModFiles(modId);
    if (!versions || versions.length === 0) {
      container.innerHTML = `<div class="p-4 text-center text-gray-400" style="padding: 2rem;">No versions found for this mod.</div>`;
      return;
    }
    // Sort versions by date desc (API returns desc but ensure)
    versions.sort((a, b) => new Date(b.fileDate) - new Date(a.fileDate));
    container.innerHTML = versions.map(file => `
      <div class="version-item">
        <div class="version-info">
          <div class="version-name">${file.displayName}</div>
          <div class="version-meta">
            <span><i class="fas fa-calendar"></i> ${new Date(file.fileDate).toLocaleDateString()}</span>
            <span><i class="fas fa-download"></i> ${formatNumber(file.downloadCount)}</span>
            <span><i class="fas fa-file-archive"></i> ${(file.fileLength / 1024 / 1024).toFixed(2)} MB</span>
          </div>
        </div>
        <div class="version-actions">
          <button class="btn-install" data-file-id="${file.id}">
            Install
          </button>
        </div>
      </div>
    `).join('');
    // Add event listeners securely
    container.querySelectorAll('.btn-install').forEach((btn, index) => {
      const file = versions[index]; // Map index to file data
      btn.onclick = () => installVersion(file);
    });
  } catch (error) {
    console.error('Error loading versions:', error);
    container.innerHTML = `<div class="p-4 text-center text-red-400" style="padding: 2rem;">Error loading versions.<br><small>${error.message}</small></div>`;
  }
 }
 async function installVersion(file) {
  if (!currentSelectedMod) return;
  const modal = document.getElementById('versionSelectModal');
  modal.style.display = 'none';
  const modInfo = {
    ...currentSelectedMod,
    fileId: file.id,
    downloadUrl: file.downloadUrl,
    fileName: file.fileName,
    fileSize: file.fileLength
  };
  await downloadAndInstallMod(modInfo);
  currentSelectedMod = null;
 }
 async function downloadAndInstallMod(modInfo) {
  try {
    const downloadMsg = window.i18n ? window.i18n.t('notifications.modsDownloading').replace('{name}', modInfo.name) : `Downloading ${modInfo.name}...`;
@@ -762,7 +907,10 @@ window.modsManager = {
  closeMyModsModal,
  viewModPage,
  loadInstalledMods,
-  loadBrowseMods
+  loadBrowseMods,
  openVersionSelectModal
 };
-document.addEventListener('DOMContentLoaded', initModsManager);
+// Remove auto-init since we are now calling it from script.js explicitly
 // which guarantees order and environment readiness
 // document.addEventListener('DOMContentLoaded', initModsManager);
--- a/GUI/js/script.js
+++ b/GUI/js/script.js
@@ -2,7 +2,7 @@ import './ui.js';
 import './install.js';
 import './launcher.js';
 import './news.js';
-import './mods.js';
+import { initModsManager } from './mods.js';
 import './players.js';
 import './settings.js';
 import './logs.js';
@@ -15,6 +15,12 @@ let i18nInitialized = false;
  if (document.readyState === 'complete' || document.readyState === 'interactive') {
    updateLanguageSelector();
    initModsManager();
  } else {
    document.addEventListener('DOMContentLoaded', () => {
      updateLanguageSelector();
      initModsManager();
    });
  }
 })();
@@ -53,7 +59,7 @@ window.closeDiscordPopup = function() {
 };
 window.joinDiscord = async function() {
-  await window.electronAPI?.openExternal('https://discord.gg/hf2pdc');
+  await window.electronAPI?.openExternal('https://discord.gg/Fhbb9Yk5WW');
  try {
    await window.electronAPI?.saveConfig({ discordPopup: true });
--- a/GUI/js/settings.js
+++ b/GUI/js/settings.js
@@ -569,6 +569,7 @@ async function loadAllSettings() {
  await loadLauncherHwAccel();
  await loadGpuPreference();
  await loadVersionBranch();
  await loadWrapperConfigUI();
 }
@@ -1254,3 +1255,235 @@ async function loadVersionBranch() {
    return 'release';
  }
 }
 // === Java Wrapper Configuration UI ===
 let _wrapperConfig = null;
 let _wrapperPreviewOpen = false;
 async function loadWrapperConfigUI() {
  try {
    if (!window.electronAPI || !window.electronAPI.loadWrapperConfig) return;
    _wrapperConfig = await window.electronAPI.loadWrapperConfig();
    renderStripFlagsList();
    renderInjectArgsList();
    setupWrapperEventListeners();
  } catch (error) {
    console.error('Error loading wrapper config UI:', error);
  }
 }
 function renderStripFlagsList() {
  const container = document.getElementById('wrapperStripFlagsList');
  if (!container || !_wrapperConfig) return;
  if (_wrapperConfig.stripFlags.length === 0) {
    container.innerHTML = '<div class="wrapper-items-empty">No flags configured</div>';
    return;
  }
  container.innerHTML = '';
  _wrapperConfig.stripFlags.forEach((flag, index) => {
    const item = document.createElement('div');
    item.className = 'wrapper-item';
    item.innerHTML = `
      <span class="wrapper-item-text">${escapeHtml(flag)}</span>
      <button class="wrapper-item-delete" data-index="${index}" title="Remove">
        <i class="fas fa-trash-alt"></i>
      </button>
    `;
    item.querySelector('.wrapper-item-delete').addEventListener('click', () => removeStripFlag(index));
    container.appendChild(item);
  });
 }
 function renderInjectArgsList() {
  const container = document.getElementById('wrapperInjectArgsList');
  if (!container || !_wrapperConfig) return;
  if (_wrapperConfig.injectArgs.length === 0) {
    container.innerHTML = '<div class="wrapper-items-empty">No arguments configured</div>';
    return;
  }
  container.innerHTML = '';
  _wrapperConfig.injectArgs.forEach((entry, index) => {
    const item = document.createElement('div');
    item.className = 'wrapper-item';
    const serverLabel = window.i18n ? window.i18n.t('settings.wrapperConditionServer') : 'Server Only';
    const alwaysLabel = window.i18n ? window.i18n.t('settings.wrapperConditionAlways') : 'Always';
    item.innerHTML = `
      <span class="wrapper-item-text">${escapeHtml(entry.arg)}</span>
      <div class="wrapper-item-condition">
        <select data-index="${index}">
          <option value="server"${entry.condition === 'server' ? ' selected' : ''}>${serverLabel}</option>
          <option value="always"${entry.condition === 'always' ? ' selected' : ''}>${alwaysLabel}</option>
        </select>
      </div>
      <button class="wrapper-item-delete" data-index="${index}" title="Remove">
        <i class="fas fa-trash-alt"></i>
      </button>
    `;
    item.querySelector('select').addEventListener('change', (e) => updateArgCondition(index, e.target.value));
    item.querySelector('.wrapper-item-delete').addEventListener('click', () => removeInjectArg(index));
    container.appendChild(item);
  });
 }
 async function addStripFlag() {
  const input = document.getElementById('wrapperAddFlagInput');
  if (!input || !_wrapperConfig) return;
  const flag = input.value.trim();
  if (!flag) return;
  if (_wrapperConfig.stripFlags.includes(flag)) {
    const msg = window.i18n ? window.i18n.t('notifications.wrapperFlagExists') : 'This flag is already in the list';
    showNotification(msg, 'error');
    return;
  }
  _wrapperConfig.stripFlags.push(flag);
  input.value = '';
  renderStripFlagsList();
  await saveWrapperConfigToBackend();
  await updateWrapperPreview();
 }
 async function removeStripFlag(index) {
  if (!_wrapperConfig) return;
  _wrapperConfig.stripFlags.splice(index, 1);
  renderStripFlagsList();
  await saveWrapperConfigToBackend();
  await updateWrapperPreview();
 }
 async function addInjectArg() {
  const input = document.getElementById('wrapperAddArgInput');
  const condSelect = document.getElementById('wrapperAddArgCondition');
  if (!input || !condSelect || !_wrapperConfig) return;
  const arg = input.value.trim();
  if (!arg) return;
  const exists = _wrapperConfig.injectArgs.some(e => e.arg === arg);
  if (exists) {
    const msg = window.i18n ? window.i18n.t('notifications.wrapperArgExists') : 'This argument is already in the list';
    showNotification(msg, 'error');
    return;
  }
  _wrapperConfig.injectArgs.push({ arg, condition: condSelect.value });
  input.value = '';
  renderInjectArgsList();
  await saveWrapperConfigToBackend();
  await updateWrapperPreview();
 }
 async function removeInjectArg(index) {
  if (!_wrapperConfig) return;
  _wrapperConfig.injectArgs.splice(index, 1);
  renderInjectArgsList();
  await saveWrapperConfigToBackend();
  await updateWrapperPreview();
 }
 async function updateArgCondition(index, condition) {
  if (!_wrapperConfig || !_wrapperConfig.injectArgs[index]) return;
  _wrapperConfig.injectArgs[index].condition = condition;
  await saveWrapperConfigToBackend();
  await updateWrapperPreview();
 }
 async function saveWrapperConfigToBackend() {
  try {
    const result = await window.electronAPI.saveWrapperConfig(_wrapperConfig);
    if (!result || !result.success) {
      throw new Error(result?.error || 'Save failed');
    }
  } catch (error) {
    console.error('Error saving wrapper config:', error);
    const msg = window.i18n ? window.i18n.t('notifications.wrapperConfigSaveFailed') : 'Failed to save wrapper configuration';
    showNotification(msg, 'error');
  }
 }
 function setupWrapperEventListeners() {
  const addFlagBtn = document.getElementById('wrapperAddFlagBtn');
  const addFlagInput = document.getElementById('wrapperAddFlagInput');
  const addArgBtn = document.getElementById('wrapperAddArgBtn');
  const addArgInput = document.getElementById('wrapperAddArgInput');
  const restoreBtn = document.getElementById('wrapperRestoreDefaultsBtn');
  const previewToggle = document.getElementById('wrapperPreviewToggle');
  if (addFlagBtn) addFlagBtn.addEventListener('click', addStripFlag);
  if (addFlagInput) addFlagInput.addEventListener('keydown', (e) => { if (e.key === 'Enter') addStripFlag(); });
  if (addArgBtn) addArgBtn.addEventListener('click', addInjectArg);
  if (addArgInput) addArgInput.addEventListener('keydown', (e) => { if (e.key === 'Enter') addInjectArg(); });
  if (restoreBtn) {
    restoreBtn.addEventListener('click', () => {
      const message = window.i18n ? window.i18n.t('confirm.resetWrapperMessage') : 'Are you sure you want to restore defaults? Your custom changes will be lost.';
      const title = window.i18n ? window.i18n.t('confirm.resetWrapperTitle') : 'Restore Defaults';
      showCustomConfirm(message, title, async () => {
        try {
          const result = await window.electronAPI.resetWrapperConfig();
          if (result && result.success) {
            _wrapperConfig = result.config;
            renderStripFlagsList();
            renderInjectArgsList();
            await updateWrapperPreview();
            const msg = window.i18n ? window.i18n.t('notifications.wrapperConfigReset') : 'Wrapper configuration restored to defaults';
            showNotification(msg, 'success');
          } else {
            throw new Error(result?.error || 'Reset failed');
          }
        } catch (error) {
          console.error('Error resetting wrapper config:', error);
          const msg = window.i18n ? window.i18n.t('notifications.wrapperConfigResetFailed') : 'Failed to restore wrapper configuration';
          showNotification(msg, 'error');
        }
      });
    });
  }
  if (previewToggle) {
    previewToggle.addEventListener('click', toggleWrapperPreview);
  }
 }
 async function toggleWrapperPreview() {
  const container = document.getElementById('wrapperPreviewContainer');
  const chevron = document.getElementById('wrapperPreviewChevron');
  if (!container) return;
  _wrapperPreviewOpen = !_wrapperPreviewOpen;
  if (_wrapperPreviewOpen) {
    container.style.display = 'block';
    if (chevron) chevron.classList.add('expanded');
    await updateWrapperPreview();
  } else {
    container.style.display = 'none';
    if (chevron) chevron.classList.remove('expanded');
  }
 }
 async function updateWrapperPreview() {
  if (!_wrapperPreviewOpen || !_wrapperConfig) return;
  const previewEl = document.getElementById('wrapperPreviewContent');
  if (!previewEl) return;
  try {
    const platform = await window.electronAPI.getCurrentPlatform();
    const script = await window.electronAPI.previewWrapperScript(_wrapperConfig, platform);
    previewEl.textContent = script;
  } catch (error) {
    previewEl.textContent = 'Error generating preview: ' + error.message;
  }
 }
--- a/GUI/js/ui.js
+++ b/GUI/js/ui.js
@@ -1103,7 +1103,7 @@ function getRetryContextMessage() {
 }
 window.openDiscordExternal = function() {
-  window.electronAPI?.openExternal('https://discord.gg/hf2pdc');
+  window.electronAPI?.openExternal('https://discord.gg/Fhbb9Yk5WW');
 };
 window.toggleMaximize = toggleMaximize;
--- a/GUI/locales/ar-SA.json
+++ b/GUI/locales/ar-SA.json
@@ -0,0 +1,263 @@
 {
  "nav": {
    "play": "لعب",
    "mods": "المودات",
    "news": "الأخبار",
    "chat": "دردشة اللاعبين",
    "settings": "الإعدادات"
  },
  "header": {
    "playersLabel": "اللاعبون:",
    "manageProfiles": "إدارة الملفات الشخصية",
    "defaultProfile": "الافتراضي"
  },
  "install": {
    "title": "مشغل اللعب المجاني",
    "playerName": "اسم اللاعب",
    "playerNamePlaceholder": "أدخل اسمك",
    "gameBranch": "إصدار اللعبة",
    "releaseVersion": "إصدار نهائي (مستقر)",
    "preReleaseVersion": "إصدار تجريبي (تجريبي)",
    "customInstallation": "تثبيت مخصص",
    "installationFolder": "مجلد التثبيت",
    "pathPlaceholder": "الموقع الافتراضي",
    "browse": "تصفح",
    "installButton": "تثبيت HYTALE",
    "installing": "جاري التثبيت..."
  },
  "play": {
    "ready": "جاهز للعب",
    "subtitle": "شغل Hytale وابدأ المغامرة",
    "playButton": "لعب HYTALE",
    "latestNews": "آخر الأخبار",
    "viewAll": "عرض الكل",
    "checking": "جاري التحقق...",
    "play": "بدء"
  },
  "mods": {
    "searchPlaceholder": "البحث عن مودات...",
    "myMods": "موداتي",
    "previous": "السابق",
    "next": "التالي",
    "page": "صفحة",
    "of": "من",
    "modalTitle": "موداتي",
    "noModsFound": "لم يتم العثور على مودات",
    "noModsFoundDesc": "حاول تعديل معايير البحث",
    "noModsInstalled": "لا توجد مودات مثبتة",
    "noModsInstalledDesc": "أضف مودات من CurseForge أو استورد ملفات محلية",
    "view": "عرض",
    "install": "تثبيت",
    "installed": "مثبت",
    "enable": "تفعيل",
    "disable": "تعطيل",
    "active": "نشط",
    "disabled": "معطل",
    "delete": "حذف المود",
    "noDescription": "لا يوجد وصف متاح",
    "confirmDelete": "هل أنت متأكد أنك تريد حذف \"{name}\"؟",
    "confirmDeleteDesc": "لا يمكن التراجع عن هذا الإجراء.",
    "confirmDeletion": "تأكيد الحذف",
    "apiKeyRequired": "مطلوب مفتاح API",
    "apiKeyRequiredDesc": "مطلوب مفتاح CurseForge API لتصفح المودات"
  },
  "news": {
    "title": "كل الأخبار",
    "readMore": "اقرأ المزيد"
  },
  "chat": {
    "title": "دردشة اللاعبين",
    "pickColor": "اللون",
    "inputPlaceholder": "اكتب رسالتك...",
    "send": "إرسال",
    "online": "متصل",
    "charCounter": "{current}/{max}",
    "secureChat": "دردشة آمنة - الروابط محجوبة",
    "joinChat": "انضمام للدردشة",
    "chooseUsername": "اختر اسم مستخدم للانضمام إلى دردشة اللاعبين",
    "username": "اسم المستخدم",
    "usernamePlaceholder": "أدخل اسم المستخدم...",
    "usernameHint": "3-20 حرفاً، حروف، أرقام، و - و _ فقط",
    "joinButton": "انضمام",
    "colorModal": {
      "title": "تخصيص لون اسم المستخدم",
      "chooseSolid": "اختر لوناً ثابتاً:",
      "customColor": "لون مخصص:",
      "preview": "معاينة:",
      "previewUsername": "اسم المستخدم",
      "apply": "تطبيق اللون"
    }
  },
  "settings": {
    "title": "الإعدادات",
    "java": "بيئة تشغيل جافا",
    "useCustomJava": "استخدام مسار جافا مخصص",
    "javaDescription": "تجاوز بيئة جافا المرفقة واستخدام تثبيت خاص بك",
    "javaPath": "مسار ملف جافا التنفيذي",
    "javaPathPlaceholder": "اختر مسار جافا...",
    "javaBrowse": "تصفح",
    "javaHint": "اختر مجلد تثبيت جافا (يدعم ويندوز، ماك، ولينكس)",
    "discord": "تكامل ديسكورد",
    "enableRPC": "تفعيل نشاط ديسكورد (Rich Presence)",
    "discordDescription": "إظهار نشاط المشغل الخاص بك على ديسكورد",
    "game": "خيارات اللعبة",
    "playerName": "اسم اللاعب",
    "playerNamePlaceholder": "أدخل اسم اللاعب",
    "playerNameHint": "سيتم استخدام هذا الاسم داخل اللعبة (1-16 حرفاً)",
    "openGameLocation": "فتح موقع اللعبة",
    "openGameLocationDesc": "فتح مجلد تثبيت اللعبة",
    "account": "إدارة UUID اللاعب",
    "currentUUID": "الـ UUID الحالي",
    "uuidPlaceholder": "جاري تحميل UUID...",
    "copyUUID": "نسخ UUID",
    "regenerateUUID": "إعادة إنشاء UUID",
    "uuidHint": "معرف اللاعب الفريد الخاص بك لهذا الاسم",
    "manageUUIDs": "إدارة جميع الـ UUIDs",
    "manageUUIDsDesc": "عرض وإدارة جميع معرفات اللاعبين",
    "language": "اللغة",
    "selectLanguage": "اختر اللغة",
    "repairGame": "إصلاح اللعبة",
    "reinstallGame": "إعادة تثبيت ملفات اللعبة (يحفظ البيانات)",
    "gpuPreference": "تفضيل معالج الرسوميات (GPU)",
    "gpuHint": "ميزة للمحمول فقط؛ اضبطها على Integrated إذا كنت تستخدم كمبيوتر مكتبي",
    "gpuAuto": "تلقائي",
    "gpuIntegrated": "مدمج",
    "gpuDedicated": "منفصل",
    "logs": "سجلات النظام",
    "logsCopy": "نسخ",
    "logsRefresh": "تحديث",
    "logsFolder": "فتح المجلد",
    "logsSend": "إرسال السجلات",
    "logsSending": "جارٍ الإرسال...",
    "logsSent": "تم الإرسال!",
    "logsSendFailed": "فشل",
    "logsSubmissionId": "معرف الإرسال",
    "logsShareId": "شارك هذا المعرف مع الدعم عند الإبلاغ عن المشاكل",
    "logsLoading": "جاري تحميل السجلات...",
    "closeLauncher": "سلوك المشغل",
    "closeOnStart": "إغلاق المشغل عند بدء اللعبة",
    "closeOnStartDescription": "إغلاق المشغل تلقائياً بعد تشغيل Hytale",
    "hwAccel": "تسريع الأجهزة (Hardware Acceleration)",
    "hwAccelDescription": "تفعيل تسريع الأجهزة للمشغل",
    "gameBranch": "فرع اللعبة",
    "branchRelease": "إصدار نهائي",
    "branchPreRelease": "إصدار تجريبي",
    "branchHint": "التبديل بين الإصدار المستقر والإصدار التجريبي",
    "branchWarning": "تغيير الفرع سيؤدي إلى تحميل وتثبيت نسخة مختلفة من اللعبة",
    "branchSwitching": "جاري التبديل إلى {branch}...",
    "branchSwitched": "تم التبديل إلى {branch} بنجاح!",
    "installRequired": "التثبيت مطلوب",
    "branchInstallConfirm": "سيتم تثبيت اللعبة لفرع {branch}. هل تريد الاستمرار؟"
  },
  "uuid": {
    "modalTitle": "إدارة UUID",
    "currentUserUUID": "UUID المستخدم الحالي",
    "allPlayerUUIDs": "جميع معرفات UUID للاعبين",
    "generateNew": "إنشاء UUID جديد",
    "loadingUUIDs": "جاري تحميل الـ UUIDs...",
    "setCustomUUID": "تعيين UUID مخصص",
    "customPlaceholder": "أدخل UUID مخصص (الصيغة: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)",
    "setUUID": "تعيين UUID",
    "warning": "تحذير: تعيين UUID مخصص سيغير هوية اللاعب الحالية",
    "copyTooltip": "نسخ UUID",
    "regenerateTooltip": "إنشاء UUID جديد"
  },
  "profiles": {
    "modalTitle": "إدارة الملفات الشخصية",
    "newProfilePlaceholder": "اسم الملف الشخصي الجديد",
    "createProfile": "إنشاء ملف شخصي"
  },
  "discord": {
    "notificationText": "انضم إلى مجتمعنا على ديسكورد!",
    "joinButton": "انضم إلى ديسكورد"
  },
  "common": {
    "confirm": "تأكيد",
    "cancel": "إلغاء",
    "save": "حفظ",
    "close": "إغلاق",
    "delete": "حذف",
    "edit": "تعديل",
    "loading": "جاري التحميل...",
    "apply": "تطبيق",
    "install": "تثبيت"
  },
  "notifications": {
    "gameDataNotFound": "خطأ: لم يتم العثور على بيانات اللعبة",
    "gameUpdatedSuccess": "تم تحديث اللعبة بنجاح! 🎉",
    "updateFailed": "فشل التحديث: {error}",
    "updateError": "خطأ في التحديث: {error}",
    "discordEnabled": "تم تفعيل نشاط ديسكورد",
    "discordDisabled": "تم تعطيل نشاط ديسكورد",
    "discordSaveFailed": "فشل حفظ إعدادات ديسكورد",
    "playerNameRequired": "يرجى إدخال اسم لاعب صالح",
    "playerNameSaved": "تم حفظ اسم اللاعب بنجاح",
    "playerNameSaveFailed": "فشل حفظ اسم اللاعب",
    "uuidCopied": "تم نسخ الـ UUID إلى الحافظة!",
    "uuidCopyFailed": "فشل نسخ الـ UUID",
    "uuidRegenNotAvailable": "إعادة إنشاء UUID غير متاحة",
    "uuidRegenFailed": "فشل إعادة إنشاء الـ UUID",
    "uuidGenerated": "تم إنشاء UUID جديد بنجاح!",
    "uuidGeneratedShort": "تم إنشاء UUID جديد!",
    "uuidGenerateFailed": "فشل إنشاء UUID جديد",
    "uuidRequired": "يرجى إدخال UUID",
    "uuidInvalidFormat": "صيغة UUID غير صالحة",
    "uuidSetFailed": "فشل تعيين الـ UUID المخصص",
    "uuidSetSuccess": "تم تعيين الـ UUID المخصص بنجاح!",
    "uuidDeleteFailed": "فشل حذف الـ UUID",
    "uuidDeleteSuccess": "تم حذف الـ UUID بنجاح!",
    "modsDownloading": "جاري تحميل {name}...",
    "modsTogglingMod": "جاري تبديل حالة المود...",
    "modsDeletingMod": "جاري حذف المود...",
    "modsLoadingMods": "جاري تحميل المودات من CurseForge...",
    "modsInstalledSuccess": "تم تثبيت {name} بنجاح! 🎉",
    "modsDeletedSuccess": "تم حذف {name} بنجاح",
    "modsDownloadFailed": "فشل تحميل المود: {error}",
    "modsToggleFailed": "فشل تبديل المود: {error}",
    "modsDeleteFailed": "فشل حذف المود: {error}",
    "modsModNotFound": "لم يتم العثور على معلومات المود",
    "hwAccelSaved": "تم حفظ إعداد تسريع الأجهزة",
    "hwAccelSaveFailed": "فشل حفظ إعداد تسريع الأجهزة",
    "noUsername": "لم يتم تهيئة اسم مستخدم. يرجى حفظ اسم المستخدم أولاً.",
    "switchUsernameSuccess": "تم التبديل إلى المستخدم \"{username}\" بنجاح!",
    "switchUsernameFailed": "فشل تبديل اسم المستخدم",
    "playerNameTooLong": "يجب أن يكون اسم اللاعب 16 حرفاً أو أقل"
  },
  "confirm": {
    "defaultTitle": "تأكيد الإجراء",
    "regenerateUuidTitle": "إنشاء UUID جديد",
    "regenerateUuidMessage": "هل أنت متأكد أنك تريد إنشاء UUID جديد؟ سيؤدي ذلك إلى تغيير هوية اللاعب الخاصة بك.",
    "regenerateUuidButton": "إنشاء",
    "setCustomUuidTitle": "تعيين UUID مخصص",
    "setCustomUuidMessage": "هل أنت متأكد أنك تريد تعيين هذا الـ UUID المخصص؟ سيؤدي ذلك إلى تغيير هوية اللاعب الخاصة بك.",
    "setCustomUuidButton": "تعيين UUID",
    "deleteUuidTitle": "حذف UUID",
    "deleteUuidMessage": "هل أنت متأكد أنك تريد حذف الـ UUID الخاص بـ \"{username}\"؟ لا يمكن التراجع عن هذا الإجراء.",
    "deleteUuidButton": "حذف",
    "uninstallGameTitle": "إلغاء تثبيت اللعبة",
    "uninstallGameMessage": "هل أنت متأكد أنك تريد إلغاء تثبيت Hytale؟ سيتم حذف جميع ملفات اللعبة.",
    "uninstallGameButton": "إلغاء التثبيت",
    "switchUsernameTitle": "تبديل الهوية",
    "switchUsernameMessage": "التبديل إلى اسم المستخدم \"{username}\"؟ سيؤدي هذا إلى تغيير هوية اللاعب الحالية.",
    "switchUsernameButton": "تبديل"
  },
  "progress": {
    "initializing": "جاري التهيئة...",
    "downloading": "جاري التحميل...",
    "installing": "جاري التثبيت...",
    "extracting": "جاري الاستخراج...",
    "verifying": "جاري التحقق...",
    "switchingProfile": "جاري تبديل الملف الشخصي...",
    "profileSwitched": "تم تبديل الملف الشخصي!",
    "startingGame": "جاري بدء اللعبة...",
    "launching": "جاري التشغيل...",
    "uninstallingGame": "جاري إلغاء تثبيت اللعبة...",
    "gameUninstalled": "تم إلغاء تثبيت اللعبة بنجاح!",
    "uninstallFailed": "فشل إلغاء التثبيت: {error}",
    "startingUpdate": "جاري بدء تحديث اللعبة الإجباري...",
    "installationComplete": "تم اكتمال التثبيت بنجاح!",
    "installationFailed": "فشل التثبيت: {error}",
    "installingGameFiles": "جاري تثبيت ملفات اللعبة...",
    "installComplete": "اكتمل التثبيت!"
  }
 }
--- a/GUI/locales/de-DE.json
+++ b/GUI/locales/de-DE.json
@@ -127,6 +127,12 @@
    "logsCopy": "Kopieren",
    "logsRefresh": "Aktualisieren",
    "logsFolder": "Ordner öffnen",
    "logsSend": "Logs senden",
    "logsSending": "Senden...",
    "logsSent": "Gesendet!",
    "logsSendFailed": "Fehlgeschlagen",
    "logsSubmissionId": "Einreichungs-ID",
    "logsShareId": "Teilen Sie diese ID dem Support mit, wenn Sie Probleme melden",
    "logsLoading": "Protokolle werden geladen...",
    "closeLauncher": "Launcher-Verhalten",
    "closeOnStart": "Launcher beim Spielstart schließen",
--- a/GUI/locales/en.json
+++ b/GUI/locales/en.json
@@ -127,6 +127,12 @@
    "logsCopy": "Copy",
    "logsRefresh": "Refresh",
    "logsFolder": "Open Folder",
    "logsSend": "Send Logs",
    "logsSending": "Sending...",
    "logsSent": "Sent!",
    "logsSendFailed": "Failed",
    "logsSubmissionId": "Submission ID",
    "logsShareId": "Share this ID with support when reporting issues",
    "logsLoading": "Loading logs...",
    "closeLauncher": "Launcher Behavior",
    "closeOnStart": "Close Launcher on game start",
@@ -141,7 +147,18 @@
    "branchSwitching": "Switching to {branch}...",
    "branchSwitched": "Switched to {branch} successfully!",
    "installRequired": "Installation Required",
-    "branchInstallConfirm": "The game will be installed for the {branch} branch. Continue?"
+    "branchInstallConfirm": "The game will be installed for the {branch} branch. Continue?",
    "wrapperConfig": "Java Wrapper Configuration",
    "wrapperConfigHint": "Configure how the Java wrapper handles JVM flags and arguments at launch time.",
    "wrapperStripFlags": "JVM Flags to Remove",
    "wrapperInjectArgs": "Arguments to Inject",
    "wrapperAddFlagPlaceholder": "e.g. -XX:+SomeFlag",
    "wrapperAddArgPlaceholder": "e.g. --some-flag",
    "wrapperAdd": "Add",
    "wrapperConditionServer": "Server Only",
    "wrapperConditionAlways": "Always",
    "wrapperRestoreDefaults": "Restore Defaults",
    "wrapperAdvancedPreview": "Advanced: Script Preview"
  },
  "uuid": {
    "modalTitle": "UUID Management",
@@ -215,7 +232,13 @@
    "noUsername": "No username configured. Please save your username first.",
    "switchUsernameSuccess": "Switched to \"{username}\" successfully!",
    "switchUsernameFailed": "Failed to switch username",
-    "playerNameTooLong": "Player name must be 16 characters or less"
+    "playerNameTooLong": "Player name must be 16 characters or less",
    "wrapperConfigSaved": "Wrapper configuration saved",
    "wrapperConfigSaveFailed": "Failed to save wrapper configuration",
    "wrapperConfigReset": "Wrapper configuration restored to defaults",
    "wrapperConfigResetFailed": "Failed to restore wrapper configuration",
    "wrapperFlagExists": "This flag is already in the list",
    "wrapperArgExists": "This argument is already in the list"
  },
  "confirm": {
    "defaultTitle": "Confirm action",
@@ -233,7 +256,9 @@
    "uninstallGameButton": "Uninstall",
    "switchUsernameTitle": "Switch Identity",
    "switchUsernameMessage": "Switch to username \"{username}\"? This will change your current player identity.",
-    "switchUsernameButton": "Switch"
+    "switchUsernameButton": "Switch",
    "resetWrapperTitle": "Restore Defaults",
    "resetWrapperMessage": "Are you sure you want to restore the default wrapper configuration? Your custom changes will be lost."
  },
  "progress": {
    "initializing": "Initializing...",
--- a/GUI/locales/es-ES.json
+++ b/GUI/locales/es-ES.json
@@ -127,6 +127,12 @@
    "logsCopy": "Copiar",
    "logsRefresh": "Actualizar",
    "logsFolder": "Abrir Carpeta",
    "logsSend": "Enviar logs",
    "logsSending": "Enviando...",
    "logsSent": "Enviado!",
    "logsSendFailed": "Fallido",
    "logsSubmissionId": "ID de envío",
    "logsShareId": "Comparte este ID con soporte al reportar problemas",
    "logsLoading": "Cargando registros...",
    "closeLauncher": "Comportamiento del Launcher",
    "closeOnStart": "Cerrar Launcher al iniciar el juego",
--- a/GUI/locales/fr-FR.json
+++ b/GUI/locales/fr-FR.json
@@ -127,6 +127,12 @@
    "logsCopy": "Copier",
    "logsRefresh": "Actualiser",
    "logsFolder": "Ouvrir le Dossier",
    "logsSend": "Envoyer les logs",
    "logsSending": "Envoi...",
    "logsSent": "Envoyé !",
    "logsSendFailed": "Échoué",
    "logsSubmissionId": "ID de soumission",
    "logsShareId": "Partagez cet ID avec le support pour signaler des problèmes",
    "logsLoading": "Chargement des journaux...",
    "closeLauncher": "Comportement du Launcher",
    "closeOnStart": "Fermer le Launcher au démarrage du jeu",
--- a/GUI/locales/id-ID.json
+++ b/GUI/locales/id-ID.json
@@ -127,6 +127,12 @@
    "logsCopy": "Salin",
    "logsRefresh": "Segarkan",
    "logsFolder": "Buka Folder",
    "logsSend": "Kirim Log",
    "logsSending": "Mengirim...",
    "logsSent": "Terkirim!",
    "logsSendFailed": "Gagal",
    "logsSubmissionId": "ID Pengiriman",
    "logsShareId": "Bagikan ID ini ke dukungan saat melaporkan masalah",
    "logsLoading": "Memuat log...",
    "closeLauncher": "Perilaku Launcher",
    "closeOnStart": "Tutup launcher saat game dimulai",
--- a/GUI/locales/pl-PL.json
+++ b/GUI/locales/pl-PL.json
@@ -127,6 +127,12 @@
    "logsCopy": "Kopiuj",
    "logsRefresh": "Odśwież",
    "logsFolder": "Otwórz Folder",
    "logsSend": "Wyślij logi",
    "logsSending": "Wysyłanie...",
    "logsSent": "Wysłano!",
    "logsSendFailed": "Błąd",
    "logsSubmissionId": "ID zgłoszenia",
    "logsShareId": "Udostępnij ten ID wsparciu technicznemu przy zgłaszaniu problemów",
    "logsLoading": "Ładowanie logów...",
    "closeLauncher": "Zachowanie Launchera",
    "closeOnStart": "Zamknij Launcher przy starcie gry",
--- a/GUI/locales/pt-BR.json
+++ b/GUI/locales/pt-BR.json
@@ -127,6 +127,12 @@
    "logsCopy": "Copiar",
    "logsRefresh": "Atualizar",
    "logsFolder": "Abrir Pasta",
    "logsSend": "Enviar logs",
    "logsSending": "Enviando...",
    "logsSent": "Enviado!",
    "logsSendFailed": "Falhou",
    "logsSubmissionId": "ID de envio",
    "logsShareId": "Compartilhe este ID com o suporte ao relatar problemas",
    "logsLoading": "Carregando registros...",
    "closeLauncher": "Comportamento do Lançador",
    "closeOnStart": "Fechar Lançador ao iniciar o jogo",
--- a/GUI/locales/ru-RU.json
+++ b/GUI/locales/ru-RU.json
@@ -127,6 +127,12 @@
    "logsCopy": "Копировать",
    "logsRefresh": "Обновить",
    "logsFolder": "Открыть папку",
    "logsSend": "Отправить логи",
    "logsSending": "Отправка...",
    "logsSent": "Отправлено!",
    "logsSendFailed": "Ошибка",
    "logsSubmissionId": "ID отправки",
    "logsShareId": "Поделитесь этим ID с поддержкой при обращении",
    "logsLoading": "Загрузка логов...",
    "closeLauncher": "Поведение лаунчера",
    "closeOnStart": "Закрыть лаунчер при старте игры",
--- a/GUI/locales/sv-SE.json
+++ b/GUI/locales/sv-SE.json
@@ -127,6 +127,12 @@
    "logsCopy": "Kopiera",
    "logsRefresh": "Uppdatera",
    "logsFolder": "Öppna mapp",
    "logsSend": "Skicka loggar",
    "logsSending": "Skickar...",
    "logsSent": "Skickat!",
    "logsSendFailed": "Misslyckades",
    "logsSubmissionId": "Inlämnings-ID",
    "logsShareId": "Dela detta ID med support vid felanmälan",
    "logsLoading": "Laddar loggar...",
    "closeLauncher": "Launcher-beteende",
    "closeOnStart": "Stäng launcher vid spelstart",
--- a/GUI/locales/tr-TR.json
+++ b/GUI/locales/tr-TR.json
@@ -127,6 +127,12 @@
    "logsCopy": "Kopyala",
    "logsRefresh": "Yenile",
    "logsFolder": "Klasörü Aç",
    "logsSend": "Logları Gönder",
    "logsSending": "Gönderiliyor...",
    "logsSent": "Gönderildi!",
    "logsSendFailed": "Başarısız",
    "logsSubmissionId": "Gönderim ID",
    "logsShareId": "Sorun bildirirken bu ID'yi destekle paylaşın",
    "logsLoading": "Loglar yükleniyor...",
    "closeLauncher": "Başlatıcı Davranışı",
    "closeOnStart": "Oyun başlatıldığında Başlatıcıyı Kapat",
--- a/GUI/style-RTL.css
+++ b/GUI/style-RTL.css
@@ -0,0 +1,209 @@
 body.rtl {
    direction: rtl;
    font-family: 'Noto Sans Arabic', 'Space Grotesk', sans-serif;
 }
 body.rtl .sidebar {
    right: 0;
    left: auto;
    border-right: none;
    border-left: 1px solid rgba(255, 255, 255, 0.1);
 }
 body.rtl .nav-item.active::before {
    right: -8px;
    left: auto;
    border-radius: 4px 0 0 4px;
 }
 body.rtl .nav-tooltip {
    right: 100%;
    left: auto;
    margin-right: 0.5rem;
    margin-left: 0;
 }
 body.rtl .nav-item:hover .nav-tooltip {
    transform: translateX(-8px);
 }
 body.rtl .main-content {
    margin-right: 80px;
    margin-left: 0;
 }
 /* Header Layout*/
 body.rtl .players-counter {
    order: 2;
    margin-left: 1.5rem;
    margin-right: 0;
 }
 body.rtl .profile-selector {
    order: -1;
 }
 body.rtl .window-controls {
    order: 3;
    flex-direction: row;
 }
 body.rtl .profile-dropdown {
    right: auto;
    left: 0;
 }
 body.rtl .form-group {
    text-align: right;
 }
 body.rtl .radio-label,
 body.rtl .checkbox-group {
    flex-direction: row-reverse;
 }
 body.rtl .form-input {
    border-radius: 0 8px 8px 0;
 }
 body.rtl .mods-pagination {
    flex-direction: row-reverse;
 }
 body.rtl .pagination-btn:first-child i {
    transform: rotate(180deg);
 }
 body.rtl .pagination-btn:last-child i {
    transform: rotate(180deg);
 }
 /* UUID Display */
 body.rtl .uuid-display-container {
    flex-direction: row-reverse;
 }
 body.rtl .uuid-btn {
    border-radius: 0 8px 8px 0;
 }
 body.rtl .uuid-input {
    border-radius: 8px 0 0 8px;
 }
 body.rtl .segmented-control {
    flex-direction: row-reverse;
 }
 /*  Mod Grid Layout */
 body.rtl .mods-search {
    text-align: right;
 }
 body.rtl .mods-search-container {
    flex-direction: row-reverse;
 }
 body.rtl .mods-actions {
    order: -1;
 }
 body.rtl .mod-card {
    direction: rtl;
 }
 body.rtl .installed-mod-card {
    direction: rtl;
 }
 body.rtl .installed-mod-card .mod-info {
    text-align: right;
 }
 body.rtl .mods-header {
    flex-direction: row-reverse;
 }
 body.rtl .news-section .news-header {
    flex-direction: row-reverse;
 }
 /* Settings Layout */
 body.rtl .settings-option {
    text-align: right;
 }
 body.rtl .settings-input-group {
    text-align: right;
 }
 body.rtl .settings-input {
    border-radius: 0 8px 8px 0;
 }
 body.rtl .settings-section-title i {
    margin-right: 0;
    margin-left: 0.5rem;
 }
 body.rtl .settings-hint i {
    margin-right: 0;
    margin-left: 0.5rem;
 }
 body.rtl .custom-options,
 body.rtl .custom-java-options {
    text-align: right;
 }
 body.rtl .checkbox-content {
    margin-right: 2rem;
    margin-left: 0;
 }
 body.rtl .btn-content {
    text-align: right;
 }
 /* Icons & Transformations */
 body.rtl .news-title i {
    padding-left: 0.5rem;
 }
 body.rtl .uuid-modal-title i {
    padding-left: 0.5rem;
 }
 body.rtl .mods-modal-title i {
    padding-left: 0.5rem;
 }
 body.rtl .view-all-btn i,
 body.rtl .sidebar-nav div i,
 body.rtl .logs-header i,
 body.rtl .home-play-button i {
    transform: scaleX(-1);
 }
 body.rtl .play-title i {
    transform: scaleX(-1);
    padding-right: 0.5rem;
 }
 body.rtl .logs-terminal {
    direction: ltr;
    text-align: left;
 }
 body.rtl .version-display-bottom {
    right: auto;
    left: 1rem;
 }
--- a/GUI/style.css
+++ b/GUI/style.css
@@ -873,6 +873,22 @@ body {
    border-color: rgba(255, 255, 255, 0.2);
 }
 .logs-action-btn.logs-send-btn {
    background: rgba(0, 212, 255, 0.15);
    border-color: rgba(0, 212, 255, 0.3);
    color: #00d4ff;
 }
 .logs-action-btn.logs-send-btn:hover {
    background: rgba(0, 212, 255, 0.25);
    border-color: rgba(0, 212, 255, 0.5);
 }
 .logs-action-btn.logs-send-btn:disabled {
    opacity: 0.6;
    cursor: not-allowed;
 }
 .logs-terminal {
    flex: 1;
    background: #0d1117;
@@ -4813,6 +4829,140 @@ select.settings-input option {
    transform: translateY(0);
 }
 .wrapper-items-list {
    display: flex;
    flex-direction: column;
    gap: 6px;
 }
 .wrapper-item {
    display: flex;
    align-items: center;
    justify-content: space-between;
    padding: 8px 12px;
    background: rgba(0, 0, 0, 0.3);
    border: 1px solid rgba(255, 255, 255, 0.1);
    border-radius: 8px;
    transition: all 0.3s ease;
 }
 .wrapper-item:hover {
    border-color: rgba(147, 51, 234, 0.3);
    background: rgba(147, 51, 234, 0.05);
 }
 .wrapper-item-text {
    font-family: 'JetBrains Mono', 'Courier New', monospace;
    font-size: 0.82rem;
    color: #e5e7eb;
    flex: 1;
    overflow: hidden;
    text-overflow: ellipsis;
    white-space: nowrap;
 }
 .wrapper-item-condition select {
    background: rgba(0, 0, 0, 0.4);
    border: 1px solid rgba(255, 255, 255, 0.15);
    border-radius: 6px;
    color: #e5e7eb;
    font-size: 0.75rem;
    padding: 4px 8px;
    cursor: pointer;
    margin: 0 8px;
 }
 .wrapper-item-condition select:focus {
    outline: none;
    border-color: rgba(147, 51, 234, 0.5);
 }
 .wrapper-item-delete {
    padding: 4px 8px;
    background: rgba(255, 255, 255, 0.05);
    border: 1px solid rgba(255, 255, 255, 0.1);
    border-radius: 6px;
    color: rgba(255, 255, 255, 0.5);
    cursor: pointer;
    transition: all 0.3s ease;
    font-size: 0.8rem;
    display: flex;
    align-items: center;
    justify-content: center;
    min-width: 28px;
    height: 28px;
 }
 .wrapper-item-delete:hover {
    background: rgba(239, 68, 68, 0.2);
    border-color: rgba(239, 68, 68, 0.4);
    color: #ef4444;
 }
 .wrapper-items-empty {
    font-style: italic;
    text-align: center;
    color: rgba(255, 255, 255, 0.4);
    padding: 12px;
    font-size: 0.82rem;
 }
 .wrapper-condition-select {
    background: rgba(0, 0, 0, 0.4);
    border: 1px solid rgba(255, 255, 255, 0.15);
    border-radius: 6px;
    color: #e5e7eb;
    font-size: 0.82rem;
    padding: 6px 10px;
    cursor: pointer;
 }
 .wrapper-condition-select:focus {
    outline: none;
    border-color: rgba(147, 51, 234, 0.5);
 }
 .wrapper-preview-toggle {
    background: none;
    border: none;
    color: rgba(255, 255, 255, 0.6);
    cursor: pointer;
    font-size: 0.82rem;
    padding: 4px 0;
    display: flex;
    align-items: center;
    gap: 6px;
    transition: color 0.2s;
 }
 .wrapper-preview-toggle:hover {
    color: rgba(255, 255, 255, 0.9);
 }
 .wrapper-preview-toggle i {
    transition: transform 0.2s;
    font-size: 0.7rem;
 }
 .wrapper-preview-toggle i.expanded {
    transform: rotate(90deg);
 }
 .wrapper-preview-content {
    background: rgba(0, 0, 0, 0.4);
    border: 1px solid rgba(255, 255, 255, 0.1);
    border-radius: 8px;
    color: rgba(255, 255, 255, 0.7);
    font-family: 'JetBrains Mono', 'Courier New', monospace;
    font-size: 0.72rem;
    line-height: 1.5;
    padding: 12px;
    max-height: 300px;
    overflow: auto;
    white-space: pre;
    tab-size: 4;
 }
 .settings-hint {
    margin-top: 0.5rem;
    font-size: 0.8rem;
@@ -6460,3 +6610,85 @@ input[type="text"].uuid-input,
    opacity: 0.5;
    cursor: not-allowed;
 }
 /* Version Selection Styles */
 .version-list-container::-webkit-scrollbar {
    width: 6px;
 }
 .version-list-container::-webkit-scrollbar-thumb {
    background: rgba(255, 255, 255, 0.2);
    border-radius: 3px;
 }
 .version-item {
    display: flex;
    justify-content: space-between;
    align-items: center;
    padding: 1rem;
    background: rgba(255, 255, 255, 0.05);
    border: 1px solid rgba(255, 255, 255, 0.1);
    border-radius: 8px;
    margin-bottom: 0.5rem;
    transition: all 0.2s ease;
 }
 .version-item:hover {
    background: rgba(255, 255, 255, 0.1);
    transform: translateX(4px);
 }
 .version-info {
    display: flex;
    flex-direction: column;
    gap: 0.25rem;
 }
 .version-name {
    font-weight: 600;
    color: #fff;
    font-size: 0.95rem;
 }
 .version-meta {
    font-size: 0.8rem;
    color: #a0a0a0;
    display: flex;
    gap: 1rem;
    align-items: center;
 }
 .version-meta span {
    display: flex;
    align-items: center;
    gap: 0.35rem;
 }
 .version-meta i {
    font-size: 0.8em;
    opacity: 0.7;
 }
 .version-actions .btn-install {
    padding: 0.5rem 1.25rem;
    background: linear-gradient(135deg, #3b82f6, #2563eb);
    color: white;
    border: none;
    border-radius: 6px;
    cursor: pointer;
    font-weight: 600;
    font-size: 0.85rem;
    transition: all 0.2s;
    box-shadow: 0 4px 6px rgba(0, 0, 0, 0.2);
 }
 .version-actions .btn-install:hover {
    transform: translateY(-1px);
    box-shadow: 0 6px 8px rgba(0, 0, 0, 0.3);
    background: linear-gradient(135deg, #4f93f6, #3b82f6);
 }
 .loading-versions {
    padding: 3rem;
    text-align: center;
 }
--- a/README.md
+++ b/README.md
@@ -18,7 +18,7 @@
 ### ⚠️ **WARNING: READ [QUICK START](#-quick-start) before Downloading & Installing the Launcher!** ⚠️
-#### 🛑 **Found a problem? [Join the HF2P Discord](https://discord.gg/hf2pdc) and head to `#-⚠️-community-help`** 🛑
+#### 🛑 **Found a problem? [Join the HF2P Discord](https://discord.gg/Fhbb9Yk5WW) and head to `#-⚠️-community-help`** 🛑
 <p>
  👍 If you like the project, <b>feel free to support us via Buy Me a Coffee!</b> ☕<br>
@@ -455,7 +455,7 @@ See [BUILD.md](docs/BUILD.md) for comprehensive build instructions.
 <div align="center">
 **Questions? Ads? Collaboration? Endorsement? Other business-related?** 
-Message the founders at https://discord.gg/hf2pdc
+Message the founders at https://discord.gg/Fhbb9Yk5WW
 </div>
--- a/SERVER.md
+++ b/SERVER.md
@@ -2,7 +2,7 @@
 Play with friends online! This guide covers both easy in-game hosting and advanced dedicated server setup.
-### **DOWNLOAD SERVER FILES (JAR/RAR/SCRIPTS) HERE: https://discord.gg/hf2pdc** 
+### **DOWNLOAD SERVER FILES (JAR/RAR/SCRIPTS) HERE: https://discord.gg/Fhbb9Yk5WW** 
 **Table of Contents**
--- a/TROUBLESHOOTING.md
+++ b/TROUBLESHOOTING.md
@@ -1,6 +1,6 @@
 # Hytale F2P Launcher - Troubleshooting Guide
-This guide covers common issues and their solutions. If your issue isn't listed here, please check [existing issues](https://github.com/amiayweb/Hytale-F2P/issues) or join our [Discord](https://discord.gg/gME8rUy3MB).
+This guide covers common issues and their solutions. If your issue isn't listed here, please check [existing issues](https://github.com/amiayweb/Hytale-F2P/issues) or join our [Discord](https://discord.gg/Fhbb9Yk5WW).
 ---
@@ -437,7 +437,7 @@ Game sessions have a 10-hour TTL. This is by design for security.
 If your issue isn't resolved by this guide:
 1. **Check existing issues:** [GitHub Issues](https://github.com/amiayweb/Hytale-F2P/issues)
-2. **Join Discord:** [discord.gg/gME8rUy3MB](https://discord.gg/gME8rUy3MB)
+2. **Join Discord:** [discord.gg/Fhbb9Yk5WW](https://discord.gg/Fhbb9Yk5WW)
 3. **Open a new issue** with:
   - Your operating system and version
   - Launcher version
--- a/backend/core/config.js
+++ b/backend/core/config.js
@@ -54,6 +54,7 @@ function getAppDir() {
 const CONFIG_FILE = path.join(getAppDir(), 'config.json');
 const CONFIG_BACKUP = path.join(getAppDir(), 'config.json.bak');
 const CONFIG_TEMP = path.join(getAppDir(), 'config.json.tmp');
 const UUID_STORE_FILE = path.join(getAppDir(), 'uuid-store.json');
 // =============================================================================
 // CONFIG VALIDATION
@@ -152,6 +153,22 @@ function saveConfig(update) {
      // Load current config
      const currentConfig = loadConfig();
      // SAFETY: If config file exists on disk but loadConfig() returned empty,
      // something is wrong (file locked, corrupted, etc.). Refuse to save
      // because merging with {} would wipe all existing data (userUuids, username, etc.)
      if (Object.keys(currentConfig).length === 0 && fs.existsSync(CONFIG_FILE)) {
        const fileSize = fs.statSync(CONFIG_FILE).size;
        if (fileSize > 2) { // More than just "{}"
          console.error(`[Config] REFUSING to save — loaded empty but file exists (${fileSize} bytes). Retrying load...`);
          // Wait and retry the load
          const delay = attempt * 200;
          const start = Date.now();
          while (Date.now() - start < delay) { /* busy wait */ }
          continue;
        }
      }
      const newConfig = { ...currentConfig, ...update };
      const data = JSON.stringify(newConfig, null, 2);
@@ -238,11 +255,18 @@ function saveUsername(username) {
  // Check if we're actually changing the username (case-insensitive comparison)
  const isRename = currentName && currentName.toLowerCase() !== newName.toLowerCase();
  // Also update UUID store (source of truth)
  migrateUuidStoreIfNeeded();
  const uuidStore = loadUuidStore();
  if (isRename) {
    // Find the UUID for the current username
    const currentKey = Object.keys(userUuids).find(
      k => k.toLowerCase() === currentName.toLowerCase()
    );
    const currentStoreKey = Object.keys(uuidStore).find(
      k => k.toLowerCase() === currentName.toLowerCase()
    );
    if (currentKey && userUuids[currentKey]) {
      // Check if target username already exists (would be a different identity)
@@ -258,6 +282,9 @@ function saveUsername(username) {
        const uuid = userUuids[currentKey];
        delete userUuids[currentKey];
        userUuids[newName] = uuid;
        // Same in UUID store
        if (currentStoreKey) delete uuidStore[currentStoreKey];
        uuidStore[newName] = uuid;
        console.log(`[Config] Renamed identity: "${currentKey}" → "${newName}" (UUID preserved: ${uuid})`);
      }
    }
@@ -270,11 +297,20 @@ function saveUsername(username) {
      const uuid = userUuids[currentKey];
      delete userUuids[currentKey];
      userUuids[newName] = uuid;
      // Same in UUID store
      const storeKey = Object.keys(uuidStore).find(k => k.toLowerCase() === currentName.toLowerCase());
      if (storeKey) {
        delete uuidStore[storeKey];
        uuidStore[newName] = uuid;
      }
      console.log(`[Config] Updated username case: "${currentKey}" → "${newName}"`);
    }
  }
-  // Save both username and updated userUuids
+  // Save UUID store
  saveUuidStore(uuidStore);
  // Save both username and updated userUuids to config
  saveConfig({ username: newName, userUuids });
  console.log(`[Config] Username saved: "${newName}"`);
  return newName;
@@ -310,6 +346,7 @@ function hasUsername() {
 // =============================================================================
 // UUID MANAGEMENT - Persistent and safe
 // Uses separate uuid-store.json as source of truth (survives config.json corruption)
 // =============================================================================
 /**
@@ -320,10 +357,55 @@ function normalizeUsername(username) {
  return username.trim().toLowerCase();
 }
 /**
 * Load UUID store from separate file (independent of config.json)
 */
 function loadUuidStore() {
  try {
    if (fs.existsSync(UUID_STORE_FILE)) {
      const data = fs.readFileSync(UUID_STORE_FILE, 'utf8');
      if (data.trim()) {
        return JSON.parse(data);
      }
    }
  } catch (err) {
    console.error('[UUID Store] Failed to load:', err.message);
  }
  return {};
 }
 /**
 * Save UUID store to separate file (atomic write)
 */
 function saveUuidStore(store) {
  try {
    const dir = path.dirname(UUID_STORE_FILE);
    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
    const tmpFile = UUID_STORE_FILE + '.tmp';
    fs.writeFileSync(tmpFile, JSON.stringify(store, null, 2), 'utf8');
    fs.renameSync(tmpFile, UUID_STORE_FILE);
  } catch (err) {
    console.error('[UUID Store] Failed to save:', err.message);
  }
 }
 /**
 * One-time migration: copy userUuids from config.json to uuid-store.json
 */
 function migrateUuidStoreIfNeeded() {
  if (fs.existsSync(UUID_STORE_FILE)) return; // Already migrated
  const config = loadConfig();
  if (config.userUuids && Object.keys(config.userUuids).length > 0) {
    console.log('[UUID Store] Migrating', Object.keys(config.userUuids).length, 'UUIDs from config.json');
    saveUuidStore(config.userUuids);
  }
 }
 /**
 * Get UUID for a username
- * Creates new UUID only if user explicitly doesn't exist
+ * Source of truth: uuid-store.json (separate from config.json)
- * Uses case-insensitive lookup to prevent duplicates, but preserves original case for display
+ * Also writes to config.json for backward compatibility
 * Creates new UUID only if user doesn't exist in EITHER store
 */
 function getUuidForUser(username) {
  const { v4: uuidv4 } = require('uuid');
@@ -335,32 +417,69 @@ function getUuidForUser(username) {
  const displayName = username.trim();
  const normalizedLookup = displayName.toLowerCase();
-  const config = loadConfig();
+  // Ensure UUID store exists (one-time migration from config.json)
-  const userUuids = config.userUuids || {};
+  migrateUuidStoreIfNeeded();
-  // Case-insensitive lookup - find existing key regardless of case
+  // 1. Check UUID store first (source of truth)
-  const existingKey = Object.keys(userUuids).find(k => k.toLowerCase() === normalizedLookup);
+  const uuidStore = loadUuidStore();
  const storeKey = Object.keys(uuidStore).find(k => k.toLowerCase() === normalizedLookup);
-  if (existingKey) {
+  if (storeKey) {
-    // Found existing - return UUID, update display name if case changed
+    const existingUuid = uuidStore[storeKey];
    const existingUuid = userUuids[existingKey];
-    // If user typed different case, update the key to new case (preserving UUID)
+    // Update case if needed
-    if (existingKey !== displayName) {
+    if (storeKey !== displayName) {
-      console.log(`[Config] Updating username case: "${existingKey}" → "${displayName}"`);
+      console.log(`[UUID Store] Updating username case: "${storeKey}" → "${displayName}"`);
-      delete userUuids[existingKey];
+      delete uuidStore[storeKey];
-      userUuids[displayName] = existingUuid;
+      uuidStore[displayName] = existingUuid;
-      saveConfig({ userUuids });
+      saveUuidStore(uuidStore);
    }
    // Sync to config.json (backward compat, non-critical)
    try {
      const config = loadConfig();
      const configUuids = config.userUuids || {};
      const configKey = Object.keys(configUuids).find(k => k.toLowerCase() === normalizedLookup);
      if (!configKey || configUuids[configKey] !== existingUuid) {
        if (configKey) delete configUuids[configKey];
        configUuids[displayName] = existingUuid;
        saveConfig({ userUuids: configUuids });
      }
    } catch (e) {
      // Non-critical — UUID store is the source of truth
    }
    console.log(`[UUID] ${displayName} → ${existingUuid} (from uuid-store)`);
    return existingUuid;
  }
-  // Create new UUID for new user - store with original case
+  // 2. Fallback: check config.json (recovery if uuid-store.json was lost)
  const config = loadConfig();
  const userUuids = config.userUuids || {};
  const configKey = Object.keys(userUuids).find(k => k.toLowerCase() === normalizedLookup);
  if (configKey) {
    const recoveredUuid = userUuids[configKey];
    console.warn(`[UUID] RECOVERED "${displayName}" → ${recoveredUuid} from config.json (uuid-store was missing)`);
    // Save to UUID store
    uuidStore[displayName] = recoveredUuid;
    saveUuidStore(uuidStore);
    return recoveredUuid;
  }
  // 3. New user — generate UUID, save to BOTH stores
  const newUuid = uuidv4();
  console.log(`[UUID] NEW user "${displayName}" → ${newUuid}`);
  // Save to UUID store (source of truth)
  uuidStore[displayName] = newUuid;
  saveUuidStore(uuidStore);
  // Save to config.json (backward compat)
  userUuids[displayName] = newUuid;
  saveConfig({ userUuids });
  console.log(`[Config] Created new UUID for "${displayName}": ${newUuid}`);
  return newUuid;
 }
@@ -380,22 +499,26 @@ function getCurrentUuid() {
 * Get all UUID mappings (raw object)
 */
 function getAllUuidMappings() {
-  const config = loadConfig();
+  migrateUuidStoreIfNeeded();
-  return config.userUuids || {};
+  const uuidStore = loadUuidStore();
  // Fallback to config if uuid-store is empty
  if (Object.keys(uuidStore).length === 0) {
    const config = loadConfig();
    return config.userUuids || {};
  }
  return uuidStore;
 }
 /**
 * Get all UUID mappings as array with current user flag
 */
 function getAllUuidMappingsArray() {
-  const config = loadConfig();
+  const allMappings = getAllUuidMappings();
  const userUuids = config.userUuids || {};
  const currentUsername = loadUsername();
  // Case-insensitive comparison for isCurrent
  const normalizedCurrent = currentUsername ? currentUsername.toLowerCase() : null;
-  return Object.entries(userUuids).map(([username, uuid]) => ({
+  return Object.entries(allMappings).map(([username, uuid]) => ({
-    username,  // Original case preserved
+    username,
    uuid,
    isCurrent: username.toLowerCase() === normalizedCurrent
  }));
@@ -419,16 +542,20 @@ function setUuidForUser(username, uuid) {
  const displayName = username.trim();
  const normalizedLookup = displayName.toLowerCase();
  // 1. Update UUID store (source of truth)
  migrateUuidStoreIfNeeded();
  const uuidStore = loadUuidStore();
  const storeKey = Object.keys(uuidStore).find(k => k.toLowerCase() === normalizedLookup);
  if (storeKey) delete uuidStore[storeKey];
  uuidStore[displayName] = uuid;
  saveUuidStore(uuidStore);
  // 2. Update config.json (backward compat)
  const config = loadConfig();
  const userUuids = config.userUuids || {};
  // Remove any existing entry with same name (case-insensitive)
  const existingKey = Object.keys(userUuids).find(k => k.toLowerCase() === normalizedLookup);
-  if (existingKey) {
+  if (existingKey) delete userUuids[existingKey];
    delete userUuids[existingKey];
  }
  // Store with original case
  userUuids[displayName] = uuid;
  saveConfig({ userUuids });
@@ -454,20 +581,30 @@ function deleteUuidForUser(username) {
  }
  const normalizedLookup = username.trim().toLowerCase();
  let deleted = false;
  // 1. Delete from UUID store (source of truth)
  migrateUuidStoreIfNeeded();
  const uuidStore = loadUuidStore();
  const storeKey = Object.keys(uuidStore).find(k => k.toLowerCase() === normalizedLookup);
  if (storeKey) {
    delete uuidStore[storeKey];
    saveUuidStore(uuidStore);
    deleted = true;
  }
  // 2. Delete from config.json (backward compat)
  const config = loadConfig();
  const userUuids = config.userUuids || {};
  // Case-insensitive lookup
  const existingKey = Object.keys(userUuids).find(k => k.toLowerCase() === normalizedLookup);
  if (existingKey) {
    delete userUuids[existingKey];
    saveConfig({ userUuids });
-    console.log(`[Config] UUID deleted for "${username}"`);
+    deleted = true;
    return true;
  }
-  return false;
+  if (deleted) console.log(`[Config] UUID deleted for "${username}"`);
  return deleted;
 }
 /**
@@ -721,6 +858,212 @@ function checkLaunchReady() {
  };
 }
 // =============================================================================
 // JAVA WRAPPER CONFIGURATION (Structured)
 // =============================================================================
 const DEFAULT_WRAPPER_CONFIG = {
  stripFlags: ['-XX:+UseCompactObjectHeaders'],
  injectArgs: [
    { arg: '--disable-sentry', condition: 'server' }
  ]
 };
 function getDefaultWrapperConfig() {
  return JSON.parse(JSON.stringify(DEFAULT_WRAPPER_CONFIG));
 }
 function loadWrapperConfig() {
  const config = loadConfig();
  if (config.javaWrapperConfig && typeof config.javaWrapperConfig === 'object') {
    const wc = config.javaWrapperConfig;
    if (Array.isArray(wc.stripFlags) && Array.isArray(wc.injectArgs)) {
      const loaded = JSON.parse(JSON.stringify(wc));
      // Normalize entries: ensure every injectArg has a valid condition
      for (const entry of loaded.injectArgs) {
        if (!['server', 'always'].includes(entry.condition)) {
          entry.condition = 'always';
        }
      }
      return loaded;
    }
  }
  return getDefaultWrapperConfig();
 }
 function saveWrapperConfig(wrapperConfig) {
  if (!wrapperConfig || typeof wrapperConfig !== 'object') {
    throw new Error('Invalid wrapper config');
  }
  if (!Array.isArray(wrapperConfig.stripFlags) || !Array.isArray(wrapperConfig.injectArgs)) {
    throw new Error('Invalid wrapper config structure');
  }
  // Validate injectArgs entries
  for (const entry of wrapperConfig.injectArgs) {
    if (!entry.arg || typeof entry.arg !== 'string') {
      throw new Error('Each inject arg must have a string "arg" property');
    }
    if (!['server', 'always'].includes(entry.condition)) {
      throw new Error('Inject arg condition must be "server" or "always"');
    }
  }
  saveConfig({ javaWrapperConfig: wrapperConfig });
  console.log('[Config] Wrapper config saved');
 }
 function resetWrapperConfig() {
  const config = loadConfig();
  delete config.javaWrapperConfig;
  delete config.javaWrapperScripts; // Clean up legacy key if present
  // Write the cleaned config using the same atomic pattern as saveConfig.
  // We cannot use saveConfig() here because it merges (spread) which cannot remove keys.
  const data = JSON.stringify(config, null, 2);
  fs.writeFileSync(CONFIG_TEMP, data, 'utf8');
  if (fs.existsSync(CONFIG_FILE)) {
    fs.copyFileSync(CONFIG_FILE, CONFIG_BACKUP);
  }
  fs.renameSync(CONFIG_TEMP, CONFIG_FILE);
  console.log('[Config] Wrapper config reset to default');
  return getDefaultWrapperConfig();
 }
 /**
 * Generate a platform-specific wrapper script from structured config
 * @param {Object} config - { stripFlags: string[], injectArgs: {arg, condition}[] }
 * @param {string} platform - 'darwin', 'win32', or 'linux'
 * @param {string|null} javaBin - Path to real java binary (required for darwin/linux)
 * @returns {string} Generated script content
 */
 function generateWrapperScript(config, platform, javaBin) {
  const { stripFlags, injectArgs } = config;
  const alwaysArgs = injectArgs.filter(a => a.condition === 'always');
  const serverArgs = injectArgs.filter(a => a.condition === 'server');
  if (platform === 'win32') {
    return _generateWindowsWrapper(stripFlags, alwaysArgs, serverArgs);
  } else {
    return _generateUnixWrapper(stripFlags, alwaysArgs, serverArgs, javaBin);
  }
 }
 function _generateUnixWrapper(stripFlags, alwaysArgs, serverArgs, javaBin) {
  const lines = [
    '#!/bin/bash',
    '# Java wrapper - generated by HytaleF2P launcher',
    `REAL_JAVA="${javaBin || '${JAVA_BIN}'}"`,
    'ARGS=("$@")',
    ''
  ];
  // Strip flags
  if (stripFlags.length > 0) {
    lines.push('# Strip JVM flags');
    lines.push('FILTERED_ARGS=()');
    lines.push('for arg in "${ARGS[@]}"; do');
    lines.push('  case "$arg" in');
    for (const flag of stripFlags) {
      lines.push(`    "${flag}") echo "[Wrapper] Stripped: $arg" ;;`);
    }
    lines.push('    *) FILTERED_ARGS+=("$arg") ;;');
    lines.push('  esac');
    lines.push('done');
  } else {
    lines.push('FILTERED_ARGS=("${ARGS[@]}")');
  }
  lines.push('');
  // Always-inject args
  if (alwaysArgs.length > 0) {
    lines.push('# Inject args (always)');
    for (const a of alwaysArgs) {
      lines.push(`FILTERED_ARGS+=("${a.arg}")`);
      lines.push(`echo "[Wrapper] Injected ${a.arg}"`);
    }
    lines.push('');
  }
  // Server-conditional args (appended after HytaleServer.jar if present)
  if (serverArgs.length > 0) {
    lines.push('# Inject args (server only)');
    lines.push('IS_SERVER=false');
    lines.push('for arg in "${FILTERED_ARGS[@]}"; do');
    lines.push('  if [[ "$arg" == *"HytaleServer.jar"* ]]; then');
    lines.push('    IS_SERVER=true');
    lines.push('    break');
    lines.push('  fi');
    lines.push('done');
    lines.push('if [ "$IS_SERVER" = true ]; then');
    for (const a of serverArgs) {
      lines.push(`  FILTERED_ARGS+=("${a.arg}")`);
      lines.push(`  echo "[Wrapper] Injected ${a.arg}"`);
    }
    lines.push('fi');
    lines.push('');
  }
  lines.push('echo "[Wrapper] Executing: $REAL_JAVA ${FILTERED_ARGS[*]}"');
  lines.push('exec "$REAL_JAVA" "${FILTERED_ARGS[@]}"');
  lines.push('');
  return lines.join('\n');
 }
 function _generateWindowsWrapper(stripFlags, alwaysArgs, serverArgs) {
  const lines = [
    '@echo off',
    'setlocal EnableDelayedExpansion',
    '',
    'REM Java wrapper - generated by HytaleF2P launcher',
    'set "REAL_JAVA=%~dp0java-original.exe"',
    'set "ARGS=%*"',
    ''
  ];
  // Strip flags using string replacement
  if (stripFlags.length > 0) {
    lines.push('REM Strip JVM flags');
    for (const flag of stripFlags) {
      lines.push(`set "ARGS=!ARGS:${flag}=!"`);
    }
    lines.push('');
  }
  // Always-inject args
  const alwaysExtra = alwaysArgs.map(a => a.arg).join(' ');
  // Server-conditional args
  if (serverArgs.length > 0) {
    const serverExtra = serverArgs.map(a => a.arg).join(' ');
    lines.push('REM Check if running HytaleServer.jar and inject server args');
    lines.push('echo !ARGS! | findstr /i "HytaleServer.jar" >nul 2>&1');
    lines.push('if "!ERRORLEVEL!"=="0" (');
    if (alwaysExtra) {
      lines.push(`    echo [Wrapper] Injected ${alwaysExtra} ${serverExtra}`);
      lines.push(`    "%REAL_JAVA%" !ARGS! ${alwaysExtra} ${serverExtra}`);
    } else {
      lines.push(`    echo [Wrapper] Injected ${serverExtra}`);
      lines.push(`    "%REAL_JAVA%" !ARGS! ${serverExtra}`);
    }
    lines.push(') else (');
    if (alwaysExtra) {
      lines.push(`    "%REAL_JAVA%" !ARGS! ${alwaysExtra}`);
    } else {
      lines.push('    "%REAL_JAVA%" !ARGS!');
    }
    lines.push(')');
  } else if (alwaysExtra) {
    lines.push(`"%REAL_JAVA%" !ARGS! ${alwaysExtra}`);
  } else {
    lines.push('"%REAL_JAVA%" !ARGS!');
  }
  lines.push('exit /b !ERRORLEVEL!');
  lines.push('');
  return lines.join('\r\n');
 }
 // =============================================================================
 // EXPORTS
 // =============================================================================
@@ -787,6 +1130,14 @@ module.exports = {
  saveVersionBranch,
  loadVersionBranch,
  // Java Wrapper Config
  getDefaultWrapperConfig,
  loadWrapperConfig,
  saveWrapperConfig,
  resetWrapperConfig,
  generateWrapperScript,
  // Constants
-  CONFIG_FILE
+  CONFIG_FILE,
  UUID_STORE_FILE
 };
--- a/backend/launcher.js
+++ b/backend/launcher.js
@@ -45,7 +45,13 @@ const {
  saveVersionClient,
  loadVersionClient,
  saveVersionBranch,
-  loadVersionBranch
+  loadVersionBranch,
  // Java Wrapper Config
  getDefaultWrapperConfig,
  loadWrapperConfig,
  saveWrapperConfig,
  resetWrapperConfig,
  generateWrapperScript
 } = require('./core/config');
 const { getResolvedAppDir, getModsPath } = require('./core/paths');
@@ -78,7 +84,8 @@ const {
  loadInstalledMods,
  downloadMod,
  uninstallMod,
-  toggleMod
+  toggleMod,
  getModFiles
 } = require('./managers/modManager');
 // Services
@@ -181,6 +188,7 @@ module.exports = {
  downloadMod,
  uninstallMod,
  toggleMod,
  getModFiles,
  saveModsToConfig,
  loadModsFromConfig,
@@ -197,6 +205,13 @@ module.exports = {
  proposeGameUpdate,
  handleFirstLaunchCheck,
  // Java Wrapper Config functions
  getDefaultWrapperConfig,
  loadWrapperConfig,
  saveWrapperConfig,
  resetWrapperConfig,
  generateWrapperScript,
  // Path functions
  getResolvedAppDir
 };
--- a/backend/managers/differentialUpdateManager.js
+++ b/backend/managers/differentialUpdateManager.js
@@ -3,7 +3,7 @@ const path = require('path');
 const { execFile } = require('child_process');
 const { downloadFile, retryDownload } = require('../utils/fileManager');
 const { getOS, getArch } = require('../utils/platformUtils');
-const { validateChecksum, extractVersionDetails, getInstalledClientVersion, getUpdatePlan, extractVersionNumber } = require('../services/versionManager');
+const { validateChecksum, extractVersionDetails, getInstalledClientVersion, getUpdatePlan, extractVersionNumber, getAllMirrorUrls, getPatchesBaseUrl } = require('../services/versionManager');
 const { installButler } = require('./butlerManager');
 const { GAME_DIR, CACHE_DIR, TOOLS_DIR } = require('../core/paths');
 const { saveVersionClient } = require('../core/config');
@@ -31,15 +31,62 @@ async function acquireGameArchive(downloadUrl, targetPath, checksum, progressCal
  console.log(`Downloading game archive from: ${downloadUrl}`);
-  try {
+  // Try primary URL first, then mirror URLs on timeout/connection failure
-    if (allowRetry) {
+  const mirrors = await getAllMirrorUrls();
-      await retryDownload(downloadUrl, targetPath, progressCallback);
+  const primaryBase = await getPatchesBaseUrl();
-    } else {
+  const urlsToTry = [downloadUrl];
-      await downloadFile(downloadUrl, targetPath, progressCallback);
+
  // Build mirror URLs by replacing the base URL
  for (const mirror of mirrors) {
    if (mirror !== primaryBase && downloadUrl.startsWith(primaryBase)) {
      const mirrorUrl = downloadUrl.replace(primaryBase, mirror);
      if (!urlsToTry.includes(mirrorUrl)) {
        urlsToTry.push(mirrorUrl);
      }
    }
-  } catch (error) {
+  }
-    const enhancedError = new Error(`Archive download failed: ${error.message}`);
+
-    enhancedError.originalError = error;
+  let lastError;
  for (let i = 0; i < urlsToTry.length; i++) {
    const url = urlsToTry[i];
    try {
      if (i > 0) {
        console.log(`[Download] Trying mirror ${i}: ${url}`);
        if (progressCallback) {
          progressCallback(`Trying alternative mirror (${i}/${urlsToTry.length - 1})...`, 0, null, null, null);
        }
        // Clean up partial download from previous attempt
        if (fs.existsSync(targetPath)) {
          try { fs.unlinkSync(targetPath); } catch (e) {}
        }
      }
      if (allowRetry) {
        await retryDownload(url, targetPath, progressCallback);
      } else {
        await downloadFile(url, targetPath, progressCallback);
      }
      lastError = null;
      break; // Success
    } catch (error) {
      lastError = error;
      const isConnectionError = error.message && (
        error.message.includes('ETIMEDOUT') ||
        error.message.includes('ECONNREFUSED') ||
        error.message.includes('ECONNABORTED') ||
        error.message.includes('timeout')
      );
      if (isConnectionError && i < urlsToTry.length - 1) {
        console.warn(`[Download] Connection failed (${error.message}), will try mirror...`);
        continue;
      }
      // Non-connection error or last mirror — throw
      break;
    }
  }
  if (lastError) {
    const enhancedError = new Error(`Archive download failed: ${lastError.message}`);
    enhancedError.originalError = lastError;
    enhancedError.downloadUrl = downloadUrl;
    enhancedError.targetPath = targetPath;
    throw enhancedError;
--- a/backend/managers/gameLauncher.js
+++ b/backend/managers/gameLauncher.js
@@ -18,7 +18,9 @@ const {
  saveVersionClient,
  loadUsername,
  hasUsername,
-  checkLaunchReady
+  checkLaunchReady,
  loadWrapperConfig,
  generateWrapperScript
 } = require('../core/config');
 const { resolveJavaPath, getJavaExec, getBundledJavaPath, detectSystemJava, JAVA_EXECUTABLE } = require('./javaManager');
 const { getLatestClientVersion } = require('../services/versionManager');
@@ -27,6 +29,7 @@ const { ensureGameInstalled } = require('./differentialUpdateManager');
 const { syncModsForCurrentProfile } = require('./modManager');
 const { getUserDataPath } = require('../utils/userDataMigration');
 const { syncServerList } = require('../utils/serverListSync');
 const { killGameProcesses } = require('./gameManager');
 // Client patcher for custom auth server (sanasol.ws)
 let clientPatcher = null;
@@ -250,6 +253,7 @@ async function launchGame(playerNameOverride = null, progressCallback, javaPathO
  }
  const uuid = getUuidForUser(playerName);
  console.log(`[Launcher] UUID for "${playerName}": ${uuid} (verify this stays constant across launches)`);
  // Fetch tokens from auth server
  if (progressCallback) {
@@ -326,23 +330,13 @@ async function launchGame(playerNameOverride = null, progressCallback, javaPathO
        console.log('Signed server binaries (after patching)');
      }
      // Create java wrapper (must be signed on macOS)
      if (javaBin && fs.existsSync(javaBin)) {
        const javaWrapperPath = path.join(path.dirname(javaBin), 'java-wrapper');
-        const wrapperScript = `#!/bin/bash
+        const wrapperScript = generateWrapperScript(loadWrapperConfig(), 'darwin', javaBin);
 # Java wrapper for macOS - adds --disable-sentry to fix Sentry hang issue
 REAL_JAVA="${javaBin}"
 ARGS=("$@")
 for i in "\${!ARGS[@]}"; do
  if [[ "\${ARGS[$i]}" == *"HytaleServer.jar"* ]]; then
    ARGS=("\${ARGS[@]:0:$((i+1))}" "--disable-sentry" "\${ARGS[@]:$((i+1))}")
    break
  fi
 done
 exec "$REAL_JAVA" "\${ARGS[@]}"
 `;
        fs.writeFileSync(javaWrapperPath, wrapperScript, { mode: 0o755 });
        await signPath(javaWrapperPath, false);
-        console.log('Created java wrapper with --disable-sentry fix');
+        console.log('Created java wrapper from config template');
        javaBin = javaWrapperPath;
      }
    } catch (signError) {
@@ -351,6 +345,40 @@ exec "$REAL_JAVA" "\${ARGS[@]}"
    }
  }
  // Windows: Create java wrapper to strip/inject JVM flags per wrapper config
  if (process.platform === 'win32' && javaBin && fs.existsSync(javaBin)) {
    try {
      const javaDir = path.dirname(javaBin);
      const javaOriginal = path.join(javaDir, 'java-original.exe');
      const javaWrapperPath = path.join(javaDir, 'java-wrapper.bat');
      if (!fs.existsSync(javaOriginal)) {
        fs.copyFileSync(javaBin, javaOriginal);
        console.log('Backed up java.exe as java-original.exe');
      }
      const wrapperScript = generateWrapperScript(loadWrapperConfig(), 'win32', null);
      fs.writeFileSync(javaWrapperPath, wrapperScript);
      console.log('Created Windows java wrapper from config template');
      javaBin = javaWrapperPath;
    } catch (wrapperError) {
      console.log('Notice: Windows java wrapper creation failed:', wrapperError.message);
    }
  }
  // Linux: Create java wrapper to strip/inject JVM flags per wrapper config
  if (process.platform === 'linux' && javaBin && fs.existsSync(javaBin)) {
    try {
      const javaWrapperPath = path.join(path.dirname(javaBin), 'java-wrapper');
      const wrapperScript = generateWrapperScript(loadWrapperConfig(), 'linux', javaBin);
      fs.writeFileSync(javaWrapperPath, wrapperScript, { mode: 0o755 });
      console.log('Created Linux java wrapper from config template');
      javaBin = javaWrapperPath;
    } catch (wrapperError) {
      console.log('Notice: Linux java wrapper creation failed:', wrapperError.message);
    }
  }
  const args = [
    '--app-dir', gameLatest,
    '--java-exec', javaBin,
@@ -435,11 +463,27 @@ exec "$REAL_JAVA" "\${ARGS[@]}"
    }
  }
  // Kill any stalled game processes from a previous launch to prevent file locks
  // and "game already running" issues
  await killGameProcesses();
  // Remove AOT cache: generated by official Hytale JRE, incompatible with F2P JRE.
  // Client adds -XX:AOTCache when this file exists, causing classloading failures.
  const aotCache = path.join(gameLatest, 'Server', 'HytaleServer.aot');
  if (fs.existsSync(aotCache)) {
    try {
      fs.unlinkSync(aotCache);
      console.log('Removed incompatible AOT cache (HytaleServer.aot)');
    } catch (aotErr) {
      console.warn('Could not remove AOT cache:', aotErr.message);
    }
  }
  // DualAuth Agent: Set JAVA_TOOL_OPTIONS so java picks up -javaagent: flag
  // This enables runtime auth patching without modifying the server JAR
  const agentJar = path.join(gameLatest, 'Server', 'dualauth-agent.jar');
  if (fs.existsSync(agentJar)) {
-    const agentFlag = `-javaagent:${agentJar}`;
+    const agentFlag = `-javaagent:"${agentJar}"`;
    env.JAVA_TOOL_OPTIONS = env.JAVA_TOOL_OPTIONS
      ? `${env.JAVA_TOOL_OPTIONS} ${agentFlag}`
      : agentFlag;
--- a/backend/managers/gameManager.js
+++ b/backend/managers/gameManager.js
@@ -39,6 +39,41 @@ async function isGameRunning() {
  }
 }
 // Force-kill stalled game processes to release file locks before repair/reinstall.
 // Cross-platform: Windows (taskkill/PowerShell), macOS (pkill), Linux (pkill).
 async function killGameProcesses() {
  const killed = [];
  async function tryKill(command, label) {
    try {
      await execAsync(command);
      killed.push(label);
    } catch (_) { /* process not found is expected */ }
  }
  if (process.platform === 'win32') {
    // Kill client
    await tryKill('taskkill /F /IM "HytaleClient.exe" /T', 'HytaleClient.exe');
    // Kill java.exe instances running HytaleServer.jar via PowerShell
    // (Get-CimInstance replaces deprecated wmic, works on Windows 10+)
    await tryKill(
      'powershell -NoProfile -Command "Get-CimInstance Win32_Process -Filter \\"name=\'java.exe\'\\" | Where-Object { $_.CommandLine -like \'*HytaleServer*\' } | ForEach-Object { Stop-Process -Id $_.ProcessId -Force }"',
      'java.exe(HytaleServer)'
    );
  } else {
    // macOS and Linux
    await tryKill('pkill -9 -f HytaleClient', 'HytaleClient');
    await tryKill('pkill -9 -f HytaleServer', 'HytaleServer');
  }
  if (killed.length > 0) {
    console.log(`[GameManager] Force-killed stalled processes: ${killed.join(', ')}`);
    // Wait for OS to release file handles
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  return killed;
 }
 // Helper function to safely remove directory with retry logic
 async function safeRemoveDirectory(dirPath, maxRetries = 3) {
  for (let attempt = 1; attempt <= maxRetries; attempt++) {
@@ -52,6 +87,11 @@ async function safeRemoveDirectory(dirPath, maxRetries = 3) {
      console.warn(`Attempt ${attempt}/${maxRetries} failed to remove ${dirPath}: ${error.message}`);
      if (attempt < maxRetries) {
        // On EPERM/EBUSY, try killing stalled game processes that hold file locks
        if (attempt === 1 && (error.code === 'EPERM' || error.code === 'EBUSY')) {
          console.log('Permission error detected, killing stalled game processes...');
          await killGameProcesses();
        }
        // Wait before retrying (exponential backoff)
        const delay = Math.min(1000 * Math.pow(2, attempt - 1), 5000);
        console.log(`Waiting ${delay}ms before retry...`);
@@ -64,7 +104,7 @@ async function safeRemoveDirectory(dirPath, maxRetries = 3) {
  }
 }
-async function downloadPWR(branch = 'release', fileName = 'v8', progressCallback, cacheDir = CACHE_DIR, manualRetry = false, directUrl = null) {
+async function downloadPWR(branch = 'release', fileName = 'v8', progressCallback, cacheDir = CACHE_DIR, manualRetry = false, directUrl = null, expectedSize = null) {
  const osName = getOS();
  const arch = getArch();
@@ -85,22 +125,53 @@ async function downloadPWR(branch = 'release', fileName = 'v8', progressCallback
      console.log(`[DownloadPWR] Mirror URL: ${url}`);
    } catch (error) {
      console.error(`[DownloadPWR] Failed to get mirror URL: ${error.message}`);
-      const { MIRROR_BASE_URL } = require('../services/versionManager');
+      const { getPatchesBaseUrl } = require('../services/versionManager');
-      url = `${MIRROR_BASE_URL}/${osName}/${arch}/${branch}/0_to_${extractVersionNumber(fileName)}.pwr`;
+      const baseUrl = await getPatchesBaseUrl();
      url = `${baseUrl}/${osName}/${arch}/${branch}/0_to_${extractVersionNumber(fileName)}.pwr`;
      console.log(`[DownloadPWR] Fallback URL: ${url}`);
    }
  }
  // Look up expected file size from manifest if not provided
  if (!expectedSize) {
    try {
      const { fetchMirrorManifest } = require('../services/versionManager');
      const manifest = await fetchMirrorManifest();
      // Try to match: "0_to_11" format or "v11" format
      const versionMatch = fileName.match(/^(\d+)_to_(\d+)$/);
      let manifestKey;
      if (versionMatch) {
        manifestKey = `${osName}/${arch}/${branch}/${fileName}.pwr`;
      } else {
        const buildNum = extractVersionNumber(fileName);
        manifestKey = `${osName}/${arch}/${branch}/0_to_${buildNum}.pwr`;
      }
      if (manifest.files[manifestKey]) {
        expectedSize = manifest.files[manifestKey].size;
        console.log(`[PWR] Expected size from manifest: ${(expectedSize / 1024 / 1024).toFixed(2)} MB`);
      }
    } catch (e) {
      console.log(`[PWR] Could not fetch expected size from manifest: ${e.message}`);
    }
  }
  const dest = path.join(cacheDir, `${branch}_${fileName}.pwr`);
  // Check if file exists and validate it
  if (fs.existsSync(dest) && !manualRetry) {
    const stats = fs.statSync(dest);
    if (stats.size > 1024 * 1024) {
-      console.log(`[PWR] Using cached file: ${dest} (${(stats.size / 1024 / 1024).toFixed(2)} MB)`);
+      // Validate against expected size - reject if file is truncated (< 99% of expected)
-      return dest;
+      if (expectedSize && stats.size < expectedSize * 0.99) {
        console.log(`[PWR] Cached file truncated: ${(stats.size / 1024 / 1024).toFixed(2)} MB, expected ${(expectedSize / 1024 / 1024).toFixed(2)} MB. Deleting and re-downloading.`);
        fs.unlinkSync(dest);
      } else {
        console.log(`[PWR] Using cached file: ${dest} (${(stats.size / 1024 / 1024).toFixed(2)} MB)`);
        return dest;
      }
    } else {
      console.log(`[PWR] Cached file too small (${stats.size} bytes), re-downloading`);
    }
    console.log(`[PWR] Cached file too small (${stats.size} bytes), re-downloading`);
  }
  console.log(`[DownloadPWR] Downloading from: ${url}`);
@@ -129,7 +200,7 @@ async function downloadPWR(branch = 'release', fileName = 'v8', progressCallback
        const retryStats = fs.statSync(dest);
        console.log(`PWR file downloaded (auto-retry), size: ${(retryStats.size / 1024 / 1024).toFixed(2)} MB`);
-        if (!validatePWRFile(dest)) {
+        if (!validatePWRFile(dest, expectedSize)) {
          console.log(`[PWR Validation] PWR file validation failed after auto-retry, deleting corrupted file: ${dest}`);
          fs.unlinkSync(dest);
          throw new Error('Downloaded PWR file is corrupted or invalid after automatic retry. Please retry manually');
@@ -180,7 +251,7 @@ async function downloadPWR(branch = 'release', fileName = 'v8', progressCallback
  const stats = fs.statSync(dest);
  console.log(`PWR file downloaded, size: ${(stats.size / 1024 / 1024).toFixed(2)} MB`);
-  if (!validatePWRFile(dest)) {
+  if (!validatePWRFile(dest, expectedSize)) {
    console.log(`[PWR Validation] PWR file validation failed, deleting corrupted file: ${dest}`);
    fs.unlinkSync(dest);
    throw new Error('Downloaded PWR file is corrupted or invalid. Please retry');
@@ -440,7 +511,7 @@ async function updateGameFiles(newVersion, progressCallback, gameDir = GAME_DIR,
          progressCallback(`Downloading patch ${i + 1}/${updatePlan.steps.length} (${stepName})...`, progress, null, null, null);
        }
-        const pwrFile = await downloadPWR(branch, stepName, progressCallback, cacheDir, false, step.url);
+        const pwrFile = await downloadPWR(branch, stepName, progressCallback, cacheDir, false, step.url, step.size);
        if (!pwrFile) {
          throw new Error(`Failed to download patch ${stepName}`);
@@ -802,11 +873,14 @@ async function repairGame(progressCallback, branchOverride = null) {
    progressCallback('Removing old game files...', 30, null, null, null);
  }
-  // Check if game is running before attempting to delete files
+  // Kill stalled game processes before attempting to delete files
  const gameRunning = await isGameRunning();
  if (gameRunning) {
-    console.warn('[RepairGame] Game appears to be running. This may cause permission errors during repair.');
+    console.warn('[RepairGame] Game processes detected. Force-killing to release file locks...');
-    console.log('[RepairGame] Please close the game before repairing, or wait for the repair to complete.');
+    if (progressCallback) {
      progressCallback('Stopping stalled game processes...', 20, null, null, null);
    }
    await killGameProcesses();
  }
  // Delete Game and Cache Directory with retry logic
@@ -891,7 +965,7 @@ function validateGameDirectory(gameDir, stagingDir) {
 // Enhanced PWR file validation
 // Accepts intermediate patches (50+ MB) and full installs (1.5+ GB)
-function validatePWRFile(filePath) {
+function validatePWRFile(filePath, expectedSize = null) {
  try {
    if (!fs.existsSync(filePath)) {
      return false;
@@ -906,6 +980,13 @@ function validatePWRFile(filePath) {
      return false;
    }
    // Validate against expected size if known (reject if < 99% of expected)
    if (expectedSize && stats.size < expectedSize * 0.99) {
      const expectedMB = expectedSize / 1024 / 1024;
      console.log(`[PWR Validation] File truncated: ${sizeInMB.toFixed(2)} MB, expected ${expectedMB.toFixed(2)} MB`);
      return false;
    }
    console.log(`[PWR Validation] File size: ${sizeInMB.toFixed(2)} MB - OK`);
    return true;
  } catch (error) {
@@ -926,5 +1007,6 @@ module.exports = {
  installGame,
  uninstallGame,
  checkExistingGameInstallation,
-  repairGame
+  repairGame,
  killGameProcesses
 };
--- a/backend/managers/modManager.js
+++ b/backend/managers/modManager.js
@@ -285,6 +285,27 @@ async function toggleMod(modId, modsPath) {
  }
 }
 async function getModFiles(modId) {
  try {
    const response = await axios.get(`https://api.curseforge.com/v1/mods/${modId}/files`, {
      headers: {
        'x-api-key': API_KEY,
        'Accept': 'application/json'
      },
      params: {
        pageSize: 20,
        sortOrder: 'desc'
      }
    });
    return response.data.data;
  } catch (error) {
    console.error('Error fetching mod files:', error);
    return [];
  }
 }
 async function syncModsForCurrentProfile() {
  try {
    const activeProfile = profileManager.getActiveProfile();
@@ -455,5 +476,6 @@ module.exports = {
  syncModsForCurrentProfile,
  generateModId,
  extractModName,
-  extractVersion
+  extractVersion,
  getModFiles
 };
--- a/backend/services/versionManager.js
+++ b/backend/services/versionManager.js
@@ -1,22 +1,191 @@
 const axios = require('axios');
 const crypto = require('crypto');
 const fs = require('fs');
 const path = require('path');
 const { getOS, getArch } = require('../utils/platformUtils');
-// Patches CDN via auth server redirect gateway (allows instant CDN switching)
+// Patches base URL fetched dynamically via multi-source fallback chain
 const AUTH_DOMAIN = process.env.HYTALE_AUTH_DOMAIN || 'auth.sanasol.ws';
-const MIRROR_BASE_URL = `https://${AUTH_DOMAIN}/patches`;
+const PATCHES_CONFIG_SOURCES = [
-const MIRROR_MANIFEST_URL = `${MIRROR_BASE_URL}/manifest.json`;
+  { type: 'http', url: `https://${AUTH_DOMAIN}/api/patches-config`, name: 'primary' },
  { type: 'http', url: 'https://htdwnldsan.top/patches-config', name: 'backup-1' },
  { type: 'http', url: 'https://dl1.htdwnldsan.top/patches-config', name: 'backup-2' },
  { type: 'doh',  name: '_patches.htdwnldsan.top', name_label: 'dns-txt' },
 ];
 const HARDCODED_FALLBACK = 'https://dl.vboro.de/patches';
 // Alternative mirrors (non-Cloudflare) for regions where CF is blocked
 const NON_CF_MIRRORS = [
  'https://dl1.htdwnldsan.top',
  'https://htdwnldsan.top/patches',
 ];
 // Fallback: latest known build number if manifest is unreachable
 const FALLBACK_LATEST_BUILD = 11;
 let patchesBaseUrl = null;
 let patchesConfigTime = 0;
 const PATCHES_CONFIG_CACHE_DURATION = 300000; // 5 minutes
 let manifestCache = null;
 let manifestCacheTime = 0;
 const MANIFEST_CACHE_DURATION = 60000; // 1 minute
 // Disk cache path for patches URL (survives restarts)
 function getDiskCachePath() {
  const os = require('os');
  const home = os.homedir();
  let appDir;
  if (process.platform === 'win32') {
    appDir = path.join(home, 'AppData', 'Local', 'HytaleF2P');
  } else if (process.platform === 'darwin') {
    appDir = path.join(home, 'Library', 'Application Support', 'HytaleF2P');
  } else {
    appDir = path.join(home, '.hytalef2p');
  }
  return path.join(appDir, 'patches-url-cache.json');
 }
 function saveDiskCache(url) {
  try {
    const cachePath = getDiskCachePath();
    const dir = path.dirname(cachePath);
    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
    fs.writeFileSync(cachePath, JSON.stringify({ patches_url: url, ts: Date.now() }), 'utf8');
  } catch (e) {
    // Non-critical, ignore
  }
 }
 function loadDiskCache() {
  try {
    const cachePath = getDiskCachePath();
    if (fs.existsSync(cachePath)) {
      const data = JSON.parse(fs.readFileSync(cachePath, 'utf8'));
      if (data && data.patches_url) return data.patches_url;
    }
  } catch (e) {
    // Non-critical, ignore
  }
  return null;
 }
 /**
- * Fetch the mirror manifest from MEGA S4
+ * Fetch patches URL from a single HTTP config endpoint
 */
 async function fetchFromHttp(url) {
  const response = await axios.get(url, {
    timeout: 8000,
    headers: { 'User-Agent': 'Hytale-F2P-Launcher' }
  });
  if (response.data && response.data.patches_url) {
    return response.data.patches_url.replace(/\/+$/, '');
  }
  throw new Error('Invalid response');
 }
 /**
 * Fetch patches URL from DNS TXT record via DNS-over-HTTPS
 */
 async function fetchFromDoh(recordName) {
  const dohEndpoints = [
    { url: 'https://dns.google/resolve', params: { name: recordName, type: 'TXT' } },
    { url: 'https://cloudflare-dns.com/dns-query', params: { name: recordName, type: 'TXT' }, headers: { 'Accept': 'application/dns-json' } },
  ];
  for (const endpoint of dohEndpoints) {
    try {
      const response = await axios.get(endpoint.url, {
        params: endpoint.params,
        headers: { 'User-Agent': 'Hytale-F2P-Launcher', ...(endpoint.headers || {}) },
        timeout: 5000
      });
      const answers = response.data && response.data.Answer;
      if (answers && answers.length > 0) {
        // TXT records are quoted, strip quotes
        const txt = answers[0].data.replace(/^"|"$/g, '');
        if (txt.startsWith('http')) return txt.replace(/\/+$/, '');
      }
    } catch (e) {
      // Try next DoH endpoint
    }
  }
  throw new Error('All DoH endpoints failed');
 }
 /**
 * Fetch patches base URL with hardened multi-source fallback chain:
 * 1. Memory cache (5 min)
 * 2. HTTP: auth.sanasol.ws (primary)
 * 3. HTTP: htdwnldsan.top (backup, different host/domain/registrar)
 * 4. DNS TXT: _patches.htdwnldsan.top via DoH (different protocol layer)
 * 5. Disk cache (survives restarts, never expires)
 * 6. Hardcoded fallback URL (last resort)
 */
 async function getPatchesBaseUrl() {
  const now = Date.now();
  // 1. Memory cache
  if (patchesBaseUrl && (now - patchesConfigTime) < PATCHES_CONFIG_CACHE_DURATION) {
    return patchesBaseUrl;
  }
  // 2-4. Try all sources: HTTP endpoints first, then DoH
  for (const source of PATCHES_CONFIG_SOURCES) {
    try {
      let url;
      if (source.type === 'http') {
        console.log(`[Mirror] Trying ${source.name}: ${source.url}`);
        url = await fetchFromHttp(source.url);
      } else if (source.type === 'doh') {
        console.log(`[Mirror] Trying ${source.name_label}: ${source.name}`);
        url = await fetchFromDoh(source.name);
      }
      if (url) {
        patchesBaseUrl = url;
        patchesConfigTime = now;
        saveDiskCache(url);
        console.log(`[Mirror] Patches URL (via ${source.name || source.name_label}): ${url}`);
        return url;
      }
    } catch (e) {
      console.warn(`[Mirror] ${source.name || source.name_label} failed: ${e.message}`);
    }
  }
  // 5. Stale memory cache (any age)
  if (patchesBaseUrl) {
    console.log('[Mirror] All sources failed, using stale memory cache:', patchesBaseUrl);
    return patchesBaseUrl;
  }
  // 6. Disk cache (survives restarts)
  const diskUrl = loadDiskCache();
  if (diskUrl) {
    patchesBaseUrl = diskUrl;
    console.log('[Mirror] All sources failed, using disk cache:', diskUrl);
    return diskUrl;
  }
  // 7. Hardcoded fallback
  console.warn('[Mirror] All sources + caches exhausted, using hardcoded fallback:', HARDCODED_FALLBACK);
  patchesBaseUrl = HARDCODED_FALLBACK;
  return HARDCODED_FALLBACK;
 }
 /**
 * Get all available mirror base URLs (primary + non-Cloudflare fallbacks)
 * Used by download logic to retry on different mirrors when primary is blocked
 */
 async function getAllMirrorUrls() {
  const primary = await getPatchesBaseUrl();
  // Deduplicate: don't include mirrors that match primary
  const mirrors = NON_CF_MIRRORS.filter(m => m !== primary);
  return [primary, ...mirrors];
 }
 /**
 * Fetch the mirror manifest — tries primary URL first, then non-Cloudflare mirrors
 */
 async function fetchMirrorManifest() {
  const now = Date.now();
@@ -26,28 +195,48 @@ async function fetchMirrorManifest() {
    return manifestCache;
  }
-  try {
+  const mirrors = await getAllMirrorUrls();
    console.log('[Mirror] Fetching manifest from:', MIRROR_MANIFEST_URL);
    const response = await axios.get(MIRROR_MANIFEST_URL, {
      timeout: 15000,
      headers: { 'User-Agent': 'Hytale-F2P-Launcher' }
    });
-    if (response.data && response.data.files) {
+  for (let i = 0; i < mirrors.length; i++) {
-      manifestCache = response.data;
+    const baseUrl = mirrors[i];
-      manifestCacheTime = now;
+    const manifestUrl = `${baseUrl}/manifest.json`;
-      console.log('[Mirror] Manifest fetched successfully');
+    try {
-      return response.data;
+      console.log(`[Mirror] Fetching manifest from: ${manifestUrl}`);
      const response = await axios.get(manifestUrl, {
        timeout: 15000,
        maxRedirects: 5,
        headers: { 'User-Agent': 'Hytale-F2P-Launcher' }
      });
      if (response.data && response.data.files) {
        manifestCache = response.data;
        manifestCacheTime = now;
        // If a non-primary mirror worked, switch to it for downloads too
        if (i > 0) {
          console.log(`[Mirror] Primary unreachable, switching to mirror: ${baseUrl}`);
          patchesBaseUrl = baseUrl;
          patchesConfigTime = now;
          saveDiskCache(baseUrl);
        }
        console.log('[Mirror] Manifest fetched successfully');
        return response.data;
      }
      throw new Error('Invalid manifest structure');
    } catch (error) {
      const isTimeout = error.code === 'ETIMEDOUT' || error.code === 'ECONNABORTED' || error.message.includes('timeout');
      console.error(`[Mirror] Error fetching manifest from ${baseUrl}: ${error.message}${isTimeout ? ' (Cloudflare may be blocked)' : ''}`);
      if (i < mirrors.length - 1) {
        console.log(`[Mirror] Trying next mirror...`);
      }
    }
    throw new Error('Invalid manifest structure');
  } catch (error) {
    console.error('[Mirror] Error fetching manifest:', error.message);
    if (manifestCache) {
      console.log('[Mirror] Using expired cache');
      return manifestCache;
    }
    throw error;
  }
  // All mirrors failed — use cached manifest if available
  if (manifestCache) {
    console.log('[Mirror] All mirrors failed, using expired cache');
    return manifestCache;
  }
  throw new Error('All mirrors failed and no cached manifest available');
 }
 /**
@@ -82,9 +271,10 @@ function getPlatformPatches(manifest, branch = 'release') {
 * Find optimal patch path using BFS with download size minimization
 * Returns array of { from, to, url, size, key } steps, or null if no path found
 */
-function findOptimalPatchPath(currentBuild, targetBuild, patches) {
+async function findOptimalPatchPath(currentBuild, targetBuild, patches) {
  if (currentBuild >= targetBuild) return [];
  const baseUrl = await getPatchesBaseUrl();
  const edges = {};
  for (const patch of patches) {
    if (!edges[patch.from]) edges[patch.from] = [];
@@ -118,7 +308,7 @@ function findOptimalPatchPath(currentBuild, targetBuild, patches) {
        path: [...path, {
          from: edge.from,
          to: edge.to,
-          url: `${MIRROR_BASE_URL}/${edge.key}`,
+          url: `${baseUrl}/${edge.key}`,
          size: edge.size,
          key: edge.key
        }],
@@ -139,7 +329,7 @@ async function getUpdatePlan(currentBuild, targetBuild, branch = 'release') {
  const patches = getPlatformPatches(manifest, branch);
  // Try optimal path
-  const steps = findOptimalPatchPath(currentBuild, targetBuild, patches);
+  const steps = await findOptimalPatchPath(currentBuild, targetBuild, patches);
  if (steps && steps.length > 0) {
    const totalSize = steps.reduce((sum, s) => sum + s.size, 0);
@@ -150,10 +340,11 @@ async function getUpdatePlan(currentBuild, targetBuild, branch = 'release') {
  // Fallback: full install 0 -> target
  const fullPatch = patches.find(p => p.from === 0 && p.to === targetBuild);
  if (fullPatch) {
    const baseUrl = await getPatchesBaseUrl();
    const step = {
      from: 0,
      to: targetBuild,
-      url: `${MIRROR_BASE_URL}/${fullPatch.key}`,
+      url: `${baseUrl}/${fullPatch.key}`,
      size: fullPatch.size,
      key: fullPatch.key
    };
@@ -200,7 +391,8 @@ async function getPWRUrl(branch = 'release', version = 'v11') {
    const fullPatch = patches.find(p => p.from === 0 && p.to === targetBuild);
    if (fullPatch) {
-      const url = `${MIRROR_BASE_URL}/${fullPatch.key}`;
+      const baseUrl = await getPatchesBaseUrl();
      const url = `${baseUrl}/${fullPatch.key}`;
      console.log(`[Mirror] PWR URL: ${url}`);
      return url;
    }
@@ -216,7 +408,8 @@ async function getPWRUrl(branch = 'release', version = 'v11') {
  }
  // Construct mirror URL (will work if patch was uploaded but manifest is stale)
-  return `${MIRROR_BASE_URL}/${os}/${arch}/${branch}/0_to_${targetBuild}.pwr`;
+  const baseUrl = await getPatchesBaseUrl();
  return `${baseUrl}/${os}/${arch}/${branch}/0_to_${targetBuild}.pwr`;
 }
 // Backward-compatible alias
@@ -240,14 +433,15 @@ function extractVersionNumber(version) {
  return isNaN(num) ? 0 : num;
 }
-function buildArchiveUrl(buildNumber, branch = 'release') {
+async function buildArchiveUrl(buildNumber, branch = 'release') {
  const baseUrl = await getPatchesBaseUrl();
  const os = getOS();
  const arch = getArch();
-  return `${MIRROR_BASE_URL}/${os}/${arch}/${branch}/0_to_${buildNumber}.pwr`;
+  return `${baseUrl}/${os}/${arch}/${branch}/0_to_${buildNumber}.pwr`;
 }
 async function checkArchiveExists(buildNumber, branch = 'release') {
-  const url = buildArchiveUrl(buildNumber, branch);
+  const url = await buildArchiveUrl(buildNumber, branch);
  try {
    const response = await axios.head(url, { timeout: 10000 });
    return response.status === 200;
@@ -269,7 +463,7 @@ async function discoverAvailableVersions(latestKnown, branch = 'release') {
 async function extractVersionDetails(targetVersion, branch = 'release') {
  const buildNumber = extractVersionNumber(targetVersion);
-  const fullUrl = buildArchiveUrl(buildNumber, branch);
+  const fullUrl = await buildArchiveUrl(buildNumber, branch);
  return {
    version: targetVersion,
@@ -340,5 +534,6 @@ module.exports = {
  extractVersionNumber,
  getPlatformPatches,
  findOptimalPatchPath,
-  MIRROR_BASE_URL
+  getPatchesBaseUrl,
  getAllMirrorUrls
 };
--- a/backend/utils/clientPatcher.js
+++ b/backend/utils/clientPatcher.js
@@ -9,7 +9,9 @@ const MAX_DOMAIN_LENGTH = 16;
 // DualAuth ByteBuddy Agent (runtime class transformation, no JAR modification)
 const DUALAUTH_AGENT_URL = 'https://github.com/sanasol/hytale-auth-server/releases/latest/download/dualauth-agent.jar';
 const DUALAUTH_AGENT_VERSION_API = 'https://api.github.com/repos/sanasol/hytale-auth-server/releases/latest';
 const DUALAUTH_AGENT_FILENAME = 'dualauth-agent.jar';
 const DUALAUTH_AGENT_VERSION_FILE = 'dualauth-agent.version';
 function getTargetDomain() {
  if (process.env.HYTALE_AUTH_DOMAIN) {
@@ -511,30 +513,70 @@ class ClientPatcher {
   */
  async ensureAgentAvailable(serverDir, progressCallback) {
    const agentPath = this.getAgentPath(serverDir);
    const versionPath = path.join(serverDir, DUALAUTH_AGENT_VERSION_FILE);
    console.log('=== DualAuth Agent (ByteBuddy) ===');
    console.log(`Target: ${agentPath}`);
-    // Check if agent already exists and is valid
+    // Check local version and whether file exists
    let localVersion = null;
    let agentExists = false;
    if (fs.existsSync(agentPath)) {
      try {
        const stats = fs.statSync(agentPath);
        if (stats.size > 1024) {
-          console.log(`DualAuth Agent present (${(stats.size / 1024).toFixed(0)} KB)`);
+          agentExists = true;
-          if (progressCallback) progressCallback('DualAuth Agent ready', 100);
+          if (fs.existsSync(versionPath)) {
-          return { success: true, agentPath, alreadyExists: true };
+            localVersion = fs.readFileSync(versionPath, 'utf8').trim();
          }
        } else {
          console.log('Agent file appears corrupt, re-downloading...');
          fs.unlinkSync(agentPath);
        }
        // File exists but too small - corrupt, re-download
        console.log('Agent file appears corrupt, re-downloading...');
        fs.unlinkSync(agentPath);
      } catch (e) {
        console.warn('Could not check agent file:', e.message);
      }
    }
    // Check for updates from GitHub
    let remoteVersion = null;
    let needsDownload = !agentExists;
    if (agentExists) {
      try {
        if (progressCallback) progressCallback('Checking for agent updates...', 5);
        const axios = require('axios');
        const resp = await axios.get(DUALAUTH_AGENT_VERSION_API, {
          timeout: 5000,
          headers: { 'Accept': 'application/vnd.github.v3+json' }
        });
        remoteVersion = resp.data.tag_name; // e.g. "v1.1.10"
        if (localVersion && localVersion === remoteVersion) {
          console.log(`DualAuth Agent up to date (${localVersion})`);
          if (progressCallback) progressCallback('DualAuth Agent ready', 100);
          return { success: true, agentPath, alreadyExists: true, version: localVersion };
        }
        console.log(`Agent update available: ${localVersion || 'unknown'} → ${remoteVersion}`);
        needsDownload = true;
      } catch (e) {
        // GitHub API failed - use existing agent if available
        console.warn(`Could not check for updates: ${e.message}`);
        if (agentExists) {
          console.log(`Using existing agent (${localVersion || 'unknown version'})`);
          if (progressCallback) progressCallback('DualAuth Agent ready', 100);
          return { success: true, agentPath, alreadyExists: true, version: localVersion };
        }
      }
    }
    if (!needsDownload) {
      if (progressCallback) progressCallback('DualAuth Agent ready', 100);
      return { success: true, agentPath, alreadyExists: true, version: localVersion };
    }
    // Download agent from GitHub releases
-    if (progressCallback) progressCallback('Downloading DualAuth Agent...', 20);
+    const action = agentExists ? 'Updating' : 'Downloading';
-    console.log(`Downloading from: ${DUALAUTH_AGENT_URL}`);
+    if (progressCallback) progressCallback(`${action} DualAuth Agent...`, 20);
    console.log(`${action} from: ${DUALAUTH_AGENT_URL}`);
    try {
      // Ensure server directory exists
@@ -548,7 +590,7 @@ class ClientPatcher {
      const stream = await smartDownloadStream(DUALAUTH_AGENT_URL, (chunk, downloadedBytes, total) => {
        if (progressCallback && total) {
          const percent = 20 + Math.floor((downloadedBytes / total) * 70);
-          progressCallback(`Downloading agent... ${(downloadedBytes / 1024).toFixed(0)} KB`, percent);
+          progressCallback(`${action} agent... ${(downloadedBytes / 1024).toFixed(0)} KB`, percent);
        }
      });
@@ -575,9 +617,13 @@ class ClientPatcher {
      }
      fs.renameSync(tmpPath, agentPath);
-      console.log(`DualAuth Agent downloaded (${(stats.size / 1024).toFixed(0)} KB)`);
+      // Save version
      const version = remoteVersion || 'unknown';
      fs.writeFileSync(versionPath, version, 'utf8');
      console.log(`DualAuth Agent ${agentExists ? 'updated' : 'downloaded'} (${(stats.size / 1024).toFixed(0)} KB, ${version})`);
      if (progressCallback) progressCallback('DualAuth Agent ready', 100);
-      return { success: true, agentPath };
+      return { success: true, agentPath, updated: agentExists, version };
    } catch (downloadError) {
      console.error(`Failed to download DualAuth Agent: ${downloadError.message}`);
@@ -586,6 +632,11 @@ class ClientPatcher {
      if (fs.existsSync(tmpPath)) {
        try { fs.unlinkSync(tmpPath); } catch (e) { /* ignore */ }
      }
      // If we had an existing agent, still use it
      if (agentExists) {
        console.log('Using existing agent despite update failure');
        return { success: true, agentPath, alreadyExists: true, version: localVersion };
      }
      return { success: false, error: downloadError.message };
    }
  }
--- a/backend/utils/logCollector.js
+++ b/backend/utils/logCollector.js
@@ -0,0 +1,238 @@
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
 const zlib = require('zlib');
 const logger = require('../logger');
 const MAX_FILE_SIZE = 2 * 1024 * 1024; // 2MB per file
 /**
 * Get the HytaleSaves directory (game client logs)
 */
 function getHytaleSavesDir() {
  const home = os.homedir();
  if (process.platform === 'win32') {
    return path.join(home, 'AppData', 'Local', 'HytaleSaves');
  } else if (process.platform === 'darwin') {
    return path.join(home, 'Library', 'Application Support', 'HytaleSaves');
  } else {
    return path.join(home, '.hytalesaves');
  }
 }
 /**
 * Read a log file, capping at MAX_FILE_SIZE (keeps tail/most recent lines)
 */
 function readLogFile(filePath) {
  try {
    const stats = fs.statSync(filePath);
    if (stats.size <= MAX_FILE_SIZE) {
      return fs.readFileSync(filePath, 'utf8');
    }
    // Read only the last MAX_FILE_SIZE bytes
    const fd = fs.openSync(filePath, 'r');
    const buffer = Buffer.alloc(MAX_FILE_SIZE);
    fs.readSync(fd, buffer, 0, MAX_FILE_SIZE, stats.size - MAX_FILE_SIZE);
    fs.closeSync(fd);
    const content = buffer.toString('utf8');
    // Skip first partial line
    const firstNewline = content.indexOf('\n');
    const trimmed = firstNewline >= 0 ? content.substring(firstNewline + 1) : content;
    return `[... truncated ${stats.size - MAX_FILE_SIZE} bytes ...]\n` + trimmed;
  } catch (err) {
    return `[Error reading file: ${err.message}]`;
  }
 }
 /**
 * Get files matching a date pattern from a directory
 */
 function getFilesForDate(dir, dateStr, pattern) {
  if (!fs.existsSync(dir)) return [];
  try {
    return fs.readdirSync(dir)
      .filter(f => f.includes(dateStr) && (pattern ? pattern.test(f) : true))
      .map(f => ({
        name: f,
        path: path.join(dir, f),
        mtime: fs.statSync(path.join(dir, f)).mtime
      }))
      .sort((a, b) => b.mtime - a.mtime);
  } catch (err) {
    return [];
  }
 }
 // ============================================================================
 // ZIP BUILDER (pure Node.js, no dependencies)
 // ============================================================================
 /**
 * CRC32 lookup table
 */
 const crc32Table = new Uint32Array(256);
 for (let i = 0; i < 256; i++) {
  let c = i;
  for (let j = 0; j < 8; j++) {
    c = (c & 1) ? (0xEDB88320 ^ (c >>> 1)) : (c >>> 1);
  }
  crc32Table[i] = c;
 }
 function crc32(buf) {
  let crc = 0xFFFFFFFF;
  for (let i = 0; i < buf.length; i++) {
    crc = crc32Table[(crc ^ buf[i]) & 0xFF] ^ (crc >>> 8);
  }
  return (crc ^ 0xFFFFFFFF) >>> 0;
 }
 /**
 * Create a ZIP file from an array of {name, content} entries
 * Uses DEFLATE compression via built-in zlib
 */
 function createZipBuffer(files) {
  const localHeaders = [];
  const centralEntries = [];
  let offset = 0;
  for (const file of files) {
    const nameBytes = Buffer.from(file.name, 'utf8');
    const contentBytes = Buffer.from(file.content, 'utf8');
    const compressed = zlib.deflateRawSync(contentBytes);
    const crcVal = crc32(contentBytes);
    // Local file header (30 bytes + filename)
    const local = Buffer.alloc(30);
    local.writeUInt32LE(0x04034b50, 0);   // signature
    local.writeUInt16LE(20, 4);            // version needed
    local.writeUInt16LE(0, 6);             // flags
    local.writeUInt16LE(8, 8);             // compression: DEFLATE
    local.writeUInt16LE(0, 10);            // mod time
    local.writeUInt16LE(0, 12);            // mod date
    local.writeUInt32LE(crcVal, 14);       // crc32
    local.writeUInt32LE(compressed.length, 18); // compressed size
    local.writeUInt32LE(contentBytes.length, 22); // uncompressed size
    local.writeUInt16LE(nameBytes.length, 26);    // filename length
    local.writeUInt16LE(0, 28);            // extra field length
    localHeaders.push(local, nameBytes, compressed);
    // Central directory entry (46 bytes + filename)
    const central = Buffer.alloc(46);
    central.writeUInt32LE(0x02014b50, 0);  // signature
    central.writeUInt16LE(20, 4);           // version made by
    central.writeUInt16LE(20, 6);           // version needed
    central.writeUInt16LE(0, 8);            // flags
    central.writeUInt16LE(8, 10);           // compression
    central.writeUInt16LE(0, 12);           // mod time
    central.writeUInt16LE(0, 14);           // mod date
    central.writeUInt32LE(crcVal, 16);      // crc32
    central.writeUInt32LE(compressed.length, 20); // compressed size
    central.writeUInt32LE(contentBytes.length, 24); // uncompressed size
    central.writeUInt16LE(nameBytes.length, 28);    // filename length
    central.writeUInt16LE(0, 30);           // extra field length
    central.writeUInt16LE(0, 32);           // comment length
    central.writeUInt16LE(0, 34);           // disk number
    central.writeUInt16LE(0, 36);           // internal attrs
    central.writeUInt32LE(0, 38);           // external attrs
    central.writeUInt32LE(offset, 42);      // local header offset
    centralEntries.push(central, nameBytes);
    offset += 30 + nameBytes.length + compressed.length;
  }
  const centralDirBuf = Buffer.concat(centralEntries);
  // End of central directory (22 bytes)
  const eocd = Buffer.alloc(22);
  eocd.writeUInt32LE(0x06054b50, 0);       // signature
  eocd.writeUInt16LE(0, 4);                // disk number
  eocd.writeUInt16LE(0, 6);                // cd disk number
  eocd.writeUInt16LE(files.length, 8);     // entries on disk
  eocd.writeUInt16LE(files.length, 10);    // total entries
  eocd.writeUInt32LE(centralDirBuf.length, 12); // cd size
  eocd.writeUInt32LE(offset, 16);          // cd offset
  eocd.writeUInt16LE(0, 20);              // comment length
  return Buffer.concat([...localHeaders, centralDirBuf, eocd]);
 }
 // ============================================================================
 /**
 * Collect all relevant logs for submission
 * Returns { files: [{name, content}], meta: {username, platform, version} }
 */
 function collectLogs() {
  const files = [];
  const today = new Date();
  const todayStr = today.toISOString().split('T')[0]; // YYYY-MM-DD
  const yesterday = new Date(today);
  yesterday.setDate(yesterday.getDate() - 1);
  const yesterdayStr = yesterday.toISOString().split('T')[0];
  // 1. Launcher logs
  const launcherLogDir = logger.getLogDirectory();
  if (launcherLogDir && fs.existsSync(launcherLogDir)) {
    // Today's launcher logs
    const todayLogs = getFilesForDate(launcherLogDir, todayStr, /^launcher-.*\.log$/);
    for (const f of todayLogs) {
      files.push({ name: `launcher/${f.name}`, content: readLogFile(f.path) });
    }
    // Most recent from yesterday (just one)
    const yesterdayLogs = getFilesForDate(launcherLogDir, yesterdayStr, /^launcher-.*\.log$/);
    if (yesterdayLogs.length > 0) {
      files.push({ name: `launcher/${yesterdayLogs[0].name}`, content: readLogFile(yesterdayLogs[0].path) });
    }
  }
  // 2. Game client logs
  const savesDir = getHytaleSavesDir();
  const clientLogDir = path.join(savesDir, 'Logs');
  if (fs.existsSync(clientLogDir)) {
    const clientLogs = getFilesForDate(clientLogDir, todayStr, /client\.log$/);
    for (const f of clientLogs) {
      files.push({ name: `client/${f.name}`, content: readLogFile(f.path) });
    }
  }
  // 3. Config snapshot
  const appDir = logger.getAppDir ? logger.getAppDir() : logger.getInstallPath();
  const configPath = path.join(appDir, 'config.json');
  if (fs.existsSync(configPath)) {
    try {
      const configContent = fs.readFileSync(configPath, 'utf8');
      files.push({ name: 'config.json', content: configContent });
    } catch (err) {
      files.push({ name: 'config.json', content: `[Error reading config: ${err.message}]` });
    }
  }
  // Build metadata
  const { app } = require('electron');
  let username = 'unknown';
  try {
    const configFile = path.join(appDir, 'config.json');
    if (fs.existsSync(configFile)) {
      const cfg = JSON.parse(fs.readFileSync(configFile, 'utf8'));
      username = cfg.username || cfg.playerName || 'unknown';
    }
  } catch (err) {}
  return {
    files,
    meta: {
      username,
      platform: `${process.platform}-${process.arch}`,
      version: app.getVersion()
    }
  };
 }
 module.exports = { collectLogs, createZipBuffer };
--- a/backend/utils/platformUtils.js
+++ b/backend/utils/platformUtils.js
@@ -164,8 +164,14 @@ function detectGpuLinux() {
    const isAmd = lowerLine.includes('amd') || lowerLine.includes('radeon') || vendorId === '1002';
    const isIntel = lowerLine.includes('intel') || vendorId === '8086';
-    // Intel Arc detection
+    // Intel Arc discrete GPU detection
-    const isIntelArc = isIntel && (lowerName.includes('arc') || lowerName.includes('a770') || lowerName.includes('a750') || lowerName.includes('a380'));
+    // Discrete Arc cards have specific model numbers: A310, A380, A580, A750, A770, B570, B580
    // Integrated "Intel Arc Graphics" (Meteor Lake, Lunar Lake, Arrow Lake) have NO model suffix
    // and sit on bus 00 (slot 00:02.0) — these are iGPUs, not dGPUs
    const pciSlot = line.split(' ')[0] || '';
    const pciBus = parseInt(pciSlot.split(':')[0], 16) || 0;
    const hasArcModelNumber = isIntel && /\b[ab]\d{3}\b/i.test(lowerName);
    const isIntelArc = isIntel && (hasArcModelNumber || (lowerName.includes('arc') && pciBus > 0));
    let vendor = 'unknown';
    if (isNvidia) vendor = 'nvidia';
--- a/docs/PATCH_CDN_INFRASTRUCTURE.md
+++ b/docs/PATCH_CDN_INFRASTRUCTURE.md
@@ -1,217 +0,0 @@
 # Patch CDN Infrastructure & Game Update System
 ## Overview
 The F2P launcher downloads game patches through a CDN redirect gateway hosted on the auth server. This allows instant CDN switching (e.g., for DMCA takedowns) without releasing a new launcher version.
 ## Architecture
 ```
 Launcher --> GET auth.sanasol.ws/patches/manifest.json
          --> 302 --> mega.io/.../manifest.json
 Launcher --> GET auth.sanasol.ws/patches/windows/amd64/release/0_to_11.pwr
          --> 302 --> mega.io/.../windows/amd64/release/0_to_11.pwr
 ```
 The auth server acts as a pure redirect gateway (302). No bandwidth is consumed on the auth server - all actual file transfers happen directly between the launcher and the CDN.
 ## URLs
 | URL | Purpose |
 |-----|---------|
 | `https://auth.sanasol.ws/patches/*` | Redirect gateway (302 -> CDN) |
 | `https://auth.sanasol.ws/patches/manifest.json` | Patch manifest (redirects to CDN) |
 | `https://auth.sanasol.ws/admin/page/settings` | Admin panel to change CDN URL |
 | `https://auth.sanasol.ws/admin/api/settings/patches-cdn` | API to GET/POST CDN base URL |
 ### Default CDN (MEGA S4)
 ```
 Base URL: https://s3.g.s4.mega.io/kcvismkrtfcalgwxzsazbq46l72dwsypqaham/hytale/patches
 ```
 ### Changing CDN (DMCA response)
 1. Go to `https://auth.sanasol.ws/admin/page/settings`
 2. Find "Patches CDN Base URL" section
 3. Change URL to new CDN (e.g., `https://new-cdn.example.com/patches`)
 4. Click "Save" - all launcher requests instantly redirect to new CDN
 5. No launcher update needed
 ## Manifest Format
 The manifest is a JSON file listing all available patch files:
 ```json
 {
  "updated": "2026-02-20T13:20:09.776Z",
  "files": {
    "windows/amd64/release/0_to_11.pwr": { "size": 1618804736 },
    "windows/amd64/release/10_to_11.pwr": { "size": 62914560 },
    "darwin/arm64/release/0_to_11.pwr": { "size": 1617100800 },
    "server/release": { "version": "2026.02.19-1a311a592", "size": 1509949440, "sha256": "..." },
    ...
  }
 }
 ```
 ### Key Structure
 File keys follow the pattern: `{os}/{arch}/{branch}/{from}_to_{to}.pwr`
 - **OS**: `windows`, `linux`, `darwin`
 - **Arch**: `amd64`, `arm64`
 - **Branch**: `release`, `pre-release`
 - **Patch**: `{from}_to_{to}.pwr` (e.g., `0_to_11.pwr` for full install, `10_to_11.pwr` for differential)
 Server builds use: `server/{branch}` with `version`, `size`, `sha256` fields.
 ## Game Update Process
 ### 1. Version Check
 ```
 Launcher calls: getLatestClientVersion(branch)
  -> Fetches manifest from auth.sanasol.ws/patches/manifest.json
  -> Finds highest build number for current platform/branch
  -> Returns "v{buildNumber}" (e.g., "v11")
 ```
 ### 2. Update Plan (Optimal Patch Routing)
 ```
 Launcher calls: getUpdatePlan(currentBuild, targetBuild, branch)
  -> Fetches manifest
  -> Finds available patches for platform
  -> Uses BFS to find optimal path (minimizes total download size)
  -> Example: build 5 -> 11 might use: 5->10 (148MB) + 10->11 (60MB)
    instead of: 0->11 (1.5GB)
 ```
 ### 3. Download & Apply
 ```
 For each step in the update plan:
  1. Download .pwr file from auth.sanasol.ws/patches/{key}
     (redirects to CDN, supports resume via Range headers)
  2. Apply patch using butler tool:
     butler apply --staging-dir <staging> <pwr_file> <game_dir>
  3. Save version after each step
 ```
 ### 4. Fresh Install
 For first-time installs (currentBuild = 0):
 - Downloads `0_to_{target}.pwr` (full install, ~1.5GB)
 - Applies with butler to create the full game directory
 ### 5. Differential Update
 For existing installations:
 - Finds optimal patch chain (e.g., `10_to_11.pwr` at ~60MB)
 - Applies incrementally, saving progress after each step
 - Falls back to full install if no patch path found
 ## Mirror Sync Script
 The mirror script (`scripts/hytale-mirror.js`) downloads patches from the official Hytale API and uploads to MEGA S4.
 ### Usage
 ```bash
 cd scripts
 node hytale-mirror.js download   # Download patches locally
 node hytale-mirror.js upload     # Upload to MEGA S4 via rclone
 node hytale-mirror.js sync       # Download + Upload in one step
 ```
 ### What It Does
 1. **Discovery**: Calls Hytale API to find available patches for all platforms
 2. **Download**: Downloads .pwr files to `scripts/mirror/` directory
 3. **Manifest Generation**: Creates `manifest.json` with file sizes (no local paths)
 4. **Upload**: Uses `rclone` to sync to MEGA S4
 ### SOCKS5 Proxy
 - API discovery calls use SOCKS5 proxy rotation (for rate limiting)
 - File downloads do NOT use proxy (too slow for large files)
 - Proxy list in `proxies.json` (auto-refreshed from proxy service)
 ### Prerequisites
 - `rclone` configured with `megas4` remote pointing to MEGA S4
 - Node.js 20+
 - Network access to Hytale API endpoints
 ## Launcher Configuration
 ### Environment Variables
 | Variable | Default | Description |
 |----------|---------|-------------|
 | `HYTALE_AUTH_DOMAIN` | `auth.sanasol.ws` | Auth domain (used for patch redirects) |
 ### Key Files
 | File | Description |
 |------|-------------|
 | `backend/services/versionManager.js` | Manifest fetching, version checking, update planning |
 | `backend/managers/differentialUpdateManager.js` | Download orchestration, butler integration |
 | `backend/utils/fileManager.js` | File download with retry, resume, stall detection |
 | `backend/managers/gameLauncher.js` | Game launch with token fetch, patching, signing |
 ### Constants (versionManager.js)
 ```javascript
 const AUTH_DOMAIN = process.env.HYTALE_AUTH_DOMAIN || 'auth.sanasol.ws';
 const MIRROR_BASE_URL = `https://${AUTH_DOMAIN}/patches`;
 const MIRROR_MANIFEST_URL = `${MIRROR_BASE_URL}/manifest.json`;
 const MANIFEST_CACHE_DURATION = 60000; // 1 minute cache
 const FALLBACK_LATEST_BUILD = 11; // If manifest unreachable
 ```
 ## Auth Server Implementation
 ### Routes
 ```
 GET /patches/*  -> handlePatchRedirect()
  - Extracts path after /patches/
  - Reads CDN base URL from Redis settings
  - Returns 302 redirect to {baseUrl}/{path}
  - Tracks download metrics
 GET /admin/api/settings/patches-cdn -> getPatchesCdnBaseUrl()
 POST /admin/api/settings/patches-cdn -> setPatchesCdnBaseUrl()
 ```
 ### Redis Storage
 ```
 settings:global -> { patchesCdnBaseUrl: "https://s3.g.s4.mega.io/..." }
 metrics:downloads -> { "patch:manifest.json": count, ... }
 ```
 ## Troubleshooting
 ### "Invalid manifest structure" error
 - Check manifest.json is valid JSON with `files` object
 - Verify CDN is accessible: `curl -sL https://auth.sanasol.ws/patches/manifest.json | python3 -m json.tool`
 - Check admin settings for correct CDN URL
 ### 0-byte downloads
 - Verify redirect works: `curl -sI https://auth.sanasol.ws/patches/darwin/arm64/release/0_to_11.pwr`
 - Should show `302` with `Location` header
 - Test actual download: `curl -sL -o /dev/null -w "%{size_download}" -r 0-1023 <url>`
 ### Manifest has local paths
 - Regenerate manifest: `node scripts/hytale-mirror.js download` (re-scans files)
 - Re-upload: `node scripts/hytale-mirror.js upload`
 - Verify: entries should only have `{ size: <bytes> }`, no `path` field
 ### CDN switch not taking effect
 - Check Redis: CDN URL stored in `settings:global`
 - Verify via API: `curl https://auth.sanasol.ws/admin/api/settings/patches-cdn`
 - Manifest is cached for 1 minute in launcher - wait or restart
--- a/main.js
+++ b/main.js
@@ -84,12 +84,12 @@ function setDiscordActivity() {
      largeImageText: 'Hytale F2P Launcher',
      buttons: [
        {
-          label: 'GitHub',
+          label: 'Download',
-          url: 'https://github.com/amiayweb/Hytale-F2P'
+          url: 'https://git.sanhost.net/sanasol/hytale-f2p/releases'
        },
        {
          label: 'Discord',
-          url: 'https://discord.gg/hf2pdc'
+          url: 'https://discord.gg/Fhbb9Yk5WW'
        }
      ]
    });
@@ -964,8 +964,8 @@ ipcMain.handle('open-external', async (event, url) => {
 ipcMain.handle('open-download-page', async () => {
  try {
-    // Open GitHub releases page for manual download
+    // Open Forgejo releases page for manual download
-    await shell.openExternal('https://github.com/amiayweb/Hytale-F2P/releases/latest');
+    await shell.openExternal('https://git.sanhost.net/sanasol/hytale-f2p/releases/latest');
    return { success: true };
  } catch (error) {
    console.error('Failed to open download page:', error);
@@ -1068,7 +1068,7 @@ ipcMain.handle('load-settings', async () => {
  }
 });
-const { getModsPath, loadInstalledMods, downloadMod, uninstallMod, toggleMod, getCurrentUuid, getAllUuidMappings, setUuidForUser, generateNewUuid, deleteUuidForUser, resetCurrentUserUuid } = require('./backend/launcher');
+const { getModsPath, loadInstalledMods, downloadMod, uninstallMod, toggleMod, getModFiles, getCurrentUuid, getAllUuidMappings, setUuidForUser, generateNewUuid, deleteUuidForUser, resetCurrentUserUuid } = require('./backend/launcher');
 const os = require('os');
 ipcMain.handle('get-local-app-data', async () => {
@@ -1118,6 +1118,15 @@ ipcMain.handle('download-mod', async (event, modInfo) => {
  }
 });
 ipcMain.handle('get-mod-files', async (event, modId) => {
  try {
    return await getModFiles(modId);
  } catch (error) {
    console.error('Error getting mod files:', error);
    return { success: false, error: error.message };
  }
 });
 ipcMain.handle('uninstall-mod', async (event, modId, modsPath) => {
  try {
    return await uninstallMod(modId, modsPath);
@@ -1407,6 +1416,83 @@ ipcMain.handle('get-recent-logs', async (event, maxLines = 100) => {
 ipcMain.handle('send-logs', async () => {
  try {
    const https = require('https');
    const http = require('http');
    const { collectLogs, createZipBuffer } = require('./backend/utils/logCollector');
    const { files, meta } = collectLogs();
    if (files.length === 0) {
      return { success: false, error: 'No log files found' };
    }
    // Create ZIP with individual log files
    const zipBuffer = createZipBuffer(files);
    // Get auth server URL from core config
    const { getAuthServerUrl } = require('./backend/core/config');
    const authUrl = getAuthServerUrl();
    // Build file names list
    const fileNames = files.map(f => f.name).join(',');
    return await new Promise((resolve) => {
      const url = new URL(authUrl + '/logs/submit');
      const transport = url.protocol === 'https:' ? https : http;
      const options = {
        hostname: url.hostname,
        port: url.port || (url.protocol === 'https:' ? 443 : 80),
        path: url.pathname,
        method: 'POST',
        headers: {
          'Content-Type': 'application/zip',
          'Content-Length': zipBuffer.length,
          'X-Log-Username': meta.username || 'unknown',
          'X-Log-Platform': meta.platform || 'unknown',
          'X-Log-Version': meta.version || 'unknown',
          'X-Log-File-Count': String(files.length),
          'X-Log-Files': fileNames
        },
        timeout: 30000
      };
      const req = transport.request(options, (res) => {
        let body = '';
        res.on('data', (chunk) => body += chunk);
        res.on('end', () => {
          try {
            const data = JSON.parse(body);
            if (res.statusCode === 200) {
              resolve({ success: true, id: data.id, message: data.message });
            } else {
              resolve({ success: false, error: data.error || `Server error ${res.statusCode}` });
            }
          } catch (e) {
            resolve({ success: false, error: `Invalid response: ${res.statusCode}` });
          }
        });
      });
      req.on('error', (err) => {
        resolve({ success: false, error: err.message });
      });
      req.on('timeout', () => {
        req.destroy();
        resolve({ success: false, error: 'Request timed out' });
      });
      req.write(zipBuffer);
      req.end();
    });
  } catch (error) {
    console.error('Error sending logs:', error);
    return { success: false, error: error.message };
  }
 });
 ipcMain.handle('open-logs-folder', async () => {
  try {
    const logDir = logger.getLogDirectory();
@@ -1462,3 +1548,45 @@ ipcMain.handle('profile-update', async (event, id, updates) => {
  }
 });
 // Java Wrapper Config IPC
 ipcMain.handle('load-wrapper-config', () => {
  const { loadWrapperConfig } = require('./backend/launcher');
  return loadWrapperConfig();
 });
 ipcMain.handle('save-wrapper-config', (event, config) => {
  try {
    const { saveWrapperConfig } = require('./backend/launcher');
    saveWrapperConfig(config);
    return { success: true };
  } catch (error) {
    console.error('Error saving wrapper config:', error);
    return { success: false, error: error.message };
  }
 });
 ipcMain.handle('reset-wrapper-config', () => {
  try {
    const { resetWrapperConfig } = require('./backend/launcher');
    const config = resetWrapperConfig();
    return { success: true, config };
  } catch (error) {
    console.error('Error resetting wrapper config:', error);
    return { success: false, error: error.message };
  }
 });
 ipcMain.handle('get-default-wrapper-config', () => {
  const { getDefaultWrapperConfig } = require('./backend/launcher');
  return getDefaultWrapperConfig();
 });
 ipcMain.handle('preview-wrapper-script', (event, config, platform) => {
  const { generateWrapperScript } = require('./backend/launcher');
  return generateWrapperScript(config || require('./backend/launcher').loadWrapperConfig(), platform || process.platform, '/path/to/java');
 });
 ipcMain.handle('get-current-platform', () => {
  return process.platform;
 });
--- a/package.json
+++ b/package.json
@@ -1,8 +1,8 @@
 {
  "name": "hytale-f2p-launcher",
-  "version": "2.3.1",
+  "version": "2.4.1",
  "description": "A modern, cross-platform launcher for Hytale with automatic updates and multi-client support",
-  "homepage": "https://github.com/amiayweb/Hytale-F2P",
+  "homepage": "https://git.sanhost.net/sanasol/hytale-f2p",
  "main": "main.js",
  "scripts": {
    "start": "electron .",
--- a/preload.js
+++ b/preload.js
@@ -45,6 +45,7 @@ contextBridge.exposeInMainWorld('electronAPI', {
  loadInstalledMods: (modsPath) => ipcRenderer.invoke('load-installed-mods', modsPath),
  downloadMod: (modInfo) => ipcRenderer.invoke('download-mod', modInfo),
  uninstallMod: (modId, modsPath) => ipcRenderer.invoke('uninstall-mod', modId, modsPath),
  getModFiles: (modId) => ipcRenderer.invoke('get-mod-files', modId),
  toggleMod: (modId, modsPath) => ipcRenderer.invoke('toggle-mod', modId, modsPath),
  selectModFiles: () => ipcRenderer.invoke('select-mod-files'),
  copyModFile: (sourcePath, modsPath) => ipcRenderer.invoke('copy-mod-file', sourcePath, modsPath),
@@ -94,6 +95,7 @@ contextBridge.exposeInMainWorld('electronAPI', {
  getLogDirectory: () => ipcRenderer.invoke('get-log-directory'),
  openLogsFolder: () => ipcRenderer.invoke('open-logs-folder'),
  getRecentLogs: (maxLines) => ipcRenderer.invoke('get-recent-logs', maxLines),
  sendLogs: () => ipcRenderer.invoke('send-logs'),
  // UUID Management methods
  getCurrentUuid: () => ipcRenderer.invoke('get-current-uuid'),
@@ -103,6 +105,14 @@ contextBridge.exposeInMainWorld('electronAPI', {
  deleteUuidForUser: (username) => ipcRenderer.invoke('delete-uuid-for-user', username),
  resetCurrentUserUuid: () => ipcRenderer.invoke('reset-current-user-uuid'),
  // Java Wrapper Config API
  loadWrapperConfig: () => ipcRenderer.invoke('load-wrapper-config'),
  saveWrapperConfig: (config) => ipcRenderer.invoke('save-wrapper-config', config),
  resetWrapperConfig: () => ipcRenderer.invoke('reset-wrapper-config'),
  getDefaultWrapperConfig: () => ipcRenderer.invoke('get-default-wrapper-config'),
  previewWrapperScript: (config, platform) => ipcRenderer.invoke('preview-wrapper-script', config, platform),
  getCurrentPlatform: () => ipcRenderer.invoke('get-current-platform'),
  // Profile API
  profile: {
    create: (name) => ipcRenderer.invoke('profile-create', name),
--- a/server/README.md
+++ b/server/README.md
@@ -0,0 +1,133 @@
 # Hytale F2P - Dedicated Server
 Host your own Hytale server. The scripts handle everything automatically.
 ## Prerequisites
 - **Java 25+** — [Windows installer](https://download.oracle.com/java/25/latest/jdk-25_windows-x64_bin.exe) | [Other platforms](https://adoptium.net/)
  - If you have the F2P launcher installed, its bundled Java will be used automatically
 - **Internet connection** for first launch (downloads ~3.5 GB of game files)
  - If you have the F2P launcher installed, game files are copied locally (no download needed)
 ## Video Guide
 [![Video Guide](https://img.youtube.com/vi/KvuXLH7SKvI/maxresdefault.jpg)](https://youtu.be/KvuXLH7SKvI)
 ## Quick Start
 ### Free Hosted Server (no PC required)
 Use [play.hosting](https://play.hosting) to get a free Hytale server with F2P support:
 1. Register at [play.hosting](https://play.hosting)
 2. Create a **Hytale** server
 3. Start the server once and wait for it to fully load
 4. Go to **Files** → open the `mods` folder
 5. Click **New** → **File via URL**
 6. Paste: `https://github.com/sanasol/hytale-auth-server/releases/latest/download/dualauth-agent.jar`
 7. Click **Query** and download the file
 8. Go to **Console** and **Restart** the server
 Done — your F2P server is ready to join.
 ### Windows (self-hosted)
 1. Download `start.bat` to an empty folder
 2. Double-click `start.bat`
 3. Done — server starts on port **5520**
 ### Linux / macOS (self-hosted)
 ```bash
 mkdir hytale-server && cd hytale-server
 curl -O https://git.sanhost.net/sanasol/hytale-f2p/raw/branch/develop/server/start.sh
 chmod +x start.sh
 ./start.sh
 ```
 ## What the scripts do
 1. Search for the F2P launcher install (default paths + custom `installPath` from config)
 2. Use bundled Java from the launcher, or fall back to system Java (25+ required)
 3. Copy game files from the launcher install if available
 4. Download missing files: `HytaleServer.jar` (~150 MB), `Assets.zip` (~3.3 GB), `dualauth-agent.jar` (~5 MB)
 5. Check for updates on every launch (server, assets, and agent)
 6. Generate a persistent server ID
 7. Fetch authentication tokens
 8. Start the server with dual-auth support
 ## Connecting
 - **Same PC**: Connect to `localhost:5520` or `127.0.0.1:5520`
 - **LAN**: Connect to your local IP (e.g. `192.168.1.x:5520`)
 - **Internet**: Forward port `5520` (TCP + UDP) on your router, friends connect to your public IP
 ### No public IP? Use playit.gg (recommended)
 If you're behind CGNAT or can't port forward, [playit.gg](https://playit.gg) gives you a public address for free:
 1. Go to [playit.gg](https://playit.gg) and create an account
 2. Download and run the playit agent
 3. Create a tunnel — select **Hytale** as the game type, local port `5520`
 4. Share the generated address with friends (e.g. `something.joinplayit.gg:12345`)
 ### Other options
 - [Radmin VPN](https://www.radmin-vpn.com/) — virtual LAN, all players must install it
 - [ZeroTier](https://www.zerotier.com/) — same idea, create a network, friends join and connect via VPN IP
 ## Configuration
 Set environment variables before running the script:
 | Variable | Default | Description |
 |----------|---------|-------------|
 | `SERVER_NAME` | `My Hytale Server` | Server name shown in listings |
 | `BIND_ADDRESS` | `0.0.0.0:5520` | IP and port to listen on |
 | `JVM_XMX` | *(Java default)* | Max memory (e.g. `4G`, `8G`) |
 | `JVM_XMS` | *(Java default)* | Initial memory |
 | `AUTH_MODE` | `authenticated` | Auth mode (`authenticated` or `none`) |
 | `HYTALE_AUTH_DOMAIN` | `auth.sanasol.ws` | Auth server domain |
 | `DOWNLOAD_BASE` | `https://download.sanasol.ws/download` | File download URL |
 **Example (Linux):**
 ```bash
 SERVER_NAME="Epic Server" JVM_XMX=4G ./start.sh
 ```
 **Example (Windows):**
 ```cmd
 set SERVER_NAME=Epic Server
 set JVM_XMX=4G
 start.bat
 ```
 ## Files created
 ```
 your-folder/
 ├── start.sh / start.bat     # Startup script
 ├── HytaleServer.jar          # Game server (auto-downloaded)
 ├── Assets.zip                 # Game assets (auto-downloaded)
 ├── dualauth-agent.jar         # Auth agent (auto-downloaded)
 ├── .server-id                 # Persistent server UUID
 ├── .versions/                 # Version tracking for auto-updates
 ├── Server/                    # Server data (created by server)
 │   ├── config.json
 │   └── worlds/
 └── UserData/                  # Player saves
 ```
 ## Troubleshooting
 | Problem | Solution |
 |---------|----------|
 | `java not found` | Install the F2P launcher (includes Java) or install Java 25+ from [adoptium.net](https://adoptium.net/) |
 | Download fails | Check internet connection. Files can be downloaded manually from `https://download.sanasol.ws/download/` |
 | Port already in use | Change port: `BIND_ADDRESS=0.0.0.0:5521 ./start.sh` |
 | Out of memory | Set more RAM: `JVM_XMX=4G ./start.sh` |
 | Friends can't connect | Forward port 5520 (TCP+UDP) on your router, or use [playit.gg](https://playit.gg) if you can't port forward |
 ## Discord
 Need help? Join the community: https://discord.gg/Fhbb9Yk5WW
--- a/server/start.bat
+++ b/server/start.bat
@@ -0,0 +1,441 @@
@echo off
 setlocal enabledelayedexpansion
 :: ============================================================
 :: Hytale F2P Dedicated Server - One-Click Starter
 :: ============================================================
 :: Just double-click this file to start your server!
 ::
 :: The script will:
 ::   1. Look for game files and Java in your F2P launcher install
 ::   2. Auto-download anything missing
 ::   3. Auto-update server, assets, and agent on each launch
 ::   4. Fetch auth tokens and start the server
 :: ============================================================
 :: Configuration (edit these or set as environment variables)
 if not defined HYTALE_AUTH_DOMAIN set "HYTALE_AUTH_DOMAIN=auth.sanasol.ws"
 if not defined AUTH_SERVER set "AUTH_SERVER=https://%HYTALE_AUTH_DOMAIN%"
 if not defined SERVER_NAME set "SERVER_NAME=My Hytale Server"
 if not defined ASSETS_PATH set "ASSETS_PATH=.\Assets.zip"
 if not defined BIND_ADDRESS set "BIND_ADDRESS=0.0.0.0:5520"
 if not defined AUTH_MODE set "AUTH_MODE=authenticated"
 if not defined DOWNLOAD_BASE set "DOWNLOAD_BASE=https://download.sanasol.ws/download"
 :: File names
 set "AGENT_JAR=dualauth-agent.jar"
 set "SERVER_JAR=HytaleServer.jar"
 set "AGENT_URL=https://github.com/sanasol/hytale-auth-server/releases/latest/download/dualauth-agent.jar"
 set "AGENT_VERSION_API=https://api.github.com/repos/sanasol/hytale-auth-server/releases/latest"
 set "VERSION_DIR=.versions"
 echo ============================================================
 echo   Hytale F2P Dedicated Server
 echo ============================================================
 echo.
 :: --- Prerequisite Checks ---
 where curl >nul 2>&1
 if errorlevel 1 (
    echo [ERROR] curl is required but not found
    echo [ERROR] curl comes with Windows 10+. Update Windows or install curl.
    pause
    exit /b 1
 )
 if not exist "%VERSION_DIR%" mkdir "%VERSION_DIR%"
 :: --- Find Local F2P Launcher Install ---
 set "F2P_DIR="
 set "F2P_BASE=%USERPROFILE%\AppData\Local\HytaleF2P"
 set "F2P_CONFIG=%F2P_BASE%\config.json"
 set "JAVA_CMD=java"
 :: Check config.json for custom installPath
 set "F2P_CUSTOM_BASE="
 if exist "%F2P_CONFIG%" (
    for /f "delims=" %%p in ('powershell -Command "try { $c = Get-Content '%F2P_CONFIG%' | ConvertFrom-Json; if ($c.installPath) { $c.installPath.Trim() + '\HytaleF2P' } } catch {}" 2^>nul') do (
        set "F2P_CUSTOM_BASE=%%p"
    )
 )
 :: Search for game files: custom path first, then default
 if defined F2P_CUSTOM_BASE (
    if exist "!F2P_CUSTOM_BASE!\release\package\game\latest" (
        set "F2P_DIR=!F2P_CUSTOM_BASE!\release\package\game\latest"
    ) else if exist "!F2P_CUSTOM_BASE!\pre-release\package\game\latest" (
        set "F2P_DIR=!F2P_CUSTOM_BASE!\pre-release\package\game\latest"
    )
 )
 if not defined F2P_DIR (
    if exist "%F2P_BASE%\release\package\game\latest" (
        set "F2P_DIR=%F2P_BASE%\release\package\game\latest"
    ) else if exist "%F2P_BASE%\pre-release\package\game\latest" (
        set "F2P_DIR=%F2P_BASE%\pre-release\package\game\latest"
    )
 )
 :: --- Find Java from F2P launcher ---
 :: Check config.json for custom javaPath
 if exist "%F2P_CONFIG%" (
    for /f "delims=" %%j in ('powershell -Command "try { $c = Get-Content '%F2P_CONFIG%' | ConvertFrom-Json; if ($c.javaPath -and (Test-Path $c.javaPath)) { $c.javaPath.Trim() } } catch {}" 2^>nul') do (
        set "JAVA_CMD=%%j"
        echo [INFO] Found Java in F2P config: %%j
    )
 )
 :: Check bundled JRE if no custom javaPath found
 if "!JAVA_CMD!"=="java" (
    set "F2P_JRE_BASE="
    if defined F2P_CUSTOM_BASE (
        if exist "!F2P_CUSTOM_BASE!\release\package\jre\latest\bin\java.exe" (
            set "F2P_JRE_BASE=!F2P_CUSTOM_BASE!\release\package\jre\latest"
        ) else if exist "!F2P_CUSTOM_BASE!\pre-release\package\jre\latest\bin\java.exe" (
            set "F2P_JRE_BASE=!F2P_CUSTOM_BASE!\pre-release\package\jre\latest"
        )
    )
    if not defined F2P_JRE_BASE (
        if exist "%F2P_BASE%\release\package\jre\latest\bin\java.exe" (
            set "F2P_JRE_BASE=%F2P_BASE%\release\package\jre\latest"
        ) else if exist "%F2P_BASE%\pre-release\package\jre\latest\bin\java.exe" (
            set "F2P_JRE_BASE=%F2P_BASE%\pre-release\package\jre\latest"
        )
    )
    if defined F2P_JRE_BASE (
        set "JAVA_CMD=!F2P_JRE_BASE!\bin\java.exe"
        echo [INFO] Found Java in F2P launcher: !JAVA_CMD!
    )
 )
 :: Verify java exists
 "!JAVA_CMD!" -version >nul 2>&1
 if errorlevel 1 (
    where java >nul 2>&1
    if errorlevel 1 (
        echo [ERROR] Java is not installed and no F2P launcher JRE found
        echo.
        echo   Options:
        echo     1. Install the F2P launcher first ^(it includes Java^)
        echo     2. Download Java 25: https://download.oracle.com/java/25/latest/jdk-25_windows-x64_bin.exe
        echo.
        pause
        exit /b 1
    )
    set "JAVA_CMD=java"
 )
 :: Check Java version
 for /f "tokens=3 delims= " %%v in ('"!JAVA_CMD!" -version 2^>^&1 ^| findstr /i "version"') do (
    set "JAVA_VER_RAW=%%~v"
 )
 if defined JAVA_VER_RAW (
    for /f "tokens=1 delims=." %%m in ("!JAVA_VER_RAW!") do set "JAVA_MAJOR=%%m"
 )
 echo [INFO] Java: !JAVA_VER_RAW! ^(!JAVA_CMD!^)
 if defined JAVA_MAJOR (
    if !JAVA_MAJOR! LSS 25 (
        echo [ERROR] Java !JAVA_MAJOR! detected. Java 25+ is REQUIRED.
        echo         The DualAuth agent requires Java 25 ^(class file version 69^).
        echo.
        echo   Download Java 25: https://download.oracle.com/java/25/latest/jdk-25_windows-x64_bin.exe
        echo.
        pause
        exit /b 1
    )
 )
 :: --- Copy game files from F2P install ---
 if defined F2P_DIR (
    echo [INFO] Found F2P launcher game files: !F2P_DIR!
    if not exist "%SERVER_JAR%" (
        if exist "!F2P_DIR!\Server\HytaleServer.jar" (
            echo [INFO] Found HytaleServer.jar in F2P launcher
            echo [INFO]   Copying from: !F2P_DIR!\Server\HytaleServer.jar
            copy "!F2P_DIR!\Server\HytaleServer.jar" "%SERVER_JAR%" >nul
            echo [INFO]   Copied successfully
        )
    )
    if not exist "%ASSETS_PATH%" (
        if exist "!F2P_DIR!\Assets.zip" (
            echo [INFO] Found Assets.zip in F2P launcher
            echo [INFO]   Copying from: !F2P_DIR!\Assets.zip
            copy "!F2P_DIR!\Assets.zip" "%ASSETS_PATH%" >nul
            echo [INFO]   Copied successfully
        )
    )
    echo.
 ) else (
    echo [INFO] No F2P launcher install found, will download files
    echo.
 )
 :: --- Download / Update HytaleServer.jar ---
 set "JAR_URL=%DOWNLOAD_BASE%/HytaleServer.jar"
 set "JAR_VERSION_FILE=%VERSION_DIR%\HytaleServer.jar.version"
 if not exist "%SERVER_JAR%" (
    echo [INFO] HytaleServer.jar not found, downloading...
    echo [INFO]   Expected size: ~150 MB
    curl -fL --progress-bar -o "%SERVER_JAR%.tmp" "%JAR_URL%" --connect-timeout 15 --max-time 3600
    if exist "%SERVER_JAR%.tmp" (
        move /y "%SERVER_JAR%.tmp" "%SERVER_JAR%" >nul
        echo [INFO] HytaleServer.jar downloaded
        for /f "delims=" %%h in ('powershell -Command "try { (Invoke-WebRequest -Uri '%JAR_URL%' -Method Head -UseBasicParsing).Headers['ETag'] } catch {}" 2^>nul') do (
            echo %%h>"%JAR_VERSION_FILE%"
        )
    ) else (
        echo [ERROR] Failed to download HytaleServer.jar
        echo [ERROR] Check your internet connection
        pause
        exit /b 1
    )
 ) else (
    echo [INFO] Checking for HytaleServer.jar updates...
    set "LOCAL_JAR_VER="
    if exist "%JAR_VERSION_FILE%" set /p LOCAL_JAR_VER=<"%JAR_VERSION_FILE%"
    set "REMOTE_JAR_VER="
    for /f "delims=" %%h in ('powershell -Command "try { (Invoke-WebRequest -Uri '%JAR_URL%' -Method Head -UseBasicParsing -TimeoutSec 10).Headers['ETag'] } catch { '' }" 2^>nul') do (
        set "REMOTE_JAR_VER=%%h"
    )
    if defined REMOTE_JAR_VER (
        if "!LOCAL_JAR_VER!"=="!REMOTE_JAR_VER!" (
            echo [INFO] HytaleServer.jar is up to date
        ) else (
            echo [INFO] HytaleServer.jar update available, downloading...
            curl -fL --progress-bar -o "%SERVER_JAR%.tmp" "%JAR_URL%" --connect-timeout 15 --max-time 3600
            if exist "%SERVER_JAR%.tmp" (
                move /y "%SERVER_JAR%.tmp" "%SERVER_JAR%" >nul
                echo !REMOTE_JAR_VER!>"%JAR_VERSION_FILE%"
                echo [INFO] HytaleServer.jar updated
            ) else (
                echo [WARN] Update failed, using existing HytaleServer.jar
            )
        )
    ) else (
        echo [INFO] Could not check for updates, using existing HytaleServer.jar
    )
 )
 :: --- Download / Update Assets.zip ---
 set "ASSETS_URL=%DOWNLOAD_BASE%/Assets.zip"
 set "ASSETS_VERSION_FILE=%VERSION_DIR%\Assets.zip.version"
 if not exist "%ASSETS_PATH%" (
    echo [INFO] Assets.zip not found, downloading...
    echo [INFO]   Expected size: ~3.3 GB - this will take a while
    curl -fL --progress-bar -o "%ASSETS_PATH%.tmp" "%ASSETS_URL%" --connect-timeout 15 --max-time 7200
    if exist "%ASSETS_PATH%.tmp" (
        move /y "%ASSETS_PATH%.tmp" "%ASSETS_PATH%" >nul
        echo [INFO] Assets.zip downloaded
        for /f "delims=" %%h in ('powershell -Command "try { (Invoke-WebRequest -Uri '%ASSETS_URL%' -Method Head -UseBasicParsing).Headers['ETag'] } catch {}" 2^>nul') do (
            echo %%h>"%ASSETS_VERSION_FILE%"
        )
    ) else (
        echo [ERROR] Failed to download Assets.zip
        echo [ERROR] Check your internet connection
        pause
        exit /b 1
    )
 ) else (
    echo [INFO] Checking for Assets.zip updates...
    set "LOCAL_ASSETS_VER="
    if exist "%ASSETS_VERSION_FILE%" set /p LOCAL_ASSETS_VER=<"%ASSETS_VERSION_FILE%"
    set "REMOTE_ASSETS_VER="
    for /f "delims=" %%h in ('powershell -Command "try { (Invoke-WebRequest -Uri '%ASSETS_URL%' -Method Head -UseBasicParsing -TimeoutSec 10).Headers['ETag'] } catch { '' }" 2^>nul') do (
        set "REMOTE_ASSETS_VER=%%h"
    )
    if defined REMOTE_ASSETS_VER (
        if "!LOCAL_ASSETS_VER!"=="!REMOTE_ASSETS_VER!" (
            echo [INFO] Assets.zip is up to date
        ) else (
            echo [INFO] Assets.zip update available, downloading...
            echo [INFO]   This is a large file ^(~3.3 GB^), please be patient
            curl -fL --progress-bar -o "%ASSETS_PATH%.tmp" "%ASSETS_URL%" --connect-timeout 15 --max-time 7200
            if exist "%ASSETS_PATH%.tmp" (
                move /y "%ASSETS_PATH%.tmp" "%ASSETS_PATH%" >nul
                echo !REMOTE_ASSETS_VER!>"%ASSETS_VERSION_FILE%"
                echo [INFO] Assets.zip updated
            ) else (
                echo [WARN] Update failed, using existing Assets.zip
            )
        )
    ) else (
        echo [INFO] Could not check for updates, using existing Assets.zip
    )
 )
 :: --- Download / Update DualAuth Agent ---
 set "AGENT_VERSION_FILE=%VERSION_DIR%\dualauth-agent.jar.version"
 if not exist "%AGENT_JAR%" (
    echo [INFO] Downloading DualAuth Agent...
    curl -fL -# -o "%AGENT_JAR%.tmp" "%AGENT_URL%" --connect-timeout 15 --max-time 120
    if exist "%AGENT_JAR%.tmp" (
        move /y "%AGENT_JAR%.tmp" "%AGENT_JAR%" >nul
        echo [INFO] DualAuth Agent downloaded
        for /f "delims=" %%v in ('powershell -Command "try { $r = Invoke-RestMethod -Uri '%AGENT_VERSION_API%' -TimeoutSec 10; $r.tag_name } catch { '' }" 2^>nul') do (
            echo %%v>"%AGENT_VERSION_FILE%"
        )
    ) else (
        echo [ERROR] Failed to download DualAuth Agent
        echo [ERROR] Download manually: %AGENT_URL%
        pause
        exit /b 1
    )
 ) else (
    echo [INFO] Checking for DualAuth Agent updates...
    set "LOCAL_AGENT_VER="
    if exist "%AGENT_VERSION_FILE%" set /p LOCAL_AGENT_VER=<"%AGENT_VERSION_FILE%"
    set "REMOTE_AGENT_VER="
    for /f "delims=" %%v in ('powershell -Command "try { $r = Invoke-RestMethod -Uri '%AGENT_VERSION_API%' -TimeoutSec 10; $r.tag_name } catch { '' }" 2^>nul') do (
        set "REMOTE_AGENT_VER=%%v"
    )
    if defined REMOTE_AGENT_VER (
        if "!LOCAL_AGENT_VER!"=="!REMOTE_AGENT_VER!" (
            echo [INFO] DualAuth Agent up to date ^(!LOCAL_AGENT_VER!^)
        ) else (
            echo [INFO] Agent update: !LOCAL_AGENT_VER! -^> !REMOTE_AGENT_VER!
            curl -fL -# -o "%AGENT_JAR%.tmp" "%AGENT_URL%" --connect-timeout 15 --max-time 120
            if exist "%AGENT_JAR%.tmp" (
                move /y "%AGENT_JAR%.tmp" "%AGENT_JAR%" >nul
                echo !REMOTE_AGENT_VER!>"%AGENT_VERSION_FILE%"
                echo [INFO] DualAuth Agent updated
            ) else (
                echo [WARN] Agent update failed, using existing
            )
        )
    ) else (
        echo [INFO] Could not check agent updates, using existing
    )
 )
 :: --- Final Checks ---
 if not exist "%SERVER_JAR%" (
    echo [ERROR] HytaleServer.jar not found
    pause
    exit /b 1
 )
 if not exist "%ASSETS_PATH%" (
    echo [ERROR] Assets.zip not found
    pause
    exit /b 1
 )
 if not exist "%AGENT_JAR%" (
    echo [ERROR] dualauth-agent.jar not found
    pause
    exit /b 1
 )
 :: --- Generate or Load Server ID ---
 set "SERVER_ID_FILE=.server-id"
 if exist "%SERVER_ID_FILE%" (
    set /p SERVER_ID=<"%SERVER_ID_FILE%"
    echo [INFO] Server ID: !SERVER_ID!
 ) else (
    for /f "delims=" %%i in ('powershell -Command "[guid]::NewGuid().ToString()"') do set "SERVER_ID=%%i"
    echo !SERVER_ID!>"%SERVER_ID_FILE%"
    echo [INFO] Generated server ID: !SERVER_ID!
 )
 :: --- Fetch Server Tokens ---
 echo.
 echo [INFO] Fetching server tokens from %AUTH_SERVER%...
 set "TEMP_RESPONSE=%TEMP%\hytale_auth_%RANDOM%.json"
 curl -s -X POST "%AUTH_SERVER%/server/auto-auth" ^
    -H "Content-Type: application/json" ^
    -d "{\"server_id\": \"!SERVER_ID!\", \"server_name\": \"%SERVER_NAME%\"}" ^
    --connect-timeout 10 ^
    --max-time 30 ^
    -o "%TEMP_RESPONSE%" 2>nul
 if errorlevel 1 (
    echo [ERROR] Failed to connect to auth server at %AUTH_SERVER%
    del "%TEMP_RESPONSE%" 2>nul
    pause
    exit /b 1
 )
 findstr /C:"sessionToken" "%TEMP_RESPONSE%" >nul 2>&1
 if errorlevel 1 (
    echo [ERROR] Invalid response from auth server:
    type "%TEMP_RESPONSE%"
    del "%TEMP_RESPONSE%" 2>nul
    pause
    exit /b 1
 )
 :: Extract tokens using PowerShell
 for /f "delims=" %%i in ('powershell -Command "$j = Get-Content '%TEMP_RESPONSE%' | ConvertFrom-Json; $j.sessionToken"') do set "SESSION_TOKEN=%%i"
 for /f "delims=" %%i in ('powershell -Command "$j = Get-Content '%TEMP_RESPONSE%' | ConvertFrom-Json; $j.identityToken"') do set "IDENTITY_TOKEN=%%i"
 del "%TEMP_RESPONSE%" 2>nul
 if "!SESSION_TOKEN!"=="" (
    echo [ERROR] Could not extract session token from response
    pause
    exit /b 1
 )
 if "!IDENTITY_TOKEN!"=="" (
    echo [ERROR] Could not extract identity token from response
    pause
    exit /b 1
 )
 echo [INFO] Tokens received successfully
 :: --- Start Server ---
 set "JAVA_ARGS="
 if defined JVM_XMS set "JAVA_ARGS=!JAVA_ARGS! -Xms%JVM_XMS%"
 if defined JVM_XMX set "JAVA_ARGS=!JAVA_ARGS! -Xmx%JVM_XMX%"
 echo.
 echo ============================================================
 echo   Starting Hytale Server
 echo   Name:    %SERVER_NAME%
 echo   Bind:    %BIND_ADDRESS%
 echo   Java:    !JAVA_CMD!
 echo   Agent:   %AGENT_JAR%
 echo ============================================================
 echo.
 "!JAVA_CMD!" %JAVA_ARGS% -javaagent:"%AGENT_JAR%" -jar "%SERVER_JAR%" ^
    --assets "%ASSETS_PATH%" ^
    --bind "%BIND_ADDRESS%" ^
    --auth-mode "%AUTH_MODE%" ^
    --disable-sentry ^
    --session-token "!SESSION_TOKEN!" ^
    --identity-token "!IDENTITY_TOKEN!" ^
    %*
 echo.
 echo ============================================================
 echo   Server stopped. Exit code: %ERRORLEVEL%
 echo ============================================================
 pause
 endlocal
--- a/server/start.sh
+++ b/server/start.sh
@@ -0,0 +1,516 @@
 #!/bin/bash
 # ============================================================
 # Hytale F2P Dedicated Server - One-Click Starter
 # ============================================================
 # Just run: ./start.sh
 #
 # The script will:
 #   1. Look for game files in your F2P launcher install
 #   2. Auto-download anything missing
 #   3. Auto-update server, assets, and agent on each launch
 #   4. Fetch auth tokens and start the server
 # ============================================================
 set -e
 # Configuration (edit these or set as environment variables)
 HYTALE_AUTH_DOMAIN="${HYTALE_AUTH_DOMAIN:-auth.sanasol.ws}"
 AUTH_SERVER="${AUTH_SERVER:-https://$HYTALE_AUTH_DOMAIN}"
 SERVER_NAME="${SERVER_NAME:-My Hytale Server}"
 BIND_ADDRESS="${BIND_ADDRESS:-0.0.0.0:5520}"
 AUTH_MODE="${AUTH_MODE:-authenticated}"
 # Download URLs
 DOWNLOAD_BASE="${DOWNLOAD_BASE:-https://download.sanasol.ws/download}"
 AGENT_URL="https://github.com/sanasol/hytale-auth-server/releases/latest/download/dualauth-agent.jar"
 AGENT_VERSION_API="https://api.github.com/repos/sanasol/hytale-auth-server/releases/latest"
 # File names (in current directory)
 AGENT_JAR="dualauth-agent.jar"
 SERVER_JAR="HytaleServer.jar"
 ASSETS_FILE="Assets.zip"
 ASSETS_PATH="${ASSETS_PATH:-./Assets.zip}"
 VERSION_DIR=".versions"
 echo "============================================================"
 echo "  Hytale F2P Dedicated Server"
 echo "============================================================"
 echo ""
 # --- Prerequisite Checks ---
 if ! command -v curl &>/dev/null; then
    echo "[ERROR] curl is required but not found"
    echo "        Install: sudo apt install curl"
    exit 1
 fi
 mkdir -p "$VERSION_DIR"
 # --- Find Local F2P Launcher Install ---
 get_f2p_default_dir() {
    case "$(uname -s)" in
        Darwin) echo "$HOME/Library/Application Support/HytaleF2P" ;;
        Linux)  echo "$HOME/.hytalef2p" ;;
        *)      return 1 ;;
    esac
 }
 # Read a JSON string field from config.json using available tools
 read_config_field() {
    local config_file="$1" field="$2"
    if [ ! -f "$config_file" ]; then return 1; fi
    if command -v python3 &>/dev/null; then
        python3 -c "
 import json
 try:
    c = json.load(open('$config_file'))
    v = c.get('$field', '').strip()
    if v: print(v)
 except: pass
 " 2>/dev/null
    elif command -v jq &>/dev/null; then
        jq -r ".$field // empty" "$config_file" 2>/dev/null
    else
        grep -o "\"$field\"[[:space:]]*:[[:space:]]*\"[^\"]*\"" "$config_file" 2>/dev/null | cut -d'"' -f4
    fi
 }
 find_f2p_install() {
    local default_app_dir
    default_app_dir=$(get_f2p_default_dir) || return 1
    local search_dirs=()
    # Check config.json for custom installPath
    local config_file="$default_app_dir/config.json"
    local custom_path
    custom_path=$(read_config_field "$config_file" "installPath")
    if [ -n "$custom_path" ]; then
        local custom_f2p="$custom_path/HytaleF2P"
        if [ -d "$custom_f2p" ]; then
            search_dirs+=("$custom_f2p")
        fi
    fi
    # Always also check default location
    search_dirs+=("$default_app_dir")
    for base in "${search_dirs[@]}"; do
        for branch in "release" "pre-release"; do
            local game_dir="$base/$branch/package/game/latest"
            if [ -d "$game_dir" ]; then
                echo "$game_dir"
                return 0
            fi
        done
    done
    return 1
 }
 # Find bundled JRE from F2P launcher install
 find_f2p_java() {
    local default_app_dir
    default_app_dir=$(get_f2p_default_dir) || return 1
    local search_dirs=()
    # Check config.json for custom javaPath first
    local config_file="$default_app_dir/config.json"
    local custom_java
    custom_java=$(read_config_field "$config_file" "javaPath")
    if [ -n "$custom_java" ] && [ -x "$custom_java" ]; then
        echo "$custom_java"
        return 0
    fi
    # Check custom installPath
    local custom_path
    custom_path=$(read_config_field "$config_file" "installPath")
    if [ -n "$custom_path" ]; then
        local custom_f2p="$custom_path/HytaleF2P"
        [ -d "$custom_f2p" ] && search_dirs+=("$custom_f2p")
    fi
    search_dirs+=("$default_app_dir")
    for base in "${search_dirs[@]}"; do
        for branch in "release" "pre-release"; do
            local jre_dir="$base/$branch/package/jre/latest"
            # Standard path
            if [ -x "$jre_dir/bin/java" ]; then
                echo "$jre_dir/bin/java"
                return 0
            fi
            # macOS bundle path
            if [ -x "$jre_dir/Contents/Home/bin/java" ]; then
                echo "$jre_dir/Contents/Home/bin/java"
                return 0
            fi
        done
    done
    return 1
 }
 copy_from_f2p() {
    local file="$1" local_path="$2" f2p_path="$3"
    if [ -f "$local_path" ]; then
        return 1  # Already exists locally
    fi
    if [ -f "$f2p_path" ]; then
        echo "[INFO] Found $file in F2P launcher install"
        echo "[INFO]   Copying from: $f2p_path"
        cp "$f2p_path" "$local_path"
        echo "[INFO]   Copied successfully"
        return 0
    fi
    return 1
 }
 # --- Detect Java ---
 JAVA_CMD="java"
 # Try F2P bundled JRE first
 F2P_JAVA=$(find_f2p_java 2>/dev/null) || true
 if [ -n "$F2P_JAVA" ]; then
    echo "[INFO] Found Java in F2P launcher: $F2P_JAVA"
    JAVA_CMD="$F2P_JAVA"
 elif ! command -v java &>/dev/null; then
    echo "[ERROR] Java is not installed and no F2P launcher JRE found"
    echo ""
    echo "  Options:"
    echo "    1. Install the F2P launcher first (it includes Java)"
    echo "    2. Install Java 25+ manually:"
    echo "       Windows:       https://download.oracle.com/java/25/latest/jdk-25_windows-x64_bin.exe"
    echo "       macOS:         brew install openjdk"
    echo "       Ubuntu/Debian: sudo apt install openjdk-25-jre"
    echo ""
    exit 1
 fi
 # Check Java version
 JAVA_FULL=$("$JAVA_CMD" -version 2>&1 | head -1)
 JAVA_VER=$(echo "$JAVA_FULL" | grep -oP '(?<=")\d+' 2>/dev/null || echo "$JAVA_FULL" | sed 's/.*"\([0-9]*\).*/\1/')
 echo "[INFO] Java: $JAVA_FULL"
 if [ -n "$JAVA_VER" ] && [ "$JAVA_VER" -lt 25 ] 2>/dev/null; then
    echo "[ERROR] Java $JAVA_VER detected. Java 25+ is REQUIRED."
    echo "        The DualAuth agent requires Java 25 (class file version 69)."
    echo ""
    if [ -n "$F2P_JAVA" ]; then
        echo "  Your F2P launcher JRE is outdated. Update the launcher to get a newer Java."
    else
        echo "  Install Java 25+:"
        echo "    Windows:       https://download.oracle.com/java/25/latest/jdk-25_windows-x64_bin.exe"
        echo "    macOS:         brew install openjdk"
        echo "    Ubuntu/Debian: sudo apt install openjdk-25-jre"
    fi
    echo ""
    exit 1
 fi
 # --- Find F2P Game Files ---
 F2P_DIR=""
 if F2P_DIR=$(find_f2p_install 2>/dev/null); then
    echo "[INFO] Found F2P launcher game files: $F2P_DIR"
    # Try to copy HytaleServer.jar from F2P install
    copy_from_f2p "HytaleServer.jar" "$SERVER_JAR" "$F2P_DIR/Server/HytaleServer.jar" || true
    # Try to copy Assets.zip from F2P install
    copy_from_f2p "Assets.zip" "$ASSETS_PATH" "$F2P_DIR/Assets.zip" || true
    echo ""
 else
    echo "[INFO] No F2P launcher install found, will download files"
    echo ""
 fi
 # --- Download / Update Functions ---
 get_remote_version() {
    local url="$1"
    local headers
    headers=$(curl -sI -L "$url" --connect-timeout 10 --max-time 15 2>/dev/null | tr -d '\r')
    local etag
    etag=$(echo "$headers" | grep -i "^etag:" | tail -1 | sed 's/^[^:]*: *//' | tr -d '"')
    if [ -n "$etag" ]; then printf '%s' "$etag"; return 0; fi
    local lastmod
    lastmod=$(echo "$headers" | grep -i "^last-modified:" | tail -1 | sed 's/^[^:]*: *//')
    if [ -n "$lastmod" ]; then printf '%s' "$lastmod"; return 0; fi
    local length
    length=$(echo "$headers" | grep -i "^content-length:" | tail -1 | sed 's/^[^:]*: *//')
    if [ -n "$length" ]; then printf 'size:%s' "$length"; return 0; fi
    return 1
 }
 needs_update() {
    local url="$1" dest="$2" name="$3"
    local version_file="${VERSION_DIR}/${name}.version"
    if [ ! -f "$dest" ]; then
        echo "[INFO] $name not found, will download"
        return 0
    fi
    echo "[INFO] Checking for $name updates..."
    local remote_version
    remote_version=$(get_remote_version "$url" 2>/dev/null) || true
    if [ -z "$remote_version" ]; then
        echo "[INFO] Could not check for updates, using existing $name"
        return 1
    fi
    local local_version=""
    [ -f "$version_file" ] && local_version=$(cat "$version_file" 2>/dev/null)
    if [ "$remote_version" = "$local_version" ]; then
        echo "[INFO] $name is up to date"
        return 1
    fi
    if [ -n "$local_version" ]; then
        echo "[INFO] $name update available"
    fi
    return 0
 }
 save_version() {
    local url="$1" name="$2"
    local version_file="${VERSION_DIR}/${name}.version"
    local ver
    ver=$(get_remote_version "$url" 2>/dev/null) || true
    [ -n "$ver" ] && printf '%s\n' "$ver" > "$version_file"
 }
 download_file() {
    local url="$1" dest="$2" name="$3" expected_mb="${4:-0}"
    local tmp="${dest}.tmp"
    echo "[INFO] Downloading $name..."
    [ "$expected_mb" -gt 0 ] 2>/dev/null && echo "[INFO]   Expected size: ~${expected_mb} MB"
    for attempt in 1 2 3; do
        rm -f "$tmp" 2>/dev/null || true
        if [ "$expected_mb" -gt 50 ] 2>/dev/null; then
            curl -fL --progress-bar -o "$tmp" "$url" --connect-timeout 15 --max-time 3600 2>&1
        else
            curl -fL -# -o "$tmp" "$url" --connect-timeout 15 --max-time 300 2>&1
        fi
        if [ $? -eq 0 ] && [ -f "$tmp" ]; then
            local size
            size=$(stat -c%s "$tmp" 2>/dev/null || stat -f%z "$tmp" 2>/dev/null || echo 0)
            if [ "$size" -gt 1000 ]; then
                mv -f "$tmp" "$dest"
                local mb=$((size / 1024 / 1024))
                echo "[INFO] $name downloaded (${mb} MB)"
                return 0
            fi
            echo "[WARN] $name download too small (${size} bytes), retrying..."
        fi
        echo "[WARN] Download attempt $attempt failed, retrying..."
        rm -f "$tmp" 2>/dev/null || true
        sleep 2
    done
    echo "[ERROR] Failed to download $name after 3 attempts"
    rm -f "$tmp" 2>/dev/null || true
    return 1
 }
 # --- Download / Update Server Files ---
 # HytaleServer.jar
 JAR_URL="${DOWNLOAD_BASE}/HytaleServer.jar"
 if needs_update "$JAR_URL" "$SERVER_JAR" "HytaleServer.jar"; then
    if download_file "$JAR_URL" "$SERVER_JAR" "HytaleServer.jar" "150"; then
        save_version "$JAR_URL" "HytaleServer.jar"
    else
        if [ ! -f "$SERVER_JAR" ]; then
            echo "[ERROR] HytaleServer.jar is required. Check your internet connection."
            exit 1
        fi
        echo "[WARN] Update failed, using existing HytaleServer.jar"
    fi
 fi
 # Assets.zip
 ASSETS_URL="${DOWNLOAD_BASE}/Assets.zip"
 if needs_update "$ASSETS_URL" "$ASSETS_PATH" "Assets.zip"; then
    echo "[INFO] Assets.zip is large (~3.3 GB), this may take a while..."
    if download_file "$ASSETS_URL" "$ASSETS_PATH" "Assets.zip" "3300"; then
        save_version "$ASSETS_URL" "Assets.zip"
    else
        if [ ! -f "$ASSETS_PATH" ]; then
            echo "[ERROR] Assets.zip is required. Check your internet connection."
            exit 1
        fi
        echo "[WARN] Update failed, using existing Assets.zip"
    fi
 fi
 # DualAuth Agent (uses GitHub releases API for version tracking)
 check_agent_update() {
    if [ -f "$AGENT_JAR" ]; then
        local agent_size
        agent_size=$(stat -c%s "$AGENT_JAR" 2>/dev/null || stat -f%z "$AGENT_JAR" 2>/dev/null || echo 0)
        if [ "$agent_size" -lt 10000 ]; then
            echo "[WARN] Agent JAR seems corrupt (${agent_size} bytes), re-downloading..."
            rm -f "$AGENT_JAR"
            return 0
        fi
        local version_file="${VERSION_DIR}/${AGENT_JAR}.version"
        local local_version=""
        [ -f "$version_file" ] && local_version=$(cat "$version_file" 2>/dev/null)
        echo "[INFO] Checking for DualAuth Agent updates..."
        local remote_version
        remote_version=$(curl -sf "$AGENT_VERSION_API" --connect-timeout 5 --max-time 10 2>/dev/null | grep -o '"tag_name":"[^"]*"' | cut -d'"' -f4)
        if [ -n "$remote_version" ]; then
            if [ "$local_version" = "$remote_version" ]; then
                echo "[INFO] DualAuth Agent up to date ($local_version)"
                return 1
            else
                echo "[INFO] Agent update: ${local_version:-unknown} -> $remote_version"
                return 0
            fi
        else
            echo "[INFO] Could not check agent updates, using existing"
            return 1
        fi
    else
        return 0
    fi
 }
 AGENT_REMOTE_VERSION=""
 if check_agent_update; then
    echo "[INFO] Downloading DualAuth Agent..."
    if curl -fL -# -o "${AGENT_JAR}.tmp" "$AGENT_URL" --connect-timeout 15 --max-time 120 2>&1 && [ -f "${AGENT_JAR}.tmp" ]; then
        dl_size=$(stat -c%s "${AGENT_JAR}.tmp" 2>/dev/null || stat -f%z "${AGENT_JAR}.tmp" 2>/dev/null || echo 0)
        if [ "$dl_size" -gt 10000 ]; then
            mv -f "${AGENT_JAR}.tmp" "$AGENT_JAR"
            AGENT_REMOTE_VERSION=$(curl -sf "$AGENT_VERSION_API" --connect-timeout 5 --max-time 10 2>/dev/null | grep -o '"tag_name":"[^"]*"' | cut -d'"' -f4)
            [ -n "$AGENT_REMOTE_VERSION" ] && printf '%s\n' "$AGENT_REMOTE_VERSION" > "${VERSION_DIR}/${AGENT_JAR}.version"
            echo "[INFO] DualAuth Agent ready (${AGENT_REMOTE_VERSION:-latest})"
        else
            echo "[WARN] Downloaded agent too small, discarding"
            rm -f "${AGENT_JAR}.tmp"
        fi
    else
        rm -f "${AGENT_JAR}.tmp" 2>/dev/null
        if [ -f "$AGENT_JAR" ]; then
            echo "[WARN] Agent update failed, using existing"
        else
            echo "[ERROR] Failed to download DualAuth Agent"
            echo "[ERROR] Download manually: $AGENT_URL"
            exit 1
        fi
    fi
 fi
 # --- Final Checks ---
 for required in "$SERVER_JAR" "$ASSETS_PATH" "$AGENT_JAR"; do
    if [ ! -f "$required" ]; then
        echo "[ERROR] Required file missing: $required"
        exit 1
    fi
 done
 # --- Generate Server ID ---
 SERVER_ID_FILE=".server-id"
 if [ -f "$SERVER_ID_FILE" ]; then
    SERVER_ID=$(cat "$SERVER_ID_FILE")
    echo "[INFO] Server ID: $SERVER_ID"
 else
    SERVER_ID=$(cat /proc/sys/kernel/random/uuid 2>/dev/null || uuidgen 2>/dev/null || python3 -c "import uuid; print(uuid.uuid4())" 2>/dev/null)
    if [ -z "$SERVER_ID" ]; then
        echo "[ERROR] Could not generate UUID. Install uuidgen or python3."
        exit 1
    fi
    printf '%s' "$SERVER_ID" > "$SERVER_ID_FILE"
    echo "[INFO] Generated server ID: $SERVER_ID"
 fi
 # --- Fetch Tokens ---
 echo ""
 echo "[INFO] Fetching server tokens from $AUTH_SERVER..."
 TEMP_RESPONSE=$(mktemp)
 curl -s -X POST "$AUTH_SERVER/server/auto-auth" \
    -H "Content-Type: application/json" \
    -d "{\"server_id\": \"$SERVER_ID\", \"server_name\": \"$SERVER_NAME\"}" \
    --connect-timeout 10 \
    --max-time 30 \
    -o "$TEMP_RESPONSE"
 if [ $? -ne 0 ]; then
    echo "[ERROR] Failed to connect to auth server at $AUTH_SERVER"
    rm -f "$TEMP_RESPONSE"
    exit 1
 fi
 if ! grep -q "sessionToken" "$TEMP_RESPONSE" 2>/dev/null; then
    echo "[ERROR] Invalid response from auth server:"
    cat "$TEMP_RESPONSE"
    rm -f "$TEMP_RESPONSE"
    exit 1
 fi
 # Extract tokens (python3 > jq > grep fallback)
 if command -v python3 &>/dev/null; then
    SESSION_TOKEN=$(python3 -c "import json,sys; print(json.load(open('$TEMP_RESPONSE'))['sessionToken'])")
    IDENTITY_TOKEN=$(python3 -c "import json,sys; print(json.load(open('$TEMP_RESPONSE'))['identityToken'])")
 elif command -v jq &>/dev/null; then
    SESSION_TOKEN=$(jq -r '.sessionToken' "$TEMP_RESPONSE")
    IDENTITY_TOKEN=$(jq -r '.identityToken' "$TEMP_RESPONSE")
 else
    SESSION_TOKEN=$(grep -o '"sessionToken":"[^"]*"' "$TEMP_RESPONSE" | cut -d'"' -f4)
    IDENTITY_TOKEN=$(grep -o '"identityToken":"[^"]*"' "$TEMP_RESPONSE" | cut -d'"' -f4)
 fi
 rm -f "$TEMP_RESPONSE"
 if [ -z "$SESSION_TOKEN" ] || [ -z "$IDENTITY_TOKEN" ]; then
    echo "[ERROR] Could not extract tokens from auth server response"
    exit 1
 fi
 echo "[INFO] Tokens received successfully"
 # --- Start Server ---
 JAVA_ARGS=""
 [ -n "${JVM_XMS:-}" ] && JAVA_ARGS="$JAVA_ARGS -Xms$JVM_XMS"
 [ -n "${JVM_XMX:-}" ] && JAVA_ARGS="$JAVA_ARGS -Xmx$JVM_XMX"
 echo ""
 echo "============================================================"
 echo "  Starting Hytale Server"
 echo "  Name:    $SERVER_NAME"
 echo "  Bind:    $BIND_ADDRESS"
 echo "  Agent:   $AGENT_JAR"
 echo "============================================================"
 echo ""
 exec "$JAVA_CMD" $JAVA_ARGS -javaagent:"$AGENT_JAR" -jar "$SERVER_JAR" \
    --assets "$ASSETS_PATH" \
    --bind "$BIND_ADDRESS" \
    --auth-mode "$AUTH_MODE" \
    --disable-sentry \
    --session-token "$SESSION_TOKEN" \
    --identity-token "$IDENTITY_TOKEN" \
    "$@"
--- a/test-uuid-persistence.js
+++ b/test-uuid-persistence.js
@@ -0,0 +1,523 @@
 #!/usr/bin/env node
 /**
 * UUID Persistence Tests
 *
 * Simulates the exact conditions that caused character data loss:
 * - Config file corruption during updates
 * - File locks making config temporarily unreadable
 * - Username re-entry after config wipe
 *
 * Run: node test-uuid-persistence.js
 */
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
 // Use a temp directory so we don't mess with real config
 const TEST_DIR = path.join(os.tmpdir(), 'hytale-uuid-test-' + Date.now());
 const CONFIG_FILE = path.join(TEST_DIR, 'config.json');
 const CONFIG_BACKUP = path.join(TEST_DIR, 'config.json.bak');
 const CONFIG_TEMP = path.join(TEST_DIR, 'config.json.tmp');
 const UUID_STORE_FILE = path.join(TEST_DIR, 'uuid-store.json');
 // Track test results
 let passed = 0;
 let failed = 0;
 const failures = [];
 function assert(condition, message) {
  if (condition) {
    passed++;
    console.log(`  ✓ ${message}`);
  } else {
    failed++;
    failures.push(message);
    console.log(`  ✗ FAIL: ${message}`);
  }
 }
 function assertEqual(actual, expected, message) {
  if (actual === expected) {
    passed++;
    console.log(`  ✓ ${message}`);
  } else {
    failed++;
    failures.push(`${message} (expected: ${expected}, got: ${actual})`);
    console.log(`  ✗ FAIL: ${message} (expected: "${expected}", got: "${actual}")`);
  }
 }
 function cleanup() {
  try {
    if (fs.existsSync(TEST_DIR)) {
      fs.rmSync(TEST_DIR, { recursive: true });
    }
  } catch (e) {}
 }
 function setup() {
  cleanup();
  fs.mkdirSync(TEST_DIR, { recursive: true });
 }
 // ============================================================================
 // Inline the config functions so we can override paths
 // (We can't require config.js directly because it uses hardcoded getAppDir())
 // ============================================================================
 function validateConfig(config) {
  if (!config || typeof config !== 'object') return false;
  if (config.userUuids !== undefined && typeof config.userUuids !== 'object') return false;
  if (config.username !== undefined && (typeof config.username !== 'string')) return false;
  return true;
 }
 function loadConfig() {
  try {
    if (fs.existsSync(CONFIG_FILE)) {
      const data = fs.readFileSync(CONFIG_FILE, 'utf8');
      if (data.trim()) {
        const config = JSON.parse(data);
        if (validateConfig(config)) return config;
        console.warn('[Config] Primary config invalid structure, trying backup...');
      }
    }
  } catch (err) {
    console.error('[Config] Failed to load primary config:', err.message);
  }
  try {
    if (fs.existsSync(CONFIG_BACKUP)) {
      const data = fs.readFileSync(CONFIG_BACKUP, 'utf8');
      if (data.trim()) {
        const config = JSON.parse(data);
        if (validateConfig(config)) {
          console.log('[Config] Recovered from backup successfully');
          try { fs.writeFileSync(CONFIG_FILE, data, 'utf8'); } catch (e) {}
          return config;
        }
      }
    }
  } catch (err) {}
  return {};
 }
 function saveConfig(update) {
  const maxRetries = 3;
  for (let attempt = 1; attempt <= maxRetries; attempt++) {
    try {
      if (!fs.existsSync(TEST_DIR)) fs.mkdirSync(TEST_DIR, { recursive: true });
      const currentConfig = loadConfig();
      // SAFETY CHECK: refuse to save if file exists but loaded empty
      if (Object.keys(currentConfig).length === 0 && fs.existsSync(CONFIG_FILE)) {
        const fileSize = fs.statSync(CONFIG_FILE).size;
        if (fileSize > 2) {
          console.error(`[Config] REFUSING to save — loaded empty but file exists (${fileSize} bytes). Retrying...`);
          const delay = attempt * 50; // shorter delay for tests
          const start = Date.now();
          while (Date.now() - start < delay) {}
          continue;
        }
      }
      const newConfig = { ...currentConfig, ...update };
      const data = JSON.stringify(newConfig, null, 2);
      fs.writeFileSync(CONFIG_TEMP, data, 'utf8');
      const verification = JSON.parse(fs.readFileSync(CONFIG_TEMP, 'utf8'));
      if (!validateConfig(verification)) throw new Error('Validation failed');
      if (fs.existsSync(CONFIG_FILE)) {
        try {
          const currentData = fs.readFileSync(CONFIG_FILE, 'utf8');
          if (currentData.trim()) fs.writeFileSync(CONFIG_BACKUP, currentData, 'utf8');
        } catch (e) {}
      }
      fs.renameSync(CONFIG_TEMP, CONFIG_FILE);
      return true;
    } catch (err) {
      try { if (fs.existsSync(CONFIG_TEMP)) fs.unlinkSync(CONFIG_TEMP); } catch (e) {}
      if (attempt >= maxRetries) throw err;
    }
  }
 }
 function loadUuidStore() {
  try {
    if (fs.existsSync(UUID_STORE_FILE)) {
      const data = fs.readFileSync(UUID_STORE_FILE, 'utf8');
      if (data.trim()) return JSON.parse(data);
    }
  } catch (err) {}
  return {};
 }
 function saveUuidStore(store) {
  const tmpFile = UUID_STORE_FILE + '.tmp';
  fs.writeFileSync(tmpFile, JSON.stringify(store, null, 2), 'utf8');
  fs.renameSync(tmpFile, UUID_STORE_FILE);
 }
 function migrateUuidStoreIfNeeded() {
  if (fs.existsSync(UUID_STORE_FILE)) return;
  const config = loadConfig();
  if (config.userUuids && Object.keys(config.userUuids).length > 0) {
    console.log('[UUID Store] Migrating', Object.keys(config.userUuids).length, 'UUIDs');
    saveUuidStore(config.userUuids);
  }
 }
 function getUuidForUser(username) {
  const { v4: uuidv4 } = require('uuid');
  if (!username || !username.trim()) throw new Error('Username required');
  const displayName = username.trim();
  const normalizedLookup = displayName.toLowerCase();
  migrateUuidStoreIfNeeded();
  // 1. Check UUID store (source of truth)
  const uuidStore = loadUuidStore();
  const storeKey = Object.keys(uuidStore).find(k => k.toLowerCase() === normalizedLookup);
  if (storeKey) {
    const existingUuid = uuidStore[storeKey];
    if (storeKey !== displayName) {
      delete uuidStore[storeKey];
      uuidStore[displayName] = existingUuid;
      saveUuidStore(uuidStore);
    }
    // Sync to config (non-critical)
    try {
      const config = loadConfig();
      const configUuids = config.userUuids || {};
      const configKey = Object.keys(configUuids).find(k => k.toLowerCase() === normalizedLookup);
      if (!configKey || configUuids[configKey] !== existingUuid) {
        if (configKey) delete configUuids[configKey];
        configUuids[displayName] = existingUuid;
        saveConfig({ userUuids: configUuids });
      }
    } catch (e) {}
    return existingUuid;
  }
  // 2. Fallback: check config.json
  const config = loadConfig();
  const userUuids = config.userUuids || {};
  const configKey = Object.keys(userUuids).find(k => k.toLowerCase() === normalizedLookup);
  if (configKey) {
    const recoveredUuid = userUuids[configKey];
    uuidStore[displayName] = recoveredUuid;
    saveUuidStore(uuidStore);
    return recoveredUuid;
  }
  // 3. New user — generate UUID
  const newUuid = uuidv4();
  uuidStore[displayName] = newUuid;
  saveUuidStore(uuidStore);
  userUuids[displayName] = newUuid;
  saveConfig({ userUuids });
  return newUuid;
 }
 // ============================================================================
 // OLD CODE (before fix) — for comparison testing
 // ============================================================================
 function getUuidForUser_OLD(username) {
  const { v4: uuidv4 } = require('uuid');
  if (!username || !username.trim()) throw new Error('Username required');
  const displayName = username.trim();
  const normalizedLookup = displayName.toLowerCase();
  const config = loadConfig();
  const userUuids = config.userUuids || {};
  const existingKey = Object.keys(userUuids).find(k => k.toLowerCase() === normalizedLookup);
  if (existingKey) {
    return userUuids[existingKey];
  }
  // New user
  const newUuid = uuidv4();
  userUuids[displayName] = newUuid;
  saveConfig({ userUuids });
  return newUuid;
 }
 function saveConfig_OLD(update) {
  // OLD saveConfig without safety check
  if (!fs.existsSync(TEST_DIR)) fs.mkdirSync(TEST_DIR, { recursive: true });
  const currentConfig = loadConfig();
  // NO SAFETY CHECK — this is the bug
  const newConfig = { ...currentConfig, ...update };
  fs.writeFileSync(CONFIG_FILE, JSON.stringify(newConfig, null, 2), 'utf8');
  return true;
 }
 // ============================================================================
 // TESTS
 // ============================================================================
 console.log('\n' + '='.repeat(70));
 console.log('UUID PERSISTENCE TESTS — Simulating update corruption scenarios');
 console.log('='.repeat(70));
 // --------------------------------------------------------------------------
 // TEST 1: Normal flow — UUID stays consistent
 // --------------------------------------------------------------------------
 console.log('\n--- Test 1: Normal flow — UUID stays consistent ---');
 setup();
 const uuid1 = getUuidForUser('SpecialK');
 const uuid2 = getUuidForUser('SpecialK');
 const uuid3 = getUuidForUser('specialk'); // case insensitive
 assertEqual(uuid1, uuid2, 'Same username returns same UUID');
 assertEqual(uuid1, uuid3, 'Case-insensitive lookup returns same UUID');
 assert(uuid1.match(/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i), 'UUID is valid v4 format');
 // --------------------------------------------------------------------------
 // TEST 2: Simulate update corruption (THE BUG) — old code
 // --------------------------------------------------------------------------
 console.log('\n--- Test 2: OLD CODE — Config wipe during update loses UUID ---');
 setup();
 // Setup: player has UUID
 const oldConfig = { username: 'SpecialK', userUuids: { 'SpecialK': 'aaaaaaaa-bbbb-4ccc-9ddd-eeeeeeeeeeee' }, hasLaunchedBefore: true };
 fs.writeFileSync(CONFIG_FILE, JSON.stringify(oldConfig, null, 2), 'utf8');
 const uuidBefore = getUuidForUser_OLD('SpecialK');
 assertEqual(uuidBefore, 'aaaaaaaa-bbbb-4ccc-9ddd-eeeeeeeeeeee', 'UUID correct before corruption');
 // Simulate: config.json gets corrupted (loadConfig returns {} because file locked)
 // This simulates what happens when saveConfig reads an empty/locked file
 fs.writeFileSync(CONFIG_FILE, '', 'utf8'); // Simulate corruption: empty file
 // Old saveConfig behavior: reads empty, merges with update, saves
 // This wipes userUuids
 saveConfig_OLD({ hasLaunchedBefore: true });
 const configAfterCorruption = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
 assert(!configAfterCorruption.userUuids, 'OLD CODE: userUuids wiped after corruption');
 assert(!configAfterCorruption.username, 'OLD CODE: username wiped after corruption');
 // Player re-enters name, gets NEW UUID (character data lost!)
 const uuidAfterOld = getUuidForUser_OLD('SpecialK');
 assert(uuidAfterOld !== uuidBefore, 'OLD CODE: UUID changed after corruption (BUG!)');
 // --------------------------------------------------------------------------
 // TEST 3: NEW CODE — Config wipe during update, UUID survives via uuid-store
 // --------------------------------------------------------------------------
 console.log('\n--- Test 3: NEW CODE — Config wipe + UUID survives via uuid-store ---');
 setup();
 // Setup: player has UUID (stored in both config.json AND uuid-store.json)
 const initialConfig = { username: 'SpecialK', userUuids: { 'SpecialK': 'aaaaaaaa-bbbb-4ccc-9ddd-eeeeeeeeeeee' }, hasLaunchedBefore: true };
 fs.writeFileSync(CONFIG_FILE, JSON.stringify(initialConfig, null, 2), 'utf8');
 // First call migrates to uuid-store
 const uuidFirst = getUuidForUser('SpecialK');
 assertEqual(uuidFirst, 'aaaaaaaa-bbbb-4ccc-9ddd-eeeeeeeeeeee', 'UUID correct before corruption');
 assert(fs.existsSync(UUID_STORE_FILE), 'uuid-store.json created');
 // Simulate: config.json gets wiped (same as the update bug)
 fs.writeFileSync(CONFIG_FILE, '{}', 'utf8');
 // Verify config is empty
 const wipedConfig = loadConfig();
 assert(!wipedConfig.userUuids || Object.keys(wipedConfig.userUuids).length === 0, 'Config wiped — no userUuids');
 assert(!wipedConfig.username, 'Config wiped — no username');
 // Player re-enters same name → UUID recovered from uuid-store!
 const uuidAfterNew = getUuidForUser('SpecialK');
 assertEqual(uuidAfterNew, 'aaaaaaaa-bbbb-4ccc-9ddd-eeeeeeeeeeee', 'NEW CODE: UUID preserved after config wipe!');
 // --------------------------------------------------------------------------
 // TEST 4: saveConfig safety check — refuses to overwrite good data with empty
 // --------------------------------------------------------------------------
 console.log('\n--- Test 4: saveConfig safety check — blocks destructive writes ---');
 setup();
 // Setup: valid config file with data
 const goodConfig = { username: 'SpecialK', userUuids: { 'SpecialK': 'aaaaaaaa-bbbb-4ccc-9ddd-eeeeeeeeeeee' }, hasLaunchedBefore: true, installPath: 'C:\\Games\\Hytale' };
 fs.writeFileSync(CONFIG_FILE, JSON.stringify(goodConfig, null, 2), 'utf8');
 // Make the file temporarily unreadable by writing garbage (simulates file lock/corruption)
 const originalContent = fs.readFileSync(CONFIG_FILE, 'utf8');
 fs.writeFileSync(CONFIG_FILE, 'NOT VALID JSON!!!', 'utf8');
 // Try to save — should refuse because file exists but can't be parsed
 let saveThrew = false;
 try {
  saveConfig({ someNewField: true });
 } catch (e) {
  saveThrew = true;
 }
 // The file should still have the garbage (not overwritten with { someNewField: true })
 const afterContent = fs.readFileSync(CONFIG_FILE, 'utf8');
 // Restore original for backup recovery test
 fs.writeFileSync(CONFIG_FILE, JSON.stringify(goodConfig, null, 2), 'utf8');
 // Note: with invalid JSON, loadConfig returns {} and safety check triggers
 // The save may eventually succeed on retry if the file becomes readable
 // What matters is that it doesn't blindly overwrite
 assert(afterContent !== '{\n  "someNewField": true\n}', 'Safety check prevented blind overwrite of corrupted file');
 // --------------------------------------------------------------------------
 // TEST 5: Backup recovery — config.json corrupted, recovered from .bak
 // --------------------------------------------------------------------------
 console.log('\n--- Test 5: Backup recovery — auto-recover from .bak ---');
 setup();
 // Create config and backup
 const validConfig = { username: 'SpecialK', userUuids: { 'SpecialK': 'aaaaaaaa-bbbb-4ccc-9ddd-eeeeeeeeeeee' } };
 fs.writeFileSync(CONFIG_BACKUP, JSON.stringify(validConfig, null, 2), 'utf8');
 fs.writeFileSync(CONFIG_FILE, 'CORRUPTED', 'utf8');
 const recovered = loadConfig();
 assertEqual(recovered.username, 'SpecialK', 'Username recovered from backup');
 assert(recovered.userUuids && recovered.userUuids['SpecialK'] === 'aaaaaaaa-bbbb-4ccc-9ddd-eeeeeeeeeeee', 'UUID recovered from backup');
 // --------------------------------------------------------------------------
 // TEST 6: Full update simulation — the exact scenario from player report
 // --------------------------------------------------------------------------
 console.log('\n--- Test 6: Full update simulation (player report scenario) ---');
 setup();
 // Step 1: Player installs v2.3.4, sets username, plays game
 console.log('  Step 1: Player sets up profile...');
 saveConfig({ username: 'Special K', hasLaunchedBefore: true });
 const originalUuid = getUuidForUser('Special K');
 console.log(`  Original UUID: ${originalUuid}`);
 // Step 2: v2.3.5 auto-update — new app launches
 console.log('  Step 2: Simulating v2.3.5 update...');
 // Simulate the 3 saveConfig calls that happen during startup
 // But first, simulate config being temporarily locked (returns empty)
 const preUpdateContent = fs.readFileSync(CONFIG_FILE, 'utf8');
 fs.writeFileSync(CONFIG_FILE, '', 'utf8'); // Simulate: file empty during write (race condition)
 // These are the 3 calls from: profileManager.init, migrateUserDataToCentralized, handleFirstLaunchCheck
 // With our safety check, they should NOT wipe the data
 try { saveConfig({ hasLaunchedBefore: true }); } catch (e) { /* expected — safety check blocks it */ }
 // Simulate file becomes readable again (antivirus releases lock)
 fs.writeFileSync(CONFIG_FILE, preUpdateContent, 'utf8');
 // Step 3: Player re-enters username (because UI might show empty)
 console.log('  Step 3: Player re-enters username...');
 const postUpdateUuid = getUuidForUser('Special K');
 console.log(`  Post-update UUID: ${postUpdateUuid}`);
 assertEqual(postUpdateUuid, originalUuid, 'UUID survived the full update cycle!');
 // --------------------------------------------------------------------------
 // TEST 7: Multiple users — UUIDs stay independent
 // --------------------------------------------------------------------------
 console.log('\n--- Test 7: Multiple users — UUIDs stay independent ---');
 setup();
 const uuidAlice = getUuidForUser('Alice');
 const uuidBob = getUuidForUser('Bob');
 const uuidCharlie = getUuidForUser('Charlie');
 assert(uuidAlice !== uuidBob, 'Alice and Bob have different UUIDs');
 assert(uuidBob !== uuidCharlie, 'Bob and Charlie have different UUIDs');
 // Wipe config, all should survive
 fs.writeFileSync(CONFIG_FILE, '{}', 'utf8');
 assertEqual(getUuidForUser('Alice'), uuidAlice, 'Alice UUID survived config wipe');
 assertEqual(getUuidForUser('Bob'), uuidBob, 'Bob UUID survived config wipe');
 assertEqual(getUuidForUser('Charlie'), uuidCharlie, 'Charlie UUID survived config wipe');
 // --------------------------------------------------------------------------
 // TEST 8: UUID store deleted — recovery from config.json
 // --------------------------------------------------------------------------
 console.log('\n--- Test 8: UUID store deleted — recovery from config.json ---');
 setup();
 // Create UUID via normal flow (saves to both stores)
 const uuidOriginal = getUuidForUser('TestPlayer');
 // Delete uuid-store.json (simulates user manually deleting it or disk issue)
 fs.unlinkSync(UUID_STORE_FILE);
 assert(!fs.existsSync(UUID_STORE_FILE), 'uuid-store.json deleted');
 // UUID should be recovered from config.json
 const uuidRecovered = getUuidForUser('TestPlayer');
 assertEqual(uuidRecovered, uuidOriginal, 'UUID recovered from config.json after uuid-store deletion');
 assert(fs.existsSync(UUID_STORE_FILE), 'uuid-store.json recreated after recovery');
 // --------------------------------------------------------------------------
 // TEST 9: Both stores deleted — new UUID generated (fresh install)
 // --------------------------------------------------------------------------
 console.log('\n--- Test 9: Both stores deleted — new UUID (fresh install) ---');
 setup();
 const uuidFresh = getUuidForUser('NewPlayer');
 // Delete both
 fs.unlinkSync(UUID_STORE_FILE);
 fs.unlinkSync(CONFIG_FILE);
 const uuidAfterWipe = getUuidForUser('NewPlayer');
 assert(uuidAfterWipe !== uuidFresh, 'New UUID generated when both stores are gone (expected for true fresh install)');
 // --------------------------------------------------------------------------
 // TEST 10: Worst case — config.json wiped AND uuid-store.json exists
 // Simulates the EXACT player-reported scenario with new code
 // --------------------------------------------------------------------------
 console.log('\n--- Test 10: Exact player scenario with new code ---');
 setup();
 // Player has been playing for a while
 saveConfig({
  username: 'Special K',
  hasLaunchedBefore: true,
  installPath: 'C:\\Games\\Hytale',
  version_client: '2026.02.19-1a311a592',
  version_branch: 'release',
  userUuids: { 'Special K': '11111111-2222-4333-9444-555555555555' }
 });
 // First call creates uuid-store.json
 const originalUuid10 = getUuidForUser('Special K');
 assertEqual(originalUuid10, '11111111-2222-4333-9444-555555555555', 'Original UUID loaded');
 // BOOM: Update happens, config.json completely wiped
 fs.writeFileSync(CONFIG_FILE, '{}', 'utf8');
 // Username lost — player has to re-enter
 const loadedUsername = loadConfig().username;
 assert(!loadedUsername, 'Username is gone from config (simulating what player saw)');
 // Player types "Special K" again in settings
 saveConfig({ username: 'Special K' });
 // Player clicks Play — getUuidForUser called
 const recoveredUuid10 = getUuidForUser('Special K');
 assertEqual(recoveredUuid10, '11111111-2222-4333-9444-555555555555', 'UUID recovered — character data preserved!');
 // ============================================================================
 // RESULTS
 // ============================================================================
 console.log('\n' + '='.repeat(70));
 console.log(`RESULTS: ${passed} passed, ${failed} failed`);
 if (failed > 0) {
  console.log('\nFailures:');
  failures.forEach(f => console.log(`  ✗ ${f}`));
 }
 console.log('='.repeat(70));
 cleanup();
 process.exit(failed > 0 ? 1 : 0);
Author	SHA1	Message	Date
amiay	5170f453ea	Merge pull request 'added search bar in "my mods"' (#3 ) from amiay/hytale-f2p:develop into develop Reviewed-on: https://git.sanhost.net/sanasol/hytale-f2p/pulls/3	2026-02-24 16:31:54 +00:00
amiay	db3b2fc966	added search bar in my mods added search bar in my mods	2026-02-24 17:31:13 +01:00
amiay	2f5820e850	Merge pull request 'Mods update' (#2 ) from amiay/hytale-f2p:develop into develop Reviewed-on: https://git.sanhost.net/sanasol/hytale-f2p/pulls/2	2026-02-24 16:22:55 +00:00
dsqd2505-netizen	4abb455e0f	update "My mods"	2026-02-24 17:15:47 +01:00
dsqd2505-netizen	d5828463f9	Added mods version selector Added mods version selector	2026-02-24 17:04:46 +01:00
sanasol	0d15659dc0	v2.4.1: Replace raw wrapper script editor with structured config UI Replace the raw textarea script editor with a structured form for Java wrapper configuration. Users now manage two lists (JVM flags to strip, args to inject with server/always condition) instead of editing bash/batch scripts directly. Scripts are generated at launch time from the structured config. Includes collapsible script preview for power users.	2026-02-24 16:53:19 +01:00
sanasol	19c8991a44	v2.4.0: Add Send Logs, fix Intel Arc iGPU misdetection - Add Send Logs button for one-click log submission to support - Fix Intel Arc Graphics (Meteor Lake/Lunar Lake) on bus 00 being classified as discrete GPU instead of integrated	2026-02-24 13:57:10 +01:00
sanasol	320ca54758	Add Send Logs button for one-click log submission to support Collects launcher logs, game client logs, and config snapshot into a ZIP file and uploads to auth server. Shows submission ID for sharing with support. Includes i18n for all 11 locales.	2026-02-24 13:50:23 +01:00
sanasol	e14d56ef48	v2.3.9: Fix stalled processes and AOT cache crash - Auto-kill stalled HytaleClient/java processes before launch and repair (cross-platform: Windows taskkill+PowerShell, macOS/Linux pkill) - Remove HytaleServer.aot before launch to prevent incompatible AOT cache causing fastutil ClassNotFoundException on singleplayer - safeRemoveDirectory auto-kills processes on EPERM/EBUSY before retry Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-24 12:52:07 +01:00
sanasol	a649bf1fcc	Update README: replace outdated GitHub URL with Forgejo URL for start.sh script	2026-02-23 03:12:39 +01:00
sanasol	66faa1bb1e	Update README files with free hosted server instructions Added detailed steps to set up a free Hytale server via play.hosting in both README files. Updated outdated URLs for the F2P Launcher to the new repository location. Improved clarity in self-hosted setup sections.	2026-02-23 03:11:02 +01:00
sanasol	a63e026700	Server setup video	2026-02-23 01:02:16 +01:00
sanasol	552ec42d6c	Add one-click dedicated server scripts for Hytale F2P - server/start.sh: Linux/macOS starter with auto-download, auto-update, F2P launcher detection (game files + bundled JRE), and token fetch - server/start.bat: Windows equivalent using PowerShell for JSON/UUID - server/README.md: Beginner-friendly guide with playit.gg networking - Remove obsolete server_scripts_2.zip Scripts auto-detect F2P launcher install (including custom installPath from config.json), copy game files locally if available, download missing files (HytaleServer.jar, Assets.zip, dualauth-agent.jar), and check for updates on every launch via ETag/GitHub releases API.	2026-02-23 00:55:38 +01:00
sanasol	fb90277be9	Fix Arabic RTL support: correct locale code and CSS syntax - Rename ar-AR to ar-SA (valid BCP 47 code for Saudi Arabia) - Fix missing dot in CSS selector: .news-section .news-header - Add trailing newline to ar-SA.json Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-22 23:00:08 +01:00
sanasol	27c220a757	Merge pull request 'Arabic and RTL support added' (#1 ) from Yugurten/hytale-f2p:develop into develop	2026-02-22 21:58:25 +00:00
Finix	30929ee0da	Arabic and RTL support added	2026-02-22 19:25:01 +00:00
sanasol	44834e7d12	Bump version to 2.3.8 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-21 23:47:52 +01:00
sanasol	cb7f7e51bf	v2.3.8: auto-update agent from GitHub releases, add dl1 mirror fallback - Agent auto-update: check GitHub releases API for new versions, download only when update available, track version in .version file - Add dl1.htdwnldsan.top as backup-2 mirror in patches config sources - Add dl1.htdwnldsan.top as primary non-Cloudflare mirror - Graceful fallback: use existing agent if update check or download fails Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-21 23:31:28 +01:00
sanasol	9b20c454d3	v2.3.7: add non-Cloudflare mirror fallback for blocked regions Users in Russia/Ukraine where Cloudflare IPs are blocked can now download game files via htdwnldsan.top (direct VPS → MEGA redirect). Both manifest fetch and archive downloads try mirrors automatically on ETIMEDOUT/ECONNREFUSED errors. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-21 13:21:19 +01:00
sanasol	4e04d657b7	v2.3.6: fix UUID loss during launcher updates Players were losing character data (inventory, armor, backpack) after each launcher update because config.json corruption wiped the UUID mapping. Same username, new UUID = server treats as new player. Fix: UUIDs now stored in separate uuid-store.json that saveConfig() can never touch. Added safety check to refuse destructive writes when config file exists but loads empty. Includes 28 regression tests. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-20 23:10:13 +01:00
sanasol	6d811fd7e0	v2.3.5: hardened fallback chain for patch URL discovery 6-step fallback: auth.sanasol.ws → htdwnldsan.top → DNS TXT via DoH → disk cache → hardcoded URL. Practically unkillable by DMCA. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-20 20:22:57 +01:00
sanasol	8435fc698c	fix: replace GitHub URLs with Forgejo after DMCA takedown GitHub repo amiayweb/Hytale-F2P was DMCA'd. Updated Discord RPC link, download page URL, and homepage to point to Forgejo instance. Auto-update already pointed to git.sanhost.net (no change needed). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-20 19:32:37 +01:00
sanasol	6c369edb0f	v2.3.4: dynamic patches URL from auth server Launcher now fetches patches base URL from /api/patches-config endpoint instead of using hardcoded domain. URL cached for 5 minutes, no fallback to hardcoded domain - requires auth server connection or cached URL. Enables instant CDN switching without launcher updates. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-20 19:27:55 +01:00
sanasol	fdd8e59ec4	v2.3.3: fix singleplayer crash when install path has spaces JAVA_TOOL_OPTIONS -javaagent path was not quoted, causing JVM to truncate at first space. Affects all users with spaces in install path (e.g. "Hytale F2P Launcher"). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-20 15:54:17 +01:00
sanasol	e7a033932f	v2.3.2: fix truncated download cache, update Discord link Fix pre-release downloads failing with "unexpected EOF" by validating cached PWR file sizes against manifest expected sizes. Previously only checked > 1MB which accepted truncated files. Also update Discord invite link to new server across all files. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-20 15:14:20 +01:00
sanasol	11c6d40dfe	chore: remove private docs from repo Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-20 14:38:34 +01:00