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 09:21:48 -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
36 changed files with 4316 additions and 155 deletions
--- 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>
-        <h4 data-i18n="mods.noModsInstalled">No Mods Installed</h4>
-        <p data-i18n="mods.noModsInstalledDesc">Add mods from CurseForge or import local files</p>
+        <i class=\"fas fa-${isSearching ? 'search' : 'box-open'}\"></i>
+        <h4 data-i18n="${isSearching ? 'mods.noModsFound' : 'mods.noModsInstalled'}">${isSearching ? 'No Mods Found' : 'No Mods Installed'}</h4>
+        <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">
-            <i class="fas fa-download"></i>
+      `<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>
            ${window.i18n ? window.i18n.t('mods.install') : 'INSTALL'}
          </button>` :
-      `<button class="mod-btn-toggle bg-white/10 text-white" disabled>
-            <i class="fas fa-check"></i>
+      `<button class=\"mod-btn-toggle bg-white/10 text-white\" disabled>
+            <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();
+    });
  }
 })();

--- 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/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/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
- * Uses case-insensitive lookup to prevent duplicates, but preserves original case for display
+ * Source of truth: uuid-store.json (separate from config.json)
+ * 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();
-  const userUuids = config.userUuids || {};
+  // Ensure UUID store exists (one-time migration from config.json)
+  migrateUuidStoreIfNeeded();

-  // Case-insensitive lookup - find existing key regardless of case
-  const existingKey = Object.keys(userUuids).find(k => k.toLowerCase() === normalizedLookup);
+  // 1. Check UUID store first (source of truth)
+  const uuidStore = loadUuidStore();
+  const storeKey = Object.keys(uuidStore).find(k => k.toLowerCase() === normalizedLookup);

-  if (existingKey) {
-    // Found existing - return UUID, update display name if case changed
-    const existingUuid = userUuids[existingKey];
+  if (storeKey) {
+    const existingUuid = uuidStore[storeKey];

-    // If user typed different case, update the key to new case (preserving UUID)
-    if (existingKey !== displayName) {
-      console.log(`[Config] Updating username case: "${existingKey}" → "${displayName}"`);
-      delete userUuids[existingKey];
-      userUuids[displayName] = existingUuid;
-      saveConfig({ userUuids });
+    // Update case if needed
+    if (storeKey !== displayName) {
+      console.log(`[UUID Store] Updating username case: "${storeKey}" → "${displayName}"`);
+      delete uuidStore[storeKey];
+      uuidStore[displayName] = existingUuid;
+      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() {
+  migrateUuidStoreIfNeeded();
+  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 userUuids = config.userUuids || {};
+  const allMappings = getAllUuidMappings();
  const currentUsername = loadUsername();
-  // Case-insensitive comparison for isCurrent
  const normalizedCurrent = currentUsername ? currentUsername.toLowerCase() : null;

-  return Object.entries(userUuids).map(([username, uuid]) => ({
-    username,  // Original case preserved
+  return Object.entries(allMappings).map(([username, uuid]) => ({
+    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) {
-    delete userUuids[existingKey];
-  }
-
-  // Store with original case
+  if (existingKey) delete userUuids[existingKey];
  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}"`);
-    return true;
+    deleted = 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 {
-    if (allowRetry) {
-      await retryDownload(downloadUrl, targetPath, progressCallback);
-    } else {
-      await downloadFile(downloadUrl, targetPath, progressCallback);
+  // Try primary URL first, then mirror URLs on timeout/connection failure
+  const mirrors = await getAllMirrorUrls();
+  const primaryBase = await getPatchesBaseUrl();
+  const urlsToTry = [downloadUrl];
+
+  // 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);
      }
+    }
+  }
+
+  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) {
-    const enhancedError = new Error(`Archive download failed: ${error.message}`);
-    enhancedError.originalError = 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
-# 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[@]}"
-`;
+        const wrapperScript = generateWrapperScript(loadWrapperConfig(), 'darwin', javaBin);
        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,6 +463,22 @@ 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');
--- 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...`);
@@ -85,8 +125,9 @@ 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');
-      url = `${MIRROR_BASE_URL}/${osName}/${arch}/${branch}/0_to_${extractVersionNumber(fileName)}.pwr`;
+      const { getPatchesBaseUrl } = require('../services/versionManager');
+      const baseUrl = await getPatchesBaseUrl();
+      url = `${baseUrl}/${osName}/${arch}/${branch}/0_to_${extractVersionNumber(fileName)}.pwr`;
      console.log(`[DownloadPWR] Fallback URL: ${url}`);
    }
  }
@@ -832,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.log('[RepairGame] Please close the game before repairing, or wait for the repair to complete.');
+    console.warn('[RepairGame] Game processes detected. Force-killing to release file locks...');
+    if (progressCallback) {
+      progressCallback('Stopping stalled game processes...', 20, null, null, null);
+    }
+    await killGameProcesses();
  }

  // Delete Game and Cache Directory with retry logic
@@ -963,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 MIRROR_MANIFEST_URL = `${MIRROR_BASE_URL}/manifest.json`;
+const PATCHES_CONFIG_SOURCES = [
+  { 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;
  }

+  const mirrors = await getAllMirrorUrls();
+
+  for (let i = 0; i < mirrors.length; i++) {
+    const baseUrl = mirrors[i];
+    const manifestUrl = `${baseUrl}/manifest.json`;
    try {
-    console.log('[Mirror] Fetching manifest from:', MIRROR_MANIFEST_URL);
-    const response = await axios.get(MIRROR_MANIFEST_URL, {
+      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) {
-    console.error('[Mirror] Error fetching manifest:', error.message);
+      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...`);
+      }
+    }
+  }
+
+  // All mirrors failed — use cached manifest if available
  if (manifestCache) {
-      console.log('[Mirror] Using expired cache');
+    console.log('[Mirror] All mirrors failed, using expired cache');
    return manifestCache;
  }
-    throw error;
-  }
+  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)`);
-          if (progressCallback) progressCallback('DualAuth Agent ready', 100);
-          return { success: true, agentPath, alreadyExists: true };
+          agentExists = true;
+          if (fs.existsSync(versionPath)) {
+            localVersion = fs.readFileSync(versionPath, 'utf8').trim();
          }
-        // File exists but too small - corrupt, re-download
+        } else {
          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);
-    console.log(`Downloading from: ${DUALAUTH_AGENT_URL}`);
+    const action = agentExists ? 'Updating' : 'Downloading';
+    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
-    const isIntelArc = isIntel && (lowerName.includes('arc') || lowerName.includes('a770') || lowerName.includes('a750') || lowerName.includes('a380'));
+    // Intel Arc discrete GPU detection
+    // 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/main.js
+++ b/main.js
@@ -84,8 +84,8 @@ function setDiscordActivity() {
      largeImageText: 'Hytale F2P Launcher',
      buttons: [
        {
-          label: 'GitHub',
-          url: 'https://github.com/amiayweb/Hytale-F2P'
+          label: 'Download',
+          url: 'https://git.sanhost.net/sanasol/hytale-f2p/releases'
        },
        {
          label: 'Discord',
@@ -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
-    await shell.openExternal('https://github.com/amiayweb/Hytale-F2P/releases/latest');
+    // Open Forgejo releases page for manual download
+    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.3",
+  "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