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
Add Send Logs button for one-click log submission to support
2026-02-26 14:01:48 -03:00 · 2026-02-24 13:57:10 +01:00 · 2026-02-24 13:50:23 +01:00 · 2026-02-24 12:52:07 +01:00 · 2026-02-23 03:12:39 +01:00 · 2026-02-23 03:11:02 +01:00
41 changed files with 3767 additions and 474 deletions
--- a/.github/CODE_OF_CONDUCT.md
+++ b/.github/CODE_OF_CONDUCT.md
@@ -36,7 +36,7 @@ This Code of Conduct applies within all community spaces, and also applies when
 ## Enforcement
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at [Discord Server, message Founders/Devs](https://discord.gg/hf2pdc). All complaints will be reviewed and investigated promptly and fairly.
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at [Discord Server, message Founders/Devs](https://discord.gg/Fhbb9Yk5WW). All complaints will be reviewed and investigated promptly and fairly.
 All community leaders are obligated to respect the privacy and security of the reporter of any incident.
--- a/.github/ISSUE_TEMPLATE/support_request.yml
+++ b/.github/ISSUE_TEMPLATE/support_request.yml
@@ -22,7 +22,7 @@ body:
      value: |
        If you need help or support with using the launcher, please fill out this support request.
        Provide as much detail as possible so we can assist you effectively.
-        **Need a quick assistance?** Please Open-A-Ticket in our [Discord Server](https://discord.gg/gME8rUy3MB)!
+        **Need a quick assistance?** Please Open-A-Ticket in our [Discord Server](https://discord.gg/Fhbb9Yk5WW)!
  - type: textarea
    id: question
--- a/.gitignore
+++ b/.gitignore
@@ -17,6 +17,9 @@ dist/
 # Project Specific: Downloaded patcher (from hytale-auth-server)
 backend/patcher/
 # Private docs (local only)
 docs/PATCH_CDN_INFRASTRUCTURE.md
 # macOS Specific
 .DS_Store
 *.zst.DS_Store
--- a/GUI/index.html
+++ b/GUI/index.html
@@ -8,9 +8,10 @@
    <link href="https://cdn.jsdelivr.net/npm/tailwindcss@2.2.19/dist/tailwind.min.css" rel="stylesheet">
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css">
    <link
-        href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap"
+        href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&family=Noto+Sans+Arabic:wght@300;400;500;600;700&display=swap"
        rel="stylesheet">
    <link rel="stylesheet" href="style.css">
    <link rel="stylesheet" href="style-RTL.css">
 </head>
 <body class="bg-black text-white overflow-hidden font-sans select-none" tabindex="-1">
@@ -574,6 +575,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">
--- 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/script.js
+++ b/GUI/js/script.js
@@ -53,7 +53,7 @@ window.closeDiscordPopup = function() {
 };
 window.joinDiscord = async function() {
-  await window.electronAPI?.openExternal('https://discord.gg/hf2pdc');
+  await window.electronAPI?.openExternal('https://discord.gg/Fhbb9Yk5WW');
  try {
    await window.electronAPI?.saveConfig({ discordPopup: true });
--- a/GUI/js/ui.js
+++ b/GUI/js/ui.js
@@ -1103,7 +1103,7 @@ function getRetryContextMessage() {
 }
 window.openDiscordExternal = function() {
-  window.electronAPI?.openExternal('https://discord.gg/hf2pdc');
+  window.electronAPI?.openExternal('https://discord.gg/Fhbb9Yk5WW');
 };
 window.toggleMaximize = toggleMaximize;
--- a/GUI/locales/ar-SA.json
+++ b/GUI/locales/ar-SA.json
@@ -0,0 +1,263 @@
 {
  "nav": {
    "play": "لعب",
    "mods": "المودات",
    "news": "الأخبار",
    "chat": "دردشة اللاعبين",
    "settings": "الإعدادات"
  },
  "header": {
    "playersLabel": "اللاعبون:",
    "manageProfiles": "إدارة الملفات الشخصية",
    "defaultProfile": "الافتراضي"
  },
  "install": {
    "title": "مشغل اللعب المجاني",
    "playerName": "اسم اللاعب",
    "playerNamePlaceholder": "أدخل اسمك",
    "gameBranch": "إصدار اللعبة",
    "releaseVersion": "إصدار نهائي (مستقر)",
    "preReleaseVersion": "إصدار تجريبي (تجريبي)",
    "customInstallation": "تثبيت مخصص",
    "installationFolder": "مجلد التثبيت",
    "pathPlaceholder": "الموقع الافتراضي",
    "browse": "تصفح",
    "installButton": "تثبيت HYTALE",
    "installing": "جاري التثبيت..."
  },
  "play": {
    "ready": "جاهز للعب",
    "subtitle": "شغل Hytale وابدأ المغامرة",
    "playButton": "لعب HYTALE",
    "latestNews": "آخر الأخبار",
    "viewAll": "عرض الكل",
    "checking": "جاري التحقق...",
    "play": "بدء"
  },
  "mods": {
    "searchPlaceholder": "البحث عن مودات...",
    "myMods": "موداتي",
    "previous": "السابق",
    "next": "التالي",
    "page": "صفحة",
    "of": "من",
    "modalTitle": "موداتي",
    "noModsFound": "لم يتم العثور على مودات",
    "noModsFoundDesc": "حاول تعديل معايير البحث",
    "noModsInstalled": "لا توجد مودات مثبتة",
    "noModsInstalledDesc": "أضف مودات من CurseForge أو استورد ملفات محلية",
    "view": "عرض",
    "install": "تثبيت",
    "installed": "مثبت",
    "enable": "تفعيل",
    "disable": "تعطيل",
    "active": "نشط",
    "disabled": "معطل",
    "delete": "حذف المود",
    "noDescription": "لا يوجد وصف متاح",
    "confirmDelete": "هل أنت متأكد أنك تريد حذف \"{name}\"؟",
    "confirmDeleteDesc": "لا يمكن التراجع عن هذا الإجراء.",
    "confirmDeletion": "تأكيد الحذف",
    "apiKeyRequired": "مطلوب مفتاح API",
    "apiKeyRequiredDesc": "مطلوب مفتاح CurseForge API لتصفح المودات"
  },
  "news": {
    "title": "كل الأخبار",
    "readMore": "اقرأ المزيد"
  },
  "chat": {
    "title": "دردشة اللاعبين",
    "pickColor": "اللون",
    "inputPlaceholder": "اكتب رسالتك...",
    "send": "إرسال",
    "online": "متصل",
    "charCounter": "{current}/{max}",
    "secureChat": "دردشة آمنة - الروابط محجوبة",
    "joinChat": "انضمام للدردشة",
    "chooseUsername": "اختر اسم مستخدم للانضمام إلى دردشة اللاعبين",
    "username": "اسم المستخدم",
    "usernamePlaceholder": "أدخل اسم المستخدم...",
    "usernameHint": "3-20 حرفاً، حروف، أرقام، و - و _ فقط",
    "joinButton": "انضمام",
    "colorModal": {
      "title": "تخصيص لون اسم المستخدم",
      "chooseSolid": "اختر لوناً ثابتاً:",
      "customColor": "لون مخصص:",
      "preview": "معاينة:",
      "previewUsername": "اسم المستخدم",
      "apply": "تطبيق اللون"
    }
  },
  "settings": {
    "title": "الإعدادات",
    "java": "بيئة تشغيل جافا",
    "useCustomJava": "استخدام مسار جافا مخصص",
    "javaDescription": "تجاوز بيئة جافا المرفقة واستخدام تثبيت خاص بك",
    "javaPath": "مسار ملف جافا التنفيذي",
    "javaPathPlaceholder": "اختر مسار جافا...",
    "javaBrowse": "تصفح",
    "javaHint": "اختر مجلد تثبيت جافا (يدعم ويندوز، ماك، ولينكس)",
    "discord": "تكامل ديسكورد",
    "enableRPC": "تفعيل نشاط ديسكورد (Rich Presence)",
    "discordDescription": "إظهار نشاط المشغل الخاص بك على ديسكورد",
    "game": "خيارات اللعبة",
    "playerName": "اسم اللاعب",
    "playerNamePlaceholder": "أدخل اسم اللاعب",
    "playerNameHint": "سيتم استخدام هذا الاسم داخل اللعبة (1-16 حرفاً)",
    "openGameLocation": "فتح موقع اللعبة",
    "openGameLocationDesc": "فتح مجلد تثبيت اللعبة",
    "account": "إدارة UUID اللاعب",
    "currentUUID": "الـ UUID الحالي",
    "uuidPlaceholder": "جاري تحميل UUID...",
    "copyUUID": "نسخ UUID",
    "regenerateUUID": "إعادة إنشاء UUID",
    "uuidHint": "معرف اللاعب الفريد الخاص بك لهذا الاسم",
    "manageUUIDs": "إدارة جميع الـ UUIDs",
    "manageUUIDsDesc": "عرض وإدارة جميع معرفات اللاعبين",
    "language": "اللغة",
    "selectLanguage": "اختر اللغة",
    "repairGame": "إصلاح اللعبة",
    "reinstallGame": "إعادة تثبيت ملفات اللعبة (يحفظ البيانات)",
    "gpuPreference": "تفضيل معالج الرسوميات (GPU)",
    "gpuHint": "ميزة للمحمول فقط؛ اضبطها على Integrated إذا كنت تستخدم كمبيوتر مكتبي",
    "gpuAuto": "تلقائي",
    "gpuIntegrated": "مدمج",
    "gpuDedicated": "منفصل",
    "logs": "سجلات النظام",
    "logsCopy": "نسخ",
    "logsRefresh": "تحديث",
    "logsFolder": "فتح المجلد",
    "logsSend": "إرسال السجلات",
    "logsSending": "جارٍ الإرسال...",
    "logsSent": "تم الإرسال!",
    "logsSendFailed": "فشل",
    "logsSubmissionId": "معرف الإرسال",
    "logsShareId": "شارك هذا المعرف مع الدعم عند الإبلاغ عن المشاكل",
    "logsLoading": "جاري تحميل السجلات...",
    "closeLauncher": "سلوك المشغل",
    "closeOnStart": "إغلاق المشغل عند بدء اللعبة",
    "closeOnStartDescription": "إغلاق المشغل تلقائياً بعد تشغيل Hytale",
    "hwAccel": "تسريع الأجهزة (Hardware Acceleration)",
    "hwAccelDescription": "تفعيل تسريع الأجهزة للمشغل",
    "gameBranch": "فرع اللعبة",
    "branchRelease": "إصدار نهائي",
    "branchPreRelease": "إصدار تجريبي",
    "branchHint": "التبديل بين الإصدار المستقر والإصدار التجريبي",
    "branchWarning": "تغيير الفرع سيؤدي إلى تحميل وتثبيت نسخة مختلفة من اللعبة",
    "branchSwitching": "جاري التبديل إلى {branch}...",
    "branchSwitched": "تم التبديل إلى {branch} بنجاح!",
    "installRequired": "التثبيت مطلوب",
    "branchInstallConfirm": "سيتم تثبيت اللعبة لفرع {branch}. هل تريد الاستمرار؟"
  },
  "uuid": {
    "modalTitle": "إدارة UUID",
    "currentUserUUID": "UUID المستخدم الحالي",
    "allPlayerUUIDs": "جميع معرفات UUID للاعبين",
    "generateNew": "إنشاء UUID جديد",
    "loadingUUIDs": "جاري تحميل الـ UUIDs...",
    "setCustomUUID": "تعيين UUID مخصص",
    "customPlaceholder": "أدخل UUID مخصص (الصيغة: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)",
    "setUUID": "تعيين UUID",
    "warning": "تحذير: تعيين UUID مخصص سيغير هوية اللاعب الحالية",
    "copyTooltip": "نسخ UUID",
    "regenerateTooltip": "إنشاء UUID جديد"
  },
  "profiles": {
    "modalTitle": "إدارة الملفات الشخصية",
    "newProfilePlaceholder": "اسم الملف الشخصي الجديد",
    "createProfile": "إنشاء ملف شخصي"
  },
  "discord": {
    "notificationText": "انضم إلى مجتمعنا على ديسكورد!",
    "joinButton": "انضم إلى ديسكورد"
  },
  "common": {
    "confirm": "تأكيد",
    "cancel": "إلغاء",
    "save": "حفظ",
    "close": "إغلاق",
    "delete": "حذف",
    "edit": "تعديل",
    "loading": "جاري التحميل...",
    "apply": "تطبيق",
    "install": "تثبيت"
  },
  "notifications": {
    "gameDataNotFound": "خطأ: لم يتم العثور على بيانات اللعبة",
    "gameUpdatedSuccess": "تم تحديث اللعبة بنجاح! 🎉",
    "updateFailed": "فشل التحديث: {error}",
    "updateError": "خطأ في التحديث: {error}",
    "discordEnabled": "تم تفعيل نشاط ديسكورد",
    "discordDisabled": "تم تعطيل نشاط ديسكورد",
    "discordSaveFailed": "فشل حفظ إعدادات ديسكورد",
    "playerNameRequired": "يرجى إدخال اسم لاعب صالح",
    "playerNameSaved": "تم حفظ اسم اللاعب بنجاح",
    "playerNameSaveFailed": "فشل حفظ اسم اللاعب",
    "uuidCopied": "تم نسخ الـ UUID إلى الحافظة!",
    "uuidCopyFailed": "فشل نسخ الـ UUID",
    "uuidRegenNotAvailable": "إعادة إنشاء UUID غير متاحة",
    "uuidRegenFailed": "فشل إعادة إنشاء الـ UUID",
    "uuidGenerated": "تم إنشاء UUID جديد بنجاح!",
    "uuidGeneratedShort": "تم إنشاء UUID جديد!",
    "uuidGenerateFailed": "فشل إنشاء UUID جديد",
    "uuidRequired": "يرجى إدخال UUID",
    "uuidInvalidFormat": "صيغة UUID غير صالحة",
    "uuidSetFailed": "فشل تعيين الـ UUID المخصص",
    "uuidSetSuccess": "تم تعيين الـ UUID المخصص بنجاح!",
    "uuidDeleteFailed": "فشل حذف الـ UUID",
    "uuidDeleteSuccess": "تم حذف الـ UUID بنجاح!",
    "modsDownloading": "جاري تحميل {name}...",
    "modsTogglingMod": "جاري تبديل حالة المود...",
    "modsDeletingMod": "جاري حذف المود...",
    "modsLoadingMods": "جاري تحميل المودات من CurseForge...",
    "modsInstalledSuccess": "تم تثبيت {name} بنجاح! 🎉",
    "modsDeletedSuccess": "تم حذف {name} بنجاح",
    "modsDownloadFailed": "فشل تحميل المود: {error}",
    "modsToggleFailed": "فشل تبديل المود: {error}",
    "modsDeleteFailed": "فشل حذف المود: {error}",
    "modsModNotFound": "لم يتم العثور على معلومات المود",
    "hwAccelSaved": "تم حفظ إعداد تسريع الأجهزة",
    "hwAccelSaveFailed": "فشل حفظ إعداد تسريع الأجهزة",
    "noUsername": "لم يتم تهيئة اسم مستخدم. يرجى حفظ اسم المستخدم أولاً.",
    "switchUsernameSuccess": "تم التبديل إلى المستخدم \"{username}\" بنجاح!",
    "switchUsernameFailed": "فشل تبديل اسم المستخدم",
    "playerNameTooLong": "يجب أن يكون اسم اللاعب 16 حرفاً أو أقل"
  },
  "confirm": {
    "defaultTitle": "تأكيد الإجراء",
    "regenerateUuidTitle": "إنشاء UUID جديد",
    "regenerateUuidMessage": "هل أنت متأكد أنك تريد إنشاء UUID جديد؟ سيؤدي ذلك إلى تغيير هوية اللاعب الخاصة بك.",
    "regenerateUuidButton": "إنشاء",
    "setCustomUuidTitle": "تعيين UUID مخصص",
    "setCustomUuidMessage": "هل أنت متأكد أنك تريد تعيين هذا الـ UUID المخصص؟ سيؤدي ذلك إلى تغيير هوية اللاعب الخاصة بك.",
    "setCustomUuidButton": "تعيين UUID",
    "deleteUuidTitle": "حذف UUID",
    "deleteUuidMessage": "هل أنت متأكد أنك تريد حذف الـ UUID الخاص بـ \"{username}\"؟ لا يمكن التراجع عن هذا الإجراء.",
    "deleteUuidButton": "حذف",
    "uninstallGameTitle": "إلغاء تثبيت اللعبة",
    "uninstallGameMessage": "هل أنت متأكد أنك تريد إلغاء تثبيت Hytale؟ سيتم حذف جميع ملفات اللعبة.",
    "uninstallGameButton": "إلغاء التثبيت",
    "switchUsernameTitle": "تبديل الهوية",
    "switchUsernameMessage": "التبديل إلى اسم المستخدم \"{username}\"؟ سيؤدي هذا إلى تغيير هوية اللاعب الحالية.",
    "switchUsernameButton": "تبديل"
  },
  "progress": {
    "initializing": "جاري التهيئة...",
    "downloading": "جاري التحميل...",
    "installing": "جاري التثبيت...",
    "extracting": "جاري الاستخراج...",
    "verifying": "جاري التحقق...",
    "switchingProfile": "جاري تبديل الملف الشخصي...",
    "profileSwitched": "تم تبديل الملف الشخصي!",
    "startingGame": "جاري بدء اللعبة...",
    "launching": "جاري التشغيل...",
    "uninstallingGame": "جاري إلغاء تثبيت اللعبة...",
    "gameUninstalled": "تم إلغاء تثبيت اللعبة بنجاح!",
    "uninstallFailed": "فشل إلغاء التثبيت: {error}",
    "startingUpdate": "جاري بدء تحديث اللعبة الإجباري...",
    "installationComplete": "تم اكتمال التثبيت بنجاح!",
    "installationFailed": "فشل التثبيت: {error}",
    "installingGameFiles": "جاري تثبيت ملفات اللعبة...",
    "installComplete": "اكتمل التثبيت!"
  }
 }
--- a/GUI/locales/de-DE.json
+++ b/GUI/locales/de-DE.json
@@ -127,6 +127,12 @@
    "logsCopy": "Kopieren",
    "logsRefresh": "Aktualisieren",
    "logsFolder": "Ordner öffnen",
    "logsSend": "Logs senden",
    "logsSending": "Senden...",
    "logsSent": "Gesendet!",
    "logsSendFailed": "Fehlgeschlagen",
    "logsSubmissionId": "Einreichungs-ID",
    "logsShareId": "Teilen Sie diese ID dem Support mit, wenn Sie Probleme melden",
    "logsLoading": "Protokolle werden geladen...",
    "closeLauncher": "Launcher-Verhalten",
    "closeOnStart": "Launcher beim Spielstart schließen",
--- a/GUI/locales/en.json
+++ b/GUI/locales/en.json
@@ -127,6 +127,12 @@
    "logsCopy": "Copy",
    "logsRefresh": "Refresh",
    "logsFolder": "Open Folder",
    "logsSend": "Send Logs",
    "logsSending": "Sending...",
    "logsSent": "Sent!",
    "logsSendFailed": "Failed",
    "logsSubmissionId": "Submission ID",
    "logsShareId": "Share this ID with support when reporting issues",
    "logsLoading": "Loading logs...",
    "closeLauncher": "Launcher Behavior",
    "closeOnStart": "Close Launcher on game start",
--- 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;
--- a/README.md
+++ b/README.md
@@ -18,7 +18,7 @@
 ### ⚠️ **WARNING: READ [QUICK START](#-quick-start) before Downloading & Installing the Launcher!** ⚠️
-#### 🛑 **Found a problem? [Join the HF2P Discord](https://discord.gg/hf2pdc) and head to `#-⚠️-community-help`** 🛑
+#### 🛑 **Found a problem? [Join the HF2P Discord](https://discord.gg/Fhbb9Yk5WW) and head to `#-⚠️-community-help`** 🛑
 <p>
  👍 If you like the project, <b>feel free to support us via Buy Me a Coffee!</b> ☕<br>
@@ -455,7 +455,7 @@ See [BUILD.md](docs/BUILD.md) for comprehensive build instructions.
 <div align="center">
 **Questions? Ads? Collaboration? Endorsement? Other business-related?** 
-Message the founders at https://discord.gg/hf2pdc
+Message the founders at https://discord.gg/Fhbb9Yk5WW
 </div>
--- a/SERVER.md
+++ b/SERVER.md
@@ -2,7 +2,7 @@
 Play with friends online! This guide covers both easy in-game hosting and advanced dedicated server setup.
-### **DOWNLOAD SERVER FILES (JAR/RAR/SCRIPTS) HERE: https://discord.gg/hf2pdc** 
+### **DOWNLOAD SERVER FILES (JAR/RAR/SCRIPTS) HERE: https://discord.gg/Fhbb9Yk5WW** 
 **Table of Contents**
--- a/TROUBLESHOOTING.md
+++ b/TROUBLESHOOTING.md
@@ -1,6 +1,6 @@
 # Hytale F2P Launcher - Troubleshooting Guide
-This guide covers common issues and their solutions. If your issue isn't listed here, please check [existing issues](https://github.com/amiayweb/Hytale-F2P/issues) or join our [Discord](https://discord.gg/gME8rUy3MB).
+This guide covers common issues and their solutions. If your issue isn't listed here, please check [existing issues](https://github.com/amiayweb/Hytale-F2P/issues) or join our [Discord](https://discord.gg/Fhbb9Yk5WW).
 ---
@@ -437,7 +437,7 @@ Game sessions have a 10-hour TTL. This is by design for security.
 If your issue isn't resolved by this guide:
 1. **Check existing issues:** [GitHub Issues](https://github.com/amiayweb/Hytale-F2P/issues)
-2. **Join Discord:** [discord.gg/gME8rUy3MB](https://discord.gg/gME8rUy3MB)
+2. **Join Discord:** [discord.gg/Fhbb9Yk5WW](https://discord.gg/Fhbb9Yk5WW)
 3. **Open a new issue** with:
   - Your operating system and version
   - Launcher version
--- a/backend/appUpdater.js
+++ b/backend/appUpdater.js
@@ -4,6 +4,10 @@ const logger = require('./logger');
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
 const https = require('https');
 const FORGEJO_API = 'https://git.sanhost.net/api/v1';
 const FORGEJO_REPO = 'sanasol/hytale-f2p';
 class AppUpdater {
  constructor(mainWindow) {
@@ -14,6 +18,34 @@ class AppUpdater {
    this.setupAutoUpdater();
  }
  /**
   * Fetch the latest non-draft release tag from Forgejo and set the feed URL
   */
  async _resolveUpdateUrl() {
    return new Promise((resolve, reject) => {
      https.get(`${FORGEJO_API}/repos/${FORGEJO_REPO}/releases?limit=5`, (res) => {
        let data = '';
        res.on('data', (chunk) => data += chunk);
        res.on('end', () => {
          try {
            const releases = JSON.parse(data);
            const latest = releases.find(r => !r.draft && !r.prerelease);
            if (latest) {
              const url = `https://git.sanhost.net/${FORGEJO_REPO}/releases/download/${latest.tag_name}`;
              console.log(`Auto-update URL resolved to: ${url}`);
              autoUpdater.setFeedURL({ provider: 'generic', url });
              resolve(url);
            } else {
              reject(new Error('No published release found'));
            }
          } catch (e) {
            reject(e);
          }
        });
      }).on('error', reject);
    });
  }
  setupAutoUpdater() {
    // Configure logger for electron-updater
@@ -216,8 +248,10 @@ class AppUpdater {
  }
  checkForUpdatesAndNotify() {
-    // Check for updates and notify if available
+    // Resolve latest release URL then check for updates
-    autoUpdater.checkForUpdatesAndNotify().catch(err => {
+    this._resolveUpdateUrl().catch(err => {
      console.warn('Failed to resolve update URL:', err.message);
    }).then(() => autoUpdater.checkForUpdatesAndNotify()).catch(err => {
      console.error('Failed to check for updates:', err);
      // Network errors are not critical - just log and continue
@@ -245,8 +279,10 @@ class AppUpdater {
  }
  checkForUpdates() {
-    // Manual check for updates (returns promise)
+    // Manual check - resolve latest release URL first
-    return autoUpdater.checkForUpdates().catch(err => {
+    return this._resolveUpdateUrl().catch(err => {
      console.warn('Failed to resolve update URL:', err.message);
    }).then(() => autoUpdater.checkForUpdates()).catch(err => {
      console.error('Failed to check for updates:', err);
      // Network errors are not critical - just return no update available
--- a/backend/core/config.js
+++ b/backend/core/config.js
@@ -54,6 +54,7 @@ function getAppDir() {
 const CONFIG_FILE = path.join(getAppDir(), 'config.json');
 const CONFIG_BACKUP = path.join(getAppDir(), 'config.json.bak');
 const CONFIG_TEMP = path.join(getAppDir(), 'config.json.tmp');
 const UUID_STORE_FILE = path.join(getAppDir(), 'uuid-store.json');
 // =============================================================================
 // CONFIG VALIDATION
@@ -152,6 +153,22 @@ function saveConfig(update) {
      // Load current config
      const currentConfig = loadConfig();
      // SAFETY: If config file exists on disk but loadConfig() returned empty,
      // something is wrong (file locked, corrupted, etc.). Refuse to save
      // because merging with {} would wipe all existing data (userUuids, username, etc.)
      if (Object.keys(currentConfig).length === 0 && fs.existsSync(CONFIG_FILE)) {
        const fileSize = fs.statSync(CONFIG_FILE).size;
        if (fileSize > 2) { // More than just "{}"
          console.error(`[Config] REFUSING to save — loaded empty but file exists (${fileSize} bytes). Retrying load...`);
          // Wait and retry the load
          const delay = attempt * 200;
          const start = Date.now();
          while (Date.now() - start < delay) { /* busy wait */ }
          continue;
        }
      }
      const newConfig = { ...currentConfig, ...update };
      const data = JSON.stringify(newConfig, null, 2);
@@ -238,11 +255,18 @@ function saveUsername(username) {
  // Check if we're actually changing the username (case-insensitive comparison)
  const isRename = currentName && currentName.toLowerCase() !== newName.toLowerCase();
  // Also update UUID store (source of truth)
  migrateUuidStoreIfNeeded();
  const uuidStore = loadUuidStore();
  if (isRename) {
    // Find the UUID for the current username
    const currentKey = Object.keys(userUuids).find(
      k => k.toLowerCase() === currentName.toLowerCase()
    );
    const currentStoreKey = Object.keys(uuidStore).find(
      k => k.toLowerCase() === currentName.toLowerCase()
    );
    if (currentKey && userUuids[currentKey]) {
      // Check if target username already exists (would be a different identity)
@@ -258,6 +282,9 @@ function saveUsername(username) {
        const uuid = userUuids[currentKey];
        delete userUuids[currentKey];
        userUuids[newName] = uuid;
        // Same in UUID store
        if (currentStoreKey) delete uuidStore[currentStoreKey];
        uuidStore[newName] = uuid;
        console.log(`[Config] Renamed identity: "${currentKey}" → "${newName}" (UUID preserved: ${uuid})`);
      }
    }
@@ -270,11 +297,20 @@ function saveUsername(username) {
      const uuid = userUuids[currentKey];
      delete userUuids[currentKey];
      userUuids[newName] = uuid;
      // Same in UUID store
      const storeKey = Object.keys(uuidStore).find(k => k.toLowerCase() === currentName.toLowerCase());
      if (storeKey) {
        delete uuidStore[storeKey];
        uuidStore[newName] = uuid;
      }
      console.log(`[Config] Updated username case: "${currentKey}" → "${newName}"`);
    }
  }
-  // Save both username and updated userUuids
+  // Save UUID store
  saveUuidStore(uuidStore);
  // Save both username and updated userUuids to config
  saveConfig({ username: newName, userUuids });
  console.log(`[Config] Username saved: "${newName}"`);
  return newName;
@@ -310,6 +346,7 @@ function hasUsername() {
 // =============================================================================
 // UUID MANAGEMENT - Persistent and safe
 // Uses separate uuid-store.json as source of truth (survives config.json corruption)
 // =============================================================================
 /**
@@ -320,10 +357,55 @@ function normalizeUsername(username) {
  return username.trim().toLowerCase();
 }
 /**
 * Load UUID store from separate file (independent of config.json)
 */
 function loadUuidStore() {
  try {
    if (fs.existsSync(UUID_STORE_FILE)) {
      const data = fs.readFileSync(UUID_STORE_FILE, 'utf8');
      if (data.trim()) {
        return JSON.parse(data);
      }
    }
  } catch (err) {
    console.error('[UUID Store] Failed to load:', err.message);
  }
  return {};
 }
 /**
 * Save UUID store to separate file (atomic write)
 */
 function saveUuidStore(store) {
  try {
    const dir = path.dirname(UUID_STORE_FILE);
    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
    const tmpFile = UUID_STORE_FILE + '.tmp';
    fs.writeFileSync(tmpFile, JSON.stringify(store, null, 2), 'utf8');
    fs.renameSync(tmpFile, UUID_STORE_FILE);
  } catch (err) {
    console.error('[UUID Store] Failed to save:', err.message);
  }
 }
 /**
 * One-time migration: copy userUuids from config.json to uuid-store.json
 */
 function migrateUuidStoreIfNeeded() {
  if (fs.existsSync(UUID_STORE_FILE)) return; // Already migrated
  const config = loadConfig();
  if (config.userUuids && Object.keys(config.userUuids).length > 0) {
    console.log('[UUID Store] Migrating', Object.keys(config.userUuids).length, 'UUIDs from config.json');
    saveUuidStore(config.userUuids);
  }
 }
 /**
 * Get UUID for a username
- * Creates new UUID only if user explicitly doesn't exist
+ * Source of truth: uuid-store.json (separate from config.json)
- * Uses case-insensitive lookup to prevent duplicates, but preserves original case for display
+ * Also writes to config.json for backward compatibility
 * Creates new UUID only if user doesn't exist in EITHER store
 */
 function getUuidForUser(username) {
  const { v4: uuidv4 } = require('uuid');
@@ -335,32 +417,69 @@ function getUuidForUser(username) {
  const displayName = username.trim();
  const normalizedLookup = displayName.toLowerCase();
-  const config = loadConfig();
+  // Ensure UUID store exists (one-time migration from config.json)
-  const userUuids = config.userUuids || {};
+  migrateUuidStoreIfNeeded();
-  // Case-insensitive lookup - find existing key regardless of case
+  // 1. Check UUID store first (source of truth)
-  const existingKey = Object.keys(userUuids).find(k => k.toLowerCase() === normalizedLookup);
+  const uuidStore = loadUuidStore();
  const storeKey = Object.keys(uuidStore).find(k => k.toLowerCase() === normalizedLookup);
-  if (existingKey) {
+  if (storeKey) {
-    // Found existing - return UUID, update display name if case changed
+    const existingUuid = uuidStore[storeKey];
    const existingUuid = userUuids[existingKey];
-    // If user typed different case, update the key to new case (preserving UUID)
+    // Update case if needed
-    if (existingKey !== displayName) {
+    if (storeKey !== displayName) {
-      console.log(`[Config] Updating username case: "${existingKey}" → "${displayName}"`);
+      console.log(`[UUID Store] Updating username case: "${storeKey}" → "${displayName}"`);
-      delete userUuids[existingKey];
+      delete uuidStore[storeKey];
-      userUuids[displayName] = existingUuid;
+      uuidStore[displayName] = existingUuid;
-      saveConfig({ userUuids });
+      saveUuidStore(uuidStore);
    }
    // Sync to config.json (backward compat, non-critical)
    try {
      const config = loadConfig();
      const configUuids = config.userUuids || {};
      const configKey = Object.keys(configUuids).find(k => k.toLowerCase() === normalizedLookup);
      if (!configKey || configUuids[configKey] !== existingUuid) {
        if (configKey) delete configUuids[configKey];
        configUuids[displayName] = existingUuid;
        saveConfig({ userUuids: configUuids });
      }
    } catch (e) {
      // Non-critical — UUID store is the source of truth
    }
    console.log(`[UUID] ${displayName} → ${existingUuid} (from uuid-store)`);
    return existingUuid;
  }
-  // Create new UUID for new user - store with original case
+  // 2. Fallback: check config.json (recovery if uuid-store.json was lost)
  const config = loadConfig();
  const userUuids = config.userUuids || {};
  const configKey = Object.keys(userUuids).find(k => k.toLowerCase() === normalizedLookup);
  if (configKey) {
    const recoveredUuid = userUuids[configKey];
    console.warn(`[UUID] RECOVERED "${displayName}" → ${recoveredUuid} from config.json (uuid-store was missing)`);
    // Save to UUID store
    uuidStore[displayName] = recoveredUuid;
    saveUuidStore(uuidStore);
    return recoveredUuid;
  }
  // 3. New user — generate UUID, save to BOTH stores
  const newUuid = uuidv4();
  console.log(`[UUID] NEW user "${displayName}" → ${newUuid}`);
  // Save to UUID store (source of truth)
  uuidStore[displayName] = newUuid;
  saveUuidStore(uuidStore);
  // Save to config.json (backward compat)
  userUuids[displayName] = newUuid;
  saveConfig({ userUuids });
  console.log(`[Config] Created new UUID for "${displayName}": ${newUuid}`);
  return newUuid;
 }
@@ -380,22 +499,26 @@ function getCurrentUuid() {
 * Get all UUID mappings (raw object)
 */
 function getAllUuidMappings() {
  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 allMappings = getAllUuidMappings();
  const userUuids = config.userUuids || {};
  const currentUsername = loadUsername();
  // Case-insensitive comparison for isCurrent
  const normalizedCurrent = currentUsername ? currentUsername.toLowerCase() : null;
-  return Object.entries(userUuids).map(([username, uuid]) => ({
+  return Object.entries(allMappings).map(([username, uuid]) => ({
-    username,  // Original case preserved
+    username,
    uuid,
    isCurrent: username.toLowerCase() === normalizedCurrent
  }));
@@ -419,16 +542,20 @@ function setUuidForUser(username, uuid) {
  const displayName = username.trim();
  const normalizedLookup = displayName.toLowerCase();
  // 1. Update UUID store (source of truth)
  migrateUuidStoreIfNeeded();
  const uuidStore = loadUuidStore();
  const storeKey = Object.keys(uuidStore).find(k => k.toLowerCase() === normalizedLookup);
  if (storeKey) delete uuidStore[storeKey];
  uuidStore[displayName] = uuid;
  saveUuidStore(uuidStore);
  // 2. Update config.json (backward compat)
  const config = loadConfig();
  const userUuids = config.userUuids || {};
  // Remove any existing entry with same name (case-insensitive)
  const existingKey = Object.keys(userUuids).find(k => k.toLowerCase() === normalizedLookup);
-  if (existingKey) {
+  if (existingKey) delete userUuids[existingKey];
    delete userUuids[existingKey];
  }
  // Store with original case
  userUuids[displayName] = uuid;
  saveConfig({ userUuids });
@@ -454,20 +581,30 @@ function deleteUuidForUser(username) {
  }
  const normalizedLookup = username.trim().toLowerCase();
  let deleted = false;
  // 1. Delete from UUID store (source of truth)
  migrateUuidStoreIfNeeded();
  const uuidStore = loadUuidStore();
  const storeKey = Object.keys(uuidStore).find(k => k.toLowerCase() === normalizedLookup);
  if (storeKey) {
    delete uuidStore[storeKey];
    saveUuidStore(uuidStore);
    deleted = true;
  }
  // 2. Delete from config.json (backward compat)
  const config = loadConfig();
  const userUuids = config.userUuids || {};
  // Case-insensitive lookup
  const existingKey = Object.keys(userUuids).find(k => k.toLowerCase() === normalizedLookup);
  if (existingKey) {
    delete userUuids[existingKey];
    saveConfig({ userUuids });
-    console.log(`[Config] UUID deleted for "${username}"`);
+    deleted = true;
    return true;
  }
-  return false;
+  if (deleted) console.log(`[Config] UUID deleted for "${username}"`);
  return deleted;
 }
 /**
@@ -788,5 +925,6 @@ module.exports = {
  loadVersionBranch,
  // Constants
-  CONFIG_FILE
+  CONFIG_FILE,
  UUID_STORE_FILE
 };
--- 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, canUseDifferentialUpdate, needsIntermediatePatches, getInstalledClientVersion } = require('../services/versionManager');
+const { validateChecksum, extractVersionDetails, getInstalledClientVersion, getUpdatePlan, extractVersionNumber, getAllMirrorUrls, getPatchesBaseUrl } = require('../services/versionManager');
 const { installButler } = require('./butlerManager');
 const { GAME_DIR, CACHE_DIR, TOOLS_DIR } = require('../core/paths');
 const { saveVersionClient } = require('../core/config');
@@ -31,15 +31,62 @@ async function acquireGameArchive(downloadUrl, targetPath, checksum, progressCal
  console.log(`Downloading game archive from: ${downloadUrl}`);
-  try {
+  // Try primary URL first, then mirror URLs on timeout/connection failure
-    if (allowRetry) {
+  const mirrors = await getAllMirrorUrls();
-      await retryDownload(downloadUrl, targetPath, progressCallback);
+  const primaryBase = await getPatchesBaseUrl();
-    } else {
+  const urlsToTry = [downloadUrl];
-      await downloadFile(downloadUrl, targetPath, progressCallback);
+
  // Build mirror URLs by replacing the base URL
  for (const mirror of mirrors) {
    if (mirror !== primaryBase && downloadUrl.startsWith(primaryBase)) {
      const mirrorUrl = downloadUrl.replace(primaryBase, mirror);
      if (!urlsToTry.includes(mirrorUrl)) {
        urlsToTry.push(mirrorUrl);
      }
    }
  }
  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}`);
+      lastError = error;
-    enhancedError.originalError = 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;
@@ -156,15 +203,15 @@ async function performIntelligentUpdate(targetVersion, branch = 'release', progr
  console.log(`Initiating intelligent update to version ${targetVersion}`);
  const currentVersion = getInstalledClientVersion();
-  console.log(`Current version: ${currentVersion || 'none (clean install)'}`);
+  const currentBuild = extractVersionNumber(currentVersion) || 0;
-  console.log(`Target version: ${targetVersion}`);
+  const targetBuild = extractVersionNumber(targetVersion);
-  console.log(`Branch: ${branch}`);
+  console.log(`Current build: ${currentBuild}, Target build: ${targetBuild}, Branch: ${branch}`);
  // For non-release branches, always do full install
  if (branch !== 'release') {
-    console.log(`Pre-release branch detected - forcing full archive download`);
+    console.log('Pre-release branch detected - forcing full archive download');
    const versionDetails = await extractVersionDetails(targetVersion, branch);
-    const archiveName = path.basename(versionDetails.fullUrl);
+    const archivePath = path.join(cacheDir, `${branch}_0_to_${targetBuild}.pwr`);
    const archivePath = path.join(cacheDir, `${branch}_${archiveName}`);
    if (progressCallback) {
      progressCallback('Downloading full game archive (pre-release)...', 0, null, null, null);
@@ -177,14 +224,14 @@ async function performIntelligentUpdate(targetVersion, branch = 'release', progr
    return;
  }
-  if (!currentVersion) {
+  // Clean install (no current version)
  if (currentBuild === 0) {
    console.log('No existing installation detected - downloading full archive');
    const versionDetails = await extractVersionDetails(targetVersion, branch);
-    const archiveName = path.basename(versionDetails.fullUrl);
+    const archivePath = path.join(cacheDir, `${branch}_0_to_${targetBuild}.pwr`);
    const archivePath = path.join(cacheDir, `${branch}_${archiveName}`);
    if (progressCallback) {
-      progressCallback(`Downloading full game archive (first install - v${targetVersion})...`, 0, null, null, null);
+      progressCallback(`Downloading full game archive (first install - v${targetBuild})...`, 0, null, null, null);
    }
    await acquireGameArchive(versionDetails.fullUrl, archivePath, null, progressCallback);
@@ -194,59 +241,67 @@ async function performIntelligentUpdate(targetVersion, branch = 'release', progr
    return;
  }
-  const patchesToApply = needsIntermediatePatches(currentVersion, targetVersion);
+  // Already at target
-  
+  if (currentBuild >= targetBuild) {
-  if (patchesToApply.length === 0) {
+    console.log('Already at target version or newer');
    console.log('Already at target version or invalid version sequence');
    return;
  }
-  console.log(`Applying ${patchesToApply.length} differential patch(es): ${patchesToApply.join(' -> ')}`);
+  // Use mirror's update plan for optimal patch routing
  try {
    const plan = await getUpdatePlan(currentBuild, targetBuild, branch);
-  for (let i = 0; i < patchesToApply.length; i++) {
+    console.log(`Applying ${plan.steps.length} patch(es): ${plan.steps.map(s => `${s.from}\u2192${s.to}`).join(' + ')}`);
    const patchVersion = patchesToApply[i];
    const versionDetails = await extractVersionDetails(patchVersion, branch);
-    const canDifferential = canUseDifferentialUpdate(getInstalledClientVersion(), versionDetails);
+    for (let i = 0; i < plan.steps.length; i++) {
-    
+      const step = plan.steps[i];
-    if (!canDifferential || !versionDetails.differentialUrl) {
+      const stepName = `${step.from}_to_${step.to}`;
-      console.log(`WARNING: Differential patch not available for ${patchVersion}, using full archive`);
+      const archivePath = path.join(cacheDir, `${branch}_${stepName}.pwr`);
-      const archiveName = path.basename(versionDetails.fullUrl);
+      const isDifferential = step.from !== 0;
      const archivePath = path.join(cacheDir, `${branch}_${archiveName}`);
      if (progressCallback) {
-        progressCallback(`Downloading full archive for ${patchVersion} (${i + 1}/${patchesToApply.length})...`, 0, null, null, null);
+        progressCallback(`Downloading patch ${i + 1}/${plan.steps.length}: ${stepName}...`, 0, null, null, null);
      }
      await acquireGameArchive(step.url, archivePath, null, progressCallback);
      if (progressCallback) {
        progressCallback(`Applying patch ${i + 1}/${plan.steps.length}: ${stepName}...`, 50, null, null, null);
      }
      await deployGameArchive(archivePath, gameDir, toolsDir, progressCallback, isDifferential);
      // Clean up patch file
      if (fs.existsSync(archivePath)) {
        try {
          fs.unlinkSync(archivePath);
          console.log(`Cleaned up: ${stepName}.pwr`);
        } catch (cleanupErr) {
          console.warn(`Failed to cleanup: ${cleanupErr.message}`);
        }
      }
      saveVersionClient(`v${step.to}`);
      console.log(`Patch ${stepName} applied (${i + 1}/${plan.steps.length})`);
    }
    console.log(`Update completed. Version ${targetVersion} is now installed.`);
  } catch (planError) {
    console.error('Update plan failed:', planError.message);
    console.log('Falling back to full archive download');
    // Fallback: full install
    const versionDetails = await extractVersionDetails(targetVersion, branch);
    const archivePath = path.join(cacheDir, `${branch}_0_to_${targetBuild}.pwr`);
    if (progressCallback) {
      progressCallback(`Downloading full game archive (fallback)...`, 0, null, null, null);
    }
    await acquireGameArchive(versionDetails.fullUrl, archivePath, null, progressCallback);
    await deployGameArchive(archivePath, gameDir, toolsDir, progressCallback, false);
-    } else {
+    saveVersionClient(targetVersion);
      console.log(`Applying differential patch: ${versionDetails.sourceVersion} -> ${patchVersion}`);
      const archiveName = path.basename(versionDetails.differentialUrl);
      const archivePath = path.join(cacheDir, `${branch}_patch_${archiveName}`);
      if (progressCallback) {
        progressCallback(`Applying patch ${i + 1}/${patchesToApply.length}: ${patchVersion}...`, 0, null, null, null);
  }
      await acquireGameArchive(versionDetails.differentialUrl, archivePath, versionDetails.checksum, progressCallback);
      await deployGameArchive(archivePath, gameDir, toolsDir, progressCallback, true);
      if (fs.existsSync(archivePath)) {
        try {
          fs.unlinkSync(archivePath);
          console.log(`Cleaned up patch file: ${archiveName}`);
        } catch (cleanupErr) {
          console.warn(`Failed to cleanup patch file: ${cleanupErr.message}`);
        }
      }
    }
    saveVersionClient(patchVersion);
    console.log(`Patch ${patchVersion} applied successfully (${i + 1}/${patchesToApply.length})`);
  }
  console.log(`Update completed successfully. Version ${targetVersion} is now installed.`);
 }
 async function ensureGameInstalled(targetVersion, branch = 'release', progressCallback, gameDir = GAME_DIR, cacheDir = CACHE_DIR, toolsDir = TOOLS_DIR) {
--- a/backend/managers/gameLauncher.js
+++ b/backend/managers/gameLauncher.js
@@ -27,6 +27,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;
@@ -61,12 +62,39 @@ async function fetchAuthTokens(uuid, name) {
    }
    const data = await response.json();
-    console.log('Auth tokens received from server');
+    const identityToken = data.IdentityToken || data.identityToken;
    const sessionToken = data.SessionToken || data.sessionToken;
    // Verify the identity token has the correct username
    // This catches cases where the auth server defaults to "Player"
    try {
      const parts = identityToken.split('.');
      if (parts.length >= 2) {
        const payload = JSON.parse(Buffer.from(parts[1], 'base64url').toString());
        if (payload.username && payload.username !== name && name !== 'Player') {
          console.warn(`[Auth] Token username mismatch: token has "${payload.username}", expected "${name}". Retrying...`);
          // Retry once with explicit name
          const retryResponse = await fetch(`${authServerUrl}/game-session/child`, {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify({ uuid: uuid, name: name, scopes: ['hytale:server', 'hytale:client'] })
          });
          if (retryResponse.ok) {
            const retryData = await retryResponse.json();
            console.log('[Auth] Retry successful');
            return {
-      identityToken: data.IdentityToken || data.identityToken,
+              identityToken: retryData.IdentityToken || retryData.identityToken,
-      sessionToken: data.SessionToken || data.sessionToken
+              sessionToken: retryData.SessionToken || retryData.sessionToken
            };
          }
        }
      }
    } catch (verifyErr) {
      console.warn('[Auth] Token verification skipped:', verifyErr.message);
    }
    console.log('Auth tokens received from server');
    return { identityToken, sessionToken };
  } catch (error) {
    console.error('Failed to fetch auth tokens:', error.message);
    // Fallback to local generation if server unavailable
@@ -223,6 +251,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) {
@@ -408,11 +437,27 @@ exec "$REAL_JAVA" "\${ARGS[@]}"
    }
  }
  // Kill any stalled game processes from a previous launch to prevent file locks
  // and "game already running" issues
  await killGameProcesses();
  // Remove AOT cache: generated by official Hytale JRE, incompatible with F2P JRE.
  // Client adds -XX:AOTCache when this file exists, causing classloading failures.
  const aotCache = path.join(gameLatest, 'Server', 'HytaleServer.aot');
  if (fs.existsSync(aotCache)) {
    try {
      fs.unlinkSync(aotCache);
      console.log('Removed incompatible AOT cache (HytaleServer.aot)');
    } catch (aotErr) {
      console.warn('Could not remove AOT cache:', aotErr.message);
    }
  }
  // DualAuth Agent: Set JAVA_TOOL_OPTIONS so java picks up -javaagent: flag
  // This enables runtime auth patching without modifying the server JAR
  const agentJar = path.join(gameLatest, 'Server', 'dualauth-agent.jar');
  if (fs.existsSync(agentJar)) {
-    const agentFlag = `-javaagent:${agentJar}`;
+    const agentFlag = `-javaagent:"${agentJar}"`;
    env.JAVA_TOOL_OPTIONS = env.JAVA_TOOL_OPTIONS
      ? `${env.JAVA_TOOL_OPTIONS} ${agentFlag}`
      : agentFlag;
--- a/backend/managers/gameManager.js
+++ b/backend/managers/gameManager.js
@@ -5,7 +5,7 @@ const { promisify } = require('util');
 const { getResolvedAppDir, findClientPath, findUserDataPath, findUserDataRecursive, GAME_DIR, CACHE_DIR, TOOLS_DIR } = require('../core/paths');
 const { getOS, getArch } = require('../utils/platformUtils');
 const { downloadFile, retryDownload, retryStalledDownload, MAX_AUTOMATIC_STALL_RETRIES } = require('../utils/fileManager');
-const { getLatestClientVersion, getInstalledClientVersion } = require('../services/versionManager');
+const { getLatestClientVersion, getInstalledClientVersion, getUpdatePlan, extractVersionNumber } = require('../services/versionManager');
 const { FORCE_CLEAN_INSTALL_VERSION, CLEAN_INSTALL_TEST_VERSION } = require('../core/testConfig');
 const { installButler } = require('./butlerManager');
 const { downloadAndReplaceHomePageUI, downloadAndReplaceLogo } = require('./uiFileManager');
@@ -39,6 +39,41 @@ async function isGameRunning() {
  }
 }
 // Force-kill stalled game processes to release file locks before repair/reinstall.
 // Cross-platform: Windows (taskkill/PowerShell), macOS (pkill), Linux (pkill).
 async function killGameProcesses() {
  const killed = [];
  async function tryKill(command, label) {
    try {
      await execAsync(command);
      killed.push(label);
    } catch (_) { /* process not found is expected */ }
  }
  if (process.platform === 'win32') {
    // Kill client
    await tryKill('taskkill /F /IM "HytaleClient.exe" /T', 'HytaleClient.exe');
    // Kill java.exe instances running HytaleServer.jar via PowerShell
    // (Get-CimInstance replaces deprecated wmic, works on Windows 10+)
    await tryKill(
      'powershell -NoProfile -Command "Get-CimInstance Win32_Process -Filter \\"name=\'java.exe\'\\" | Where-Object { $_.CommandLine -like \'*HytaleServer*\' } | ForEach-Object { Stop-Process -Id $_.ProcessId -Force }"',
      'java.exe(HytaleServer)'
    );
  } else {
    // macOS and Linux
    await tryKill('pkill -9 -f HytaleClient', 'HytaleClient');
    await tryKill('pkill -9 -f HytaleServer', 'HytaleServer');
  }
  if (killed.length > 0) {
    console.log(`[GameManager] Force-killed stalled processes: ${killed.join(', ')}`);
    // Wait for OS to release file handles
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  return killed;
 }
 // Helper function to safely remove directory with retry logic
 async function safeRemoveDirectory(dirPath, maxRetries = 3) {
  for (let attempt = 1; attempt <= maxRetries; attempt++) {
@@ -52,6 +87,11 @@ async function safeRemoveDirectory(dirPath, maxRetries = 3) {
      console.warn(`Attempt ${attempt}/${maxRetries} failed to remove ${dirPath}: ${error.message}`);
      if (attempt < maxRetries) {
        // On EPERM/EBUSY, try killing stalled game processes that hold file locks
        if (attempt === 1 && (error.code === 'EPERM' || error.code === 'EBUSY')) {
          console.log('Permission error detected, killing stalled game processes...');
          await killGameProcesses();
        }
        // Wait before retrying (exponential backoff)
        const delay = Math.min(1000 * Math.pow(2, attempt - 1), 5000);
        console.log(`Waiting ${delay}ms before retry...`);
@@ -64,7 +104,7 @@ async function safeRemoveDirectory(dirPath, maxRetries = 3) {
  }
 }
-async function downloadPWR(branch = 'release', fileName = 'v8', progressCallback, cacheDir = CACHE_DIR, manualRetry = false) {
+async function downloadPWR(branch = 'release', fileName = 'v8', progressCallback, cacheDir = CACHE_DIR, manualRetry = false, directUrl = null, expectedSize = null) {
  const osName = getOS();
  const arch = getArch();
@@ -72,43 +112,69 @@ async function downloadPWR(branch = 'release', fileName = 'v8', progressCallback
    throw new Error('Hytale x86_64 Intel Mac Support has not been released yet. Please check back later.');
  }
  const { getPWRUrlFromNewAPI } = require('../services/versionManager');
  let url;
  let isUsingNewAPI = false;
  if (directUrl) {
    url = directUrl;
    console.log(`[DownloadPWR] Using direct URL: ${url}`);
  } else {
    const { getPWRUrl } = require('../services/versionManager');
    try {
-    console.log(`[DownloadPWR] Fetching URL from new API for branch: ${branch}, version: ${fileName}`);
+      console.log(`[DownloadPWR] Fetching mirror URL for branch: ${branch}, version: ${fileName}`);
-    url = await getPWRUrlFromNewAPI(branch, fileName);
+      url = await getPWRUrl(branch, fileName);
-    isUsingNewAPI = true;
+      console.log(`[DownloadPWR] Mirror URL: ${url}`);
    console.log(`[DownloadPWR] Using new API URL: ${url}`);
    } catch (error) {
-    console.error(`[DownloadPWR] Failed to get URL from new API: ${error.message}`);
+      console.error(`[DownloadPWR] Failed to get mirror URL: ${error.message}`);
-    console.log(`[DownloadPWR] Falling back to old URL format`);
+      const { getPatchesBaseUrl } = require('../services/versionManager');
-    url = `https://game-patches.hytale.com/patches/${osName}/${arch}/${branch}/0/${fileName}.pwr`;
+      const baseUrl = await getPatchesBaseUrl();
      url = `${baseUrl}/${osName}/${arch}/${branch}/0_to_${extractVersionNumber(fileName)}.pwr`;
      console.log(`[DownloadPWR] Fallback URL: ${url}`);
    }
  }
  // Look up expected file size from manifest if not provided
  if (!expectedSize) {
    try {
      const { fetchMirrorManifest } = require('../services/versionManager');
      const manifest = await fetchMirrorManifest();
      // Try to match: "0_to_11" format or "v11" format
      const versionMatch = fileName.match(/^(\d+)_to_(\d+)$/);
      let manifestKey;
      if (versionMatch) {
        manifestKey = `${osName}/${arch}/${branch}/${fileName}.pwr`;
      } else {
        const buildNum = extractVersionNumber(fileName);
        manifestKey = `${osName}/${arch}/${branch}/0_to_${buildNum}.pwr`;
      }
      if (manifest.files[manifestKey]) {
        expectedSize = manifest.files[manifestKey].size;
        console.log(`[PWR] Expected size from manifest: ${(expectedSize / 1024 / 1024).toFixed(2)} MB`);
      }
    } catch (e) {
      console.log(`[PWR] Could not fetch expected size from manifest: ${e.message}`);
    }
  }
  const dest = path.join(cacheDir, `${branch}_${fileName}.pwr`);
  // Check if file exists and validate it
  if (fs.existsSync(dest) && !manualRetry) {
    console.log('PWR file found in cache:', dest);
    // Validate file size (PWR files should be > 1MB and >= 1.5GB for complete downloads)
    const stats = fs.statSync(dest);
-    if (stats.size < 1024 * 1024) {
+    if (stats.size > 1024 * 1024) {
-      return false;
+      // Validate against expected size - reject if file is truncated (< 99% of expected)
      if (expectedSize && stats.size < expectedSize * 0.99) {
        console.log(`[PWR] Cached file truncated: ${(stats.size / 1024 / 1024).toFixed(2)} MB, expected ${(expectedSize / 1024 / 1024).toFixed(2)} MB. Deleting and re-downloading.`);
        fs.unlinkSync(dest);
      } else {
        console.log(`[PWR] Using cached file: ${dest} (${(stats.size / 1024 / 1024).toFixed(2)} MB)`);
        return dest;
      }
-    
+    } else {
-    // Check if file is under 1.5 GB (incomplete download)
+      console.log(`[PWR] Cached file too small (${stats.size} bytes), re-downloading`);
    const sizeInMB = stats.size / 1024 / 1024;
    if (sizeInMB < 1500) {
      console.log(`[PWR Validation] File appears incomplete: ${sizeInMB.toFixed(2)} MB < 1.5 GB`);
      return false;
    }
  }
-  console.log(`Fetching PWR patch file from ${isUsingNewAPI ? 'NEW API' : 'old API'}:`, url);
+  console.log(`[DownloadPWR] Downloading from: ${url}`);
  try {
    if (manualRetry) {
@@ -134,7 +200,7 @@ async function downloadPWR(branch = 'release', fileName = 'v8', progressCallback
        const retryStats = fs.statSync(dest);
        console.log(`PWR file downloaded (auto-retry), size: ${(retryStats.size / 1024 / 1024).toFixed(2)} MB`);
-        if (!validatePWRFile(dest)) {
+        if (!validatePWRFile(dest, expectedSize)) {
          console.log(`[PWR Validation] PWR file validation failed after auto-retry, deleting corrupted file: ${dest}`);
          fs.unlinkSync(dest);
          throw new Error('Downloaded PWR file is corrupted or invalid after automatic retry. Please retry manually');
@@ -185,7 +251,7 @@ async function downloadPWR(branch = 'release', fileName = 'v8', progressCallback
  const stats = fs.statSync(dest);
  console.log(`PWR file downloaded, size: ${(stats.size / 1024 / 1024).toFixed(2)} MB`);
-  if (!validatePWRFile(dest)) {
+  if (!validatePWRFile(dest, expectedSize)) {
    console.log(`[PWR Validation] PWR file validation failed, deleting corrupted file: ${dest}`);
    fs.unlinkSync(dest);
    throw new Error('Downloaded PWR file is corrupted or invalid. Please retry');
@@ -203,7 +269,7 @@ async function retryPWRDownload(branch, fileName, progressCallback, cacheDir = C
  return await downloadPWR(branch, fileName, progressCallback, cacheDir, true);
 }
-async function applyPWR(pwrFile, progressCallback, gameDir = GAME_DIR, toolsDir = TOOLS_DIR, branch = 'release', cacheDir = CACHE_DIR) {
+async function applyPWR(pwrFile, progressCallback, gameDir = GAME_DIR, toolsDir = TOOLS_DIR, branch = 'release', cacheDir = CACHE_DIR, skipExistingCheck = false) {
  console.log(`[Butler] Starting PWR application with:`);
  console.log(`[Butler] - PWR file: ${pwrFile}`);
  console.log(`[Butler] - Staging dir: ${path.join(gameDir, 'staging-temp')}`);
@@ -227,12 +293,13 @@ async function applyPWR(pwrFile, progressCallback, gameDir = GAME_DIR, toolsDir
  const gameLatest = gameDir;
  const stagingDir = path.join(gameLatest, 'staging-temp');
  if (!skipExistingCheck) {
    const clientPath = findClientPath(gameLatest);
    if (clientPath) {
      console.log('Game files detected, skipping patch installation.');
      return;
    }
  }
  // Validate and prepare directories
  validateGameDirectory(gameLatest, stagingDir);
@@ -412,6 +479,65 @@ async function updateGameFiles(newVersion, progressCallback, gameDir = GAME_DIR,
    }
    console.log(`Updating game files to version: ${newVersion} (branch: ${branch})`);
    // Determine update strategy: intermediate patches vs full reinstall
    const currentVersion = loadVersionClient();
    const currentBuild = extractVersionNumber(currentVersion) || 0;
    const targetBuild = extractVersionNumber(newVersion);
    let useIntermediatePatches = false;
    let updatePlan = null;
    if (currentBuild > 0 && currentBuild < targetBuild) {
      try {
        updatePlan = await getUpdatePlan(currentBuild, targetBuild, branch);
        useIntermediatePatches = !updatePlan.isFullInstall;
        if (useIntermediatePatches) {
          const totalMB = (updatePlan.totalSize / 1024 / 1024).toFixed(0);
          console.log(`[UpdateGameFiles] Using intermediate patches: ${updatePlan.steps.map(s => `${s.from}\u2192${s.to}`).join(' + ')} (${totalMB} MB)`);
        }
      } catch (planError) {
        console.warn('[UpdateGameFiles] Could not get update plan, falling back to full install:', planError.message);
      }
    }
    if (useIntermediatePatches && updatePlan) {
      // Apply intermediate patches directly to game dir
      for (let i = 0; i < updatePlan.steps.length; i++) {
        const step = updatePlan.steps[i];
        const stepName = `${step.from}_to_${step.to}`;
        if (progressCallback) {
          const progress = 20 + Math.round((i / updatePlan.steps.length) * 60);
          progressCallback(`Downloading patch ${i + 1}/${updatePlan.steps.length} (${stepName})...`, progress, null, null, null);
        }
        const pwrFile = await downloadPWR(branch, stepName, progressCallback, cacheDir, false, step.url, step.size);
        if (!pwrFile) {
          throw new Error(`Failed to download patch ${stepName}`);
        }
        if (progressCallback) {
          progressCallback(`Applying patch ${i + 1}/${updatePlan.steps.length} (${stepName})...`, null, null, null, null);
        }
        await applyPWR(pwrFile, progressCallback, gameDir, toolsDir, branch, cacheDir, true);
        // Clean up PWR file from cache
        try {
          if (fs.existsSync(pwrFile)) {
            fs.unlinkSync(pwrFile);
          }
        } catch (delErr) {
          console.warn('[UpdateGameFiles] Failed to delete PWR from cache:', delErr.message);
        }
        // Save intermediate version so we can resume if interrupted
        saveVersionClient(`v${step.to}`);
        console.log(`[UpdateGameFiles] Applied patch ${stepName} (${i + 1}/${updatePlan.steps.length})`);
      }
    } else {
      // Full install: download 0->target, apply to temp dir, swap
      tempUpdateDir = path.join(gameDir, '..', 'temp_update');
      if (fs.existsSync(tempUpdateDir)) {
@@ -430,7 +556,7 @@ async function updateGameFiles(newVersion, progressCallback, gameDir = GAME_DIR,
      }
      await applyPWR(pwrFile, progressCallback, tempUpdateDir, toolsDir, branch, cacheDir);
-    // Delete PWR file from cache after successful update
+
      try {
        if (fs.existsSync(pwrFile)) {
          fs.unlinkSync(pwrFile);
@@ -439,6 +565,7 @@ async function updateGameFiles(newVersion, progressCallback, gameDir = GAME_DIR,
      } catch (delErr) {
        console.warn('[UpdateGameFiles] Failed to delete PWR file from cache:', delErr.message);
      }
      if (progressCallback) {
        progressCallback('Replacing game files...', 80, null, null, null);
      }
@@ -463,6 +590,7 @@ async function updateGameFiles(newVersion, progressCallback, gameDir = GAME_DIR,
      }
      fs.renameSync(tempUpdateDir, gameDir);
    }
    const homeUIResult = await downloadAndReplaceHomePageUI(gameDir, progressCallback);
    console.log('HomePage.ui update result after update:', homeUIResult);
@@ -745,11 +873,14 @@ async function repairGame(progressCallback, branchOverride = null) {
    progressCallback('Removing old game files...', 30, null, null, null);
  }
-  // Check if game is running before attempting to delete files
+  // Kill stalled game processes before attempting to delete files
  const gameRunning = await isGameRunning();
  if (gameRunning) {
-    console.warn('[RepairGame] Game appears to be running. This may cause permission errors during repair.');
+    console.warn('[RepairGame] Game processes detected. Force-killing to release file locks...');
-    console.log('[RepairGame] Please close the game before repairing, or wait for the repair to complete.');
+    if (progressCallback) {
      progressCallback('Stopping stalled game processes...', 20, null, null, null);
    }
    await killGameProcesses();
  }
  // Delete Game and Cache Directory with retry logic
@@ -833,7 +964,8 @@ function validateGameDirectory(gameDir, stagingDir) {
 }
 // Enhanced PWR file validation
-function validatePWRFile(filePath) {
+// Accepts intermediate patches (50+ MB) and full installs (1.5+ GB)
 function validatePWRFile(filePath, expectedSize = null) {
  try {
    if (!fs.existsSync(filePath)) {
      return false;
@@ -842,27 +974,20 @@ function validatePWRFile(filePath) {
    const stats = fs.statSync(filePath);
    const sizeInMB = stats.size / 1024 / 1024;
    // PWR files should be at least 1 MB
    if (stats.size < 1024 * 1024) {
      console.log(`[PWR Validation] File too small: ${sizeInMB.toFixed(2)} MB`);
      return false;
    }
-    // Check if file is under 1.5 GB (incomplete download)
+    // Validate against expected size if known (reject if < 99% of expected)
-    if (sizeInMB < 1500) {
+    if (expectedSize && stats.size < expectedSize * 0.99) {
-      console.log(`[PWR Validation] File appears incomplete: ${sizeInMB.toFixed(2)} MB < 1.5 GB`);
+      const expectedMB = expectedSize / 1024 / 1024;
      console.log(`[PWR Validation] File truncated: ${sizeInMB.toFixed(2)} MB, expected ${expectedMB.toFixed(2)} MB`);
      return false;
    }
-    // Basic file header validation (PWR files should have specific headers)
+    console.log(`[PWR Validation] File size: ${sizeInMB.toFixed(2)} MB - OK`);
    const buffer = fs.readFileSync(filePath, { start: 0, end: 20 });
    if (buffer.length < 10) {
      return false;
    }
    // Check for common PWR magic bytes or patterns
    // This is a basic check - could be enhanced with actual PWR format specification
    const header = buffer.toString('hex', 0, 10);
    console.log(`[PWR Validation] File header: ${header}`);
    return true;
  } catch (error) {
    console.error(`[PWR Validation] Error:`, error.message);
@@ -882,5 +1007,6 @@ module.exports = {
  installGame,
  uninstallGame,
  checkExistingGameInstallation,
-  repairGame
+  repairGame,
  killGameProcesses
 };
--- a/backend/services/versionManager.js
+++ b/backend/services/versionManager.js
@@ -1,287 +1,500 @@
 const axios = require('axios');
 const crypto = require('crypto');
 const fs = require('fs');
 const path = require('path');
 const { getOS, getArch } = require('../utils/platformUtils');
 const { smartRequest } = require('../utils/proxyClient');
-const BASE_PATCH_URL = 'https://game-patches.hytale.com/patches';
+// Patches base URL fetched dynamically via multi-source fallback chain
-const MANIFEST_API = 'https://files.hytalef2p.com/api/patch_manifest';
+const AUTH_DOMAIN = process.env.HYTALE_AUTH_DOMAIN || 'auth.sanasol.ws';
-const NEW_API_URL = 'https://thecute.cloud/ShipOfYarn/api.php';
+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';
-let apiCache = null;
+// Alternative mirrors (non-Cloudflare) for regions where CF is blocked
-let apiCacheTime = 0;
+const NON_CF_MIRRORS = [
-const API_CACHE_DURATION = 60000; // 1 minute
+  'https://dl1.htdwnldsan.top',
  'https://htdwnldsan.top/patches',
 ];
-async function fetchNewAPI() {
+// 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 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();
-  if (apiCache && (now - apiCacheTime) < API_CACHE_DURATION) {
+  // 1. Memory cache
-    console.log('[NewAPI] Using cached API data');
+  if (patchesBaseUrl && (now - patchesConfigTime) < PATCHES_CONFIG_CACHE_DURATION) {
-    return apiCache;
+    return patchesBaseUrl;
  }
  // 2-4. Try all sources: HTTP endpoints first, then DoH
  for (const source of PATCHES_CONFIG_SOURCES) {
    try {
-    console.log('[NewAPI] Fetching from:', NEW_API_URL);
+      let url;
-    const response = await axios.get(NEW_API_URL, {
+      if (source.type === 'http') {
-      timeout: 15000,
+        console.log(`[Mirror] Trying ${source.name}: ${source.url}`);
-      headers: {
+        url = await fetchFromHttp(source.url);
-        'User-Agent': 'Hytale-F2P-Launcher'
+      } else if (source.type === 'doh') {
        console.log(`[Mirror] Trying ${source.name_label}: ${source.name}`);
        url = await fetchFromDoh(source.name);
      }
-    });
+      if (url) {
-    
+        patchesBaseUrl = url;
-    if (response.data && response.data.hytale) {
+        patchesConfigTime = now;
-      apiCache = response.data;
+        saveDiskCache(url);
-      apiCacheTime = now;
+        console.log(`[Mirror] Patches URL (via ${source.name || source.name_label}): ${url}`);
      console.log('[NewAPI] API data fetched and cached successfully');
      return response.data;
    } else {
      throw new Error('Invalid API response structure');
    }
  } catch (error) {
    console.error('[NewAPI] Error fetching API:', error.message);
    if (apiCache) {
      console.log('[NewAPI] Using expired cache due to error');
      return apiCache;
    }
    throw error;
  }
 }
 async function getLatestVersionFromNewAPI(branch = 'release') {
  try {
    const apiData = await fetchNewAPI();
    const osName = getOS();
    const arch = getArch();
    let osKey = osName;
    if (osName === 'darwin') {
      osKey = 'mac';
    }
    const branchData = apiData.hytale[branch];
    if (!branchData || !branchData[osKey]) {
      throw new Error(`No data found for branch: ${branch}, OS: ${osKey}`);
    }
    const osData = branchData[osKey];
    const versions = Object.keys(osData).filter(key => key.endsWith('.pwr'));
    if (versions.length === 0) {
      throw new Error(`No .pwr files found for ${osKey}`);
    }
    const versionNumbers = versions.map(v => {
      const match = v.match(/v(\d+)/);
      return match ? parseInt(match[1]) : 0;
    });
    const latestVersionNumber = Math.max(...versionNumbers);
    console.log(`[NewAPI] Latest version number: ${latestVersionNumber} for branch ${branch}`);
    return `v${latestVersionNumber}`;
  } catch (error) {
    console.error('[NewAPI] Error getting latest version:', error.message);
    throw error;
  }
 }
 async function getPWRUrlFromNewAPI(branch = 'release', version = 'v8') {
  try {
    const apiData = await fetchNewAPI();
    const osName = getOS();
    const arch = getArch();
    let osKey = osName;
    if (osName === 'darwin') {
      osKey = 'mac';
    }
    let fileName;
    if (osName === 'windows') {
      fileName = `${version}-windows-amd64.pwr`;
    } else if (osName === 'linux') {
      fileName = `${version}-linux-amd64.pwr`;
    } else if (osName === 'darwin') {
      fileName = `${version}-darwin-arm64.pwr`;
    }
    const branchData = apiData.hytale[branch];
    if (!branchData || !branchData[osKey]) {
      throw new Error(`No data found for branch: ${branch}, OS: ${osKey}`);
    }
    const osData = branchData[osKey];
    const url = osData[fileName];
    if (!url) {
      throw new Error(`No URL found for ${fileName}`);
    }
    console.log(`[NewAPI] URL for ${fileName}: ${url}`);
        return url;
  } catch (error) {
    console.error('[NewAPI] Error getting PWR URL:', error.message);
    throw error;
      }
    } 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();
  if (manifestCache && (now - manifestCacheTime) < MANIFEST_CACHE_DURATION) {
    console.log('[Mirror] Using cached manifest');
    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: ${manifestUrl}`);
      const response = await axios.get(manifestUrl, {
        timeout: 15000,
        maxRedirects: 5,
        headers: { 'User-Agent': 'Hytale-F2P-Launcher' }
      });
      if (response.data && response.data.files) {
        manifestCache = response.data;
        manifestCacheTime = now;
        // If a non-primary mirror worked, switch to it for downloads too
        if (i > 0) {
          console.log(`[Mirror] Primary unreachable, switching to mirror: ${baseUrl}`);
          patchesBaseUrl = baseUrl;
          patchesConfigTime = now;
          saveDiskCache(baseUrl);
        }
        console.log('[Mirror] Manifest fetched successfully');
        return response.data;
      }
      throw new Error('Invalid manifest structure');
    } catch (error) {
      const isTimeout = error.code === 'ETIMEDOUT' || error.code === 'ECONNABORTED' || error.message.includes('timeout');
      console.error(`[Mirror] Error fetching manifest from ${baseUrl}: ${error.message}${isTimeout ? ' (Cloudflare may be blocked)' : ''}`);
      if (i < mirrors.length - 1) {
        console.log(`[Mirror] Trying next mirror...`);
      }
    }
  }
  // All mirrors failed — use cached manifest if available
  if (manifestCache) {
    console.log('[Mirror] All mirrors failed, using expired cache');
    return manifestCache;
  }
  throw new Error('All mirrors failed and no cached manifest available');
 }
 /**
 * Parse manifest to get available patches for current platform
 * Returns array of { from, to, key, size }
 */
 function getPlatformPatches(manifest, branch = 'release') {
  const os = getOS();
  const arch = getArch();
  const prefix = `${os}/${arch}/${branch}/`;
  const patches = [];
  for (const [key, info] of Object.entries(manifest.files)) {
    if (key.startsWith(prefix) && key.endsWith('.pwr')) {
      const filename = key.slice(prefix.length, -4); // e.g., "0_to_11"
      const match = filename.match(/^(\d+)_to_(\d+)$/);
      if (match) {
        patches.push({
          from: parseInt(match[1]),
          to: parseInt(match[2]),
          key,
          size: info.size
        });
      }
    }
  }
  return patches;
 }
 /**
 * 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
 */
 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] = [];
    edges[patch.from].push(patch);
  }
  const queue = [{ build: currentBuild, path: [], totalSize: 0 }];
  let bestPath = null;
  let bestSize = Infinity;
  while (queue.length > 0) {
    const { build, path, totalSize } = queue.shift();
    if (build === targetBuild) {
      if (totalSize < bestSize) {
        bestPath = path;
        bestSize = totalSize;
      }
      continue;
    }
    if (totalSize >= bestSize) continue;
    const nextEdges = edges[build] || [];
    for (const edge of nextEdges) {
      if (edge.to <= build || edge.to > targetBuild) continue;
      if (path.some(p => p.to === edge.to)) continue;
      queue.push({
        build: edge.to,
        path: [...path, {
          from: edge.from,
          to: edge.to,
          url: `${baseUrl}/${edge.key}`,
          size: edge.size,
          key: edge.key
        }],
        totalSize: totalSize + edge.size
      });
    }
  }
  return bestPath;
 }
 /**
 * Get the optimal update plan from currentBuild to targetBuild
 * Returns { steps: [{from, to, url, size}], totalSize, isFullInstall }
 */
 async function getUpdatePlan(currentBuild, targetBuild, branch = 'release') {
  const manifest = await fetchMirrorManifest();
  const patches = getPlatformPatches(manifest, branch);
  // Try optimal path
  const steps = await findOptimalPatchPath(currentBuild, targetBuild, patches);
  if (steps && steps.length > 0) {
    const totalSize = steps.reduce((sum, s) => sum + s.size, 0);
    console.log(`[Mirror] Update plan: ${steps.map(s => `${s.from}\u2192${s.to}`).join(' + ')} (${(totalSize / 1024 / 1024).toFixed(0)} MB)`);
    return { steps, totalSize, isFullInstall: steps.length === 1 && steps[0].from === 0 };
  }
  // 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: `${baseUrl}/${fullPatch.key}`,
      size: fullPatch.size,
      key: fullPatch.key
    };
    console.log(`[Mirror] Full install: 0\u2192${targetBuild} (${(fullPatch.size / 1024 / 1024).toFixed(0)} MB)`);
    return { steps: [step], totalSize: fullPatch.size, isFullInstall: true };
  }
  throw new Error(`No patch path found from build ${currentBuild} to ${targetBuild} for ${getOS()}/${getArch()}`);
 }
 async function getLatestClientVersion(branch = 'release') {
  try {
-    console.log(`[NewAPI] Fetching latest client version from new API (branch: ${branch})...`);
+    console.log(`[Mirror] Fetching latest client version (branch: ${branch})...`);
    const manifest = await fetchMirrorManifest();
    const patches = getPlatformPatches(manifest, branch);
-    // Utiliser la nouvelle API
+    if (patches.length === 0) {
-    const latestVersion = await getLatestVersionFromNewAPI(branch);
+      console.log(`[Mirror] No patches for branch '${branch}', using fallback`);
-    console.log(`[NewAPI] Latest client version for ${branch}: ${latestVersion}`);
+      return `v${FALLBACK_LATEST_BUILD}`;
-    return latestVersion;
+    }
    const latestBuild = Math.max(...patches.map(p => p.to));
    console.log(`[Mirror] Latest client version: v${latestBuild}`);
    return `v${latestBuild}`;
  } catch (error) {
-    console.error('[NewAPI] Error fetching client version from new API:', error.message);
+    console.error('[Mirror] Error:', error.message);
-    console.log('[NewAPI] Falling back to old API...');
+    return `v${FALLBACK_LATEST_BUILD}`;
  }
 }
 /**
 * Get PWR download URL for fresh install (0 -> target)
 * Backward-compatible with old getPWRUrlFromNewAPI signature
 * Checks mirror first, then constructs URL for the branch
 */
 async function getPWRUrl(branch = 'release', version = 'v11') {
  const targetBuild = extractVersionNumber(version);
  const os = getOS();
  const arch = getArch();
    // Fallback vers l'ancienne API si la nouvelle échoue
  try {
-      const response = await smartRequest(`https://files.hytalef2p.com/api/version_client?branch=${branch}`, {
+    const manifest = await fetchMirrorManifest();
-        timeout: 40000,
+    const patches = getPlatformPatches(manifest, branch);
-        headers: {
+    const fullPatch = patches.find(p => p.from === 0 && p.to === targetBuild);
          'User-Agent': 'Hytale-F2P-Launcher'
        }
      });
-      if (response.data && response.data.client_version) {
+    if (fullPatch) {
-        const version = response.data.client_version;
+      const baseUrl = await getPatchesBaseUrl();
-        console.log(`Latest client version for ${branch} (old API): ${version}`);
+      const url = `${baseUrl}/${fullPatch.key}`;
-        return version;
+      console.log(`[Mirror] PWR URL: ${url}`);
      return url;
    }
    if (patches.length > 0) {
      // Branch exists in mirror but no full patch for this target - construct URL
      console.log(`[Mirror] No 0->${targetBuild} patch found, constructing URL`);
    } else {
-        console.log('Warning: Invalid API response, falling back to latest known version (v8)');
+      console.log(`[Mirror] Branch '${branch}' not in mirror, constructing URL`);
        return 'v8';
      }
    } catch (fallbackError) {
      console.error('Error fetching client version from old API:', fallbackError.message);
      console.log('Warning: Both APIs unavailable, falling back to latest known version (v8)');
      return 'v8';
    }
    }
  } catch (error) {
    console.error('[Mirror] Error getting PWR URL:', error.message);
  }
-// Fonction utilitaire pour extraire le numéro de version
+  // Construct mirror URL (will work if patch was uploaded but manifest is stale)
-// Supporte les formats: "7.pwr", "v8", "v8-windows-amd64.pwr", etc.
+  const baseUrl = await getPatchesBaseUrl();
  return `${baseUrl}/${os}/${arch}/${branch}/0_to_${targetBuild}.pwr`;
 }
 // Backward-compatible alias
 const getPWRUrlFromNewAPI = getPWRUrl;
 // Utility function to extract version number
 // Supports: "7.pwr", "v8", "v8-windows-amd64.pwr", "5_to_10", etc.
 function extractVersionNumber(version) {
  if (!version) return 0;
-  // Nouveau format: "v8" ou "v8-xxx.pwr"
+  // New format: "v8" or "v8-xxx.pwr"
  const vMatch = version.match(/v(\d+)/);
-  if (vMatch) {
+  if (vMatch) return parseInt(vMatch[1]);
    return parseInt(vMatch[1]);
  }
-  // Ancien format: "7.pwr"
+  // Old format: "7.pwr"
  const pwrMatch = version.match(/(\d+)\.pwr/);
-  if (pwrMatch) {
+  if (pwrMatch) return parseInt(pwrMatch[1]);
    return parseInt(pwrMatch[1]);
  }
-  // Fallback: essayer de parser directement
+  // Fallback
  const num = parseInt(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 `${BASE_PATCH_URL}/${os}/${arch}/${branch}/0/${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;
-  } catch (error) {
+  } catch {
    return false;
  }
 }
-async function discoverAvailableVersions(latestKnown, branch = 'release', maxProbe = 50) {
+async function discoverAvailableVersions(latestKnown, branch = 'release') {
  const available = [];
  const latest = extractVersionNumber(latestKnown);
  for (let i = latest; i >= Math.max(1, latest - maxProbe); i--) {
    const exists = await checkArchiveExists(i, branch);
    if (exists) {
      available.push(`${i}.pwr`);
    }
  }
  return available;
 }
 async function fetchPatchManifest(branch = 'release') {
  try {
-    const os = getOS();
+    const manifest = await fetchMirrorManifest();
-    const arch = getArch();
+    const patches = getPlatformPatches(manifest, branch);
-    const response = await smartRequest(`${MANIFEST_API}?branch=${branch}&os=${os}&arch=${arch}`, {
+    const versions = [...new Set(patches.map(p => p.to))].sort((a, b) => b - a);
-      timeout: 10000
+    return versions.map(v => `${v}.pwr`);
-    });
+  } catch {
-    return response.data.patches || {};
+    return [];
  } catch (error) {
    console.error('Failed to fetch patch manifest:', error.message);
    return {};
  }
 }
 async function extractVersionDetails(targetVersion, branch = 'release') {
  const buildNumber = extractVersionNumber(targetVersion);
-  const previousBuild = buildNumber - 1;
+  const fullUrl = await buildArchiveUrl(buildNumber, branch);
  const manifest = await fetchPatchManifest(branch);
  const patchInfo = manifest[buildNumber];
  return {
    version: targetVersion,
-    buildNumber: buildNumber,
+    buildNumber,
    buildName: `HYTALE-Build-${buildNumber}`,
-    fullUrl: patchInfo?.original_url || buildArchiveUrl(buildNumber, branch),
+    fullUrl,
-    differentialUrl: patchInfo?.patch_url || null,
+    differentialUrl: null,
-    checksum: patchInfo?.patch_hash || null,
+    checksum: null,
-    sourceVersion: patchInfo?.from ? `${patchInfo.from}.pwr` : (previousBuild > 0 ? `${previousBuild}.pwr` : null),
+    sourceVersion: null,
-    isDifferential: !!patchInfo?.proper_patch,
+    isDifferential: false,
-    releaseNotes: patchInfo?.patch_note || null
+    releaseNotes: null
  };
 }
-function canUseDifferentialUpdate(currentVersion, targetDetails) {
+function canUseDifferentialUpdate() {
-  if (!targetDetails) return false;
+  // Differential updates are now handled via getUpdatePlan()
-  if (!targetDetails.differentialUrl) return false;
+  return false;
  if (!targetDetails.isDifferential) return false;
  if (!currentVersion) return false;
  const currentBuild = extractVersionNumber(currentVersion);
  const expectedSource = extractVersionNumber(targetDetails.sourceVersion);
  return currentBuild === expectedSource;
 }
 function needsIntermediatePatches(currentVersion, targetVersion) {
  if (!currentVersion) return [];
  const current = extractVersionNumber(currentVersion);
  const target = extractVersionNumber(targetVersion);
-  
+  if (current >= target) return [];
-  const intermediates = [];
+  return [targetVersion];
  for (let i = current + 1; i <= target; i++) {
    intermediates.push(`${i}.pwr`);
  }
  return intermediates;
 }
 async function computeFileChecksum(filePath) {
  return new Promise((resolve, reject) => {
    const hash = crypto.createHash('sha256');
    const stream = fs.createReadStream(filePath);
    stream.on('data', data => hash.update(data));
    stream.on('end', () => resolve(hash.digest('hex')));
    stream.on('error', reject);
@@ -290,7 +503,6 @@ async function computeFileChecksum(filePath) {
 async function validateChecksum(filePath, expectedChecksum) {
  if (!expectedChecksum) return true;
  const actualChecksum = await computeFileChecksum(filePath);
  return actualChecksum === expectedChecksum;
 }
@@ -299,7 +511,7 @@ function getInstalledClientVersion() {
  try {
    const { loadVersionClient } = require('../core/config');
    return loadVersionClient();
-  } catch (err) {
+  } catch {
    return null;
  }
 }
@@ -315,8 +527,13 @@ module.exports = {
  computeFileChecksum,
  validateChecksum,
  getInstalledClientVersion,
-  fetchNewAPI,
+  fetchMirrorManifest,
-  getLatestVersionFromNewAPI,
+  getPWRUrl,
  getPWRUrlFromNewAPI,
-  extractVersionNumber
+  getUpdatePlan,
  extractVersionNumber,
  getPlatformPatches,
  findOptimalPatchPath,
  getPatchesBaseUrl,
  getAllMirrorUrls
 };
--- a/backend/utils/clientPatcher.js
+++ b/backend/utils/clientPatcher.js
@@ -9,7 +9,9 @@ const MAX_DOMAIN_LENGTH = 16;
 // DualAuth ByteBuddy Agent (runtime class transformation, no JAR modification)
 const DUALAUTH_AGENT_URL = 'https://github.com/sanasol/hytale-auth-server/releases/latest/download/dualauth-agent.jar';
 const DUALAUTH_AGENT_VERSION_API = 'https://api.github.com/repos/sanasol/hytale-auth-server/releases/latest';
 const DUALAUTH_AGENT_FILENAME = 'dualauth-agent.jar';
 const DUALAUTH_AGENT_VERSION_FILE = 'dualauth-agent.version';
 function getTargetDomain() {
  if (process.env.HYTALE_AUTH_DOMAIN) {
@@ -511,30 +513,70 @@ class ClientPatcher {
   */
  async ensureAgentAvailable(serverDir, progressCallback) {
    const agentPath = this.getAgentPath(serverDir);
    const versionPath = path.join(serverDir, DUALAUTH_AGENT_VERSION_FILE);
    console.log('=== DualAuth Agent (ByteBuddy) ===');
    console.log(`Target: ${agentPath}`);
-    // Check if agent already exists and is valid
+    // Check local version and whether file exists
    let localVersion = null;
    let agentExists = false;
    if (fs.existsSync(agentPath)) {
      try {
        const stats = fs.statSync(agentPath);
        if (stats.size > 1024) {
-          console.log(`DualAuth Agent present (${(stats.size / 1024).toFixed(0)} KB)`);
+          agentExists = true;
-          if (progressCallback) progressCallback('DualAuth Agent ready', 100);
+          if (fs.existsSync(versionPath)) {
-          return { success: true, agentPath, alreadyExists: true };
+            localVersion = fs.readFileSync(versionPath, 'utf8').trim();
          }
-        // 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);
+    const action = agentExists ? 'Updating' : 'Downloading';
-    console.log(`Downloading from: ${DUALAUTH_AGENT_URL}`);
+    if (progressCallback) progressCallback(`${action} DualAuth Agent...`, 20);
    console.log(`${action} from: ${DUALAUTH_AGENT_URL}`);
    try {
      // Ensure server directory exists
@@ -548,7 +590,7 @@ class ClientPatcher {
      const stream = await smartDownloadStream(DUALAUTH_AGENT_URL, (chunk, downloadedBytes, total) => {
        if (progressCallback && total) {
          const percent = 20 + Math.floor((downloadedBytes / total) * 70);
-          progressCallback(`Downloading agent... ${(downloadedBytes / 1024).toFixed(0)} KB`, percent);
+          progressCallback(`${action} agent... ${(downloadedBytes / 1024).toFixed(0)} KB`, percent);
        }
      });
@@ -575,9 +617,13 @@ class ClientPatcher {
      }
      fs.renameSync(tmpPath, agentPath);
-      console.log(`DualAuth Agent downloaded (${(stats.size / 1024).toFixed(0)} KB)`);
+      // Save version
      const version = remoteVersion || 'unknown';
      fs.writeFileSync(versionPath, version, 'utf8');
      console.log(`DualAuth Agent ${agentExists ? 'updated' : 'downloaded'} (${(stats.size / 1024).toFixed(0)} KB, ${version})`);
      if (progressCallback) progressCallback('DualAuth Agent ready', 100);
-      return { success: true, agentPath };
+      return { success: true, agentPath, updated: agentExists, version };
    } catch (downloadError) {
      console.error(`Failed to download DualAuth Agent: ${downloadError.message}`);
@@ -586,6 +632,11 @@ class ClientPatcher {
      if (fs.existsSync(tmpPath)) {
        try { fs.unlinkSync(tmpPath); } catch (e) { /* ignore */ }
      }
      // If we had an existing agent, still use it
      if (agentExists) {
        console.log('Using existing agent despite update failure');
        return { success: true, agentPath, alreadyExists: true, version: localVersion };
      }
      return { success: false, error: downloadError.message };
    }
  }
--- a/backend/utils/logCollector.js
+++ b/backend/utils/logCollector.js
@@ -0,0 +1,238 @@
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
 const zlib = require('zlib');
 const logger = require('../logger');
 const MAX_FILE_SIZE = 2 * 1024 * 1024; // 2MB per file
 /**
 * Get the HytaleSaves directory (game client logs)
 */
 function getHytaleSavesDir() {
  const home = os.homedir();
  if (process.platform === 'win32') {
    return path.join(home, 'AppData', 'Local', 'HytaleSaves');
  } else if (process.platform === 'darwin') {
    return path.join(home, 'Library', 'Application Support', 'HytaleSaves');
  } else {
    return path.join(home, '.hytalesaves');
  }
 }
 /**
 * Read a log file, capping at MAX_FILE_SIZE (keeps tail/most recent lines)
 */
 function readLogFile(filePath) {
  try {
    const stats = fs.statSync(filePath);
    if (stats.size <= MAX_FILE_SIZE) {
      return fs.readFileSync(filePath, 'utf8');
    }
    // Read only the last MAX_FILE_SIZE bytes
    const fd = fs.openSync(filePath, 'r');
    const buffer = Buffer.alloc(MAX_FILE_SIZE);
    fs.readSync(fd, buffer, 0, MAX_FILE_SIZE, stats.size - MAX_FILE_SIZE);
    fs.closeSync(fd);
    const content = buffer.toString('utf8');
    // Skip first partial line
    const firstNewline = content.indexOf('\n');
    const trimmed = firstNewline >= 0 ? content.substring(firstNewline + 1) : content;
    return `[... truncated ${stats.size - MAX_FILE_SIZE} bytes ...]\n` + trimmed;
  } catch (err) {
    return `[Error reading file: ${err.message}]`;
  }
 }
 /**
 * Get files matching a date pattern from a directory
 */
 function getFilesForDate(dir, dateStr, pattern) {
  if (!fs.existsSync(dir)) return [];
  try {
    return fs.readdirSync(dir)
      .filter(f => f.includes(dateStr) && (pattern ? pattern.test(f) : true))
      .map(f => ({
        name: f,
        path: path.join(dir, f),
        mtime: fs.statSync(path.join(dir, f)).mtime
      }))
      .sort((a, b) => b.mtime - a.mtime);
  } catch (err) {
    return [];
  }
 }
 // ============================================================================
 // ZIP BUILDER (pure Node.js, no dependencies)
 // ============================================================================
 /**
 * CRC32 lookup table
 */
 const crc32Table = new Uint32Array(256);
 for (let i = 0; i < 256; i++) {
  let c = i;
  for (let j = 0; j < 8; j++) {
    c = (c & 1) ? (0xEDB88320 ^ (c >>> 1)) : (c >>> 1);
  }
  crc32Table[i] = c;
 }
 function crc32(buf) {
  let crc = 0xFFFFFFFF;
  for (let i = 0; i < buf.length; i++) {
    crc = crc32Table[(crc ^ buf[i]) & 0xFF] ^ (crc >>> 8);
  }
  return (crc ^ 0xFFFFFFFF) >>> 0;
 }
 /**
 * Create a ZIP file from an array of {name, content} entries
 * Uses DEFLATE compression via built-in zlib
 */
 function createZipBuffer(files) {
  const localHeaders = [];
  const centralEntries = [];
  let offset = 0;
  for (const file of files) {
    const nameBytes = Buffer.from(file.name, 'utf8');
    const contentBytes = Buffer.from(file.content, 'utf8');
    const compressed = zlib.deflateRawSync(contentBytes);
    const crcVal = crc32(contentBytes);
    // Local file header (30 bytes + filename)
    const local = Buffer.alloc(30);
    local.writeUInt32LE(0x04034b50, 0);   // signature
    local.writeUInt16LE(20, 4);            // version needed
    local.writeUInt16LE(0, 6);             // flags
    local.writeUInt16LE(8, 8);             // compression: DEFLATE
    local.writeUInt16LE(0, 10);            // mod time
    local.writeUInt16LE(0, 12);            // mod date
    local.writeUInt32LE(crcVal, 14);       // crc32
    local.writeUInt32LE(compressed.length, 18); // compressed size
    local.writeUInt32LE(contentBytes.length, 22); // uncompressed size
    local.writeUInt16LE(nameBytes.length, 26);    // filename length
    local.writeUInt16LE(0, 28);            // extra field length
    localHeaders.push(local, nameBytes, compressed);
    // Central directory entry (46 bytes + filename)
    const central = Buffer.alloc(46);
    central.writeUInt32LE(0x02014b50, 0);  // signature
    central.writeUInt16LE(20, 4);           // version made by
    central.writeUInt16LE(20, 6);           // version needed
    central.writeUInt16LE(0, 8);            // flags
    central.writeUInt16LE(8, 10);           // compression
    central.writeUInt16LE(0, 12);           // mod time
    central.writeUInt16LE(0, 14);           // mod date
    central.writeUInt32LE(crcVal, 16);      // crc32
    central.writeUInt32LE(compressed.length, 20); // compressed size
    central.writeUInt32LE(contentBytes.length, 24); // uncompressed size
    central.writeUInt16LE(nameBytes.length, 28);    // filename length
    central.writeUInt16LE(0, 30);           // extra field length
    central.writeUInt16LE(0, 32);           // comment length
    central.writeUInt16LE(0, 34);           // disk number
    central.writeUInt16LE(0, 36);           // internal attrs
    central.writeUInt32LE(0, 38);           // external attrs
    central.writeUInt32LE(offset, 42);      // local header offset
    centralEntries.push(central, nameBytes);
    offset += 30 + nameBytes.length + compressed.length;
  }
  const centralDirBuf = Buffer.concat(centralEntries);
  // End of central directory (22 bytes)
  const eocd = Buffer.alloc(22);
  eocd.writeUInt32LE(0x06054b50, 0);       // signature
  eocd.writeUInt16LE(0, 4);                // disk number
  eocd.writeUInt16LE(0, 6);                // cd disk number
  eocd.writeUInt16LE(files.length, 8);     // entries on disk
  eocd.writeUInt16LE(files.length, 10);    // total entries
  eocd.writeUInt32LE(centralDirBuf.length, 12); // cd size
  eocd.writeUInt32LE(offset, 16);          // cd offset
  eocd.writeUInt16LE(0, 20);              // comment length
  return Buffer.concat([...localHeaders, centralDirBuf, eocd]);
 }
 // ============================================================================
 /**
 * Collect all relevant logs for submission
 * Returns { files: [{name, content}], meta: {username, platform, version} }
 */
 function collectLogs() {
  const files = [];
  const today = new Date();
  const todayStr = today.toISOString().split('T')[0]; // YYYY-MM-DD
  const yesterday = new Date(today);
  yesterday.setDate(yesterday.getDate() - 1);
  const yesterdayStr = yesterday.toISOString().split('T')[0];
  // 1. Launcher logs
  const launcherLogDir = logger.getLogDirectory();
  if (launcherLogDir && fs.existsSync(launcherLogDir)) {
    // Today's launcher logs
    const todayLogs = getFilesForDate(launcherLogDir, todayStr, /^launcher-.*\.log$/);
    for (const f of todayLogs) {
      files.push({ name: `launcher/${f.name}`, content: readLogFile(f.path) });
    }
    // Most recent from yesterday (just one)
    const yesterdayLogs = getFilesForDate(launcherLogDir, yesterdayStr, /^launcher-.*\.log$/);
    if (yesterdayLogs.length > 0) {
      files.push({ name: `launcher/${yesterdayLogs[0].name}`, content: readLogFile(yesterdayLogs[0].path) });
    }
  }
  // 2. Game client logs
  const savesDir = getHytaleSavesDir();
  const clientLogDir = path.join(savesDir, 'Logs');
  if (fs.existsSync(clientLogDir)) {
    const clientLogs = getFilesForDate(clientLogDir, todayStr, /client\.log$/);
    for (const f of clientLogs) {
      files.push({ name: `client/${f.name}`, content: readLogFile(f.path) });
    }
  }
  // 3. Config snapshot
  const appDir = logger.getAppDir ? logger.getAppDir() : logger.getInstallPath();
  const configPath = path.join(appDir, 'config.json');
  if (fs.existsSync(configPath)) {
    try {
      const configContent = fs.readFileSync(configPath, 'utf8');
      files.push({ name: 'config.json', content: configContent });
    } catch (err) {
      files.push({ name: 'config.json', content: `[Error reading config: ${err.message}]` });
    }
  }
  // Build metadata
  const { app } = require('electron');
  let username = 'unknown';
  try {
    const configFile = path.join(appDir, 'config.json');
    if (fs.existsSync(configFile)) {
      const cfg = JSON.parse(fs.readFileSync(configFile, 'utf8'));
      username = cfg.username || cfg.playerName || 'unknown';
    }
  } catch (err) {}
  return {
    files,
    meta: {
      username,
      platform: `${process.platform}-${process.arch}`,
      version: app.getVersion()
    }
  };
 }
 module.exports = { collectLogs, createZipBuffer };
--- a/backend/utils/platformUtils.js
+++ b/backend/utils/platformUtils.js
@@ -164,8 +164,14 @@ function detectGpuLinux() {
    const isAmd = lowerLine.includes('amd') || lowerLine.includes('radeon') || vendorId === '1002';
    const isIntel = lowerLine.includes('intel') || vendorId === '8086';
-    // Intel Arc detection
+    // Intel Arc discrete GPU detection
-    const isIntelArc = isIntel && (lowerName.includes('arc') || lowerName.includes('a770') || lowerName.includes('a750') || lowerName.includes('a380'));
+    // Discrete Arc cards have specific model numbers: A310, A380, A580, A750, A770, B570, B580
    // Integrated "Intel Arc Graphics" (Meteor Lake, Lunar Lake, Arrow Lake) have NO model suffix
    // and sit on bus 00 (slot 00:02.0) — these are iGPUs, not dGPUs
    const pciSlot = line.split(' ')[0] || '';
    const pciBus = parseInt(pciSlot.split(':')[0], 16) || 0;
    const hasArcModelNumber = isIntel && /\b[ab]\d{3}\b/i.test(lowerName);
    const isIntelArc = isIntel && (hasArcModelNumber || (lowerName.includes('arc') && pciBus > 0));
    let vendor = 'unknown';
    if (isNvidia) vendor = 'nvidia';
--- a/dev-app-update.yml
+++ b/dev-app-update.yml
@@ -1,3 +1,2 @@
-provider: github
+provider: generic
-owner: amiayweb # Change to your own GitHub username
+url: https://git.sanhost.net/sanasol/hytale-f2p/releases/download/latest
 repo: Hytale-F2P
--- a/main.js
+++ b/main.js
@@ -84,12 +84,12 @@ function setDiscordActivity() {
      largeImageText: 'Hytale F2P Launcher',
      buttons: [
        {
-          label: 'GitHub',
+          label: 'Download',
-          url: 'https://github.com/amiayweb/Hytale-F2P'
+          url: 'https://git.sanhost.net/sanasol/hytale-f2p/releases'
        },
        {
          label: 'Discord',
-          url: 'https://discord.gg/hf2pdc'
+          url: 'https://discord.gg/Fhbb9Yk5WW'
        }
      ]
    });
@@ -964,8 +964,8 @@ ipcMain.handle('open-external', async (event, url) => {
 ipcMain.handle('open-download-page', async () => {
  try {
-    // Open GitHub releases page for manual download
+    // Open Forgejo releases page for manual download
-    await shell.openExternal('https://github.com/amiayweb/Hytale-F2P/releases/latest');
+    await shell.openExternal('https://git.sanhost.net/sanasol/hytale-f2p/releases/latest');
    return { success: true };
  } catch (error) {
    console.error('Failed to open download page:', error);
@@ -1407,6 +1407,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();
--- a/package.json
+++ b/package.json
@@ -1,8 +1,8 @@
 {
  "name": "hytale-f2p-launcher",
-  "version": "2.2.2",
+  "version": "2.4.0",
  "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 .",
@@ -118,9 +118,8 @@
      "createStartMenuShortcut": true
    },
    "publish": {
-      "provider": "github",
+      "provider": "generic",
-      "owner": "amiayweb",
+      "url": "https://git.sanhost.net/sanasol/hytale-f2p/releases/download/latest"
      "repo": "Hytale-F2P"
    }
  }
 }
--- a/preload.js
+++ b/preload.js
@@ -94,6 +94,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'),
--- 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
sanasol	19c8991a44	v2.4.0: Add Send Logs, fix Intel Arc iGPU misdetection - Add Send Logs button for one-click log submission to support - Fix Intel Arc Graphics (Meteor Lake/Lunar Lake) on bus 00 being classified as discrete GPU instead of integrated	2026-02-24 13:57:10 +01:00
sanasol	320ca54758	Add Send Logs button for one-click log submission to support Collects launcher logs, game client logs, and config snapshot into a ZIP file and uploads to auth server. Shows submission ID for sharing with support. Includes i18n for all 11 locales.	2026-02-24 13:50:23 +01:00
sanasol	e14d56ef48	v2.3.9: Fix stalled processes and AOT cache crash - Auto-kill stalled HytaleClient/java processes before launch and repair (cross-platform: Windows taskkill+PowerShell, macOS/Linux pkill) - Remove HytaleServer.aot before launch to prevent incompatible AOT cache causing fastutil ClassNotFoundException on singleplayer - safeRemoveDirectory auto-kills processes on EPERM/EBUSY before retry Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-24 12:52:07 +01:00
sanasol	a649bf1fcc	Update README: replace outdated GitHub URL with Forgejo URL for start.sh script	2026-02-23 03:12:39 +01:00
sanasol	66faa1bb1e	Update README files with free hosted server instructions Added detailed steps to set up a free Hytale server via play.hosting in both README files. Updated outdated URLs for the F2P Launcher to the new repository location. Improved clarity in self-hosted setup sections.	2026-02-23 03:11:02 +01:00
sanasol	a63e026700	Server setup video	2026-02-23 01:02:16 +01:00
sanasol	552ec42d6c	Add one-click dedicated server scripts for Hytale F2P - server/start.sh: Linux/macOS starter with auto-download, auto-update, F2P launcher detection (game files + bundled JRE), and token fetch - server/start.bat: Windows equivalent using PowerShell for JSON/UUID - server/README.md: Beginner-friendly guide with playit.gg networking - Remove obsolete server_scripts_2.zip Scripts auto-detect F2P launcher install (including custom installPath from config.json), copy game files locally if available, download missing files (HytaleServer.jar, Assets.zip, dualauth-agent.jar), and check for updates on every launch via ETag/GitHub releases API.	2026-02-23 00:55:38 +01:00
sanasol	fb90277be9	Fix Arabic RTL support: correct locale code and CSS syntax - Rename ar-AR to ar-SA (valid BCP 47 code for Saudi Arabia) - Fix missing dot in CSS selector: .news-section .news-header - Add trailing newline to ar-SA.json Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-22 23:00:08 +01:00
sanasol	27c220a757	Merge pull request 'Arabic and RTL support added' (#1 ) from Yugurten/hytale-f2p:develop into develop	2026-02-22 21:58:25 +00:00
Finix	30929ee0da	Arabic and RTL support added	2026-02-22 19:25:01 +00:00
sanasol	44834e7d12	Bump version to 2.3.8 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-21 23:47:52 +01:00
sanasol	cb7f7e51bf	v2.3.8: auto-update agent from GitHub releases, add dl1 mirror fallback - Agent auto-update: check GitHub releases API for new versions, download only when update available, track version in .version file - Add dl1.htdwnldsan.top as backup-2 mirror in patches config sources - Add dl1.htdwnldsan.top as primary non-Cloudflare mirror - Graceful fallback: use existing agent if update check or download fails Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-21 23:31:28 +01:00
sanasol	9b20c454d3	v2.3.7: add non-Cloudflare mirror fallback for blocked regions Users in Russia/Ukraine where Cloudflare IPs are blocked can now download game files via htdwnldsan.top (direct VPS → MEGA redirect). Both manifest fetch and archive downloads try mirrors automatically on ETIMEDOUT/ECONNREFUSED errors. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-21 13:21:19 +01:00
sanasol	4e04d657b7	v2.3.6: fix UUID loss during launcher updates Players were losing character data (inventory, armor, backpack) after each launcher update because config.json corruption wiped the UUID mapping. Same username, new UUID = server treats as new player. Fix: UUIDs now stored in separate uuid-store.json that saveConfig() can never touch. Added safety check to refuse destructive writes when config file exists but loads empty. Includes 28 regression tests. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-20 23:10:13 +01:00
sanasol	6d811fd7e0	v2.3.5: hardened fallback chain for patch URL discovery 6-step fallback: auth.sanasol.ws → htdwnldsan.top → DNS TXT via DoH → disk cache → hardcoded URL. Practically unkillable by DMCA. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-20 20:22:57 +01:00
sanasol	8435fc698c	fix: replace GitHub URLs with Forgejo after DMCA takedown GitHub repo amiayweb/Hytale-F2P was DMCA'd. Updated Discord RPC link, download page URL, and homepage to point to Forgejo instance. Auto-update already pointed to git.sanhost.net (no change needed). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-20 19:32:37 +01:00
sanasol	6c369edb0f	v2.3.4: dynamic patches URL from auth server Launcher now fetches patches base URL from /api/patches-config endpoint instead of using hardcoded domain. URL cached for 5 minutes, no fallback to hardcoded domain - requires auth server connection or cached URL. Enables instant CDN switching without launcher updates. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-20 19:27:55 +01:00
sanasol	fdd8e59ec4	v2.3.3: fix singleplayer crash when install path has spaces JAVA_TOOL_OPTIONS -javaagent path was not quoted, causing JVM to truncate at first space. Affects all users with spaces in install path (e.g. "Hytale F2P Launcher"). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-20 15:54:17 +01:00
sanasol	e7a033932f	v2.3.2: fix truncated download cache, update Discord link Fix pre-release downloads failing with "unexpected EOF" by validating cached PWR file sizes against manifest expected sizes. Previously only checked > 1MB which accepted truncated files. Also update Discord invite link to new server across all files. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-20 15:14:20 +01:00
sanasol	11c6d40dfe	chore: remove private docs from repo Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-20 14:38:34 +01:00
sanasol	0dafb17c7b	v2.3.1: CDN redirect gateway, fix token username bug - Migrate patch downloads to auth server redirect gateway (302 -> CDN) Allows instant CDN switching via admin panel without launcher update - Fix identity token "Player" username mismatch on fresh install Add token username verification with retry in fetchAuthTokens - Refactor versionManager to use mirror manifest via auth.sanasol.ws/patches - Add optimal patch routing (BFS) for differential updates - Add PATCH_CDN_INFRASTRUCTURE.md documentation Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-20 14:36:09 +01:00
sanasol	66112f15b2	fix: use placeholder publish URL (runtime resolver overrides it) The actual update URL is resolved dynamically via Forgejo API in _resolveUpdateUrl() before each update check. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-20 12:08:30 +01:00
sanasol	0a71fdac8c	v2.3.0: migrate auto-update to Forgejo, add Arch build - Switch auto-update from GitHub to Forgejo (generic provider) - Dynamically resolve latest release URL via Forgejo API - Add pacman target to Linux builds - Hide direct upload URL in repository secret Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-20 11:55:35 +01:00