docs: Update crash investigation - no stable solution found

- jemalloc helps ~30% of the time but not reliable
- Documented all failed approaches (allocators, scheduling, patching variations)
- Added potential alternative approaches (network hooking, proxy, container)
- Status: UNSOLVED

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -41,17 +41,17 @@ body:
       required: true
 
   - type: textarea
-    id: proof
+    id: screenshots
     attributes:
-      label: Screenshots/Recordings
-      description: If applicable, add Screenshots/Recordings to help explain your problem.
+      label: Screenshots
+      description: If applicable, add screenshots to help explain your problem.
 
   - type: input
     id: version
     attributes:
       label: Version
       description: What version of the launcher are you running?
-      placeholder: "e.g. \"v2.2.0 stable\""
+      placeholder: "e.g. \"v2.0.11 stable/pre-release\""
     validations:
       required: true
 
@@ -60,7 +60,7 @@ body:
     attributes:
       label: Hardware Specification
       description: Tell us your CPU, iGPU, dGPU, VRAM, and RAM information.
-      placeholder: "CPU: Intel i9-14900K 6.0 GHz | GPU: NVIDIA RTX 4090 24 GB VRAM | RAM: 32 GB"
+      placeholder: "CPU: Intel i9-14900K 6.0 GHz | GPU: NVIDIA RTX 4090 | VRAM: 24 GB | RAM: 32 GB"
     validations:
       required: true
 
@@ -70,11 +70,13 @@ body:
       label: Operating System
       description: What operating system are you using?
       options:
-        - Windows 11/10
-        - macOS (Apple Silicon, M1/M2/M3)
-        - Linux Ubuntu/Debian-based (Linux Mint, Pop!_OS, etc.)
-        - Linux Fedora/RHEL-based (Fedora, CentOS, etc.)
-        - Linux Arch-based (Steamdeck, CachyOS, etc.)
+        - Windows 10
+        - Windows 11
+        - macOS (Apple Silicon)
+        - macOS (Intel)
+        - Linux Ubuntu/Debian-based
+        - Linux Fedora/RHEL-based
+        - Linux Arch-based
     validations:
       required: true
 

.github/ISSUE_TEMPLATE/support_request.yml

@@ -1,22 +1,8 @@
 name: Support Request
 description: Request help or support
-title: "[SUPPORT] <ADD YOUR TITLE HERE>"
+title: "[SUPPORT] "
 labels: ["support"]
 body:
-  - type: dropdown
-    id: acknowledge
-    attributes: 
-      label: Checklist
-      options:
-        - label: I have read the README.md before asking Support Request.
-          required: true
-        - label: I have read the TROUBLESHOOTING.md before asking Support Request.
-          required: true
-        - label: I have added title before submitting this Support Request.
-          required: true
-        - label: I acknowledge that my Support Request will not be responded as quick as in Discord Open-A-Ticket, I prefer this way.
-          required: true
-
   - type: markdown
     attributes:
       value: |
@@ -38,16 +24,10 @@ body:
     attributes:
       label: Context
       description: Provide any relevant context or background information.
-      placeholder: "I've tried these steps, but got..."
+      placeholder: "I've tried..., but got..."
     validations:
       required: true
 
-  - type: textarea
-    id: proof
-    attributes:
-      label: Screenshots/Recordings
-      description: If applicable, add Screenshots/Recordings to help explain your problem.
-
   - type: textarea
     id: hardwarespec
     attributes:
@@ -57,17 +37,12 @@ body:
     validations:
       required: true
 
-  - type: dropdown
+  - type: input
     id: version
     attributes:
       label: Version
-      description: What launcher version are you using?
-      options:
-        - v2.2.0
-        - v2.1.1
-        - v2.1.0
-        - v2.0.11
-        - v2.0.2
+      description: What version are you using?
+      placeholder: "e.g. v2.0.11 stable/pre-release"
     validations:
       required: true
 
@@ -77,11 +52,13 @@ body:
       label: Platform
       description: What platform are you using?
       options:
-        - Windows 11/10
-        - macOS (Apple Silicon, M1/M2/M3)
-        - Linux Ubuntu/Debian-based (Linux Mint, Pop!_OS, etc.)
-        - Linux Fedora/RHEL-based (Fedora, CentOS, etc.)
-        - Linux Arch-based (Steamdeck, CachyOS, etc.)
+        - Windows 10
+        - Windows 11
+        - macOS (Apple Silicon)
+        - macOS (Intel)
+        - Linux Ubuntu/Debian-based
+        - Linux Fedora/RHEL-based
+        - Linux Arch-based
     validations:
       required: true
 

.github/workflows/release.yml

@@ -2,6 +2,8 @@ name: Build and Release
 
 on:
   push:
+    branches:
+      - main
     tags:
       - 'v*'
   workflow_dispatch:
@@ -16,7 +18,7 @@ jobs:
           node-version: '22'
           cache: 'npm'
       - run: npm ci
-
+      
       - name: Build Windows Packages
         run: npx electron-builder --win --publish never
       - uses: actions/upload-artifact@v4
@@ -27,10 +29,8 @@ jobs:
             dist/*.exe.blockmap
             dist/latest.yml
 
-  # macOS ARM64 build (Apple Silicon)
-  build-macos-arm64:
-    runs-on: macos-latest  # ARM64 runner for native Apple Silicon builds
-    timeout-minutes: 120
+  build-macos:
+    runs-on: macos-latest
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
@@ -39,75 +39,15 @@ jobs:
           cache: 'npm'
       - run: npm ci
 
-      - name: Build macOS ARM64 Package
-        env:
-          # Code signing
-          CSC_LINK: ${{ secrets.CSC_LINK }}
-          CSC_KEY_PASSWORD: ${{ secrets.CSC_KEY_PASSWORD }}
-          # Notarization
-          APPLE_ID: ${{ secrets.APPLE_ID }}
-          APPLE_APP_SPECIFIC_PASSWORD: ${{ secrets.APPLE_APP_SPECIFIC_PASSWORD }}
-          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
-        run: npx electron-builder --mac --arm64 --publish never
-
-      - name: Rename ARM64 artifacts for clarity
-        run: |
-          cd dist
-          for f in *.dmg; do
-            [ -f "$f" ] && mv "$f" "${f%.dmg}-arm64.dmg" 2>/dev/null || true
-          done
-          for f in *.zip; do
-            [ -f "$f" ] && mv "$f" "${f%.zip}-arm64.zip" 2>/dev/null || true
-          done
-          ls -la
-
+      - name: Build macOS Packages
+        run: npx electron-builder --mac --publish never
       - uses: actions/upload-artifact@v4
         with:
-          name: macos-arm64-builds
-          path: |
-            dist/*.dmg
-            dist/*.zip
-
-  # macOS x64 build (Intel)
-  build-macos-x64:
-    runs-on: macos-15-large  # Intel runner for native x64 builds
-    timeout-minutes: 120
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '22'
-          cache: 'npm'
-      - run: npm ci
-
-      - name: Build macOS x64 Package
-        env:
-          # Code signing
-          CSC_LINK: ${{ secrets.CSC_LINK }}
-          CSC_KEY_PASSWORD: ${{ secrets.CSC_KEY_PASSWORD }}
-          # Notarization
-          APPLE_ID: ${{ secrets.APPLE_ID }}
-          APPLE_APP_SPECIFIC_PASSWORD: ${{ secrets.APPLE_APP_SPECIFIC_PASSWORD }}
-          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
-        run: npx electron-builder --mac --x64 --publish never
-
-      - name: Rename x64 artifacts for clarity
-        run: |
-          cd dist
-          for f in *.dmg; do
-            [ -f "$f" ] && mv "$f" "${f%.dmg}-x64.dmg" 2>/dev/null || true
-          done
-          for f in *.zip; do
-            [ -f "$f" ] && mv "$f" "${f%.zip}-x64.zip" 2>/dev/null || true
-          done
-          ls -la
-
-      - uses: actions/upload-artifact@v4
-        with:
-          name: macos-x64-builds
+          name: macos-builds
           path: |
             dist/*.dmg
             dist/*.zip
+            dist/latest-mac.yml
 
   build-linux:
     runs-on: ubuntu-latest
@@ -117,7 +57,7 @@ jobs:
         run: |
           sudo apt-get update
           sudo apt-get install -y libarchive-tools
-
+          
       - uses: actions/setup-node@v4
         with:
           node-version: '22'
@@ -126,7 +66,7 @@ jobs:
 
       - name: Build Linux Packages
         run: |
-          npx electron-builder --linux AppImage deb rpm --publish never
+          npx electron-builder --linux AppImage deb rpm --x64 --arm64 --publish never
       - uses: actions/upload-artifact@v4
         with:
           name: linux-builds
@@ -146,7 +86,7 @@ jobs:
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
-
+          
       - name: Install base packages
         run: |
           pacman -Syu --noconfirm
@@ -174,53 +114,35 @@ jobs:
           makepkg -s --noconfirm
           EOF
 
-      - name: Fix permissions for upload
-        if: always()
-        run: |
-          sudo chown -R $(id -u):$(id -g) .
-
       - name: Upload Arch Package
         uses: actions/upload-artifact@v4
         with:
           name: arch-package
           path: |
             *.pkg.tar.zst
+            *.src.tar.zst
             .SRCINFO
-          include-hidden-files: true
 
-  # Create release with Windows, Linux, Arch (fast builds)
   release:
-    needs: [build-windows, build-linux, build-arch]
+    needs: [build-windows, build-macos, build-linux, build-arch]
     runs-on: ubuntu-latest
     if: |
-      startsWith(github.ref, 'refs/tags/v') ||
-      github.ref == 'refs/heads/main' ||
+      startsWith(github.ref, 'refs/tags/v') || 
+      github.ref == 'refs/heads/main' || 
       github.event_name == 'workflow_dispatch'
 
     permissions:
       contents: write
 
     steps:
+      # FIX: './package.json' Module Not Found in `Get version` step
       - name: Checkout code
         uses: actions/checkout@v4
 
-      - name: Download Windows artifacts
+      - name: Download all artifacts
         uses: actions/download-artifact@v4
         with:
-          name: windows-builds
-          path: artifacts/windows-builds
-
-      - name: Download Linux artifacts
-        uses: actions/download-artifact@v4
-        with:
-          name: linux-builds
-          path: artifacts/linux-builds
-
-      - name: Download Arch artifacts
-        uses: actions/download-artifact@v4
-        with:
-          name: arch-package
-          path: artifacts/arch-package
+          path: artifacts
 
       - name: Display structure of downloaded files
         run: ls -R artifacts
@@ -233,74 +155,18 @@ jobs:
         uses: softprops/action-gh-release@v2
         with:
           tag_name: ${{ github.ref_name }}
+          # If it's a tag, use the tag. 
+          # tag_name: ${{ github.ref_type == 'tag' && github.ref_name || format('v{0}.r{1}', steps.pkg_version.outputs.VERSION, github.run_number) }}
+          # If it's the 'release' branch, use 'v2.0.2-beta.r42'
+          # name: ${{ github.ref_type == 'tag' && github.ref_name || format('v{0}-beta.r{1}', steps.pkg_version.outputs.VERSION, github.run_number) }}
           files: |
             artifacts/arch-package/*.pkg.tar.zst
             artifacts/arch-package/*.src.tar.zst
             artifacts/arch-package/.SRCINFO
-            artifacts/linux-builds/*
-            artifacts/windows-builds/*
+            artifacts/linux-builds/**/*
+            artifacts/windows-builds/**/*
+            artifacts/macos-builds/**/*
           generate_release_notes: true
           draft: true
           prerelease: false
-
-  # Upload macOS ARM64 builds separately
-  release-macos-arm64:
-    needs: [build-macos-arm64, release]
-    runs-on: ubuntu-latest
-    if: |
-      startsWith(github.ref, 'refs/tags/v') ||
-      github.ref == 'refs/heads/main' ||
-      github.event_name == 'workflow_dispatch'
-
-    permissions:
-      contents: write
-
-    steps:
-      - name: Download macOS ARM64 artifacts
-        uses: actions/download-artifact@v4
-        with:
-          name: macos-arm64-builds
-          path: artifacts/macos-arm64-builds
-
-      - name: Display macOS ARM64 files
-        run: ls -R artifacts
-
-      - name: Upload macOS ARM64 to Release
-        uses: softprops/action-gh-release@v2
-        with:
-          tag_name: ${{ github.ref_name }}
-          files: |
-            artifacts/macos-arm64-builds/*
-          draft: true
-          prerelease: false
-
-  # Upload macOS x64 builds separately
-  release-macos-x64:
-    needs: [build-macos-x64, release]
-    runs-on: ubuntu-latest
-    if: |
-      startsWith(github.ref, 'refs/tags/v') ||
-      github.ref == 'refs/heads/main' ||
-      github.event_name == 'workflow_dispatch'
-
-    permissions:
-      contents: write
-
-    steps:
-      - name: Download macOS x64 artifacts
-        uses: actions/download-artifact@v4
-        with:
-          name: macos-x64-builds
-          path: artifacts/macos-x64-builds
-
-      - name: Display macOS x64 files
-        run: ls -R artifacts
-
-      - name: Upload macOS x64 to Release
-        uses: softprops/action-gh-release@v2
-        with:
-          tag_name: ${{ github.ref_name }}
-          files: |
-            artifacts/macos-x64-builds/*
-          draft: true
-          prerelease: false
+          

GUI/js/chat.js

@@ -0,0 +1,500 @@
+
+let socket = null;
+let isAuthenticated = false;
+let messageQueue = [];
+let chatUsername = '';
+let userColor = '#3498db';
+let userBadge = null;
+const SOCKET_URL = 'https://chat.hytalef2p.com';
+const MAX_MESSAGE_LENGTH = 500;
+
+async function getOrCreatePlayerId() {
+  return `user_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+}
+
+export async function initChat() {
+  if (window.electronAPI?.loadChatUsername) {
+    chatUsername = await window.electronAPI.loadChatUsername();
+  }
+  
+  if (window.electronAPI?.loadChatColor) {
+    const savedColor = await window.electronAPI.loadChatColor();
+    if (savedColor) {
+      userColor = savedColor;
+    }
+  }
+
+  if (!chatUsername || chatUsername.trim() === '') {
+    showUsernameModal();
+    return;
+  }
+
+  setupChatUI();
+  setupColorSelector();
+  await connectToChat();
+}
+
+function showUsernameModal() {
+  const modal = document.getElementById('chatUsernameModal');
+  if (modal) {
+    modal.style.display = 'flex';
+    
+    const input = document.getElementById('chatUsernameInput');
+    if (input) {
+      setTimeout(() => input.focus(), 100);
+    }
+  }
+}
+
+function hideUsernameModal() {
+  const modal = document.getElementById('chatUsernameModal');
+  if (modal) {
+    modal.style.display = 'none';
+  }
+}
+
+async function submitChatUsername() {
+  const input = document.getElementById('chatUsernameInput');
+  const errorMsg = document.getElementById('chatUsernameError');
+  
+  if (!input) return;
+
+  const username = input.value.trim();
+
+  if (username.length === 0) {
+    if (errorMsg) errorMsg.textContent = 'Username cannot be empty';
+    return;
+  }
+
+  if (username.length < 3) {
+    if (errorMsg) errorMsg.textContent = 'Username must be at least 3 characters';
+    return;
+  }
+
+  if (username.length > 20) {
+    if (errorMsg) errorMsg.textContent = 'Username must be 20 characters or less';
+    return;
+  }
+
+  if (!/^[a-zA-Z0-9_-]+$/.test(username)) {
+    if (errorMsg) errorMsg.textContent = 'Username can only contain letters, numbers, - and _';
+    return;
+  }
+
+  chatUsername = username;
+  if (window.electronAPI?.saveChatUsername) {
+    await window.electronAPI.saveChatUsername(username);
+  }
+
+  hideUsernameModal();
+
+  setupChatUI();
+  await connectToChat();
+}
+
+function setupChatUI() {
+  const sendBtn = document.getElementById('chatSendBtn');
+  const chatInput = document.getElementById('chatInput');
+  const chatMessages = document.getElementById('chatMessages');
+
+  if (!sendBtn || !chatInput || !chatMessages) {
+    console.warn('Chat UI elements not found');
+    return;
+  }
+
+  sendBtn.addEventListener('click', () => {
+    sendMessage();
+  });
+
+  chatInput.addEventListener('keypress', (e) => {
+    if (e.key === 'Enter' && !e.shiftKey) {
+      e.preventDefault();
+      sendMessage();
+    }
+  });
+
+  chatInput.addEventListener('input', () => {
+    if (chatInput.value.length > MAX_MESSAGE_LENGTH) {
+      chatInput.value = chatInput.value.substring(0, MAX_MESSAGE_LENGTH);
+    }
+    updateCharCounter();
+  });
+
+  updateCharCounter();
+}
+
+async function connectToChat() {
+  try {
+    if (!window.io) {
+      await loadSocketIO();
+    }
+
+    const userId = await window.electronAPI?.getUserId();
+
+    if (!userId) {
+      console.error('User ID not available');
+      addSystemMessage('Error: Could not connect to chat');
+      return;
+    }
+
+    if (!chatUsername || chatUsername.trim() === '') {
+      console.error('Chat username not set');
+      addSystemMessage('Error: Username not set');
+      return;
+    }
+
+    socket = io(SOCKET_URL, {
+      transports: ['websocket', 'polling'],
+      reconnection: true,
+      reconnectionAttempts: 5,
+      reconnectionDelay: 1000
+    });
+
+    socket.on('connect', async () => {
+      console.log('Connected to chat server');
+      
+      const uuid = await window.electronAPI?.getCurrentUuid();
+      
+      socket.emit('authenticate', { 
+        username: chatUsername, 
+        userId,
+        uuid: uuid,
+        userColor: userColor
+      });
+    });
+
+    socket.on('authenticated', (data) => {
+      isAuthenticated = true;
+      userBadge = data.badge; 
+      addSystemMessage(`Connected as ${data.username}`);
+      
+      while (messageQueue.length > 0) {
+        const msg = messageQueue.shift();
+        socket.emit('send_message', { message: msg });
+      }
+    });
+
+    socket.on('message', (data) => {
+      if (data.type === 'system') {
+        addSystemMessage(data.message);
+      } else if (data.type === 'user') {
+        addUserMessage(data.username, data.message, data.timestamp, data.userColor, data.badge);
+      }
+    });
+
+    socket.on('users_update', (data) => {
+      updateOnlineCount(data.count);
+    });
+
+    socket.on('error', (data) => {
+      addSystemMessage(`Error: ${data.message}`, 'error');
+    });
+
+    socket.on('clear_chat', (data) => {
+      clearAllMessages();
+      addSystemMessage(data.message || 'Chat cleared by server', 'warning');
+    });
+
+    socket.on('disconnect', () => {
+      isAuthenticated = false;
+      console.log('Disconnected from chat server');
+      addSystemMessage('Disconnected from chat', 'error');
+    });
+
+    socket.on('connect_error', (error) => {
+      console.error('Connection error:', error);
+      addSystemMessage('Connection error. Retrying...', 'error');
+    });
+
+  } catch (error) {
+    console.error('Error connecting to chat:', error);
+    addSystemMessage('Failed to connect to chat server', 'error');
+  }
+}
+
+function loadSocketIO() {
+  return new Promise((resolve, reject) => {
+    const script = document.createElement('script');
+    script.src = 'https://cdn.socket.io/4.6.1/socket.io.min.js';
+    script.onload = resolve;
+    script.onerror = reject;
+    document.head.appendChild(script);
+  });
+}
+
+function sendMessage() {
+  const chatInput = document.getElementById('chatInput');
+  const message = chatInput.value.trim();
+
+  if (!message || message.length === 0) {
+    return;
+  }
+
+  if (message.length > MAX_MESSAGE_LENGTH) {
+    addSystemMessage(`Message too long (max ${MAX_MESSAGE_LENGTH} characters)`, 'error');
+    return;
+  }
+
+  if (!socket || !isAuthenticated) {
+    messageQueue.push(message);
+    addSystemMessage('Connecting... Your message will be sent soon.', 'warning');
+    chatInput.value = '';
+    updateCharCounter();
+    return;
+  }
+
+  socket.emit('send_message', { message });
+  
+  chatInput.value = '';
+  updateCharCounter();
+}
+
+function addUserMessage(username, message, timestamp, userColor = '#3498db', badge = null) {
+  const chatMessages = document.getElementById('chatMessages');
+  if (!chatMessages) return;
+
+  const messageDiv = document.createElement('div');
+  messageDiv.className = 'chat-message user-message';
+
+  const time = new Date(timestamp).toLocaleTimeString('en-US', {
+    hour: '2-digit',
+    minute: '2-digit'
+  });
+
+  let badgeHTML = '';
+  if (badge) {
+    let badgeStyle = '';
+    if (badge.style === 'rainbow') {
+      badgeStyle = `background: linear-gradient(45deg, #ff6b6b, #4ecdc4, #45b7d1, #96ceb4, #ffeaa7, #fab1a0, #fd79a8); background-size: 400% 400%; animation: rainbow 3s ease infinite; -webkit-background-clip: text; -webkit-text-fill-color: transparent; background-clip: text; font-weight: bold; display: inline;`;
+    } else if (badge.style === 'gradient') {
+      if (badge.badge === 'CONTRIBUTOR') {
+        badgeStyle = `background: linear-gradient(45deg, #22c55e, #16a34a); background-size: 200% 200%; animation: contributorGlow 2s ease infinite; -webkit-background-clip: text; -webkit-text-fill-color: transparent; background-clip: text; font-weight: bold; display: inline;`;
+      } else {
+        badgeStyle = `color: ${badge.color}; font-weight: bold; display: inline;`;
+      }
+    }
+    
+    badgeHTML = `<span class="user-badge" style="${badgeStyle}">[${badge.badge}]</span> `;
+  }
+
+  messageDiv.innerHTML = `
+    <div class="message-header">
+      <span class="message-user-info">${badgeHTML}<span class="message-username" style="font-weight: bold;" data-username-color="${userColor}">${escapeHtml(username)}</span></span>
+      <span class="message-time">${time}</span>
+    </div>
+    <div class="message-content">${message}</div>
+  `;
+
+  const usernameElement = messageDiv.querySelector('.message-username');
+  if (usernameElement) {
+    applyUserColorStyle(usernameElement, userColor);
+  }
+
+  chatMessages.appendChild(messageDiv);
+  scrollToBottom();
+}
+
+function addSystemMessage(message, type = 'info') {
+  const chatMessages = document.getElementById('chatMessages');
+  if (!chatMessages) return;
+
+  const messageDiv = document.createElement('div');
+  messageDiv.className = `chat-message system-message system-${type}`;
+  messageDiv.innerHTML = `
+    <div class="message-content">
+      <i class="fas fa-info-circle"></i> ${escapeHtml(message)}
+    </div>
+  `;
+
+  chatMessages.appendChild(messageDiv);
+  scrollToBottom();
+}
+
+function updateOnlineCount(count) {
+  const onlineCountElement = document.getElementById('chatOnlineCount');
+  if (onlineCountElement) {
+    onlineCountElement.textContent = count;
+  }
+}
+
+function updateCharCounter() {
+  const chatInput = document.getElementById('chatInput');
+  const charCounter = document.getElementById('chatCharCounter');
+  
+  if (chatInput && charCounter) {
+    const length = chatInput.value.length;
+    charCounter.textContent = `${length}/${MAX_MESSAGE_LENGTH}`;
+    
+    if (length > MAX_MESSAGE_LENGTH * 0.9) {
+      charCounter.classList.add('warning');
+    } else {
+      charCounter.classList.remove('warning');
+    }
+  }
+}
+
+function scrollToBottom() {
+  const chatMessages = document.getElementById('chatMessages');
+  if (chatMessages) {
+    chatMessages.scrollTop = chatMessages.scrollHeight;
+  }
+}
+
+function clearAllMessages() {
+  const chatMessages = document.getElementById('chatMessages');
+  if (chatMessages) {
+    chatMessages.innerHTML = '';
+    console.log('Chat cleared');
+  }
+}
+
+function escapeHtml(text) {
+  const div = document.createElement('div');
+  div.textContent = text;
+  return div.innerHTML;
+}
+
+window.addEventListener('beforeunload', () => {
+  if (socket && socket.connected) {
+    socket.disconnect();
+  }
+});
+
+document.addEventListener('DOMContentLoaded', () => {
+  const usernameSubmitBtn = document.getElementById('chatUsernameSubmit');
+  const usernameCancelBtn = document.getElementById('chatUsernameCancel');
+  const usernameInput = document.getElementById('chatUsernameInput');
+
+  if (usernameSubmitBtn) {
+    usernameSubmitBtn.addEventListener('click', submitChatUsername);
+  }
+
+  if (usernameCancelBtn) {
+    usernameCancelBtn.addEventListener('click', () => {
+      hideUsernameModal();
+      const playNavItem = document.querySelector('[data-page="play"]');
+      if (playNavItem) playNavItem.click();
+    });
+  }
+
+  if (usernameInput) {
+    usernameInput.addEventListener('keypress', (e) => {
+      if (e.key === 'Enter') {
+        e.preventDefault();
+        submitChatUsername();
+      }
+    });
+  }
+
+  const chatNavItem = document.querySelector('[data-page="chat"]');
+  if (chatNavItem) {
+    chatNavItem.addEventListener('click', () => {
+      if (!socket) {
+        initChat();
+      }
+    });
+  }
+});
+
+function setupColorSelector() {
+  const colorBtn = document.getElementById('chatColorBtn');
+  if (colorBtn) {
+    colorBtn.addEventListener('click', showChatColorModal);
+  }
+
+  const colorOptions = document.querySelectorAll('.color-option');
+  colorOptions.forEach(option => {
+    option.addEventListener('click', () => {
+      document.querySelectorAll('.color-option').forEach(o => o.classList.remove('selected'));
+      option.classList.add('selected');
+      updateColorPreview();
+    });
+  });
+
+  const customColor = document.getElementById('customColor');
+  if (customColor) {
+    customColor.addEventListener('input', () => {
+      document.querySelectorAll('.color-option').forEach(o => o.classList.remove('selected'));
+      updateColorPreview();
+    });
+  }
+}
+
+function showChatColorModal() {
+  const modal = document.getElementById('chatColorModal');
+  if (modal) {
+    modal.style.display = 'flex';
+    updateColorPreview();
+  }
+}
+
+window.closeChatColorModal = function() {
+  const modal = document.getElementById('chatColorModal');
+  if (modal) {
+    modal.style.display = 'none';
+  }
+}
+
+function updateColorPreview() {
+  const preview = document.getElementById('colorPreview');
+  if (!preview) return;
+  
+  const selectedOption = document.querySelector('.color-option.selected');
+  let color = '#3498db';
+  
+  if (selectedOption) {
+    color = selectedOption.dataset.color;
+  } else {
+    const customColor = document.getElementById('customColor');
+    if (customColor) color = customColor.value;
+  }
+  
+  preview.style.color = color;
+  preview.style.background = 'transparent';
+  preview.style.webkitBackgroundClip = 'initial';
+  preview.style.webkitTextFillColor = 'initial';
+}
+
+window.applyChatColor = async function() {
+  let newColor;
+  
+  const selectedOption = document.querySelector('.color-option.selected');
+  if (selectedOption) {
+    newColor = selectedOption.dataset.color;
+  } else {
+    const customColor = document.getElementById('customColor');
+    newColor = customColor ? customColor.value : '#3498db';
+  }
+
+  userColor = newColor;
+
+  if (window.electronAPI?.saveChatColor) {
+    await window.electronAPI.saveChatColor(newColor);
+  }
+
+  if (socket && isAuthenticated) {
+    const uuid = await window.electronAPI?.getCurrentUuid();
+    socket.emit('authenticate', { 
+      username: chatUsername, 
+      userId: await getOrCreatePlayerId(),
+      uuid: uuid,
+      userColor: userColor
+    });
+    
+    addSystemMessage('Username color updated successfully', 'success');
+  }
+
+  closeChatColorModal();
+}
+
+function applyUserColorStyle(element, color) {
+  element.style.color = color;
+  element.style.background = 'transparent';
+  element.style.webkitBackgroundClip = 'initial';
+  element.style.webkitTextFillColor = 'initial';
+}
+
+window.ChatAPI = {
+  send: sendMessage,
+  disconnect: () => socket?.disconnect()
+};

GUI/js/featured.js

@@ -1,176 +0,0 @@
-// Featured Servers Management
-const FEATURED_SERVERS_API = 'https://assets.authbp.xyz/featured.json';
-
-/**
- * Safely escape HTML while preserving UTF-8 characters
- */
-function escapeHtml(text) {
-  const div = document.createElement('div');
-  div.textContent = text;
-  return div.innerHTML;
-}
-
-/**
- * Load and display featured servers
- */
-async function loadFeaturedServers() {
-  const featuredContainer = document.getElementById('featuredServersList');
-  const myServersContainer = document.getElementById('myServersList');
-  
-  try {
-    console.log('[FeaturedServers] Fetching from', FEATURED_SERVERS_API);
-    
-    // Fetch featured servers from API (no cache)
-    const response = await fetch(FEATURED_SERVERS_API, {
-      cache: 'no-store',
-      headers: {
-        'Cache-Control': 'no-cache',
-        'Pragma': 'no-cache',
-        'Accept-Charset': 'utf-8'
-      }
-    });
-    if (!response.ok) {
-      throw new Error(`HTTP error! status: ${response.status}`);
-    }
-    
-    const text = await response.text();
-    const data = JSON.parse(text);
-    const featuredServers = data.featuredServers || [];
-    
-    console.log('[FeaturedServers] Loaded', featuredServers.length, 'featured servers');
-    
-    // Render featured servers
-    if (featuredServers.length === 0) {
-      featuredContainer.innerHTML = `
-        <div class="loading-spinner">
-          <i class="fas fa-info-circle fa-2x"></i>
-          <p>No featured servers</p>
-        </div>
-      `;
-    } else {
-      const featuredHTML = featuredServers.map((server, index) => {
-        console.log(`[FeaturedServers] Building featured card ${index + 1}:`, server.Name);
-        
-        const escapedName = escapeHtml(server.Name || 'Unknown Server');
-        const escapedAddress = escapeHtml(server.Address || '');
-        const bannerUrl = server.img_Banner || 'https://via.placeholder.com/400x240/1e293b/ffffff?text=Server+Banner';
-        
-        return `
-          <div class="featured-server-card">
-            <img 
-              src="${bannerUrl}" 
-              alt="${escapedName}" 
-              class="featured-server-banner"
-              onerror="this.src='https://via.placeholder.com/400x240/1e293b/ffffff?text=Server'"
-            />
-            <div class="featured-server-content">
-              <h3 class="featured-server-name">${escapedName}</h3>
-              <div class="featured-server-address">
-                <span class="server-address-text">${escapedAddress}</span>
-                <button class="copy-address-btn" onclick="copyServerAddress('${escapedAddress}', this)">
-                  <i class="fas fa-copy"></i>
-                  <span>Copy</span>
-                </button>
-              </div>
-            </div>
-          </div>
-        `;
-      }).join('');
-      
-      featuredContainer.innerHTML = featuredHTML;
-    }
-    
-    // Show "Coming Soon" for my servers
-    myServersContainer.innerHTML = `
-      <div style="display: flex; align-items: center; justify-content: center; height: 100%; color: #94a3b8; font-size: 1.2rem;">
-        <p>Coming Soon</p>
-      </div>
-    `;
-    
-  } catch (error) {
-    console.error('[FeaturedServers] Error loading servers:', error);
-    featuredContainer.innerHTML = `
-      <div class="loading-spinner">
-        <i class="fas fa-exclamation-triangle fa-2x" style="color: #ef4444;"></i>
-        <p>Failed to load servers</p>
-        <p style="font-size: 0.9rem; color: #64748b;">${error.message}</p>
-      </div>
-    `;
-    myServersContainer.innerHTML = `
-      <div style="display: flex; align-items: center; justify-content: center; height: 100%; color: #94a3b8; font-size: 1.2rem;">
-        <p>Coming Soon</p>
-      </div>
-    `;
-  }
-}
-
-/**
- * Copy server address to clipboard
- */
-async function copyServerAddress(address, button) {
-  try {
-    await navigator.clipboard.writeText(address);
-    
-    // Visual feedback
-    const originalHTML = button.innerHTML;
-    button.classList.add('copied');
-    button.innerHTML = '<i class="fas fa-check"></i><span>Copied!</span>';
-    
-    setTimeout(() => {
-      button.classList.remove('copied');
-      button.innerHTML = originalHTML;
-    }, 2000);
-    
-    console.log('[FeaturedServers] Copied address:', address);
-  } catch (error) {
-    console.error('[FeaturedServers] Failed to copy address:', error);
-    
-    // Fallback for older browsers
-    const textArea = document.createElement('textarea');
-    textArea.value = address;
-    textArea.style.position = 'fixed';
-    textArea.style.left = '-999999px';
-    document.body.appendChild(textArea);
-    textArea.select();
-    
-    try {
-      document.execCommand('copy');
-      const originalHTML = button.innerHTML;
-      button.classList.add('copied');
-      button.innerHTML = '<i class="fas fa-check"></i><span>Copied!</span>';
-      
-      setTimeout(() => {
-        button.classList.remove('copied');
-        button.innerHTML = originalHTML;
-      }, 2000);
-    } catch (err) {
-      console.error('[FeaturedServers] Fallback copy also failed:', err);
-    }
-    
-    document.body.removeChild(textArea);
-  }
-}
-
-// Load featured servers when the featured page becomes visible
-document.addEventListener('DOMContentLoaded', () => {
-  const observer = new MutationObserver((mutations) => {
-    mutations.forEach((mutation) => {
-      if (mutation.type === 'attributes' && mutation.attributeName === 'class') {
-        const featuredPage = document.getElementById('featured-page');
-        if (featuredPage && featuredPage.classList.contains('active')) {
-          loadFeaturedServers();
-        }
-      }
-    });
-  });
-  
-  const featuredPage = document.getElementById('featured-page');
-  if (featuredPage) {
-    observer.observe(featuredPage, { attributes: true });
-    
-    // Load immediately if already visible
-    if (featuredPage.classList.contains('active')) {
-      loadFeaturedServers();
-    }
-  }
-});

GUI/js/i18n.js

@@ -4,15 +4,13 @@ const i18n = (() => {
   let translations = {};
   const availableLanguages = [
     { code: 'en', name: 'English' },
-    { code: 'de-DE', name: 'German (Germany)' },
-    { code: 'es-ES', name: 'Spanish (Spain)' },
-    { code: 'fr-FR', name: 'French (France)' },
-    { code: 'pl-PL', name: 'Polish (Poland)' },
+    { code: 'fr', name: 'Français' },
+    { code: 'de', name: 'Deutsch' },
+    { code: 'sv', name: 'Svenska' },
+    { code: 'es-ES', name: 'Español (España)' },
     { code: 'pt-BR', name: 'Portuguese (Brazil)' },
-    { 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: 'pl-PL', name: 'Polish (Poland)' }
   ];
 
   // Load single language file

GUI/js/install.js

@@ -45,17 +45,9 @@ export function setupInstallation() {
 export async function installGame() {
   if (isDownloading || (installBtn && installBtn.disabled)) return;
   
-  let playerName = (installPlayerName ? installPlayerName.value.trim() : '') || 'Player';
+  const playerName = (installPlayerName ? installPlayerName.value.trim() : '') || 'Player';
   const installPath = installPathInput ? installPathInput.value.trim() : '';
   
-  // Limit player name to 16 characters
-  if (playerName.length > 16) {
-    playerName = playerName.substring(0, 16);
-    if (installPlayerName) {
-      installPlayerName.value = playerName;
-    }
-  }
-  
   const selectedBranchRadio = document.querySelector('input[name="installBranch"]:checked');
   const selectedBranch = selectedBranchRadio ? selectedBranchRadio.value : 'release';
   
@@ -80,11 +72,8 @@ export async function installGame() {
           setTimeout(() => {
             window.LauncherUI.hideProgress();
             window.LauncherUI.showLauncherOrInstall(true);
-            // Sync player name to both launcher and settings inputs
             const playerNameInput = document.getElementById('playerName');
             if (playerNameInput) playerNameInput.value = playerName;
-            const settingsPlayerName = document.getElementById('settingsPlayerName');
-            if (settingsPlayerName) settingsPlayerName.value = playerName;
             resetInstallButton();
           }, 2000);
         }
@@ -136,11 +125,8 @@ function simulateInstallation(playerName) {
           setTimeout(() => {
             window.LauncherUI.hideProgress();
             window.LauncherUI.showLauncherOrInstall(true);
-            // Sync player name to both launcher and settings inputs
             const playerNameInput = document.getElementById('playerName');
             if (playerNameInput) playerNameInput.value = playerName;
-            const settingsPlayerName = document.getElementById('settingsPlayerName');
-            if (settingsPlayerName) settingsPlayerName.value = playerName;
             resetInstallButton();
           }, 2000);
         }
@@ -202,16 +188,7 @@ export async function browseInstallPath() {
 async function savePlayerName() {
   try {
     if (window.electronAPI && window.electronAPI.saveSettings) {
-      let playerName = (installPlayerName ? installPlayerName.value.trim() : '') || 'Player';
-      
-      // Limit player name to 16 characters
-      if (playerName.length > 16) {
-        playerName = playerName.substring(0, 16);
-        if (installPlayerName) {
-          installPlayerName.value = playerName;
-        }
-      }
-      
+      const playerName = (installPlayerName ? installPlayerName.value.trim() : '') || 'Player';
       await window.electronAPI.saveSettings({ playerName });
     }
   } catch (error) {
@@ -269,3 +246,9 @@ document.addEventListener('DOMContentLoaded', async () => {
   setupInstallation();
   await checkGameStatusAndShowInterface();
 });
+window.browseInstallPath = browseInstallPath;
+
+document.addEventListener('DOMContentLoaded', async () => {
+  setupInstallation();
+  await checkGameStatusAndShowInterface();
+});

GUI/js/script.js

@@ -4,66 +4,23 @@ import './launcher.js';
 import './news.js';
 import './mods.js';
 import './players.js';
+import './chat.js';
 import './settings.js';
 import './logs.js';
 
+// Initialize i18n immediately (before DOMContentLoaded)
 let i18nInitialized = false;
 (async () => {
   const savedLang = await window.electronAPI?.loadLanguage();
   await i18n.init(savedLang);
   i18nInitialized = true;
   
+  // Update language selector if DOM is already loaded
   if (document.readyState === 'complete' || document.readyState === 'interactive') {
     updateLanguageSelector();
   }
 })();
 
-async function checkDiscordPopup() {
-  try {
-    const config = await window.electronAPI?.loadConfig();
-    if (!config || config.discordPopup === undefined || config.discordPopup === false) {
-      const modal = document.getElementById('discordPopupModal');
-      if (modal) {
-        const buttons = modal.querySelectorAll('.discord-popup-btn');
-        buttons.forEach(btn => btn.disabled = true);
-        
-        setTimeout(() => {
-          modal.style.display = 'flex';
-          modal.classList.add('active');
-          
-          setTimeout(() => {
-            buttons.forEach(btn => btn.disabled = false);
-          }, 2000);
-        }, 1000);
-      }
-    }
-  } catch (error) {
-    console.error('Failed to check Discord popup:', error);
-  }
-}
-
-window.closeDiscordPopup = function() {
-  const modal = document.getElementById('discordPopupModal');
-  if (modal) {
-    modal.classList.remove('active');
-    setTimeout(() => {
-      modal.style.display = 'none';
-    }, 300);
-  }
-};
-
-window.joinDiscord = async function() {
-  await window.electronAPI?.openExternal('https://discord.gg/hf2pdc');
-  
-  try {
-    await window.electronAPI?.saveConfig({ discordPopup: true });
-  } catch (error) {
-    console.error('Failed to save Discord popup state:', error);
-  }
-  
-  closeDiscordPopup();
-};
-
 function updateLanguageSelector() {
   const langSelect = document.getElementById('languageSelect');
   if (langSelect) {
@@ -94,9 +51,32 @@ function updateLanguageSelector() {
 }
 
 document.addEventListener('DOMContentLoaded', () => {
+  // Populate language selector (wait for i18n if needed)
   if (i18nInitialized) {
     updateLanguageSelector();
   }
   
-  checkDiscordPopup();
-});
+  // Discord notification
+  const notification = document.getElementById('discordNotification');
+  if (notification) {
+    const dismissed = localStorage.getItem('discordNotificationDismissed');
+    if (!dismissed) {
+      setTimeout(() => {
+        notification.style.display = 'flex';
+      }, 3000);
+    } else {
+      notification.style.display = 'none';
+    }
+  }
+});
+
+window.closeDiscordNotification = function() {
+  const notification = document.getElementById('discordNotification');
+  if (notification) {
+    notification.classList.add('hidden');
+    setTimeout(() => {
+      notification.style.display = 'none';
+    }, 300);
+  }
+  localStorage.setItem('discordNotificationDismissed', 'true');
+};

GUI/js/settings.js

@@ -439,13 +439,6 @@ async function savePlayerName() {
       return;
     }
 
-    if (playerName.length > 16) {
-      const msg = window.i18n ? window.i18n.t('notifications.playerNameTooLong') : 'Player name must be 16 characters or less';
-      showNotification(msg, 'error');
-      settingsPlayerName.value = playerName.substring(0, 16);
-      return;
-    }
-
     await window.electronAPI.saveUsername(playerName);
     const successMsg = window.i18n ? window.i18n.t('notifications.playerNameSaved') : 'Player name saved successfully';
     showNotification(successMsg, 'success');

GUI/js/ui.js

@@ -63,10 +63,8 @@ function handleNavigation() {
   navItems.forEach(item => {
     item.addEventListener('click', () => {
       const page = item.getAttribute('data-page');
-      if (page) {
-        showPage(`${page}-page`);
-        setActiveNav(page);
-      }
+      showPage(`${page}-page`);
+      setActiveNav(page);
     });
   });
 }
@@ -845,7 +843,7 @@ function getErrorMessage(technicalMessage, errorType) {
     case 'stall':
       return 'Download stalled due to slow connection. Please retry.';
     case 'file':
-      return 'Unable to save file. Check permissions. Please retry.';
+      return 'Unable to save file. Check disk space and permissions. Please retry.';
     case 'permission':
       return 'Permission denied. Check if launcher has write access. Please retry.';
     case 'server':
@@ -974,7 +972,7 @@ function setupRetryButton() {
         if (!currentDownloadState.retryData || currentDownloadState.errorType === 'jre') {
           currentDownloadState.retryData = {
             branch: 'release',
-            fileName: '7.pwr'
+            fileName: '4.pwr'
           };
           console.log('[UI] Created default PWR retry data:', currentDownloadState.retryData);
         }
@@ -1042,7 +1040,7 @@ function setupRetryButton() {
           } else {
             currentDownloadState.retryData = {
               branch: 'release',
-              fileName: '7.pwr'
+              fileName: '4.pwr'
             };
           }
           console.log('[UI] Created default retry data:', currentDownloadState.retryData);
@@ -1102,10 +1100,7 @@ function getRetryContextMessage() {
   }
 }
 
-window.openDiscordExternal = function() {
-  window.electronAPI?.openExternal('https://discord.gg/hf2pdc');
-};
-
+// Make toggleMaximize globally available
 window.toggleMaximize = toggleMaximize;
 
 document.addEventListener('DOMContentLoaded', setupUI);

GUI/js/update.js

@@ -6,12 +6,12 @@ class ClientUpdateManager {
     }
 
     init() {
-        console.log('🔧 ClientUpdateManager initializing...');
+        window.electronAPI.onUpdatePopup((updateInfo) => {
+            this.showUpdatePopup(updateInfo);
+        });
 
-        // Listen for electron-updater events from main.js
-        // This is the primary update trigger - main.js checks for updates on startup
+        // Listen for electron-updater events
         window.electronAPI.onUpdateAvailable((updateInfo) => {
-            console.log('📥 update-available event received:', updateInfo);
             this.showUpdatePopup(updateInfo);
         });
 
@@ -20,30 +20,18 @@ class ClientUpdateManager {
         });
 
         window.electronAPI.onUpdateDownloaded((updateInfo) => {
-            console.log('📦 update-downloaded event received:', updateInfo);
             this.showUpdateDownloaded(updateInfo);
         });
 
         window.electronAPI.onUpdateError((errorInfo) => {
-            console.log('❌ update-error event received:', errorInfo);
             this.handleUpdateError(errorInfo);
         });
 
-        console.log('✅ ClientUpdateManager initialized');
-
-        // Note: Don't call checkForUpdatesOnDemand() here - main.js already checks
-        // for updates after 3 seconds and sends 'update-available' event.
-        // Calling it here would cause duplicate popups.
+        this.checkForUpdatesOnDemand();
     }
 
     showUpdatePopup(updateInfo) {
-        console.log('🔔 showUpdatePopup called, updatePopupVisible:', this.updatePopupVisible);
-
-        // Check if popup already exists in DOM (extra safety)
-        if (this.updatePopupVisible || document.getElementById('update-popup-overlay')) {
-            console.log('⚠️ Update popup already visible, skipping');
-            return;
-        }
+        if (this.updatePopupVisible) return;
 
         this.updatePopupVisible = true;
         
@@ -104,10 +92,7 @@ class ClientUpdateManager {
                     </div>
 
                     <div class="update-popup-footer">
-                        <span id="update-footer-text">Downloading update...</span>
-                        <button id="update-skip-btn" class="update-skip-btn" style="display: none; margin-top: 0.5rem; background: transparent; border: 1px solid rgba(255,255,255,0.2); color: #9ca3af; padding: 0.5rem 1rem; border-radius: 0.25rem; cursor: pointer; font-size: 0.75rem;">
-                            Skip for now (not recommended)
-                        </button>
+                        This popup cannot be closed until you update the launcher
                     </div>
                 </div>
             </div>
@@ -128,43 +113,16 @@ class ClientUpdateManager {
             installBtn.addEventListener('click', async (e) => {
                 e.preventDefault();
                 e.stopPropagation();
-
+                
                 installBtn.disabled = true;
                 installBtn.innerHTML = '<i class="fas fa-spinner fa-spin" style="margin-right: 0.5rem;"></i>Installing...';
-
+                
                 try {
                     await window.electronAPI.quitAndInstallUpdate();
-
-                    // If we're still here after 5 seconds, the install probably failed
-                    setTimeout(() => {
-                        console.log('⚠️ Install may have failed - showing skip option');
-                        installBtn.disabled = false;
-                        installBtn.innerHTML = '<i class="fas fa-check" style="margin-right: 0.5rem;"></i>Try Again';
-
-                        // Show skip button
-                        const skipBtn = document.getElementById('update-skip-btn');
-                        const footerText = document.getElementById('update-footer-text');
-                        if (skipBtn) {
-                            skipBtn.style.display = 'inline-block';
-                            if (footerText) {
-                                footerText.textContent = 'Install not working? Skip for now:';
-                            }
-                        }
-                    }, 5000);
                 } catch (error) {
                     console.error('❌ Error installing update:', error);
                     installBtn.disabled = false;
                     installBtn.innerHTML = '<i class="fas fa-check" style="margin-right: 0.5rem;"></i>Install & Restart';
-
-                    // Show skip button on error
-                    const skipBtn = document.getElementById('update-skip-btn');
-                    const footerText = document.getElementById('update-footer-text');
-                    if (skipBtn) {
-                        skipBtn.style.display = 'inline-block';
-                        if (footerText) {
-                            footerText.textContent = 'Install failed. Skip for now:';
-                        }
-                    }
                 }
             });
         }
@@ -180,15 +138,10 @@ class ClientUpdateManager {
                 
                 try {
                     await window.electronAPI.openDownloadPage();
-                    console.log('✅ Download page opened');
-
-                    downloadBtn.innerHTML = '<i class="fas fa-check" style="margin-right: 0.5rem;"></i>Opened in browser';
-
-                    // Close the popup after opening download page
-                    setTimeout(() => {
-                        this.closeUpdatePopup();
-                    }, 1500);
-
+                    console.log('✅ Download page opened, launcher will close...');
+                    
+                    downloadBtn.innerHTML = '<i class="fas fa-check" style="margin-right: 0.5rem;"></i>Launcher closing...';
+                    
                 } catch (error) {
                     console.error('❌ Error opening download page:', error);
                     downloadBtn.disabled = false;
@@ -208,39 +161,9 @@ class ClientUpdateManager {
             });
         }
 
-        // Show skip button after 30 seconds as fallback (in case update is stuck)
-        setTimeout(() => {
-            const skipBtn = document.getElementById('update-skip-btn');
-            const footerText = document.getElementById('update-footer-text');
-            if (skipBtn) {
-                skipBtn.style.display = 'inline-block';
-                if (footerText) {
-                    footerText.textContent = 'Update taking too long?';
-                }
-            }
-        }, 30000);
-
-        const skipBtn = document.getElementById('update-skip-btn');
-        if (skipBtn) {
-            skipBtn.addEventListener('click', (e) => {
-                e.preventDefault();
-                e.stopPropagation();
-                this.closeUpdatePopup();
-            });
-        }
-
         console.log('🔔 Update popup displayed with new style');
     }
 
-    closeUpdatePopup() {
-        const overlay = document.getElementById('update-popup-overlay');
-        if (overlay) {
-            overlay.remove();
-        }
-        this.updatePopupVisible = false;
-        this.unblockInterface();
-    }
-
     updateDownloadProgress(progress) {
         const progressBar = document.getElementById('update-progress-bar');
         const progressPercent = document.getElementById('update-progress-percent');
@@ -274,96 +197,35 @@ class ClientUpdateManager {
         const statusText = document.getElementById('update-status-text');
         const progressContainer = document.getElementById('update-progress-container');
         const buttonsContainer = document.getElementById('update-buttons-container');
-        const installBtn = document.getElementById('update-install-btn');
-        const downloadBtn = document.getElementById('update-download-btn');
-        const skipBtn = document.getElementById('update-skip-btn');
-        const footerText = document.getElementById('update-footer-text');
-        const popupContainer = document.querySelector('.update-popup-container');
 
-        // Remove breathing/pulse animation when download is complete
-        if (popupContainer) {
-            popupContainer.classList.remove('update-popup-pulse');
+        if (statusText) {
+            statusText.textContent = 'Update downloaded! Ready to install.';
         }
 
         if (progressContainer) {
             progressContainer.style.display = 'none';
         }
 
-        // Use platform info from main process if available, fallback to browser detection
-        const autoInstallSupported = updateInfo.autoInstallSupported !== undefined
-            ? updateInfo.autoInstallSupported
-            : navigator.platform.toUpperCase().indexOf('MAC') < 0;
-
-        if (!autoInstallSupported) {
-            // macOS: Show manual download as primary since auto-update doesn't work
-            if (statusText) {
-                statusText.textContent = 'Update downloaded but auto-install may not work on macOS.';
-            }
-
-            if (installBtn) {
-                // Still show install button but as secondary option
-                installBtn.classList.add('update-download-btn-secondary');
-                installBtn.innerHTML = '<i class="fas fa-check" style="margin-right: 0.5rem;"></i>Try Install & Restart';
-            }
-
-            if (downloadBtn) {
-                // Make manual download primary
-                downloadBtn.classList.remove('update-download-btn-secondary');
-                downloadBtn.innerHTML = '<i class="fas fa-external-link-alt" style="margin-right: 0.5rem;"></i>Download Manually (Recommended)';
-            }
-
-            if (footerText) {
-                footerText.textContent = 'Auto-install often fails on macOS:';
-            }
-        } else {
-            // Windows/Linux: Auto-install should work
-            if (statusText) {
-                statusText.textContent = 'Update downloaded! Ready to install.';
-            }
-
-            if (footerText) {
-                footerText.textContent = 'Click to install the update:';
-            }
-        }
-
         if (buttonsContainer) {
             buttonsContainer.style.display = 'block';
         }
 
-        // Always show skip button in downloaded state
-        if (skipBtn) {
-            skipBtn.style.display = 'inline-block';
-            console.log('✅ Skip button made visible');
-        } else {
-            console.error('❌ Skip button not found in DOM!');
-        }
-
-        console.log('✅ Update downloaded, ready to install. autoInstallSupported:', autoInstallSupported);
+        console.log('✅ Update downloaded, ready to install');
     }
 
     handleUpdateError(errorInfo) {
         console.error('Update error:', errorInfo);
-
-        // Show skip button immediately on any error
-        const skipBtn = document.getElementById('update-skip-btn');
-        const footerText = document.getElementById('update-footer-text');
-        if (skipBtn) {
-            skipBtn.style.display = 'inline-block';
-            if (footerText) {
-                footerText.textContent = 'Update failed. You can skip for now.';
-            }
-        }
-
+        
         // If manual download is required, update the UI (this will handle status text)
         if (errorInfo.requiresManualDownload) {
             this.showManualDownloadRequired(errorInfo);
             return; // Don't do anything else, showManualDownloadRequired handles everything
         }
-
+        
         // For non-critical errors, just show error message without changing status
         const errorMessage = document.getElementById('update-error-message');
         const errorText = document.getElementById('update-error-text');
-
+        
         if (errorMessage && errorText) {
             let message = errorInfo.message || 'An error occurred during the update process.';
             if (errorInfo.isMacSigningError) {
@@ -427,16 +289,6 @@ class ClientUpdateManager {
             buttonsContainer.style.display = 'block';
         }
 
-        // Show skip button for manual download errors
-        const skipBtn = document.getElementById('update-skip-btn');
-        const footerText = document.getElementById('update-footer-text');
-        if (skipBtn) {
-            skipBtn.style.display = 'inline-block';
-            if (footerText) {
-                footerText.textContent = 'Or continue without updating:';
-            }
-        }
-
         console.log('⚠️ Manual download required due to update error');
     }
 
@@ -448,35 +300,13 @@ class ClientUpdateManager {
 
         document.body.classList.add('no-select');
 
-        // Store bound functions so we can remove them later
-        this._boundBlockKeyEvents = this.blockKeyEvents.bind(this);
-        this._boundBlockContextMenu = this.blockContextMenu.bind(this);
-
-        document.addEventListener('keydown', this._boundBlockKeyEvents, true);
-        document.addEventListener('contextmenu', this._boundBlockContextMenu, true);
-
+        document.addEventListener('keydown', this.blockKeyEvents.bind(this), true);
+        
+        document.addEventListener('contextmenu', this.blockContextMenu.bind(this), true);
+        
         console.log('🚫 Interface blocked for update');
     }
 
-    unblockInterface() {
-        const mainContent = document.querySelector('.flex.w-full.h-screen');
-        if (mainContent) {
-            mainContent.classList.remove('interface-blocked');
-        }
-
-        document.body.classList.remove('no-select');
-
-        // Remove event listeners
-        if (this._boundBlockKeyEvents) {
-            document.removeEventListener('keydown', this._boundBlockKeyEvents, true);
-        }
-        if (this._boundBlockContextMenu) {
-            document.removeEventListener('contextmenu', this._boundBlockContextMenu, true);
-        }
-
-        console.log('✅ Interface unblocked');
-    }
-
     blockKeyEvents(event) {
         if (event.target.closest('#update-popup-overlay')) {
             if ((event.key === 'Enter' || event.key === ' ') && 

GUI/locales/de.json

@@ -119,7 +119,7 @@
     "repairGame": "Spiel reparieren",
     "reinstallGame": "Spieldateien neu installieren (behält Daten)",
     "gpuPreference": "GPU-Präferenz",
-    "gpuHint": "Funktion nur für Laptops; auf „Integriert“ stellen, wenn auf einem PC.",
+    "gpuHint": "Wähle deine bevorzugte GPU (Linux: betrifft DRI_PRIME)",
     "gpuAuto": "Auto",
     "gpuIntegrated": "Integriert",
     "gpuDedicated": "Dediziert",
@@ -211,7 +211,40 @@
     "modsDeleteFailed": "Mod konnte nicht gelöscht werden: {error}",
     "modsModNotFound": "Mod-Informationen nicht gefunden",
     "hwAccelSaved": "Hardware-Beschleunigungseinstellung gespeichert",
-    "hwAccelSaveFailed": "Hardware-Beschleunigungseinstellung konnte nicht gespeichert werden"
+    "hwAccelSaveFailed": "Hardware-Beschleunigungseinstellung konnte nicht gespeichert werden",
+    "javaPathCopied": "Java-Pfad in die Zwischenablage kopiert!",
+    "javaPathCopyFailed": "Java-Pfad konnte nicht kopiert werden",
+    "javaPathSaved": "Java-Pfad erfolgreich gespeichert!",
+    "javaPathSaveFailed": "Java-Pfad konnte nicht gespeichert werden",
+    "javaPathInvalid": "Ungültiger Java-Pfad",
+    "javaPathReset": "Java-Pfad auf Standardwerte zurückgesetzt",
+    "gameLocationError": "Spielordner konnte nicht geöffnet werden",
+    "launcherRestartRequired": "Launcher-Neustart erforderlich, um Änderungen anzuwenden",
+    "gameRepairConfirm": "Möchtest du das Spiel wirklich reparieren? Dies wird alle Spieldateien neu installieren.",
+    "gameRepairInProgress": "Spiel wird repariert...",
+    "gameRepairSuccess": "Spiel erfolgreich repariert!",
+    "gameRepairFailed": "Spielreparatur fehlgeschlagen: {error}",
+    "invalidUsername": "Ungültiger Benutzername",
+    "usernameInUse": "Benutzername bereits vergeben",
+    "chatJoinSuccess": "Du bist dem Chat beigetreten!",
+    "chatJoinFailed": "Chat-Beitritt fehlgeschlagen",
+    "messageTooLong": "Nachricht zu lang",
+    "messageSent": "Nachricht gesendet",
+    "messageSendFailed": "Nachricht konnte nicht gesendet werden",
+    "colorUpdated": "Farbe aktualisiert!",
+    "colorUpdateFailed": "Farbe konnte nicht aktualisiert werden",
+    "profileCreated": "Profil erfolgreich erstellt!",
+    "profileCreateFailed": "Profil konnte nicht erstellt werden",
+    "profileDeleted": "Profil gelöscht",
+    "profileDeleteFailed": "Profil konnte nicht gelöscht werden",
+    "profileSwitched": "Profil gewechselt zu: {name}",
+    "profileSwitchFailed": "Profilwechsel fehlgeschlagen",
+    "invalidProfileName": "Ungültiger Profilname",
+    "profileNameExists": "Ein Profil mit diesem Namen existiert bereits",
+    "noInternet": "Keine Internetverbindung",
+    "checkInternetConnection": "Überprüfe deine Internetverbindung",
+    "serverError": "Serverfehler. Bitte versuche es später erneut.",
+    "unknownError": "Ein unbekannter Fehler ist aufgetreten"
   },
   "confirm": {
     "defaultTitle": "Aktion bestätigen",
@@ -247,4 +280,4 @@
     "installingGameFiles": "Spieldateien werden installiert...",
     "installComplete": "Installation abgeschlossen!"
   }
-}
+}

GUI/locales/en.json

@@ -119,7 +119,7 @@
     "repairGame": "Repair Game",
     "reinstallGame": "Reinstall game files (preserves data)",
     "gpuPreference": "GPU Preference",
-    "gpuHint": "Laptop-only feature; set to Integrated if on PC",
+    "gpuHint": "Select your preferred GPU (Linux: affects DRI_PRIME)",
     "gpuAuto": "Auto",
     "gpuIntegrated": "Integrated",
     "gpuDedicated": "Dedicated",

GUI/locales/es-ES.json

@@ -119,7 +119,7 @@
     "repairGame": "Reparar juego",
     "reinstallGame": "Reinstalar archivos del juego (conserva los datos)",
     "gpuPreference": "Preferencia de GPU",
-    "gpuHint": "Función exclusiva para computadora portátil; configúrela como Integrada si está en una PC",
+    "gpuHint": "Selecciona tu GPU preferida (Linux: afecta DRI_PRIME)",
     "gpuAuto": "Automático",
     "gpuIntegrated": "Integrada",
     "gpuDedicated": "Dedicada",
@@ -131,8 +131,6 @@
     "closeLauncher": "Comportamiento del Launcher",
     "closeOnStart": "Cerrar Launcher al iniciar el juego",
     "closeOnStartDescription": "Cierra automáticamente el launcher después de que Hytale se haya iniciado",
-    "hwAccel": "Aceleración por Hardware",
-    "hwAccelDescription": "Habilitar aceleración por hardware para el launcher",
     "gameBranch": "Rama del Juego",
     "branchRelease": "Lanzamiento",
     "branchPreRelease": "Pre-Lanzamiento",
@@ -209,9 +207,7 @@
     "modsDownloadFailed": "Error al descargar mod: {error}",
     "modsToggleFailed": "Error al alternar mod: {error}",
     "modsDeleteFailed": "Error al eliminar mod: {error}",
-    "modsModNotFound": "Información del mod no encontrada",
-    "hwAccelSaved": "Configuración de aceleración por hardware guardada",
-    "hwAccelSaveFailed": "Error al guardar la configuración de aceleración por hardware"
+    "modsModNotFound": "Información del mod no encontrada"
   },
   "confirm": {
     "defaultTitle": "Confirmar acción",
@@ -247,4 +243,4 @@
     "installingGameFiles": "Instalando archivos del juego...",
     "installComplete": "¡Instalación completa!"
   }
-}
+}

GUI/locales/fr.json

@@ -119,7 +119,7 @@
     "repairGame": "Réparer le Jeu",
     "reinstallGame": "Réinstaller les fichiers du jeu (préserve les données)",
     "gpuPreference": "Préférence GPU",
-    "gpuHint": "Fonctionnalité exclusive aux ordinateurs portables; à définir sur Intégré sur PC",
+    "gpuHint": "Sélectionnez votre GPU préféré (Linux: affecte DRI_PRIME)",
     "gpuAuto": "Auto",
     "gpuIntegrated": "Intégré",
     "gpuDedicated": "Dédié",
@@ -198,53 +198,38 @@
     "uuidInvalidFormat": "Format UUID invalide",
     "uuidSetFailed": "Échec de la définition de l'UUID personnalisé",
     "uuidSetSuccess": "UUID personnalisé défini avec succès!",
-    "uuidDeleteFailed": "Échec de la suppression de l'UUID",
-    "uuidDeleteSuccess": "UUID supprimé avec succès!",
-    "modsDownloading": "Téléchargement de {name}...",
-    "modsTogglingMod": "Basculement du mod...",
-    "modsDeletingMod": "Suppression du mod...",
-    "modsLoadingMods": "Chargement des mods depuis CurseForge...",
-    "modsInstalledSuccess": "{name} installé avec succès! 🎉",
-    "modsDeletedSuccess": "{name} supprimé avec succès",
-    "modsDownloadFailed": "Échec du téléchargement du mod: {error}",
-    "modsToggleFailed": "Échec du basculement du mod: {error}",
-    "modsDeleteFailed": "Échec de la suppression du mod: {error}",
-    "modsModNotFound": "Informations du mod introuvables",
-    "hwAccelSaved": "Paramètre d'accélération matérielle sauvegardé",
-    "hwAccelSaveFailed": "Échec de la sauvegarde du paramètre d'accélération matérielle"
-  },
-  "confirm": {
-    "defaultTitle": "Confirmer l'action",
-    "regenerateUuidTitle": "Générer un nouvel UUID",
-    "regenerateUuidMessage": "Êtes-vous sûr de vouloir générer un nouvel UUID? Cela changera votre identité de joueur.",
-    "regenerateUuidButton": "Générer",
-    "setCustomUuidTitle": "Définir UUID personnalisé",
-    "setCustomUuidMessage": "Êtes-vous sûr de vouloir définir cet UUID personnalisé? Cela changera votre identité de joueur.",
-    "setCustomUuidButton": "Définir UUID",
-    "deleteUuidTitle": "Supprimer UUID",
-    "deleteUuidMessage": "Êtes-vous sûr de vouloir supprimer l'UUID de \"{username}\"? Cette action est irréversible.",
-    "deleteUuidButton": "Supprimer",
-    "uninstallGameTitle": "Désinstaller le jeu",
-    "uninstallGameMessage": "Êtes-vous sûr de vouloir désinstaller Hytale? Tous les fichiers du jeu seront supprimés.",
-    "uninstallGameButton": "Désinstaller"
-  },
-  "progress": {
-    "initializing": "Initialisation...",
-    "downloading": "Téléchargement...",
-    "installing": "Installation...",
-    "extracting": "Extraction...",
-    "verifying": "Vérification...",
-    "switchingProfile": "Changement de profil...",
-    "profileSwitched": "Profil changé!",
-    "startingGame": "Démarrage du jeu...",
-    "launching": "LANCEMENT...",
-    "uninstallingGame": "Désinstallation du jeu...",
-    "gameUninstalled": "Jeu désinstallé avec succès!",
-    "uninstallFailed": "Échec de la désinstallation: {error}",
-    "startingUpdate": "Démarrage de la mise à jour obligatoire du jeu...",
-    "installationComplete": "Installation terminée avec succès!",
-    "installationFailed": "Échec de l'installation: {error}",
-    "installingGameFiles": "Installation des fichiers du jeu...",
-    "installComplete": "Installation terminée!"
+    "javaPathCopied": "Chemin Java copié dans le presse-papiers!",
+    "javaPathCopyFailed": "Échec de la copie du chemin Java",
+    "javaPathSaved": "Chemin Java sauvegardé avec succès!",
+    "javaPathSaveFailed": "Échec de la sauvegarde du chemin Java",
+    "javaPathInvalid": "Chemin Java invalide",
+    "javaPathReset": "Chemin Java réinitialisé aux valeurs par défaut",
+    "gameLocationError": "Impossible d'ouvrir l'emplacement du jeu",
+    "launcherRestartRequired": "Redémarrage du launcher requis pour appliquer les modifications",
+    "gameRepairConfirm": "Êtes-vous sûr de vouloir réparer le jeu? Cela réinstallera tous les fichiers du jeu.",
+    "gameRepairInProgress": "Réparation du jeu en cours...",
+    "gameRepairSuccess": "Jeu réparé avec succès!",
+    "gameRepairFailed": "Échec de la réparation du jeu: {error}",
+    "invalidUsername": "Nom d'utilisateur invalide",
+    "usernameInUse": "Nom d'utilisateur déjà utilisé",
+    "chatJoinSuccess": "Vous avez rejoint le chat!",
+    "chatJoinFailed": "Échec de la connexion au chat",
+    "messageTooLong": "Message trop long",
+    "messageSent": "Message envoyé",
+    "messageSendFailed": "Échec de l'envoi du message",
+    "colorUpdated": "Couleur mise à jour!",
+    "colorUpdateFailed": "Échec de la mise à jour de la couleur",
+    "profileCreated": "Profil créé avec succès!",
+    "profileCreateFailed": "Échec de la création du profil",
+    "profileDeleted": "Profil supprimé",
+    "profileDeleteFailed": "Échec de la suppression du profil",
+    "profileSwitched": "Profil changé vers: {name}",
+    "profileSwitchFailed": "Échec du changement de profil",
+    "invalidProfileName": "Nom de profil invalide",
+    "profileNameExists": "Un profil avec ce nom existe déjà",
+    "noInternet": "Pas de connexion Internet",
+    "checkInternetConnection": "Vérifiez votre connexion Internet",
+    "serverError": "Erreur serveur. Veuillez réessayer plus tard.",
+    "unknownError": "Une erreur inconnue s'est produite"
   }
-}
+}

GUI/locales/id-ID.json

@@ -1,250 +0,0 @@
-{
-  "nav": {
-    "play": "Main",
-    "mods": "Mod",
-    "news": "Berita",
-    "chat": "Obrolan Pemain",
-    "settings": "Pengaturan"
-  },
-  "header": {
-    "playersLabel": "Pemain:",
-    "manageProfiles": "Kelola Profil",
-    "defaultProfile": "Default"
-  },
-  "install": {
-    "title": "LAUNCHER GRATIS UNTUK DIMAINKAN",
-    "playerName": "Nama Pemain",
-    "playerNamePlaceholder": "Masukkan namamu",
-    "gameBranch": "Versi Game",
-    "releaseVersion": "Rilis (Stabil)",
-    "preReleaseVersion": "Pra-Rilis (Eksperimental)",
-    "customInstallation": "Instalasi Kustom",
-    "installationFolder": "Folder Instalasi",
-    "pathPlaceholder": "Lokasi default",
-    "browse": "Telusuri",
-    "installButton": "INSTAL HYTALE",
-    "installing": "MENGINSTAL..."
-  },
-  "play": {
-    "ready": "SIAP BERMAIN",
-    "subtitle": "Luncurkan Hytale dan mulai petualanganmu",
-    "playButton": "MAIN HYTALE",
-    "latestNews": "BERITA TERBARU",
-    "viewAll": "LIHAT SEMUA",
-    "checking": "MEMERIKSA...",
-    "play": "MAIN"
-  },
-  "mods": {
-    "searchPlaceholder": "Cari mod...",
-    "myMods": "MOD SAYA",
-    "previous": "SEBELUMNYA",
-    "next": "BERIKUTNYA",
-    "page": "Halaman",
-    "of": "dari",
-    "modalTitle": "MOD SAYA",
-    "noModsFound": "Mod Tidak Ditemukan",
-    "noModsFoundDesc": "Coba sesuaikan pencarianmu",
-    "noModsInstalled": "Tidak ada Mod Terinstal",
-    "noModsInstalledDesc": "Tambahkan mod dari CurseForge atau impor file lokal",
-    "view": "LIHAT",
-    "install": "INSTAL",
-    "installed": "TERINSTAL",
-    "enable": "AKTIFKAN",
-    "disable": "NONAKTIFKAN",
-    "active": "AKTIF",
-    "disabled": "NONAKTIF",
-    "delete": "Hapus mod",
-    "noDescription": "Tidak ada deskripsi tersedia",
-    "confirmDelete": "Apakah kamu yakin ingin menghapus \"{name}\"?",
-    "confirmDeleteDesc": "Tindakan ini tidak dapat dibatalkan.",
-    "confirmDeletion": "Konfirmasi Penghapusan",
-    "apiKeyRequired": "Kunci API Diperlukan",
-    "apiKeyRequiredDesc": "Kunci API CurseForge diperlukan untuk menelusuri mod"
-  },
-  "news": {
-    "title": "SEMUA BERITA",
-    "readMore": "Baca Selengkapnya"
-  },
-  "chat": {
-    "title": "OBROLAN PEMAIN",
-    "pickColor": "Warna",
-    "inputPlaceholder": "Ketik pesanmu...",
-    "send": "Kirim",
-    "online": "aktif",
-    "charCounter": "{current}/{max}",
-    "secureChat": "Obrolan aman - Tautan disensor",
-    "joinChat": "Gabung Obrolan",
-    "chooseUsername": "Pilih nama pengguna untuk bergabung ke Obrolan Pemain",
-    "username": "Nama Pengguna",
-    "usernamePlaceholder": "Masukkan nama penggunamu...",
-    "usernameHint": "3-20 karakter, huruf, angka, - dan _ saja",
-    "joinButton": "Gabung Obrolan",
-    "colorModal": {
-      "title": "Kustomisasi Warna Nama Pengguna",
-      "chooseSolid": "Pilih warna solid:",
-      "customColor": "Warna kustom:",
-      "preview": "Pratinjau:",
-      "previewUsername": "Nama Pengguna",
-      "apply": "Terapkan Warna"
-    }
-  },
-  "settings": {
-    "title": "PENGATURAN",
-    "java": "Runtime Java",
-    "useCustomJava": "Gunakan lokasi Java Kustom",
-    "javaDescription": "Ganti runtime Java bawaan dengan instalasi milikmu",
-    "javaPath": "Lokasi Eksekutabel Java",
-    "javaPathPlaceholder": "Pilih lokasi Java...",
-    "javaBrowse": "Telusuri",
-    "javaHint": "Pilih folder instalasi Java (mendukung Windows, Mac, Linux)",
-    "discord": "Integrasi Discord",
-    "enableRPC": "Aktifkan Discord Rich Presence",
-    "discordDescription": "Tampilkan aktivitas launchermu di Discord",
-    "game": "Opsi Game",
-    "playerName": "Nama Pemain",
-    "playerNamePlaceholder": "Masukkan nama pemainmu",
-    "playerNameHint": "Nama ini akan digunakan di dalam game (1-16 karakter)",
-    "openGameLocation": "Buka Lokasi Game",
-    "openGameLocationDesc": "Buka folder instalasi game",
-    "account": "Manajemen UUID Pemain",
-    "currentUUID": "UUID Saat Ini",
-    "uuidPlaceholder": "Memuat UUID...",
-    "copyUUID": "Salin UUID",
-    "regenerateUUID": "Regenerasi UUID",
-    "uuidHint": "Pengidentifikasi pemain unikmu untuk nama pengguna ini",
-    "manageUUIDs": "Kelola Semua UUID",
-    "manageUUIDsDesc": "Lihat dan kelola semua UUID pemain",
-    "language": "Bahasa",
-    "selectLanguage": "Pilih Bahasa",
-    "repairGame": "Perbaiki Game",
-    "reinstallGame": "Instal ulang file game (tetap menyimpan data)",
-    "gpuPreference": "Preferensi GPU",
-    "gpuHint": "Fitur khusus laptop; setel ke Terintegrasi jika di PC",
-    "gpuAuto": "Otomatis",
-    "gpuIntegrated": "Terintegrasi",
-    "gpuDedicated": "Terdedikasi",
-    "logs": "LOG SISTEM",
-    "logsCopy": "Salin",
-    "logsRefresh": "Segarkan",
-    "logsFolder": "Buka Folder",
-    "logsLoading": "Memuat log...",
-    "closeLauncher": "Perilaku Launcher",
-    "closeOnStart": "Tutup launcher saat game dimulai",
-    "closeOnStartDescription": "Tutup launcher secara otomatis setelah Hytale diluncurkan",
-    "hwAccel": "Akselerasi Perangkat Keras",
-    "hwAccelDescription": "Aktifkan akselerasi perangkat keras untuk launcher`",
-    "gameBranch": "Cabang Game",
-    "branchRelease": "Rilis",
-    "branchPreRelease": "Pra-Rilis",
-    "branchHint": "Beralih antara rilis stabil dan versi pra-rilis eksperimental",
-    "branchWarning": "Mengubah cabang akan mengunduh dan menginstal versi game yang berbeda",
-    "branchSwitching": "Beralih ke {branch}...",
-    "branchSwitched": "Berhasil beralih ke {branch}!",
-    "installRequired": "Instalasi Diperlukan",
-    "branchInstallConfirm": "Game akan diinstal untuk cabang {branch}. Lanjutkan?"
-  },
-  "uuid": {
-    "modalTitle": "Manajemen UUID",
-    "currentUserUUID": "UUID Pengguna Saat Ini",
-    "allPlayerUUIDs": "Semua UUID Pemain",
-    "generateNew": "Hasilkan UUID Baru",
-    "loadingUUIDs": "Memuat UUID...",
-    "setCustomUUID": "Setel UUID Kustom",
-    "customPlaceholder": "Masukkan UUID kustom (format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)",
-    "setUUID": "Setel UUID",
-    "warning": "Peringatan: Menyetel UUID secara kustom akan mengubah identitas pemainmu saat ini",
-    "copyTooltip": "Salin UUID",
-    "regenerateTooltip": "Hasilkan UUID Baru"
-  },
-  "profiles": {
-    "modalTitle": "Kelola Profil",
-    "newProfilePlaceholder": "Nama Profil Baru",
-    "createProfile": "Buat Profil"
-  },
-  "discord": {
-    "notificationText": "Gabung komunitas Discord kami!",
-    "joinButton": "Gabung Discord"
-  },
-  "common": {
-    "confirm": "Konfirmasi",
-    "cancel": "Batal",
-    "save": "Simpan",
-    "close": "Tutup",
-    "delete": "Hapus",
-    "edit": "Edit",
-    "loading": "Memuat...",
-    "apply": "Terapkan",
-    "install": "Instal"
-  },
-  "notifications": {
-    "gameDataNotFound": "Kesalahan: Data game tidak ditemukan",
-    "gameUpdatedSuccess": "Game berhasil diperbarui! 🎉",
-    "updateFailed": "Pembaruan gagal: {error}",
-    "updateError": "Kesalahan pembaruan: {error}",
-    "discordEnabled": "Discord Rich Presence diaktifkan",
-    "discordDisabled": "Discord Rich Presence dinonaktifkan",
-    "discordSaveFailed": "Gagal menyimpan pengaturan Discord",
-    "playerNameRequired": "Silakan masukkan nama pemain yang valid",
-    "playerNameSaved": "Nama pemain berhasil disimpan",
-    "playerNameSaveFailed": "Gagal menyimpan nama pemain",
-    "uuidCopied": "UUID disalin ke papan klip!",
-    "uuidCopyFailed": "Gagal menyalin UUID",
-    "uuidRegenNotAvailable": "Regenerasi UUID tidak tersedia",
-    "uuidRegenFailed": "Gagal meregenerasi UUID",
-    "uuidGenerated": "UUID baru berhasil dihasilkan!",
-    "uuidGeneratedShort": "UUID baru dihasilkan!",
-    "uuidGenerateFailed": "Gagal menghasilkan UUID baru",
-    "uuidRequired": "Silakan masukkan UUID",
-    "uuidInvalidFormat": "Format UUID tidak valid",
-    "uuidSetFailed": "Gagal menyetel UUID kustom",
-    "uuidSetSuccess": "UUID kustom berhasil disetel!",
-    "uuidDeleteFailed": "Gagal menghapus UUID",
-    "uuidDeleteSuccess": "UUID berhasil dihapus!",
-    "modsDownloading": "Mengunduh {name}...",
-    "modsTogglingMod": "Beralih mod...",
-    "modsDeletingMod": "Menghapus mod...",
-    "modsLoadingMods": "Memuat mod dari CurseForge...",
-    "modsInstalledSuccess": "{name} berhasil diinstal! 🎉",
-    "modsDeletedSuccess": "{name} berhasil dihapus",
-    "modsDownloadFailed": "Gagal mengunduh mod: {error}",
-    "modsToggleFailed": "Gagal beralih mod: {error}",
-    "modsDeleteFailed": "Gagal menghapus mod: {error}",
-    "modsModNotFound": "Informasi mod tidak ditemukan",
-    "hwAccelSaved": "Pengaturan akselerasi perangkat keras disimpan",
-    "hwAccelSaveFailed": "Gagal menyimpan pengaturan akselerasi perangkat keras"
-  },
-  "confirm": {
-    "defaultTitle": "Konfirmasi tindakan",
-    "regenerateUuidTitle": "Hasilkan UUID baru",
-    "regenerateUuidMessage": "Apakah kamu yakin ingin menghasilkan UUID baru? Ini akan mengubah identitas pemainmu.",
-    "regenerateUuidButton": "Hasilkan",
-    "setCustomUuidTitle": "Setel UUID kustom",
-    "setCustomUuidMessage": "Apakah kamu yakin ingin menyetel UUID kustom ini? Ini akan mengubah identitas pemainmu.",
-    "setCustomUuidButton": "Setel UUID",
-    "deleteUuidTitle": "Hapus UUID",
-    "deleteUuidMessage": "Apakah kamu yakin ingin menghapus UUID untuk \"{username}\"? Tindakan ini tidak dapat dibatalkan.",
-    "deleteUuidButton": "Hapus",
-    "uninstallGameTitle": "Hapus instalasi game",
-    "uninstallGameMessage": "Apakah kamu yakin ingin menghapus instalasi Hytale? Semua file game akan dihapus.",
-    "uninstallGameButton": "Hapus Instalasi"
-  },
-  "progress": {
-    "initializing": "Menginisialisasi...",
-    "downloading": "Mengunduh...",
-    "installing": "Menginstal...",
-    "extracting": "Mengekstrak...",
-    "verifying": "Memverifikasi...",
-    "switchingProfile": "Beralih profil...",
-    "profileSwitched": "Profil dialihkan!",
-    "startingGame": "Memulai game...",
-    "launching": "MELUNCURKAN...",
-    "uninstallingGame": "Menghapus instalasi game...",
-    "gameUninstalled": "Instalasi game berhasil dihapus!",
-    "uninstallFailed": "Penghapusan instalasi gagal: {error}",
-    "startingUpdate": "Memulai pembaruan game wajib...",
-    "installationComplete": "Instalasi berhasil diselesaikan!",
-    "installationFailed": "Instalasi gagal: {error}",
-    "installingGameFiles": "Menginstal file game...",
-    "installComplete": "Instalasi selesai!"
-  }
-}

GUI/locales/pl-PL.json

@@ -4,20 +4,19 @@
     "mods": "Mody",
     "news": "Wiadomości",
     "chat": "Chat z graczami",
-    "settings": "Ustawienia"
+    "settings": "Ustawienia",
+    "skins": "Skiny"
   },
   "header": {
     "playersLabel": "Graczy:",
     "manageProfiles": "Zarządzaj Profilami",
-    "defaultProfile": "Domyślny"
+    "defaultProfile": "Domyślny",
+    "f2p": "FREE TO PLAY"
   },
   "install": {
-    "title": "DARMOWY LAUNCHER",
+    "title": "FREE TO PLAY LAUNCHER",
     "playerName": "Nazwa Gracza",
     "playerNamePlaceholder": "Wprowadź Nazwę",
-    "gameBranch": "Wersja Gry",
-    "releaseVersion": "Wydanie (Stabilna)",
-    "preReleaseVersion": "Przed-Wydaniem (Eksperymentalna)",
     "customInstallation": "Dostosuj Instalacje",
     "installationFolder": "Folder docelowy",
     "pathPlaceholder": "Domyślna lokalizacja",
@@ -57,9 +56,7 @@
     "noDescription": "Brak opisu",
     "confirmDelete": "Czy na pewno chcesz usunąć \"{name}\"?",
     "confirmDeleteDesc": "Tej czynności nie można cofnąć.",
-    "confirmDeletion": "Potwierdź",
-    "apiKeyRequired": "Wymagany Klucz API",
-    "apiKeyRequiredDesc": "Klucz API CurseForge jest potrzebny do przeglądania modów"
+    "confirmDeletion": "Potwierdź"
   },
   "news": {
     "title": "WSZYSTKIE WIADOMOŚCI",
@@ -119,29 +116,15 @@
     "repairGame": "Napraw Grę",
     "reinstallGame": "Zainstaluj ponownie pliki gry (zachowuje dane)",
     "gpuPreference": "Preferencje GPU",
-    "gpuHint": "Funkcja dostępna tylko na laptopie; ustaw na Zintegrowaną, jeśli na komputerze PC",
+    "gpuHint": "Wybierz preferowany procesor graficzny (Linux: wpływa na DRI_PRIME)",
     "gpuAuto": "Auto",
     "gpuIntegrated": "Zintegrowana",
     "gpuDedicated": "Dedykowana",
-    "logs": "DZIENNIKI SYSTEMOWE",
+    "logs": "SYSTEM LOGS",
     "logsCopy": "Kopiuj",
     "logsRefresh": "Odśwież",
     "logsFolder": "Otwórz Folder",
-    "logsLoading": "Ładowanie logów...",
-    "closeLauncher": "Zachowanie Launchera",
-    "closeOnStart": "Zamknij Launcher przy starcie gry",
-    "closeOnStartDescription": "Automatycznie zamknij launcher po uruchomieniu Hytale",
-    "hwAccel": "Przyspieszenie Sprzętowe",
-    "hwAccelDescription": "Włącz przyspieszenie sprzętowe dla launchera",
-    "gameBranch": "Gałąź Gry",
-    "branchRelease": "Wydanie",
-    "branchPreRelease": "Przed-Wydaniem",
-    "branchHint": "Przełączaj między stabilnym wydaniem a eksperymentalną wersją przed-wydaniem",
-    "branchWarning": "Zmiana gałęzi spowoduje pobranie i instalację innej wersji gry",
-    "branchSwitching": "Przełączanie na {branch}...",
-    "branchSwitched": "Pomyślnie przełączono na {branch}!",
-    "installRequired": "Wymagana Instalacja",
-    "branchInstallConfirm": "Gra zostanie zainstalowana dla gałęzi {branch}. Kontynuować?"
+    "logsLoading": "Ładowanie logów..."
   },
   "uuid": {
     "modalTitle": "Zarządzanie UUID",
@@ -165,6 +148,10 @@
     "notificationText": "Dołącz do naszej społeczności Discord!",
     "joinButton": "Dołącz Discord"
   },
+  "skins": {
+    "title": "Skiny",
+    "comingSoon": "Personalizacja skórek już wkrótce..."
+  },
   "common": {
     "confirm": "Potwierdź",
     "cancel": "Anuluj",
@@ -173,8 +160,7 @@
     "delete": "Usuń",
     "edit": "Edytuj",
     "loading": "Ładowanie...",
-    "apply": "Zastosuj",
-    "install": "Zainstaluj"
+    "apply": "Zastosuj"
   },
   "notifications": {
     "gameDataNotFound": "Błąd: Nie znaleziono danych gry",
@@ -209,9 +195,7 @@
     "modsDownloadFailed": "Nie udało się pobrać moda: {error}",
     "modsToggleFailed": "Nie udało się przełączyć moda: {error}",
     "modsDeleteFailed": "Nie udało się usunąć moda: {error}",
-    "modsModNotFound": "Nie znaleziono informacji o modzie",
-    "hwAccelSaved": "Zapisano ustawienie przyspieszenia sprzętowego",
-    "hwAccelSaveFailed": "Nie udało się zapisać ustawienia przyspieszenia sprzętowego"
+    "modsModNotFound": "Nie znaleziono informacji o modzie"
   },
   "confirm": {
     "defaultTitle": "Potwierdź działanie",
@@ -247,4 +231,4 @@
     "installingGameFiles": "Instalowanie plików gry...",
     "installComplete": "Instalacja zakończona!"
   }
-}
+}

GUI/locales/pt-BR.json

@@ -14,11 +14,9 @@
   "install": {
     "title": "LANÇADOR JOGO GRATUITO",
     "playerName": "Nome do Jogador",
-    "playerNamePlaceholder": "Digite seu nome",
-    "gameBranch": "Versão do Jogo",
+    "playerNamePlaceholder": "Digite seu nome",    "gameBranch": "Versão do Jogo",
     "releaseVersion": "Lançamento (Estável)",
-    "preReleaseVersion": "Pré-Lançamento (Experimental)",
-    "customInstallation": "Instalação Personalizada",
+    "preReleaseVersion": "Pré-Lançamento (Experimental)",    "customInstallation": "Instalação Personalizada",
     "installationFolder": "Pasta de Instalação",
     "pathPlaceholder": "Local padrão",
     "browse": "Procurar",
@@ -119,7 +117,7 @@
     "repairGame": "Reparar jogo",
     "reinstallGame": "Reinstalar arquivos do jogo (mantém os dados)",
     "gpuPreference": "Preferência de GPU",
-    "gpuHint": "Recurso exclusivo para laptops; defina como Integrado se estiver em um PC.",
+    "gpuHint": "Selecione sua GPU preferida (Linux: afeta o DRI_PRIME)",
     "gpuAuto": "Automático",
     "gpuIntegrated": "Integrada",
     "gpuDedicated": "Dedicada",
@@ -131,8 +129,6 @@
     "closeLauncher": "Comportamento do Lançador",
     "closeOnStart": "Fechar Lançador ao iniciar o jogo",
     "closeOnStartDescription": "Fechar automaticamente o lançador após o Hytale ter sido iniciado",
-    "hwAccel": "Aceleração de Hardware",
-    "hwAccelDescription": "Ativar aceleração de hardware para o lançador",
     "gameBranch": "Versão do Jogo",
     "branchRelease": "Lançamento",
     "branchPreRelease": "Pré-Lançamento",
@@ -165,6 +161,7 @@
     "notificationText": "Junte-se à nossa comunidade do Discord!",
     "joinButton": "Entrar no Discord"
   },
+
   "common": {
     "confirm": "Confirmar",
     "cancel": "Cancelar",
@@ -209,9 +206,7 @@
     "modsDownloadFailed": "Falha ao baixar mod: {error}",
     "modsToggleFailed": "Falha ao alternar mod: {error}",
     "modsDeleteFailed": "Falha ao excluir mod: {error}",
-    "modsModNotFound": "Informações do mod não encontradas",
-    "hwAccelSaved": "Configuração de aceleração de hardware salva",
-    "hwAccelSaveFailed": "Falha ao salvar configuração de aceleração de hardware"
+    "modsModNotFound": "Informações do mod não encontradas"
   },
   "confirm": {
     "defaultTitle": "Confirmar ação",

GUI/locales/ru-RU.json

@@ -1,250 +0,0 @@
-{
-  "nav": {
-    "play": "Играть",
-    "mods": "Моды",
-    "news": "Новости",
-    "chat": "Чат игроков",
-    "settings": "Настройки"
-  },
-  "header": {
-    "playersLabel": "Игроки:",
-    "manageProfiles": "Управлять профилями:",
-    "defaultProfile": "По умолчанию"
-  },
-  "install": {
-    "title": "FREE TO PLAY LAUNCHER",
-    "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": "Java Runtime",
-    "useCustomJava": "Укажите свой путь Java",
-    "javaDescription": "Переопределить встроенный Java Runtime с вашей установкой",
-    "javaPath": "Путь исполняемого файла Java",
-    "javaPathPlaceholder": "Выберите путь Java...",
-    "javaBrowse": "Обзор",
-    "javaHint": "Выберите папку установки Java (поддерживается Windows, Mac, Linux)",
-    "discord": "Интеграция Discord",
-    "enableRPC": "Включить Discord Rich Presence",
-    "discordDescription": "Показывать вашу активность лаунчера в Discord",
-    "game": "Настройки игры",
-    "playerName": "Ник игрока",
-    "playerNamePlaceholder": "Введите ваш ник",
-    "playerNameHint": "Этот ник будет использован в игре (1-16 символов)",
-    "openGameLocation": "Открыть местоположение игры",
-    "openGameLocationDesc": "Открыть папку установки игры",
-    "account": "Управление UUID игрока",
-    "currentUUID": "Текущий UUID",
-    "uuidPlaceholder": "Загрузка UUID...",
-    "copyUUID": "Копировать UUID",
-    "regenerateUUID": "Перегенерировать UUID",
-    "uuidHint": "Уникальный идентификатор игрока для этого ника",
-    "manageUUIDs": "Управление всеми UUID",
-    "manageUUIDsDesc": "Смотреть и управлять всеми UUID игрока",
-    "language": "Язык",
-    "selectLanguage": "Выберите язык",
-    "repairGame": "Починить игру",
-    "reinstallGame": "Переустановить файлы игры (сохраняет данные)",
-    "gpuPreference": "Предпочтение GPU",
-    "gpuHint": "Функция доступна только на ноутбуках; при использовании на ПК выберите встроенную видеокарту.",
-    "gpuAuto": "Автоматический выбор",
-    "gpuIntegrated": "Интегрированная видеокарта",
-    "gpuDedicated": "Дискретная видеокарта",
-    "logs": "ЛОГИ",
-    "logsCopy": "Копировать",
-    "logsRefresh": "Обновить",
-    "logsFolder": "Открыть папку",
-    "logsLoading": "Загрузка логов...",
-    "closeLauncher": "Поведение лаунчера",
-    "closeOnStart": "Закрыть лаунчер при старте игры",
-    "closeOnStartDescription": "Автоматически закрыть лаунчер после запуска Hytale",
-    "hwAccel": "Аппаратное ускорение",
-    "hwAccelDescription": "Включить аппаратное ускорение для лаунчера",
-    "gameBranch": "Ветка игры",
-    "branchRelease": "Релиз",
-    "branchPreRelease": "Пре-Релиз",
-    "branchHint": "Переключает между релизом и пре-релизом игры",
-    "branchWarning": "Изменение ветки скачает и установит другую версию игры",
-    "branchSwitching": "Переключение на {branch}...",
-    "branchSwitched": "Переключение на {branch} выполнено успешно!",
-    "installRequired": "Необходима установка",
-    "branchInstallConfirm": "Игра будет установлена для ветки {branch}. Продолжить?"
-  },
-  "uuid": {
-    "modalTitle": "Управление UUID",
-    "currentUserUUID": "UUID текущего пользователя",
-    "allPlayerUUIDs": "UUID всех игроков",
-    "generateNew": "Сгенерировать новый UUID",
-    "loadingUUIDs": "Загрузка UUID...",
-    "setCustomUUID": "Установить кастомный UUID",
-    "customPlaceholder": "Ввести кастомный UUID (форматы: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)",
-    "setUUID": "Установить UUID",
-    "warning": "Внимание! Установка кастомного UUID изменит вашу текущую личность игрока!",
-    "copyTooltip": "Скопировать UUID",
-    "regenerateTooltip": "Сгенерировать новый UUID"
-  },
-  "profiles": {
-    "modalTitle": "Управление профилями",
-    "newProfilePlaceholder": "Новое имя профиля",
-    "createProfile": "Создать профиль"
-  },
-  "discord": {
-    "notificationText": "Присоединитесь к нашему сообществу в Discord!",
-    "joinButton": "Присоединиться к Discord"
-  },
-  "common": {
-    "confirm": "Подтвердить",
-    "cancel": "Отменить",
-    "save": "Сохранить",
-    "close": "Закрыть",
-    "delete": "Удалить",
-    "edit": "Редактировать",
-    "loading": "Загружается...",
-    "apply": "Применить",
-    "install": "Установить"
-  },
-  "notifications": {
-    "gameDataNotFound": "Ошибка: данные игры не найдены",
-    "gameUpdatedSuccess": "Игра успешно обновлена! Ура! 🎉",
-    "updateFailed": "Обновление прервалось с ошибкой: {error}",
-    "updateError": "Ошибка обновления: {error}",
-    "discordEnabled": "Discord Rich Presence включен",
-    "discordDisabled": "Discord Rich Presence выключен",
-    "discordSaveFailed": "Не удалось сохранить настройку Discord",
-    "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": "Не удалось сохранить настройку аппаратного ускорения"
-  },
-  "confirm": {
-    "defaultTitle": "Подтвердить действие",
-    "regenerateUuidTitle": "Сгенерировать новый UUID",
-    "regenerateUuidMessage": "Вы уверены, что хотите сгенерировать новый UUID? Генерация нового UUID изменит вашу текущую личность игрока!",
-    "regenerateUuidButton": "Сгенерировать",
-    "setCustomUuidTitle": "Установить кастомный UUID",
-    "setCustomUuidMessage": "Вы уверены, что хотите установить кастомный UUID? Установка кастомного UUID изменит вашу текущую личность игрока!",
-    "setCustomUuidButton": "Установить UUID",
-    "deleteUuidTitle": "Удалить UUID",
-    "deleteUuidMessage": "Вы уверены, что хотите удалить UUID для \"{username}\"? Это действие необратимо!",
-    "deleteUuidButton": "Удалить",
-    "uninstallGameTitle": "Удалить игру",
-    "uninstallGameMessage": "Вы уверены, что хотите удалить Hytale? Все данные игры будут безвозвратно удалены!",
-    "uninstallGameButton": "Удалить"
-  },
-  "progress": {
-    "initializing": "Инициализация...",
-    "downloading": "Скачивание...",
-    "installing": "Установка...",
-    "extracting": "Извлечение...",
-    "verifying": "Проверка...",
-    "switchingProfile": "Смена профиля...",
-    "profileSwitched": "Профиль сменён!",
-    "startingGame": "Запуск игры...",
-    "launching": "ЗАПУСК...",
-    "uninstallingGame": "Удаление игры...",
-    "gameUninstalled": "Игра успешно удалена!",
-    "uninstallFailed": "Удаление игры прервано с ошибкой: {error}",
-    "startingUpdate": "Начало обязательного обновления игры...",
-    "installationComplete": "Установка успешно завершена!",
-    "installationFailed": "Установка прервана с ошибкой: {error}",
-    "installingGameFiles": "Установка файлов игры...",
-    "installComplete": "Установка завершена!"
-  }
-}

GUI/locales/sv.json

@@ -119,7 +119,7 @@
     "repairGame": "Reparera spel",
     "reinstallGame": "Ominstallera spelfiler (bevarar data)",
     "gpuPreference": "GPU-preferens",
-    "gpuHint": "Endast för bärbar dator; inställd på Integrerad om den är på datorn",
+    "gpuHint": "Välj din föredragna GPU (Linux: påverkar DRI_PRIME)",
     "gpuAuto": "Auto",
     "gpuIntegrated": "Integrerad",
     "gpuDedicated": "Dedikerad",
@@ -211,7 +211,40 @@
     "modsDeleteFailed": "Misslyckades med att ta bort modd: {error}",
     "modsModNotFound": "Moddinformation hittades inte",
     "hwAccelSaved": "Hårdvaruaccelerationsinställning sparad",
-    "hwAccelSaveFailed": "Misslyckades med att spara hårdvaruaccelerationsinställning"
+    "hwAccelSaveFailed": "Misslyckades med att spara hårdvaruaccelerationsinställning",
+    "javaPathCopied": "Java-sökväg kopierad till urklipp!",
+    "javaPathCopyFailed": "Misslyckades med att kopiera Java-sökväg",
+    "javaPathSaved": "Java-sökväg sparad framgångsrikt!",
+    "javaPathSaveFailed": "Misslyckades med att spara Java-sökväg",
+    "javaPathInvalid": "Ogiltig Java-sökväg",
+    "javaPathReset": "Java-sökväg återställd till standardvärden",
+    "gameLocationError": "Kunde inte öppna spelplats",
+    "launcherRestartRequired": "Launcher-omstart krävs för att tillämpa ändringar",
+    "gameRepairConfirm": "Är du säker på att du vill reparera spelet? Detta kommer att ominstallera alla spelfiler.",
+    "gameRepairInProgress": "Reparerar spel...",
+    "gameRepairSuccess": "Spel reparerat framgångsrikt!",
+    "gameRepairFailed": "Spelreparation misslyckades: {error}",
+    "invalidUsername": "Ogiltigt användarnamn",
+    "usernameInUse": "Användarnamn upptaget",
+    "chatJoinSuccess": "Du har gått med i chatten!",
+    "chatJoinFailed": "Misslyckades med att gå med i chatten",
+    "messageTooLong": "Meddelande för långt",
+    "messageSent": "Meddelande skickat",
+    "messageSendFailed": "Misslyckades med att skicka meddelande",
+    "colorUpdated": "Färg uppdaterad!",
+    "colorUpdateFailed": "Misslyckades med att uppdatera färg",
+    "profileCreated": "Profil skapad framgångsrikt!",
+    "profileCreateFailed": "Misslyckades med att skapa profil",
+    "profileDeleted": "Profil borttagen",
+    "profileDeleteFailed": "Misslyckades med att ta bort profil",
+    "profileSwitched": "Bytte profil till: {name}",
+    "profileSwitchFailed": "Profilbyte misslyckades",
+    "invalidProfileName": "Ogiltigt profilnamn",
+    "profileNameExists": "En profil med detta namn finns redan",
+    "noInternet": "Ingen internetanslutning",
+    "checkInternetConnection": "Kontrollera din internetanslutning",
+    "serverError": "Serverfel. Försök igen senare.",
+    "unknownError": "Ett okänt fel inträffade"
   },
   "confirm": {
     "defaultTitle": "Bekräfta åtgärd",
@@ -247,4 +280,4 @@
     "installingGameFiles": "Installerar spelfiler...",
     "installComplete": "Installation slutförd!"
   }
-}
+}

GUI/locales/tr-TR.json

@@ -119,7 +119,7 @@
     "repairGame": "Oyunu Onarı",
     "reinstallGame": "Oyun dosyalarını yeniden kur (veri korur)",
     "gpuPreference": "GPU Tercihi",
-    "gpuHint": "Sadece dizüstü bilgisayarlarda bulunan bir özellik; PC'de kullanılıyorsa Entegre olarak ayarlayın.",
+    "gpuHint": "Tercih ettiğiniz GPU'yu seçin (Linux: DRI_PRIME'ı etkiler)",
     "gpuAuto": "Otomatik",
     "gpuIntegrated": "Entegre",
     "gpuDedicated": "Ayrılmış",
@@ -131,8 +131,6 @@
     "closeLauncher": "Başlatıcı Davranışı",
     "closeOnStart": "Oyun başlatıldığında Başlatıcıyı Kapat",
     "closeOnStartDescription": "Hytale başlatıldıktan sonra başlatıcıyı otomatik olarak kapatın",
-    "hwAccel": "Donanım Hızlandırma",
-    "hwAccelDescription": "Başlatıcı için donanım hızlandırmasını etkinleştir",
     "gameBranch": "Oyun Dalı",
     "branchRelease": "Yayın",
     "branchPreRelease": "Ön-Yayın",
@@ -209,9 +207,7 @@
     "modsDownloadFailed": "Mod indirilemedi: {error}",
     "modsToggleFailed": "Mod değiştirilemedi: {error}",
     "modsDeleteFailed": "Mod silinemedi: {error}",
-    "modsModNotFound": "Mod bilgileri bulunamadı",
-    "hwAccelSaved": "Donanım hızlandırma ayarı kaydedildi",
-    "hwAccelSaveFailed": "Donanım hızlandırma ayarı kaydedilemedi"
+    "modsModNotFound": "Mod bilgileri bulunamadı"
   },
   "confirm": {
     "defaultTitle": "Eylemi onayla",
@@ -247,4 +243,4 @@
     "installingGameFiles": "Oyun dosyaları kuruluyor...",
     "installComplete": "Kurulum tamamlandı!"
   }
-}
+}

PKGBUILD

@@ -2,7 +2,7 @@
 # Maintainer: Fazri Gading <fazrigading@gmail.com>
 # This PKGBUILD is for Github Releases
 pkgname=Hytale-F2P
-pkgver=2.2.0
+pkgver=2.1.1
 pkgrel=1
 pkgdesc="Hytale-F2P - unofficial Hytale Launcher for free to play with multiplayer support"
 arch=('x86_64')
@@ -10,8 +10,6 @@ url="https://github.com/amiayweb/Hytale-F2P"
 license=('custom')
 depends=('gtk3' 'nss' 'libxcrypt-compat')
 makedepends=('npm')
-provides=('Hytale-F2P-git' 'hytale-f2p-git')
-conflicts=('Hytale-F2P-git' 'hytale-f2p-git')
 source=("$url/archive/v$pkgver.tar.gz" "Hytale-F2P.desktop")
 sha256sums=('SKIP' '46488fada4775d9976d7b7b62f8d1f1f8d9a9a9d8f8aa9af4f2e2153019f6a30')
 

PKGBUILD-git

@@ -10,25 +10,25 @@ url="https://github.com/amiayweb/Hytale-F2P"
 license=('custom')
 depends=('gtk3' 'nss' 'libxcrypt-compat')
 makedepends=('git' 'npm')
-provides=('Hytale-F2P' 'hytale-f2p-git')
-conflicts=('Hytale-F2P' 'hytale-f2p-git')
 source=("git+$url.git" "$_pkgname.desktop")
 sha256sums=('SKIP' '46488fada4775d9976d7b7b62f8d1f1f8d9a9a9d8f8aa9af4f2e2153019f6a30')
 
 pkgver() {
-  cd "$_pkgname"
+  cd "$srcdir/$_pkgname"
   git describe --tags --long | sed 's/^v//;s/-/.r/;s/-/./'
 }
 
 build() {
-   cd "$_pkgname"
+   cd "$srcdir/$_pkgname"
    npm ci
    npm run build:arch
 }
 
 package() {
-  mkdir -p "$pkgdir/opt/$_pkgname"
+  cd "$srcdir/$_pkgname"
+  install -d "$pkgdir/opt/$_pkgname"
   cp -r "$_pkgname/dist/linux-unpacked/"* "$pkgdir/opt/$_pkgname"
-  install -Dm644 "$_pkgname.desktop" "$pkgdir/usr/share/applications/$_pkgname.desktop"
-  install -Dm644 "$_pkgname/GUI/icon.png" "$pkgdir/usr/share/icons/hicolor/256x256/apps/$_pkgname.png"
+
+  install -Dm644 "$srcdir/$_pkgname.desktop" "$pkgdir/usr/share/applications/$_pkgname.desktop"
+  install -Dm644 GUI/icon.png "$pkgdir/usr/share/icons/hicolor/256x256/apps/$_pkgname.png"
 }

README.md

@@ -4,20 +4,19 @@
   <h1>🎮 Hytale F2P Launcher 🚀</h1>
   <h2>💻 Cross-Platform Multiplayer 🖥️</h2>
   <h3>Available for Windows 🪟, macOS 🍎, and Linux 🐧</h3>
-  <p><small>An unofficial cross-platform launcher for Hytale with automatic updates and multiplayer support!</small></p>
+  <p><small>An unofficial cross-platform launcher for Hytale with automatic updates and multiplayer support (all OS supported)</small></p>
 </header>
 
-![GitHub Downloads](https://img.shields.io/github/downloads/amiayweb/Hytale-F2P/total?style=for-the-badge)
+![Version](https://img.shields.io/badge/Version-2.1.1-green?style=for-the-badge)
 ![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-orange?style=for-the-badge)
 ![License](https://img.shields.io/badge/License-Educational-blue?style=for-the-badge)
-![Version](https://img.shields.io/badge/Version-2.2.0-green?style=for-the-badge)
 
 [![GitHub stars](https://img.shields.io/github/stars/amiayweb/Hytale-F2P?style=social)](https://github.com/amiayweb/Hytale-F2P/stargazers)
 [![GitHub forks](https://img.shields.io/github/forks/amiayweb/Hytale-F2P?style=social)](https://github.com/amiayweb/Hytale-F2P/network/members)
 
 ⭐ **If you find this project useful, please give it a STAR!** ⭐
 
-### ⚠️ **READ [QUICK START](README.md#-quick-start) before Downloading & Installing the Launcher!** ⚠️
+### ⚠️ **READ [QUICK START](https://github.com/amiayweb/Hytale-F2P/tree/main?tab=readme-ov-file#-quick-start) before Downloading & Installing the Launcher!** ⚠️
 
 #### 🛑 **Found a problem? Join the Discord and Select #Open-A-Ticket!: https://discord.gg/gME8rUy3MB** 🛑
 
@@ -36,37 +35,37 @@
 ## 📸 Screenshots
 
 <div align="center">
-  <img src="https://i.imgur.com/wwuuMUf.png" alt="Hytale F2P Launcher" width="1000">
+  <img src="https://i.imgur.com/xW9do3d.png" alt="Hytale F2P Launcher" width="1000">
   <details>
     <summary><b>View Gallery</b></summary>
     <table style="width: 100%; border-spacing: 15px; border-collapse: separate;">
       <tr>
         <td align="center" style="vertical-align: top; width: 50%;">
-          <b>Featured Servers 🆕</b><br>
-          <img src="https://i.imgur.com/fEu9y3Z.png" alt="Hytale F2P Featured Servers" width="100%">
+          <b>Mods Preview</b><br>
+          <img src="https://i.imgur.com/f8qyIJy.png" alt="Hytale F2P Mods" width="100%">
         </td>
         <td align="center" style="vertical-align: top; width: 50%;">
-          <b>Settings Page ⚙️</b><br>
-          <img src="https://i.imgur.com/l5iBzxc.png" alt="Hytale F2P Settings Page" width="100%">
+          <b>Latest News</b><br>
+          <img src="https://i.imgur.com/qu0HltD.png" alt="Hytale F2P News" width="100%">
         </td>
       </tr>
       <tr>
         <td align="center" style="vertical-align: top; width: 50%;">
-          <b>Downloadable Mods from CurseForge 🛠️</b><br>
-          <img src="https://i.imgur.com/QIDbqYn.png" alt="Hytale F2P Mods Download" width="100%">
+          <b>Social & Chat</b><br>
+          <img src="https://i.imgur.com/t3GmbfF.png" alt="Hytale F2P Chat" width="100%">
         </td>
         <td align="center" style="vertical-align: top; width: 50%;">
-          <b>My Mods Menu 🔧</b><br>
-          <img src="https://i.imgur.com/rjvwUfq.png" alt="Hytale F2P My Mods Menu" width="100%">
+          <b>Settings</b><br>
+          <img src="https://i.imgur.com/uUD7lDB.png" alt="Hytale F2P Settings" width="100%">
         </td>
       </tr>
       <tr>
         <td align="center" style="vertical-align: top; width: 50%;">
-          <b>In-Game Screenshot - Spawn Point 🎮</b><br>
+          <b>In-Game Screenshot - Spawn Point</b><br>
           <img src="https://i.imgur.com/X8lNFQ7.png" alt="Hytale F2P In-Game Screenshot-1" width="100%">
         </td>
         <td align="center" style="vertical-align: top; width: 50%;">
-          <b>In-Game Screenshot - Gameplay Terrain 🌳</b><br>
+          <b>In-Game Screenshot - Gameplay Terrain</b><br>
           <img src="https://i.imgur.com/3iRScPa.png" alt="Hytale F2P In-Game Screenshot-2" width="100%">
         </td>
       </tr>
@@ -80,7 +79,7 @@
 🎯 **Core Features**
 - 🔄 **Automatic Updates** - Smart version checking and seamless game updates
 - 💾 **Data Preservation** - Intelligent UserData backup and restoration during updates
-- 🌐 **Cross-Platform** - Full support for Windows x64, Linux x64 (X11/Wayland, SteamDeck), and macOS Silicon
+- 🌐 **Cross-Platform** - Full support for Windows, Linux (X11/Wayland), and macOS
 - ☕ **Java Management** - Automatic Java runtime detection and installation
 - 🎮 **Multiplayer Support** - Automatic multiplayer client installation (Windows, macOS & Linux !)
 
@@ -88,6 +87,7 @@
 - 📁 **Custom Installation** - Choose your own installation directory
 - 🔍 **Smart Detection** - Automatic game and dependency detection
 - 🗂️ **Mod Support** - Built-in mod management system
+- 💬 **Player Chat** - Integrated chat system for community interaction
 - 📰 **News Feed** - Stay updated with the latest Hytale news
 - 🎨 **Modern UI** - Clean, responsive interface with dark theme
 
@@ -118,9 +118,9 @@
     <tr>
       <td><b>🖥️ OS</b></td>
       <td colspan="3" align="center">
-        Windows 10/11 (64-bit X64) | Linux (x64) | macOS (ARM64/Apple Silicon)
+        Windows 10/11 (64-bit; X64/ARM64) | Linux (x64/ARM64) | macOS (Apple Silicon only)
         <br />
-        <small><i>⚠️ Note: ARM64 (Windows & Linux), macOS (x86/Intel) <b>are not supported!</b> ⚠️</i></small>
+        <small><i>⚠️ Note: macOS Intel (x86) is not yet supported <sup><a href="#fn1" id="ref1">1</a></sup></i></small>
       </td>
     </tr>
     <tr>
@@ -131,7 +131,7 @@
     </tr>
     <tr>
       <td><b>🧠 RAM</b></td>
-      <td>8GB (dGPU) / 12GB (iGPU)<sup><a href="#fn1" id="ref1">1</a></sup></td>
+      <td>8GB (dGPU)<sup><a href="#fn1" id="ref2">2</a></sup> /<br>12GB (iGPU)<sup><a href="#fn1" id="ref3">3</a></sup></td>
       <td>16 GB</td>
       <td>32 GB</td>
     </tr>
@@ -156,28 +156,31 @@
   </tbody>
 </table>
 </div>
-<p id="fn1"><sup>Note 1</sup> Using Discrete/Dedicated GPU (dGPU) must have 8 GB RAM minimum, while using Integrated GPU (iGPU) must have 12 GB RAM.</p>
+<p id="fn1"><sup>Note 1</sup> Hytale did not provide game files for macOS Intel, yet.</p>
+<p id="fn2"><sup>Note 2</sup> Using Discrete/Dedicated GPU (dGPU) must have 8 GB RAM minimum.</p>
+<p id="fn3"><sup>Note 3</sup> Using Integrated GPU (dGPU) must have 12 GB RAM minimum.</p>
 
-> [!WARNING]
-> Our launcher has **not yet** supported Offline Mode (playing Hytale without internet).
-> We will surely add the feature as soon as possible. Kindly wait for the update.
 
----
 
 ### 🪟 Windows Prequisites
+* **
 * **Java JDK 25:**
-  * [Oracle](https://www.oracle.com/java/technologies/downloads/#jdk25-windows)
-  * [Adoptium](https://adoptium.net/temurin/releases/?version=25)
+  * [Oracle](https://www.oracle.com/java/technologies/downloads/#jdk25-windows), **no** support for Windows ARM64 in both version 25 and 21.
+  * [Adoptium](https://adoptium.net/temurin/releases/?version=25), has Windows ARM64 support in version 21 only.
   * [Microsoft](https://learn.microsoft.com/en-us/java/openjdk/download), has Windows ARM64 support in version 25.
+  * Download from any vendor if your OS is not Windows with ARM64 architecture.
 * **Latest Visual Studio Redist:** 
   * Download via [Microsoft Visual C++ Redistributable](https://aka.ms/vc14/vc_redist.x64.exe)
   * Or [All-in-One by Techpowerup](https://www.techpowerup.com/download/visual-c-redistributable-runtime-package-all-in-one/)
 
 ### 🐧 Linux Prequisites
 
-* Make sure you have already installed newest **GPU driver** especially proprietary NVIDIA, consult your distro docs or wiki.
-  * Also make sure that your GPU can be connected to EGL, try checking it first (again, consult your distro docs or wiki) before installing Hytale game via our launcher.
-* Install `libpng` package to avoid `SDL3_Image` error:
+> [!WARNING]
+> Ubuntu-based Distro like ZorinOS or Pop!_OS or Linux Mint would encounter issues due to UbuntuLTS environment, [check this Discord post](https://discord.com/channels/1462260103951421493/1463662398501027973).
+
+* Make sure you have already installed newest **GPU driver**, consult your distro docs or wiki.
+
+* Install `libpng` package to avoid SDL3_Image error:
   * `libpng16-16 libpng-dev` for Ubuntu/Debian-based Distro
   * `libpng libpng-devel` for Fedora/RHEL-based Distro
   * `libpng` for Arch-based Distro
@@ -191,12 +194,11 @@
 1. **Prerequisites:** Ensure you have installed all [**Windows Prerequisites**](https://github.com/amiayweb/Hytale-F2P/tree/main?tab=readme-ov-file#-windows-prequisites) listed above.
 2. **Download:** Get the latest `Hytale-F2P-Launcher.exe` from the [**Releases**](https://github.com/amiayweb/Hytale-F2P/releases/latest/) page.
 3. **SmartScreen Note:** Since the executable is currently unsigned, Windows may show a "Windows protected your PC" popup.
-    * Click **More info**, then click **Run anyway**.
+    * Click **More info**.
+    * Click **Run anyway**.
 4. **Launch:** Once installed, you can launch the app directly from your Desktop or the Start menu.
-5. **Whitelist in Windows Firewall** [#192](https://github.com/amiayweb/Hytale-F2P/issues/192#issuecomment-3803042908)
-    * Open the Windows Start Menu and search for `Allow an app through Windows Firewall`
-    * Click "Change settings" (you may need Admin privileges) and Locate `HytaleClient.exe` in the list.
-    * Ensure both the Private and Public checkboxes are checked. Click OK to save.
+
+---
 
 ### 🐧 Linux Installation
 
@@ -217,7 +219,7 @@
      # Fedora/RHEL-based
      sudo dnf install hytale-f2p-launcher.rpm
      # Debian/Ubuntu
-     sudo apt install -y libasound2 libpng16-16 libpng-dev libicu76 # Not needed in v2.2.0+
+     sudo apt install -y libasound2 libpng16-16 libpng-dev libicu76
      sudo dpkg -i hytale-f2p-launcher.deb
      ```
    * **Arch Linux (pacman):** Install the package using:
@@ -236,6 +238,13 @@
 > [!NOTE]
 > Make sure to adjust the filename correctly with the version and the architecture type. TIP: Use `cd` command to the package location.
 
+4. **Troubleshooting:**
+   * **FUSE:** If the AppImage fails to launch on newer distributions, ensure `libfuse2` (or `fuse2` on Arch/Fedora) is installed.
+   * **Desktop Entry:** After installing via `.rpm`, `.deb`, or `.pkg.tar.zst`, the launcher should automatically appear in your App Library/Grid.
+   * Missing libxcrypt.so.1: Install `libxcrypt-compat` using your package manager
+
+---
+
 ### 🍎 macOS Installation  
 
 > [!NOTE]
@@ -250,7 +259,7 @@
     * Look for the message regarding "Hytale F2P Launcher" and click **Open Anyway**.
     * Authenticate with your password and click **Open**.
 
-#### **Advanced macOS: Manual Installation (.zip)**
+#### **Advanced: Manual Installation (.zip)**
 The `.zip` version is useful for users who prefer a portable installation or need to bypass specific permission issues.
 
 1. **Extract:** Download and unzip the file to your desired location (e.g., `~/Applications`).
@@ -263,41 +272,34 @@ The `.zip` version is useful for users who prefer a portable installation or nee
 
 --- 
 
-# 📢 How to Host a Server
+# How to Host a Server
 
-## 🌐 Host your Singleplayer Server (Online-Play Feature)
+## Host your Singleplayer Server (Online-Play Feature)
 
 > [!NOTE]
 > You have to play the game to host the server. See Dedicated Server section below if you want to host it without you playing as the host.
 
 1. Open your Singleplayer World
 2. Pause the game (Esc) > select Online Play > Turn on `Allow Other Players to Join` > Set password if needed > Press `Save`.
-3. Check the status `Connected via UPnP`.
-4. If your friends can't connect to your hosted Online-Play feature, please follow **Local Dedicated Server** tutorial.
+3. Check the status `Connected via STUN` or `Connected via UPnP`.
 
-## 🖧 Host a Dedicated Server
+## Dedicated Server
 
 > [!NOTE]
-> If you already have the patched `HytaleServer.jar` in `HytaleF2P/{release/pre-release}/package/game/latest/Server`, you can use it to host local dedicated server. Put the `.bat`/`.sh` script from our Discord server inside your `.../latest/Server` folder.
+> If you have already  `HytaleServer.jar` in `HytaleF2P/{release/pre-release}/package/game/latest/Server`, you can use it to host local dedicated server. 
 
 > [!TIP]
 > Use services like Playit.gg, Tailscale, Radmin VPN to share UDP connection if setting up router as an admin is not possible.
 
 > [!WARNING]
-> `Hytale-F2P-Server.rar` file is needed to set up a server on non-playing hardware (such as VPS/server hosting). Additional: **Linux ARM64** is supported for server only, not client.
+> `Hytale-F2P-Server.rar` file is needed to set up a server on non-playing hardware (such as VPS/server hosting).
 
 > [!IMPORTANT]
-> See detailed information of setting up a server here: [SERVER.md](SERVER.md). Download the latest patched JAR, the patched RAR, or the SH/BAT scripts from channel `#open-public-server` in our Discord Server. 
+> See detailed information of setting up a server here: [SERVER.md](SERVER.md)
 
 ---
 
-## 🔧 Troubleshooting
-
-See [TROUBLESHOOTING.md](TROUBLESHOOTING.md) for detailed Troubleshooting guide.
-
----
-
-## 🔨 Building from Source
+## 🛠️ Building from Source
 
 See [BUILD.md](docs/BUILD.md) for comprehensive build instructions.
 
@@ -305,28 +307,15 @@ See [BUILD.md](docs/BUILD.md) for comprehensive build instructions.
 
 ## 📋 Changelog
 
-### 🆕 v2.2.0
-- 🔃 **Game Patches Auto-Update Improvement:** No need to install 1.5GB for every updates! Game updates now reduced to almost **~90%** (Hytale Game Update 3 to 4 only take ~150MB).
-- 🩹 **Improved Patch System Pre-Release JAR:** In previous version, only Release JAR could be patched. Now it also can be used for Pre-Release JAR!
-- 🔗 **Fix Mods Manager Issue:** Mods now can be downloaded seamlessly from the launcher, use Profiles to install your preferred mod. It will also automatically copy from selected `Profile/<profilename>` to the `Mods` folder.
-- 💾 **New User Data Location:** UserData Migration to Centralized Location. User data now preserves in `HytaleSaves` located beside `HytaleF2P` folder.
-- 🎮 **SteamDeck and Ubuntu/Debian-based Library Fix:** Replace bundled `libzstd.so` with system version to fix `glibc 2.41+` crash.
-- 🍎 **Launcher auto-update Improvement for macOS:** Fix auto-install fails on unsigned app. Added option to download the new launcher version on Github website.
-- 🌎 **New Translations**: Added France 🇲🇫, German 🇩🇪, Indonesian 🇮🇩, Russia 🇷🇺, and Swedish 🇸🇪 translations to the launcher.
-- 🔐 **Fixes Tar Vulnerability:** Updates `tar` from version `6.2.1` to `7.5.7` for vulnerability issue.
-- ⚙️ **Improved Settings Pane UI:** Settings are now shown in two columns instead of one. No more doom scrolling just to change your language.
-- ⭐ **Added Features Servers:** Don't know which one to play? Join our Featured Servers!
-- 💬 **Removed Chat Pane and Add Discord Feature:** Useless chat feature, we got Discord. Join it, NOW. Also added Discord RPC features to Github and our Discord Server. SHOW OFF TO YOUR FRIENDS.
-- 🔍 **Investigation on Avatar Not Saving Bug:** We are currently investigating this issue.
-
-<details><summary>Click here to see older Changelogs</summary>
-
-### 🔄 v2.1.1
+### 🆕 v2.1.1
 - 🛠️ **Fix Bug EPERM**: EPERM or Error Permission in creating/removing process in reinstalling is now fixed.
 - 🅰️ **Adds .pkg.tar.zst Build for Arch Users**: This Arch-package has been needed since the first release.  
 - ❎ **Removes .pacman Build for Arch**: Based on the established conventions within the Arch Linux community, the file extension .pacman should not be used for package files.
 - 🌎 **New Translation**: New Polish 🇵🇱 Translation added to the Launcher. 
 
+<details>
+<summary>Click here to see older Changelogs</summary>
+
 ### 🔄 v2.1.0
 - 🚨 **Auto-Retry Downloads and Auto-Patch Files** — 
 - ⚡ **Hardware Acceleration** — 
@@ -394,7 +383,6 @@ See [BUILD.md](docs/BUILD.md) for comprehensive build instructions.
 - 🎨 **Modern Interface** - Clean, intuitive design
 - 🌟 **First Release** - Core launcher functionality
 </details>
-
 ---
 
 ## 👥 Contributors
@@ -408,30 +396,19 @@ See [BUILD.md](docs/BUILD.md) for comprehensive build instructions.
 </div>
 
 ### 🏆 Project Creator
-- [**@amiayweb**](https://github.com/amiayweb) - *Lead Developer & Project Creator*
+- [**@amiayweb**](https://github.com/amiayweb) - *Lead Developer & Project Creator | Windows*
 - [**@Relyz1993**](https://github.com/Relyz1993) - *Server Helper & Second Developer & Project Creator*
 
-### 🌟 Main Contributors  
+### 🌟 Contributors  
 - [**@sanasol**](https://github.com/sanasol) - *Main Issues fixer | Multiplayer Patcher*
 - [**@Terromur**](https://github.com/Terromur) - *Main Issues fixer | Beta tester*
-- [**@fazrigading**](https://github.com/fazrigading) - *Main Issues fixer | Beta tester | Github Release Maintainer*
+- [**@fazrigading**](https://github.com/fazrigading) - *Main Issues fixer | Beta tester*
 - [**@ericiskoolbeans**](https://github.com/ericiskoolbeans) - *Beta Tester*
 - [**@chasem-dev**](https://github.com/chasem-dev) - *Issues fixer*
+- [**@crimera**](https://github.com/crimera) - *Issues fixer*  
+- [**@Citeli-py**](https://github.com/Citeli-py) - *Issues fixer*
 - [**@Rahul-Sahani04**](https://github.com/Rahul-Sahani04) - *Issues fixer*
-- [**@xSamiVS**](https://github.com/xSamiVS) - *Issues fixer | Language Translator*
-
-#### 🎟️ Fresh Contributors
-- [**@GreenKod**](https://github.com/GreenKod) - *Code refractor*
-- [**@Citeli-py**](https://github.com/Citeli-py) - *Linux fix & packages version in early release*
-- [**@crimera**](https://github.com/crimera) - *Generate new UUID for new username string feature*
-- [**@letha11**](https://github.com/letha11) - *CSS filename typo fix*
-- [**@colbster937**](https://github.com/colbster937) - *Icon upscaler*
-- [**@ArnavSingh77**](https://github.com/ArnavSingh77) - *Close game launcher on start feature, improve app termination behavior*
-- [**@TalesAmaral**](https://github.com/TalesAmaral) - *BUILD.md link fix in README.md*
-
-#### 🌐 Language Translators
-- [**@BlackSystemCoder**](https://github.com/BlackSystemCoder) - *Russian Language Translator*
-- [**@walti0**](https://github.com/walti0) - *Polish Language Translator*
+- [**@xSamiVS**](https://github.com/xSamiVS) - *Language Translator*
 
 ---
 

SERVER.md

@@ -1,99 +1,34 @@
-# 🎮 Hytale F2P Server Guide
+# Hytale F2P Server Guide
 
 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/MEyWUxt77m** 
-
-**Table of Contents**
-
-* ["Server" Term and Definition](#server-term-and-definiton)
-* [Server Directory Location](#server-directory-location)
-* [A. Online Play Feature](#a-online-play-feature)
-  * [1. Host Your Singleplayer World using In-Game Invite Code](#1-host-your-singleplayer-world-using-in-game-invite-code)
-    * [Common Issues (UPnP/NAT/STUN) on Online Play](#common-issues-upnpnatstun-on-online-play)
-  * [2. Host Your Singleplayer World using Tailscale](#2-host-your-singleplayer-world-using-tailscale)
-* [B. Local Dedicated Server](#b-local-dedicated-server)
-  * [1. Using Playit.gg (Recommended) ✅](#1-using-playitgg-recommended-)
-  * [2. Using Radmin VPN](#2-using-radmin-vpn)
-* [C. 24/7 Dedicated Server (Advanced)](#c-247-dedicated-server-advanced)
-  * [Step 1: Get the Files Ready](#step-1-get-the-files-ready)
-  * [Step 2: Place HytaleServer.jar in the Server directory](#step-2-place-hytaleserverjar-in-the-server-directory)
-  * [Step 3: Run the Server](#step-3-run-the-server)
-* [D. Tinkering Guides](#d-tinkering-guides)
-  * [1. Network Setup](#1-network-setup)
-  * [2. Configuration](#2-configuration)
-  * [3. RAM Allocation Guide](#3-ram-allocation-guide)
-  * [4. Server Commands](#4-server-commands)
-  * [5. Command Line Options](#5-command-line-options)
-  * [6. File Structure](#6-file-structure)
-  * [7. Backups](#7-backups)
-  * [8. Troubleshooting](#8-troubleshooting)
-  * [9. Docker Deployment (Advanced)](#9-docker-deployment-advanced)
-  * [10. Getting Help](#10-getting-help) 
----
-
-### "Server" Term and Definiton
-
-"HytaleServer.jar", which called as "Server", functions as the place of authentication of the client that supposed to go to Hytale Official Authentication System but we managed our way to redirect it on our service (Thanks to Sanasol), handling approximately thousands of players worldwide to play this game for free.
-
-Kindly support us via [our Buy Me a Coffee link](https://buymeacoffee.com/hf2p) if you think our launcher took a big part of developing this Hytale community for the love of the game itself. 
-**We will always advertise, always pushing, and always asking, to every users of this launcher to purchase the original game to help the official development of Hytale**. 
-
-### Server Directory Location
-
-Here are the directory locations of Server folder if you have installed 
-- **Windows:** `%localappdata%\HytaleF2P\release\package\game\latest\Server`
-- **macOS:** `~/Library/Application Support/HytaleF2P/release/package/game/latest/Server`
-- **Linux:** `~/.hytalef2p/release/package/game/latest/Server`
-
-> [!NOTE]
-> This location only exists if the user installed the game using our launcher. The `Server` folder needed to auth the HytaleClient to play Hytale online
-> (for now; we planned to add offline mode in later version of our launcher).
-
-> [!IMPORTANT]
-> Hosting a dedicated Hytale server will not need the exact similar tree. You can put it anywhere, as long as the directory has `Assets.zip` which
-> can be acquired from our launcher via our `HytaleServer.rar` server file (which contains patched `HytaleServer.jar`, `Assets.zip`, and `run_server` scripts in `.sh & .bat`.
+DOWNLOAD SERVER FILES HERE: https://discord.gg/MEyWUxt77m
 
 ---
 
-# A. Host Your Singleplayer World
-
-This feature is perfect for 1-5 players that want to just play instantly with friends.
-Terms and conditions applies.
-
-## 1. Using Online-Play Feature / In-Game Invite Code
+## Part 1: Playing with Friends (Online Play)
 
 The easiest way to play with friends - no manual server setup required!
-*The game automatically handles networking using UPnP/STUN/NAT traversal.*
 
-**For Online Play to work, you need:**
+### How It Works
+
+1. **Start the game** via F2P Launcher
+2. **Click "Online Play"** in the main menu
+3. **Share the invite code** with your friends
+4. Friends enter your invite code to join
+
+The game automatically handles networking using UPnP/STUN/NAT traversal.
+
+### Network Requirements
+
+For Online Play to work, you need:
+
 - **UPnP enabled** on your router (most routers have this on by default)
 - **Public IP address** from your ISP (not behind CGNAT)
 
-> [!TIP]
-> Hoster need to make sure that the router can use UPnP: read router docs, wiki, or watch Youtube tutorials.
->
-> If you encounter any problem, check Common Issues section below!
+### Common Issues
 
-1. Press **Worlds** on the Main Menu.
-2. Select which world you want to play with your friend.
-3. Once you get in the world, press **ESC**/Pause the game.
-4. Press **Online Play** in the Pause Menu.
-5. Set option "Allow Other Players to Join" from OFF to **ON**. You can set Password if you want.
-6. Press **Save**, the Invite Code will appear.
-7. Press **Copy to Clipboard** and **Share the Invite Code** to your friends!
-8. Friends: Press **Servers** in the Main Menu > Press **Join via Code** > Paste the Code > Join.
-
-> [!WARNING]
-> If other players can't join the Hoster with error: `Failed to connect to any available address. The host may be offline or behind a strict firewall.`
-> 
-> **AND ALSO** the Hoster "Online Play" menu shows `Connected to STUN - NAT Type: Restricted (No UPnP)`,
->
-> this means the Online Play is **unavailable** on the Hoster machine, and it is neccessary to use services to host your world. **We recommend Playit.gg!**
-
-
-### Common Issues (UPnP/NAT/STUN) on Online Play
-<details><summary><b>a. "NAT Type: Carrier-Grade NAT (CGNAT)" Warning</b></summary>
+#### "NAT Type: Carrier-Grade NAT (CGNAT)" Warning
 
 If you see this message:
 ```
@@ -105,13 +40,14 @@ Warning: Your network configuration may prevent other players from connecting.
 **What this means:** Your ISP doesn't give you a public IP address. Multiple customers share one public IP, which blocks incoming connections.
 
 **Solutions:**
+
 1. **Contact your ISP** - Request a public/static IP address (may cost extra)
 2. **Use a VPN with port forwarding** - Services like Mullvad, PIA, or AirVPN offer this
-3. **Use Playit.gg / Tailscale / Radmin VPN** - Create a virtual LAN with friends (see below)
+3. **Use Radmin VPN or Playit.gg** - Create a virtual LAN with friends (see below)
 4. **Have a friend with public IP host instead**
-</details>
 
-<details><summary><b>b. "UPnP Failed" or "Port Mapping Failed" Warning</b></summary>
+#### "UPnP Failed" or "Port Mapping Failed"
+
 **Check your router:**
 1. Log into router admin panel (usually `192.168.1.1` or `192.168.0.1`)
 2. Find UPnP settings (often under "Advanced" or "NAT")
@@ -120,138 +56,117 @@ Warning: Your network configuration may prevent other players from connecting.
 
 **If UPnP isn't available:**
 - Manually forward **port 5520 UDP** to your computer's local IP
-- See "Port Forwarding" or "Workarounds or NAT/CGNAT" sections below
-</details>
+- See "Port Forwarding" section below
+
+#### "Strict NAT" or "Symmetric NAT"
 
-<details><summary><b>c. "Strict NAT" or "Symmetric NAT" Warning</b></summary>
 Some routers have restrictive NAT that blocks peer connections.
 
 **Try:**
 1. Enable "NAT Passthrough" or "NAT Filtering: Open" in router settings
 2. Put your device in router's DMZ (temporary test only)
-3. Use Playit.gg / Tailscale / Radmin VPN as workaround
-</details>
+3. Use Radmin VPN as workaround
 
-## 2. Using Tailscale
-Tailscale creates mesh VPN service that streamlines connecting devices and services securely across different networks. And **works crossplatform!!**
+### Workarounds for NAT/CGNAT Issues
 
-1. All members are required to download [Tailscale](https://tailscale.com/download) on your device.
-[Once installed, Tailscale starts and live inside your hidden icon section in Windows, Mac and Linux]
-2. Create a **common Tailscale** account which will shared among your friends to log in.
-3. Ask your **host to login in to thier Tailscale client first**, then the other members.
-  * Host
-    * Open your singleplayer world
-    * Go to Online Play settings
-    * Re-save your settings to generate a new share code
-  * Friends
-    * Ensure Tailscale is connected
-    * Use the new share code to connect
-    * To test your connection, ping the host's ipv4 mentioned in Tailscale
-
----
-
-# B. Local Dedicated Server
-
-This option is perfect for any players size. From small to high.
-
-## 1. Using Playit.gg (Recommended) ✅
+#### Option 1: playit.gg (Recommended)
 
 Free tunneling service - only the host needs to install it:
 
-1. Go to https://playit.gg/login and **Log In** with your existing account, **Create Account** if you don't have one
-2. Press "Add a tunnel" > Select `UDP` > Tunnel description of `Hytale Server` > Port count `1` > and Local Port `5520`
-3. Press **Start the tunnel** (or you can just run the Playit.gg.EXE if you already installed it on your machine) - You'll get a public address like `xx-xx.gl.at.ply.gg:5520`
-4. Go to https://playit.gg/download : `Installer` (Windows) or `x86-64` (Linux) or follow `Debian Install Script` (Debian-based only) 
-   * Windows: Install the `playit-windows.msi`
-   * Linux:
-     * Right-click file > Properties > Turn on 'Executable as a Program' | or `chmod +x playit-linux-amd64` on terminal
-     * Run by double-clicking the file or `./playit-linux-amd64` via terminal
-5. Open the URL/link by `Ctrl+Click` it. If unable, select the URL, then Right-Click to Copy (`Ctrl+Shift+C` for Linux) then Paste the URL into your browser to link it with your created account.
-6. **WARNING: Do not close the terminal if you are still playing or hosting the server**
-7. Once it done, download the `run_server_with_tokens` script file (`.BAT` for Windows, `.SH` for Linux) from our Discord server > channel `#open-public-server`
-8. Put the script file to the `Server` folder in `HytaleF2P` directory (`%localappdata%\HytaleF2P\release\package\game\latest\Server`)
-9. Copy the `Assets.zip` from the `%localappdata%\HytaleF2P\release\package\game\latest\` folder to the `Server\` folder. (TIP: You can use Symlink of that file to reduce disk usage!)
-10. Double-click the .BAT file to host your server, wait until it shows:
-```
-===================================================
-Hytale Server Booted! [Multiplayer, Fresh Universe]
-===================================================
-```
-11. Connect to the server by go to `Servers` in your game client, press `Add Server`, type `localhost` in the address box, use any name for your server.
-12. Send the public address in Step 3 to your friends.
+1. **Download [playit.gg](https://playit.gg/)** and run it - Connect your account from the terminal (do not close it when playing on the server)  
+2. **Add a tunnel** - Select "UDP", tunnel description of "Hytale Server", port count `1`, and local port `5520`
+3. **Start the tunnel** - You'll get a public address like `xx-xx.gl.at.ply.gg:5520`
+4. **Share the address** - Friends connect directly using this address
 
-## 2. Using Radmin VPN
+Works with both Online Play and dedicated servers. No software needed for players joining.
+
+#### Option 2: Radmin VPN
 
 Creates a virtual LAN - all players need to install it:
 
-1. Download [Radmin VPN](https://www.radmin-vpn.com/) - All players install it
-2. One person create a room/network, others join with network name/password
-3. Host joined the world, others will connect to it.
-4. Open Hytale Game > Servers > Add Servers > Direct Connect > Type IP Address of the Host from Radmin.
+1. **Download [Radmin VPN](https://www.radmin-vpn.com/)** - All players install it
+2. **Create a network** - One person creates, others join with network name/password
+3. **Host via Online Play** - Use your Radmin VPN IP instead
+4. **Friends connect** - They'll see you on the virtual LAN
 
-These options bypass all NAT/CGNAT issues. But for **Windows machines only!**
+Both options bypass all NAT/CGNAT issues. But for **Windows machines only!**
 
+#### Option 3: Tailscale
+It creates mesh VPN service that streamlines connecting devices and services securely across different networks. And **works crossplatform!!**
+
+1. All member's are required to download [Tailscale](https://tailscale.com/download) on your device.
+[Once installed, Tailwind starts and live inside your hidden icon section in Windows, Mac and Linux]
+2. Create a **common tailscale** account which will shared among your friends to log in.
+3. Ask your **host to login in to thier tailscale client first**, then the other members.
+##### Host
+  1. Open your singleplayer world
+  2. Go to Online Play settings
+  3. Re-save your settings to generate a new share code
+##### Friends
+  1. Ensure Tailscale is connected
+2. Use the new share code to connect
+[To test your connection, ping the host's ipv4 mentioned in tailwind]
 ---
 
-# C. 24/7 Dedicated Server (Advanced)
+## Part 2: Dedicated Server (Advanced)
 
 For 24/7 servers, custom configurations, or hosting on a VPS/dedicated machine.
 
-## Step 1: Get the Files Ready
+### Quick Start
 
-### Prequisites
+#### Step 1: Get the Server JAR
 
-1. `HytaleServer.jar` (pre-patched for F2P players; dual-auth soon for Official + F2P play)
-2. `Assets.zip`
-3. `run_scripts_with_token.bat` for Windows or `run_scripts_with_token.sh` for macOS/Linux
+The server scripts will automatically download the pre-patched server JAR if it's not present.
 
-> [!NOTE]
-> The `HytaleServer.rar` available on our Discord Server (`#open-public-server` channel; typo on the Discord, not `zip`) includes all of the prequisites.
-> Unfortunately, the JAR inside the RAR isn't updated so you'll need to download the JAR from the link on Discord.
+**Option A:** Let the scripts download automatically (requires `HYTALE_SERVER_URL` to be configured)
 
-> [!TIP]
-> You can copy `Assets.zip` generated from the launcher to be used for the dedicated server. It's located in `HytaleF2P/release/package/game/latest`. 
+**Option B:** Manually place `HytaleServer.jar` (pre-patched for F2P) in the Server directory:
 
+- **Windows:** `%localappdata%\HytaleF2P\release\package\game\latest\Server`
+- **macOS:** `~/Library/Application Support/HytaleF2P/release/package/game/latest/Server`
+- **Linux:** `~/.hytalef2p/release/package/game/latest/Server`
 
-## Step 2: Place `HytaleServer.jar` in the `Server` directory
+If you have a custom install path, the Server folder is inside your custom location under `HytaleF2P/release/package/game/latest/Server`.
 
-* Windows
-  * `%localappdata%\HytaleF2P\release\package\game\latest\Server`
-* macOS
-  * `~/Library/Application Support/HytaleF2P/release/package/game/latest/Server`
-* Linux
-  * `~/.hytalef2p/release/package/game/latest/Server`
-* If you have a custom install path, the Server folder is inside your custom location under
-  * `HytaleF2P/release/package/game/latest/Server`.
-
-## Step 3: Run the Server
+#### Step 2: Run the Server
 
 **Windows:**
 ```batch
+cd scripts
 run_server.bat
 ```
 
 **macOS / Linux:**
 ```bash
+cd scripts
 ./run_server.sh
 ```
 
+The scripts will:
+1. Find your game installation automatically
+2. Download the pre-patched server JAR if needed
+3. Fetch session tokens from the auth server
+4. Start the server
+
+#### Step 3: Connect Players
+
+Share your server IP address with players. They connect via the F2P Launcher's server browser or direct connect.
+
 ---
 
-# D. Tinkering Guides
+## Network Setup (Dedicated Server)
 
-## 1. Network Setup
-
-### a. Local Network (LAN)
+### Local Network (LAN)
 
 If all players are on the same network:
 1. Find your local IP: `ipconfig` (Windows) or `ifconfig` (Mac/Linux)
 2. Share this IP with players on your network
 3. Default port is `5520`
 
-### b. Port Forwarding (Internet Play)
+### Port Forwarding (Internet Play)
 
 To allow direct internet connections:
+
 1. Forward **port 5520 (UDP)** in your router
 2. Find your public IP at [whatismyip.com](https://whatismyip.com)
 3. Share your public IP with players
@@ -264,35 +179,36 @@ netsh advfirewall firewall add rule name="Hytale Server" dir=in action=allow pro
 
 ---
 
-## 2. Configuration
+## Configuration
 
-### a. Environment Variables
+### Environment Variables
 
-Write this in the script file `.BAT`/`.SH` or set these manually in command before running to customize your server:
+Set these before running to customize your server:
 
 | Variable | Default | Description |
 |----------|---------|-------------|
+| `HYTALE_SERVER_URL` | (placeholder) | URL to download pre-patched server JAR |
 | `HYTALE_AUTH_DOMAIN` | `auth.sanasol.ws` | Auth server domain (4-16 chars) |
-| `BIND_ADRESS` | `0.0.0.0:5520` | Server IP and port |
-| `AUTH_MODE` | `authenticated` | Auth mode (see below) |
-| `SERVER_NAME` | `My Hytale Server` | Server display name |
-| `ASSETS_PATH` | `./Assets.zip` | Assets file location |
+| `HYTALE_BIND` | `0.0.0.0:5520` | Server IP and port |
+| `HYTALE_AUTH_MODE` | `authenticated` | Auth mode (see below) |
+| `HYTALE_SERVER_NAME` | `My Hytale Server` | Server display name |
+| `HYTALE_GAME_PATH` | (auto-detected) | Override game location |
 | `JVM_XMS` | `2G` | Minimum Java memory |
 | `JVM_XMX` | `4G` | Maximum Java memory |
 
 **Example (Windows):**
 ```batch
-set SERVER_NAME=My Awesome Server
+set HYTALE_SERVER_NAME=My Awesome Server
 set JVM_XMX=8G
 run_server.bat
 ```
 
 **Example (Linux/macOS):**
 ```bash
-SERVER_NAME="My Awesome Server" JVM_XMX=8G ./run_server.sh
+HYTALE_SERVER_NAME="My Awesome Server" JVM_XMX=8G ./run_server.sh
 ```
 
-### b. Authentication Modes
+### Authentication Modes
 
 | Mode | Description | Use Case |
 |------|-------------|----------|
@@ -302,7 +218,7 @@ SERVER_NAME="My Awesome Server" JVM_XMX=8G ./run_server.sh
 
 ---
 
-## 3. RAM Allocation Guide
+## RAM Allocation Guide
 
 Adjust memory based on your system:
 
@@ -326,7 +242,7 @@ JVM_XMS=4G JVM_XMX=12G ./run_server.sh
 
 ---
 
-## 4. Server Commands
+## Server Commands
 
 Once running, use these commands in the console:
 
@@ -343,12 +259,9 @@ Once running, use these commands in the console:
 | `unban <player>` | Unban a player |
 | `tp <player> <x> <y> <z>` | Teleport player |
 
-
-Use `/` slash for these commands.
-
 ---
 
-## 5. Command Line Options
+## Command Line Options
 
 Pass these when starting the server:
 
@@ -377,7 +290,7 @@ Pass these when starting the server:
 
 ---
 
-## 6. File Structure
+## File Structure
 
 ```
 <game_path>/
@@ -395,21 +308,21 @@ Pass these when starting the server:
 
 ---
 
-## 7. Backups
+## Backups
 
-### a. Automatic Backups
+### Automatic Backups
 
 ```bash
 ./run_server.sh --backup --backup-dir ./backups --backup-frequency 30
 ```
 
-### b. Manual Backup
+### Manual Backup
 
 1. Use `save` command or stop the server
 2. Copy the `universe/` folder
 3. Store in a safe location
 
-### c. Restore
+### Restore
 
 1. Stop the server
 2. Delete/rename current `universe/`
@@ -418,9 +331,9 @@ Pass these when starting the server:
 
 ---
 
-## 8. Troubleshooting
+## Troubleshooting
 
-### a. "Java not found" or "Java version too old"
+### "Java not found" or "Java version too old"
 
 **Java 21 is REQUIRED** (the server uses class file version 65.0).
 
@@ -439,20 +352,30 @@ export PATH="$JAVA_HOME/bin:$PATH"
 ```
 Add these lines to `~/.zshrc` or `~/.bash_profile` to make permanent.
 
-### b. "Port already in use"
+### "Game directory not found"
+
+- Download game via F2P Launcher first
+- Or set `HYTALE_GAME_PATH` environment variable
+- Check custom install path in launcher settings
+
+### "Assets.zip not found"
+
+Game files incomplete. Re-download via the launcher.
+
+### "Port already in use"
 
 ```bash
 ./run_server.sh --bind 0.0.0.0:5521
 ```
 
-### c. "Out of memory"
+### "Out of memory"
 
 Increase JVM_XMX:
 ```bash
 JVM_XMX=6G ./run_server.sh
 ```
 
-### d. Players can't connect
+### Players can't connect
 
 1. Server shows "Server Ready"?
 2. Using F2P Launcher (not official)?
@@ -460,7 +383,7 @@ JVM_XMX=6G ./run_server.sh
 4. Port forwarding configured (for internet)?
 5. Try `--auth-mode unauthenticated` for testing
 
-### e. "Authentication failed"
+### "Authentication failed"
 
 - Ensure players use F2P Launcher
 - Auth server may be temporarily down
@@ -468,7 +391,7 @@ JVM_XMX=6G ./run_server.sh
 
 ---
 
-## 9. Docker Deployment (Advanced)
+## Docker Deployment (Advanced)
 
 For production servers, use Docker:
 
@@ -487,7 +410,40 @@ See [Docker documentation](https://github.com/Hybrowse/hytale-server-docker) for
 
 ---
 
-## 10. Getting Help
+## Server Settings Summary
+
+### Minimal Setup
+```bash
+./run_server.sh
+```
+
+### Custom Memory
+```bash
+JVM_XMS=2G JVM_XMX=8G ./run_server.sh
+```
+
+### Custom Port
+```bash
+HYTALE_BIND=0.0.0.0:25565 ./run_server.sh
+```
+
+### LAN Party (No Auth)
+```bash
+./run_server.sh --auth-mode unauthenticated
+```
+
+### Full Custom Setup
+```bash
+HYTALE_SERVER_NAME="Epic Server" \
+HYTALE_BIND=0.0.0.0:5520 \
+JVM_XMS=2G \
+JVM_XMX=8G \
+./run_server.sh --backup --backup-frequency 15 --allow-op
+```
+
+---
+
+## Getting Help
 
 - Check server console logs for errors
 - Test with `--auth-mode unauthenticated` first
@@ -496,9 +452,8 @@ See [Docker documentation](https://github.com/Hybrowse/hytale-server-docker) for
 
 ---
 
-# Credits
+## Credits
 
 - Hytale F2P Project
 - [Hybrowse Docker Image](https://github.com/Hybrowse/hytale-server-docker)
 - Auth Server: sanasol.ws
-

TROUBLESHOOTING.md

@@ -1,460 +0,0 @@
-# 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).
-
----
-
-## Table of Contents
-
-- [Windows Issues](#windows-issues)
-- [Linux Issues](#linux-issues)
-- [macOS Issues](#macos-issues)
-- [Connection & Server Issues](#connection--server-issues)
-- [Authentication & Token Issues](#authentication--token-issues)
-- [Avatar & Cosmetics Issues](#avatar--cosmetics-issues)
-- [General Issues](#general-issues)
-- [Known Limitations](#known-limitations)
-
----
-
-## Windows Issues
-
-### "Failed to connect to server" / Server won't boot
-
-**Symptoms:** Singleplayer world fails to load, "Server failed to boot" error.
-
-**Solution - Whitelist in Windows Firewall:**
-1. Open **Windows Settings** > **Privacy & Security** > **Windows Security**
-2. Click **Firewall & network protection** > **Allow an app through firewall**
-3. Click **Change settings**
-4. Find `HytaleClient.exe` and check both **Private** and **Public**
-5. If not listed, click **Allow another app** and browse to:
-   ```
-   %localappdata%\HytaleF2P\release\package\game\latest\Client\HytaleClient.exe
-   ```
-
-### Duplicate mod error
-
-**Symptoms:** `java.lang.IllegalArgumentException: Tried to load duplicate plugin`
-
-**Solution:**
-1. Navigate to your mods folder:
-   ```
-   %localappdata%\HytaleF2P\release\package\game\latest\Client\UserData\Mods
-   ```
-2. Remove any duplicate `.jar` files
-3. Restart the launcher
-
-### SmartScreen blocks the launcher
-
-**Solution:**
-1. Click **More info**
-2. Click **Run anyway**
-
----
-
-## Linux Issues
-
-### GPU not detected / Using software rendering (llvmpipe)
-
-**Symptoms:**
-- Game uses integrated GPU instead of dedicated GPU
-- Very low FPS / unplayable performance
-- Play button not clickable
-- Log shows `llvmpipe` instead of your GPU
-
-**Solution for NVIDIA:**
-```bash
-__EGL_VENDOR_LIBRARY_FILENAMES=/usr/share/glvnd/egl_vendor.d/10_nvidia.json ./HytaleF2P.AppImage
-```
-
-**Solution for AMD (hybrid GPU systems):**
-```bash
-DRI_PRIME=1 ./HytaleF2P.AppImage
-```
-
-**Permanent fix - Create a launcher script:**
-```bash
-#!/bin/bash
-export __EGL_VENDOR_LIBRARY_FILENAMES=/usr/share/glvnd/egl_vendor.d/10_nvidia.json
-export DRI_PRIME=1
-./HytaleF2P.AppImage
-```
-
-**Note:** On some desktop systems with AMD iGPU + dGPU, the GPU selector may be inverted (selecting iGPU actually uses dGPU). Use whichever option works.
-
-### SDL3_image / libpng errors
-
-**Symptoms:**
-- `DllNotFoundException: Unable to load shared library 'SDL3_image'`
-- `libpng` related errors
-- Game crashes on startup
-
-**Solution - Install dependencies:**
-
-**Fedora / RHEL:**
-```bash
-sudo dnf install libpng libpng-devel
-```
-
-**Debian / Ubuntu:**
-```bash
-sudo apt install libpng16-16 libpng-dev libgdiplus libc6-dev
-```
-
-**Arch Linux:**
-```bash
-sudo pacman -S libpng
-```
-
-**Alternative - Replace corrupted library:**
-```bash
-cd ~/.hytalef2p/release/package/game/latest/Client/
-mv libSDL3_image.so libSDL3_image.so.bak
-wget https://github.com/user-attachments/files/24710966/libSDL3_image.zip
-unzip libSDL3_image.zip
-chmod 644 libSDL3_image.so
-rm libSDL3_image.zip
-```
-
-### AppImage won't launch / FUSE error
-
-**Solution:**
-```bash
-# Debian/Ubuntu
-sudo apt install libfuse2
-
-# Fedora
-sudo dnf install fuse
-
-# Arch
-sudo pacman -S fuse2
-```
-
-### Missing libxcrypt.so.1
-
-**Solution:**
-```bash
-# Fedora/RHEL
-sudo dnf install libxcrypt-compat
-
-# Arch
-sudo pacman -S libxcrypt-compat
-```
-
-### Wayland display issues
-
-**Symptoms:** Game doesn't launch, stuck at loading, or display glitches on Wayland.
-
-**Solution - Force X11:**
-```bash
-GDK_BACKEND=x11 ./HytaleF2P.AppImage
-```
-
-**Alternative - Electron Wayland hint:**
-```bash
-ELECTRON_OZONE_PLATFORM_HINT=auto ./HytaleF2P.AppImage
-```
-
-### Steam Deck / Gamescope issues
-
-**Solution 1 - Add custom launch options in Steam:**
-```
-ELECTRON_OZONE_PLATFORM_HINT=x11 %command%
-```
-
-**Solution 2 - Launch from Desktop Mode** instead of Game Mode.
-
-**Solution 3 - Force X11:**
-```bash
-GDK_BACKEND=x11 ./HytaleF2P.AppImage
-```
-
-### Ubuntu LTS-based distros (Linux Mint, Zorin OS, Pop!_OS)
-
-These distributions may have compatibility issues due to older system packages. This is a limitation of the Hytale game client, not the launcher.
-
-**Workarounds:**
-1. Install all dependencies listed above
-2. Try the SDL3_image replacement
-3. Consider using a more recent distribution or Flatpak/AppImage with bundled dependencies
-
----
-
-## macOS Issues
-
-### "Butler system error -86" (Apple Silicon)
-
-**Symptoms:** `Butler execution failed: spawn Unknown system error -86` (EXC_BAD_CPU_TYPE)
-
-**Cause:** Butler (the update tool) is x86_64 only.
-
-**Solution - Install Rosetta 2:**
-```bash
-softwareupdate --install-rosetta
-```
-
-Then restart the launcher.
-
-### Auto-update fails with code signature error
-
-**Symptoms:**
-```
-Code signature at URL did not pass validation
-domain: 'SQRLCodeSignatureErrorDomain'
-```
-
-**Solution - Manual update:**
-1. Download the latest version manually from [Releases](https://github.com/amiayweb/Hytale-F2P/releases/latest)
-2. Backup your data first (see [Backup Locations](#backup-locations))
-3. Install the fresh download
-
-### "Unidentified developer" warning
-
-**Solution:**
-1. Open **System Settings** > **Privacy & Security**
-2. Scroll to **Security** section
-3. Find the message about "Hytale F2P Launcher"
-4. Click **Open Anyway**
-5. Authenticate and click **Open**
-
-### App won't open (quarantine)
-
-**Solution:**
-```bash
-xattr -rd com.apple.quarantine /Applications/Hytale-F2P-Launcher.app
-```
-
----
-
-## Connection & Server Issues
-
-### "Failed to connect to server" in Singleplayer
-
-**Possible causes:**
-1. Windows Firewall blocking (see [Windows section](#failed-to-connect-to-server--server-wont-boot))
-2. Patched server JAR download failed
-3. Regional network restrictions
-
-**Solution - Check patched JAR:**
-1. Look for `HytaleServer.jar` in:
-   - Windows: `%localappdata%\HytaleF2P\release\package\game\latest\Server\`
-   - Linux: `~/.hytalef2p/release/package/game/latest/Server/`
-   - macOS: `~/Library/Application Support/HytaleF2P/release/package/game/latest/Server/`
-2. If missing or very small, the download may have failed
-
-**Solution - Regional restrictions:**
-
-Some countries (Russia, Turkey, Indonesia, etc.) may have issues accessing download servers.
-- Try using a VPN for the initial download
-- Once downloaded, the patched JAR is cached locally
-
-### "Infinite Booting Server" / Server stuck loading
-
-**Solution:**
-1. Check if the patched JAR downloaded successfully (see above)
-2. Ensure your GPU meets minimum requirements
-3. Check launcher logs for specific errors
-4. Try with a VPN if in a restricted region
-
-### "Connection timed out from inactivity"
-
-**This is expected behavior.** Sessions have a 10-hour TTL and will timeout after extended inactivity. Simply reconnect to continue playing.
-
----
-
-## Authentication & Token Issues
-
-### "Invalid identity token" / "Failed to start Hytale"
-
-**Solution:**
-1. **Restart the launcher** - This fetches fresh tokens
-2. **Check system time** - JWT validation requires accurate system time
-3. **Clear cached tokens:**
-   - Delete `config.json` from your HytaleF2P folder
-   - Restart the launcher
-   - Re-enter your username
-
-**Locations:**
-- Windows: `%localappdata%\HytaleF2P\config.json`
-- Linux: `~/.hytalef2p/config.json`
-- macOS: `~/Library/Application Support/HytaleF2P/config.json`
-
-### Token refresh errors
-
-If you see issuer mismatch errors in logs:
-1. Delete `config.json` and `player_id.json`
-2. Restart the launcher
-3. This forces a fresh authentication
-
----
-
-## Avatar & Cosmetics Issues
-
-### Avatar/skin changes not saving
-
-**This is a known F2P limitation:**
-- F2P mode has no password protection for usernames
-- Anyone can use any username
-- Cosmetics are stored server-side by username
-- If someone else uses your username, they can change your cosmetics
-
-**Workaround:** Use a unique username that others are unlikely to choose.
-
-### Character invisible / Customization crashes
-
-**Solution:**
-1. Use **Repair Game** in launcher Settings
-2. Verify `Assets.zip` exists in your game folder
-3. Clear cached assets:
-   - Windows: Delete `%localappdata%\HytaleF2P\release\package\game\latest\Client\UserData\CachedAssets\`
-4. Restart the launcher
-
-### Avatar creator shows "Offline Mode"
-
-**Cause:** Cannot connect to auth server.
-
-**Solution:**
-1. Check your internet connection
-2. Test connectivity: Open `https://auth.sanasol.ws/health` in browser (should show "OK")
-3. Check if firewall is blocking the connection
-4. Try disabling VPN (or enabling one if in restricted region)
-
----
-
-## General Issues
-
-### Mods not showing up
-
-**Solution:**
-1. Ensure mods are placed in the correct folder:
-   - Windows: `%localappdata%\HytaleF2P\release\package\game\latest\Client\UserData\Mods\`
-   - Linux: `~/.hytalef2p/release/package/game/latest/Client/UserData/Mods/`
-   - macOS: `~/Library/Application Support/HytaleF2P/release/package/game/latest/Client/UserData/Mods/`
-2. Verify mod files are `.jar` format
-3. Check launcher logs for mod loading errors
-
-### Game updates delete configurations/mods
-
-**This is a known issue being worked on.**
-
-**Prevention - Always backup before updating:**
-- Server configs and worlds
-- Mods folder
-- `config.json` and `player_id.json`
-
-See [Backup Locations](#backup-locations) below.
-
-### Play button not clickable
-
-Usually caused by GPU detection failure. See [GPU not detected](#gpu-not-detected--using-software-rendering-llvmpipe).
-
-**Alternative:**
-1. Go to **Settings** > **Graphics**
-2. Manually select your GPU
-3. Restart the launcher
-
-### Read timeout errors
-
-**Cause:** Network connectivity issues.
-
-**Solutions:**
-1. Check your internet connection stability
-2. Try using a VPN
-3. Check firewall settings
-4. Try at a different time (server load varies)
-
----
-
-## Known Limitations
-
-### Linux ARM64 not supported
-
-Hytale does not provide ARM64 game client builds. The launcher downloads from official Hytale servers which only provide:
-- Windows x64
-- macOS (Universal/Intel)
-- Linux x64
-
-This is outside our control.
-
-### F2P Username System
-
-- No password protection for usernames
-- Anyone can claim any username
-- Cosmetics shared by username
-- UUIDs generated based on username
-
-A per-player password system is planned for future versions.
-
-### Session Timeout
-
-Game sessions have a 10-hour TTL. This is by design for security.
-
----
-
-## Backup Locations
-
-### Windows
-```
-%localappdata%\HytaleF2P\
-├── config.json                    # Launcher settings
-├── player_id.json                 # Player identity
-└── release\package\game\latest\
-    ├── Client\UserData\           # Saves, settings, mods
-    └── Server\
-        ├── universe\              # World data
-        └── config.json            # Server config
-```
-
-### Linux
-```
-~/.hytalef2p/
-├── config.json
-├── player_id.json
-└── release/package/game/latest/
-    ├── Client/UserData/
-    └── Server/
-        ├── universe/
-        └── config.json
-```
-
-### macOS
-```
-~/Library/Application Support/HytaleF2P/
-├── config.json
-├── player_id.json
-└── release/package/game/latest/
-    ├── Client/UserData/
-    └── Server/
-        ├── universe/
-        └── config.json
-```
-
----
-
-## Getting Help
-
-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)
-3. **Open a new issue** with:
-   - Your operating system and version
-   - Launcher version
-   - Full launcher logs from:
-     - Windows: `%localappdata%\HytaleF2P\logs\`
-     - Linux: `~/.hytalef2p/logs/`
-     - macOS: `~/Library/Application Support/HytaleF2P/logs/`
-   - Steps to reproduce the issue
-
----
-
-## Logs Location
-
-For bug reports, please include logs from:
-
-| OS | Path |
-|----|------|
-| Windows | `%localappdata%\HytaleF2P\logs\` |
-| Linux | `~/.hytalef2p/logs/` |
-| macOS | `~/Library/Application Support/HytaleF2P/logs/` |

backend/core/config.js

@@ -84,6 +84,15 @@ function loadUsername() {
   return config.username || 'Player';
 }
 
+function saveChatUsername(chatUsername) {
+  saveConfig({ chatUsername: chatUsername || '' });
+}
+
+function loadChatUsername() {
+  const config = loadConfig();
+  return config.chatUsername || '';
+}
+
 function getUuidForUser(username) {
   const { v4: uuidv4 } = require('uuid');
   const config = loadConfig();
@@ -285,6 +294,17 @@ function resetCurrentUserUuid() {
   return setUuidForUser(username, newUuid);
 }
 
+function saveChatColor(color) {
+  const config = loadConfig();
+  config.chatColor = color;
+  saveConfig(config);
+}
+
+function loadChatColor() {
+  const config = loadConfig();
+  return config.chatColor || '#3498db';
+}
+
 function saveGpuPreference(gpuPreference) {
   saveConfig({ gpuPreference: gpuPreference || 'auto' });
 }
@@ -323,6 +343,10 @@ module.exports = {
   saveConfig,
   saveUsername,
   loadUsername,
+  saveChatUsername,
+  loadChatUsername,
+  saveChatColor,
+  loadChatColor,
   getUuidForUser,
   saveJavaPath,
   loadJavaPath,

backend/core/paths.js

@@ -15,7 +15,7 @@ function getAppDir() {
 }
 
 /**
- * Get centralized UserData saves directory (NEW in 2.2.0)
+ * Get centralized UserData saves directory (NEW in 2.1.2)
  * UserData is now stored separately from game installation
  */
 function getHytaleSavesDir() {
@@ -233,7 +233,7 @@ async function getModsPath(customInstallPath = null) {
 
 function getProfilesDir(customInstallPath = null) {
   try {
-    // NEW 2.2.0: Use centralized UserData location
+    // NEW 2.1.2: Use centralized UserData location
     const userDataPath = getHytaleSavesDir();
     const profilesDir = path.join(userDataPath, 'Profiles');
     

backend/core/testConfig.js

@@ -1,7 +0,0 @@
-const FORCE_CLEAN_INSTALL_VERSION = false;
-const CLEAN_INSTALL_TEST_VERSION = '4.pwr';
-
-module.exports = {
-  FORCE_CLEAN_INSTALL_VERSION,
-  CLEAN_INSTALL_TEST_VERSION
-};

backend/launcher.js

@@ -5,6 +5,10 @@
 const {
   saveUsername,
   loadUsername,
+  saveChatUsername,
+  loadChatUsername,
+  saveChatColor,
+  loadChatColor,
   saveJavaPath,
   loadJavaPath,
   saveInstallPath,
@@ -16,11 +20,10 @@ const {
   saveCloseLauncherOnStart,
   loadCloseLauncherOnStart,
 
+  // Hardware Acceleration
   saveLauncherHardwareAcceleration,
   loadLauncherHardwareAcceleration,
 
-  loadConfig,
-  saveConfig,
 
   saveModsToConfig,
   loadModsFromConfig,
@@ -110,6 +113,10 @@ module.exports = {
   // User configuration functions
   saveUsername,
   loadUsername,
+  saveChatUsername,
+  loadChatUsername,
+  saveChatColor,
+  loadChatColor,
   getUuidForUser,
 
   // Java configuration functions
@@ -137,10 +144,6 @@ module.exports = {
   saveLauncherHardwareAcceleration,
   loadLauncherHardwareAcceleration,
 
-  // Config functions
-  loadConfig,
-  saveConfig,
-
   // GPU Preference functions
   saveGpuPreference,
   loadGpuPreference,

backend/managers/differentialUpdateManager.js

@@ -1,272 +0,0 @@
-const fs = require('fs');
-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 { installButler } = require('./butlerManager');
-const { GAME_DIR, CACHE_DIR, TOOLS_DIR } = require('../core/paths');
-const { saveVersionClient } = require('../core/config');
-
-async function acquireGameArchive(downloadUrl, targetPath, checksum, progressCallback, allowRetry = true) {
-  const osName = getOS();
-  const arch = getArch();
-
-  if (osName === 'darwin' && arch === 'amd64') {
-    throw new Error('Hytale x86_64 Intel Mac Support has not been released yet. Please check back later.');
-  }
-
-  if (fs.existsSync(targetPath)) {
-    const stats = fs.statSync(targetPath);
-    if (stats.size > 1024 * 1024) {
-      const isValid = await validateChecksum(targetPath, checksum);
-      if (isValid) {
-        console.log(`Valid archive found in cache: ${targetPath}`);
-        return targetPath;
-      }
-      console.log('Cached archive checksum mismatch, re-downloading');
-      fs.unlinkSync(targetPath);
-    }
-  }
-
-  console.log(`Downloading game archive from: ${downloadUrl}`);
-  
-  try {
-    if (allowRetry) {
-      await retryDownload(downloadUrl, targetPath, progressCallback);
-    } else {
-      await downloadFile(downloadUrl, targetPath, progressCallback);
-    }
-  } catch (error) {
-    const enhancedError = new Error(`Archive download failed: ${error.message}`);
-    enhancedError.originalError = error;
-    enhancedError.downloadUrl = downloadUrl;
-    enhancedError.targetPath = targetPath;
-    throw enhancedError;
-  }
-
-  const stats = fs.statSync(targetPath);
-  console.log(`Archive downloaded, size: ${(stats.size / 1024 / 1024).toFixed(2)} MB`);
-
-  const isValid = await validateChecksum(targetPath, checksum);
-  if (!isValid) {
-    console.log('Downloaded archive checksum validation failed, removing corrupted file');
-    fs.unlinkSync(targetPath);
-    throw new Error('Downloaded archive is corrupted or invalid. Please retry');
-  }
-
-  console.log(`Archive validation passed: ${targetPath}`);
-  return targetPath;
-}
-
-async function deployGameArchive(archivePath, destinationDir, toolsDir, progressCallback, isDifferential = false) {
-  if (!archivePath || !fs.existsSync(archivePath)) {
-    throw new Error(`Archive not found: ${archivePath || 'undefined'}`);
-  }
-
-  const stats = fs.statSync(archivePath);
-  console.log(`Deploying archive: ${archivePath}`);
-  console.log(`Archive size: ${(stats.size / 1024 / 1024).toFixed(2)} MB`);
-  console.log(`Deployment mode: ${isDifferential ? 'differential' : 'full'}`);
-
-  const butlerPath = await installButler(toolsDir);
-  const stagingDir = path.join(destinationDir, 'staging-temp');
-
-  if (!fs.existsSync(destinationDir)) {
-    fs.mkdirSync(destinationDir, { recursive: true });
-  }
-
-  if (fs.existsSync(stagingDir)) {
-    fs.rmSync(stagingDir, { recursive: true, force: true });
-  }
-  fs.mkdirSync(stagingDir, { recursive: true });
-
-  if (progressCallback) {
-    progressCallback(isDifferential ? 'Applying differential update...' : 'Installing game files...', null, null, null, null);
-  }
-
-  const args = [
-    'apply',
-    '--staging-dir',
-    stagingDir,
-    archivePath,
-    destinationDir
-  ];
-
-  console.log(`Executing deployment: ${butlerPath} ${args.join(' ')}`);
-
-  return new Promise((resolve, reject) => {
-    const child = execFile(butlerPath, args, {
-      maxBuffer: 1024 * 1024 * 10,
-      timeout: 600000
-    }, (error, stdout, stderr) => {
-      if (error) {
-        const cleanStderr = stderr.replace(/[\u2714\u2716\u2713\u2717\u26A0\uD83D[\uDC00-\uDFFF]]/g, '').trim();
-        const cleanStdout = stdout.replace(/[\u2714\u2716\u2713\u2717\u26A0\uD83D[\uDC00-\uDFFF]]/g, '').trim();
-        
-        if (cleanStderr) console.error('Deployment stderr:', cleanStderr);
-        if (cleanStdout) console.error('Deployment stdout:', cleanStdout);
-        
-        const errorText = (stderr + ' ' + error.message).toLowerCase();
-        let message = 'Game deployment failed';
-        
-        if (errorText.includes('unexpected eof')) {
-          message = 'Corrupted archive detected. Please retry download.';
-          if (fs.existsSync(archivePath)) {
-            fs.unlinkSync(archivePath);
-          }
-        } else if (errorText.includes('permission denied')) {
-          message = 'Permission denied. Check file permissions and try again.';
-        } else if (errorText.includes('no space left') || errorText.includes('device full')) {
-          message = 'Insufficient disk space. Free up space and try again.';
-        }
-
-        const deployError = new Error(message);
-        deployError.originalError = error;
-        deployError.stderr = cleanStderr;
-        deployError.stdout = cleanStdout;
-        return reject(deployError);
-      }
-
-      console.log('Game deployment completed successfully');
-      const cleanOutput = stdout.replace(/[\u2714\u2716\u2713\u2717\u26A0\uD83D[\uDC00-\uDFFF]]/g, '').trim();
-      if (cleanOutput) {
-        console.log(cleanOutput);
-      }
-
-      if (fs.existsSync(stagingDir)) {
-        try {
-          fs.rmSync(stagingDir, { recursive: true, force: true });
-        } catch (cleanupErr) {
-          console.warn('Failed to cleanup staging directory:', cleanupErr.message);
-        }
-      }
-
-      resolve();
-    });
-
-    child.on('error', (err) => {
-      console.error('Deployment process error:', err);
-      reject(new Error(`Failed to execute deployment tool: ${err.message}`));
-    });
-  });
-}
-
-async function performIntelligentUpdate(targetVersion, branch = 'release', progressCallback, gameDir = GAME_DIR, cacheDir = CACHE_DIR, toolsDir = TOOLS_DIR) {
-  console.log(`Initiating intelligent update to version ${targetVersion}`);
-
-  const currentVersion = getInstalledClientVersion();
-  console.log(`Current version: ${currentVersion || 'none (clean install)'}`);
-  console.log(`Target version: ${targetVersion}`);
-  console.log(`Branch: ${branch}`);
-
-  if (branch !== 'release') {
-    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}_${archiveName}`);
-    
-    if (progressCallback) {
-      progressCallback('Downloading full game archive (pre-release)...', 0, null, null, null);
-    }
-    
-    await acquireGameArchive(versionDetails.fullUrl, archivePath, null, progressCallback);
-    await deployGameArchive(archivePath, gameDir, toolsDir, progressCallback, false);
-    saveVersionClient(targetVersion);
-    console.log(`Pre-release installation completed. Version ${targetVersion} is now installed.`);
-    return;
-  }
-
-  if (!currentVersion) {
-    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}_${archiveName}`);
-    
-    if (progressCallback) {
-      progressCallback(`Downloading full game archive (first install - v${targetVersion})...`, 0, null, null, null);
-    }
-    
-    await acquireGameArchive(versionDetails.fullUrl, archivePath, null, progressCallback);
-    await deployGameArchive(archivePath, gameDir, toolsDir, progressCallback, false);
-    saveVersionClient(targetVersion);
-    console.log(`Initial installation completed. Version ${targetVersion} is now installed.`);
-    return;
-  }
-
-  const patchesToApply = needsIntermediatePatches(currentVersion, targetVersion);
-  
-  if (patchesToApply.length === 0) {
-    console.log('Already at target version or invalid version sequence');
-    return;
-  }
-
-  console.log(`Applying ${patchesToApply.length} differential patch(es): ${patchesToApply.join(' -> ')}`);
-
-  for (let i = 0; i < patchesToApply.length; i++) {
-    const patchVersion = patchesToApply[i];
-    const versionDetails = await extractVersionDetails(patchVersion, branch);
-    
-    const canDifferential = canUseDifferentialUpdate(getInstalledClientVersion(), versionDetails);
-    
-    if (!canDifferential || !versionDetails.differentialUrl) {
-      console.log(`WARNING: Differential patch not available for ${patchVersion}, using full archive`);
-      const archiveName = path.basename(versionDetails.fullUrl);
-      const archivePath = path.join(cacheDir, `${branch}_${archiveName}`);
-      
-      if (progressCallback) {
-        progressCallback(`Downloading full archive for ${patchVersion} (${i + 1}/${patchesToApply.length})...`, 0, null, null, null);
-      }
-      
-      await acquireGameArchive(versionDetails.fullUrl, archivePath, null, progressCallback);
-      await deployGameArchive(archivePath, gameDir, toolsDir, progressCallback, false);
-    } else {
-      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) {
-  const { findClientPath } = require('../core/paths');
-  const clientPath = findClientPath(gameDir);
-
-  if (clientPath) {
-    const currentVersion = getInstalledClientVersion();
-    if (currentVersion === targetVersion) {
-      console.log(`Game already installed at correct version: ${targetVersion}`);
-      return;
-    }
-  }
-
-  await performIntelligentUpdate(targetVersion, branch, progressCallback, gameDir, cacheDir, toolsDir);
-}
-
-module.exports = {
-  acquireGameArchive,
-  deployGameArchive,
-  performIntelligentUpdate,
-  ensureGameInstalled
-};

backend/managers/gameLauncher.js

@@ -10,11 +10,9 @@ const { setupWaylandEnvironment, setupGpuEnvironment } = require('../utils/platf
 const { saveUsername, saveInstallPath, loadJavaPath, getUuidForUser, getAuthServerUrl, getAuthDomain, loadVersionBranch, loadVersionClient, saveVersionClient } = require('../core/config');
 const { resolveJavaPath, getJavaExec, getBundledJavaPath, detectSystemJava, JAVA_EXECUTABLE } = require('./javaManager');
 const { getLatestClientVersion } = require('../services/versionManager');
-const { FORCE_CLEAN_INSTALL_VERSION, CLEAN_INSTALL_TEST_VERSION } = require('../core/testConfig');
-const { ensureGameInstalled } = require('./differentialUpdateManager');
+const { updateGameFiles } = require('./gameManager');
 const { syncModsForCurrentProfile } = require('./modManager');
 const { getUserDataPath } = require('../utils/userDataMigration');
-const { syncServerList } = require('../utils/serverListSync');
 
 // Client patcher for custom auth server (sanasol.ws)
 let clientPatcher = null;
@@ -26,6 +24,57 @@ try {
 
 const execAsync = promisify(exec);
 
+/**
+ * Try to auto-install jemalloc on Linux using pkexec (graphical sudo)
+ * Returns true if installation was successful
+ */
+async function tryInstallJemalloc() {
+  console.log('Linux: Attempting to auto-install jemalloc...');
+
+  // Detect package manager and get install command
+  let installCmd = null;
+  try {
+    await execAsync('which pacman');
+    installCmd = 'pacman -S --noconfirm jemalloc';
+  } catch (e) {
+    try {
+      await execAsync('which apt');
+      installCmd = 'apt install -y libjemalloc2';
+    } catch (e2) {
+      try {
+        await execAsync('which dnf');
+        installCmd = 'dnf install -y jemalloc';
+      } catch (e3) {
+        console.log('Linux: Could not detect package manager for auto-install');
+        return false;
+      }
+    }
+  }
+
+  // Try pkexec first (graphical sudo), fall back to sudo
+  const sudoCommands = ['pkexec', 'sudo'];
+  for (const sudoCmd of sudoCommands) {
+    try {
+      await execAsync(`which ${sudoCmd}`);
+      console.log(`Linux: Installing jemalloc with: ${sudoCmd} ${installCmd}`);
+      await execAsync(`${sudoCmd} ${installCmd}`, { timeout: 120000 });
+      console.log('Linux: jemalloc installed successfully');
+      return true;
+    } catch (e) {
+      if (e.killed) {
+        console.log('Linux: Install timed out');
+      } else if (e.code === 126 || e.code === 127) {
+        continue;
+      } else {
+        console.log(`Linux: Install failed with ${sudoCmd}: ${e.message}`);
+      }
+    }
+  }
+
+  console.log('Linux: Auto-install failed, manual installation required');
+  return false;
+}
+
 // Fetch tokens from the auth server (properly signed with server's Ed25519 key)
 async function fetchAuthTokens(uuid, name) {
   const authServerUrl = getAuthServerUrl();
@@ -105,20 +154,12 @@ function generateLocalTokens(uuid, name) {
 }
 
 async function launchGame(playerName = 'Player', progressCallback, javaPathOverride, installPathOverride, gpuPreference = 'auto', branchOverride = null) {
-  // Synchronize server list on every game launch
-  try {
-    console.log('[Launcher] Synchronizing server list...');
-    await syncServerList();
-  } catch (syncError) {
-    console.warn('[Launcher] Server list sync failed, continuing launch:', syncError.message);
-  }
-
   const branch = branchOverride || loadVersionBranch();
   const customAppDir = getResolvedAppDir(installPathOverride);
   const customGameDir = path.join(customAppDir, branch, 'package', 'game', 'latest');
   const customJreDir = path.join(customAppDir, branch, 'package', 'jre', 'latest');
   
-  // NEW 2.2.0: Use centralized UserData location
+  // NEW 2.1.2: Use centralized UserData location
   const userDataDir = getUserDataPath();
 
   const gameLatest = customGameDir;
@@ -179,7 +220,7 @@ async function launchGame(playerName = 'Player', progressCallback, javaPathOverr
         if (progressCallback && msg) {
           progressCallback(msg, percent, null, null, null);
         }
-       }, null, branch);
+      });
 
       if (patchResult.success) {
         console.log(`Game patched successfully (${patchResult.patchCount} total occurrences)`);
@@ -295,53 +336,62 @@ exec "$REAL_JAVA" "\${ARGS[@]}"
    const gpuEnv = setupGpuEnvironment(gpuPreference);
    Object.assign(env, gpuEnv);
 
-  // Linux: Replace bundled libzstd.so with system version to fix glibc 2.41+ crash
-  // The bundled libzstd causes "free(): invalid pointer" on Steam Deck / Ubuntu LTS
-  if (process.platform === 'linux' && process.env.HYTALE_NO_LIBZSTD_FIX !== '1') {
-    const clientDir = path.dirname(clientPath);
-    const bundledLibzstd = path.join(clientDir, 'libzstd.so');
-    const backupLibzstd = path.join(clientDir, 'libzstd.so.bundled');
+   // Linux: Use jemalloc to fix "free(): invalid pointer" crash on glibc 2.41+ (Steam Deck, Ubuntu LTS)
+   // Root cause: glibc 2.41 has stricter heap validation that catches a pre-existing race condition
+   if (process.platform === 'linux') {
+     if (process.env.HYTALE_NO_JEMALLOC !== '1') {
+       const jemallocPaths = [
+         '/usr/lib/libjemalloc.so.2',                    // Arch Linux, Steam Deck
+         '/usr/lib/x86_64-linux-gnu/libjemalloc.so.2',   // Debian/Ubuntu
+         '/usr/lib64/libjemalloc.so.2',                  // Fedora/RHEL
+         '/usr/lib/libjemalloc.so',                      // Generic fallback
+         '/usr/lib/x86_64-linux-gnu/libjemalloc.so',     // Debian/Ubuntu fallback
+         '/usr/lib64/libjemalloc.so'                     // Fedora/RHEL fallback
+       ];
 
-    // Common system libzstd paths
-    const systemLibzstdPaths = [
-      '/usr/lib/libzstd.so.1',                    // Arch Linux, Steam Deck
-      '/usr/lib/x86_64-linux-gnu/libzstd.so.1',   // Debian/Ubuntu
-      '/usr/lib64/libzstd.so.1'                   // Fedora/RHEL
-    ];
+       let jemalloc = null;
+       for (const p of jemallocPaths) {
+         if (fs.existsSync(p)) {
+           jemalloc = p;
+           break;
+         }
+       }
 
-    let systemLibzstd = null;
-    for (const p of systemLibzstdPaths) {
-      if (fs.existsSync(p)) {
-        systemLibzstd = p;
-        break;
-      }
-    }
+       if (jemalloc) {
+         env.LD_PRELOAD = jemalloc + (env.LD_PRELOAD ? ':' + env.LD_PRELOAD : '');
+         console.log(`Linux: Using jemalloc allocator for stability (${jemalloc})`);
+       } else {
+         // Try auto-install
+         if (process.env.HYTALE_AUTO_INSTALL_JEMALLOC !== '0') {
+           const installed = await tryInstallJemalloc();
+           if (installed) {
+             for (const p of jemallocPaths) {
+               if (fs.existsSync(p)) {
+                 jemalloc = p;
+                 break;
+               }
+             }
+             if (jemalloc) {
+               env.LD_PRELOAD = jemalloc + (env.LD_PRELOAD ? ':' + env.LD_PRELOAD : '');
+               console.log(`Linux: Using jemalloc after auto-install (${jemalloc})`);
+             }
+           }
+         }
 
-    if (systemLibzstd && fs.existsSync(bundledLibzstd)) {
-      try {
-        const stats = fs.lstatSync(bundledLibzstd);
+         if (!jemalloc) {
+           env.MALLOC_CHECK_ = '0';
+           console.log('Linux: jemalloc not found - install with: sudo pacman -S jemalloc (Arch) or sudo apt install libjemalloc2 (Debian/Ubuntu)');
+           console.log('Linux: Using fallback MALLOC_CHECK_=0 (may still crash on glibc 2.41+)');
+         }
+       }
+     } else {
+       console.log('Linux: jemalloc disabled by HYTALE_NO_JEMALLOC=1');
+     }
+   }
 
-        // Only replace if it's not already a symlink to system version
-        if (!stats.isSymbolicLink()) {
-          // Backup bundled version
-          if (!fs.existsSync(backupLibzstd)) {
-            fs.renameSync(bundledLibzstd, backupLibzstd);
-            console.log(`Linux: Backed up bundled libzstd.so`);
-          } else {
-            fs.unlinkSync(bundledLibzstd);
-          }
-
-          // Create symlink to system version
-          fs.symlinkSync(systemLibzstd, bundledLibzstd);
-          console.log(`Linux: Linked libzstd.so to system version (${systemLibzstd}) for glibc 2.41+ compatibility`);
-        } else {
-          const linkTarget = fs.readlinkSync(bundledLibzstd);
-          console.log(`Linux: libzstd.so already linked to ${linkTarget}`);
-        }
-      } catch (libzstdError) {
-        console.warn(`Linux: Could not replace libzstd.so: ${libzstdError.message}`);
-      }
-    }
+  // Debug: log LD_PRELOAD before spawn
+  if (process.platform === 'linux') {
+    console.log(`Linux: LD_PRELOAD = ${env.LD_PRELOAD || '(not set)'}`);
   }
 
   try {
@@ -356,7 +406,19 @@ exec "$REAL_JAVA" "\${ARGS[@]}"
       spawnOptions.windowsHide = true;
     }
 
-    const child = spawn(clientPath, args, spawnOptions);
+    let child;
+
+    // Linux: Use shell with inline LD_PRELOAD for maximum compatibility
+    if (process.platform === 'linux' && env.LD_PRELOAD) {
+      const quotedArgs = args.map(a => `"${a.replace(/"/g, '\\"')}"`).join(' ');
+      const shellCmd = `LD_PRELOAD="${env.LD_PRELOAD}" "${clientPath}" ${quotedArgs}`;
+      console.log(`Linux: Launching via shell with LD_PRELOAD`);
+
+      spawnOptions.shell = '/bin/bash';
+      child = spawn(shellCmd, [], spawnOptions);
+    } else {
+      child = spawn(clientPath, args, spawnOptions);
+    }
 
     console.log(`Game process started with PID: ${child.pid}`);
 
@@ -447,13 +509,7 @@ async function launchGameWithVersionCheck(playerName = 'Player', progressCallbac
       const customCacheDir = path.join(customAppDir, 'cache');
 
       try {
-        let versionToInstall = latestVersion;
-        if (FORCE_CLEAN_INSTALL_VERSION && !installedVersion) {
-          versionToInstall = CLEAN_INSTALL_TEST_VERSION;
-          console.log(`TESTING MODE: Clean install detected, forcing version ${versionToInstall} instead of ${latestVersion}`);
-        }
-        
-        await ensureGameInstalled(versionToInstall, branch, progressCallback, customGameDir, customCacheDir, customToolsDir);
+        await updateGameFiles(latestVersion, progressCallback, customGameDir, customToolsDir, customCacheDir, branch);
         console.log('Game updated successfully, patching will be forced on launch...');
 
         if (progressCallback) {

backend/managers/gameManager.js

@@ -5,14 +5,13 @@ const { getResolvedAppDir, findClientPath, findUserDataPath, findUserDataRecursi
 const { getOS, getArch } = require('../utils/platformUtils');
 const { downloadFile, retryDownload, retryStalledDownload, MAX_AUTOMATIC_STALL_RETRIES } = require('../utils/fileManager');
 const { getLatestClientVersion, getInstalledClientVersion } = require('../services/versionManager');
-const { FORCE_CLEAN_INSTALL_VERSION, CLEAN_INSTALL_TEST_VERSION } = require('../core/testConfig');
 const { installButler } = require('./butlerManager');
 const { downloadAndReplaceHomePageUI, downloadAndReplaceLogo } = require('./uiFileManager');
 const { saveUsername, saveInstallPath, loadJavaPath, CONFIG_FILE, loadConfig, loadVersionBranch, saveVersionClient, loadVersionClient } = require('../core/config');
 const { resolveJavaPath, detectSystemJava, downloadJRE, getJavaExec, getBundledJavaPath } = require('./javaManager');
 const { getUserDataPath, migrateUserDataToCentralized } = require('../utils/userDataMigration');
 
-async function downloadPWR(branch = 'release', fileName = '7.pwr', progressCallback, cacheDir = CACHE_DIR, manualRetry = false) {
+async function downloadPWR(branch = 'release', fileName = '4.pwr', progressCallback, cacheDir = CACHE_DIR, manualRetry = false) {
   const osName = getOS();
   const arch = getArch();
 
@@ -301,16 +300,6 @@ async function applyPWR(pwrFile, progressCallback, gameDir = GAME_DIR, toolsDir
     fs.rmSync(stagingDir, { recursive: true, force: true });
   }
 
-  // Delete PWR file from cache after successful installation
-  try {
-    if (fs.existsSync(pwrFile)) {
-      fs.unlinkSync(pwrFile);
-      console.log('[Butler] PWR file deleted from cache after successful installation:', pwrFile);
-    }
-  } catch (delErr) {
-    console.warn('[Butler] Failed to delete PWR file from cache:', delErr.message);
-  }
-
   if (progressCallback) {
     progressCallback('Installation complete', null, null, null, null);
   }
@@ -327,7 +316,7 @@ async function updateGameFiles(newVersion, progressCallback, gameDir = GAME_DIR,
   console.log(`[UpdateGameFiles] Switching from ${oldBranch} to ${branch}`);
   
   try {
-    // NEW 2.2.0: Ensure UserData migration to centralized location
+    // NEW 2.1.2: Ensure UserData migration to centralized location
     try {
       console.log('[UpdateGameFiles] Ensuring UserData migration...');
       const migrationResult = await migrateUserDataToCentralized();
@@ -363,15 +352,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);
-        console.log('[UpdateGameFiles] PWR file deleted from cache after successful update:', pwrFile);
-      }
-    } catch (delErr) {
-      console.warn('[UpdateGameFiles] Failed to delete PWR file from cache:', delErr.message);
-    }
+
     if (progressCallback) {
       progressCallback('Replacing game files...', 80, null, null, null);
     }
@@ -403,7 +384,7 @@ async function updateGameFiles(newVersion, progressCallback, gameDir = GAME_DIR,
     const logoResult = await downloadAndReplaceLogo(gameDir, progressCallback);
     console.log('Logo@2x.png update result after update:', logoResult);
 
-    // NEW 2.2.0: No longer create UserData in game installation
+    // NEW 2.1.2: No longer create UserData in game installation
     // UserData is now in centralized location (getUserDataPath())
     console.log('[UpdateGameFiles] UserData is managed in centralized location');
 
@@ -453,7 +434,7 @@ async function installGame(playerName = 'Player', progressCallback, javaPathOver
   const customGameDir = path.join(customAppDir, branch, 'package', 'game', 'latest');
   const customJreDir = path.join(customAppDir, branch, 'package', 'jre', 'latest');
 
-  // NEW 2.2.0: Ensure UserData migration to centralized location
+  // NEW 2.1.2: Ensure UserData migration to centralized location
   try {
     console.log('[InstallGame] Ensuring UserData migration...');
     const migrationResult = await migrateUserDataToCentralized();
@@ -529,33 +510,31 @@ async function installGame(playerName = 'Player', progressCallback, javaPathOver
   console.log(`Installing game files for branch: ${branch}...`);
 
   const latestVersion = await getLatestClientVersion(branch);
-  const targetVersion = FORCE_CLEAN_INSTALL_VERSION ? CLEAN_INSTALL_TEST_VERSION : latestVersion;
-  
-  if (FORCE_CLEAN_INSTALL_VERSION) {
-    console.log(`TESTING MODE: Forcing installation of ${targetVersion} instead of ${latestVersion}`);
-  }
-  
   let pwrFile;
   try {
-    pwrFile = await downloadPWR(branch, targetVersion, progressCallback, customCacheDir);
+    pwrFile = await downloadPWR(branch, latestVersion, progressCallback, customCacheDir);
     
+    // If downloadPWR returns false, it means the file doesn't exist or is invalid
+    // We should retry the download with a manual retry flag
     if (!pwrFile) {
       console.log('[Install] PWR file not found or invalid, attempting retry...');
-      pwrFile = await retryPWRDownload(branch, targetVersion, progressCallback, customCacheDir);
+      pwrFile = await retryPWRDownload(branch, latestVersion, progressCallback, customCacheDir);
     }
     
+    // Double-check we have a valid file path
     if (!pwrFile || typeof pwrFile !== 'string') {
       throw new Error(`PWR file download failed: received invalid path ${pwrFile}. Please retry download.`);
     }
     
   } catch (downloadError) {
     console.error('[Install] PWR download failed:', downloadError.message);
-    throw downloadError;
+    throw downloadError; // Re-throw to be handled by the main installGame error handler
   }
   
   await applyPWR(pwrFile, progressCallback, customGameDir, customToolsDir, branch, customCacheDir);
 
-  saveVersionClient(targetVersion);
+  // Save the installed version and branch to config
+  saveVersionClient(latestVersion);
   const { saveVersionBranch } = require('../core/config');
   saveVersionBranch(branch);
 
@@ -565,7 +544,7 @@ async function installGame(playerName = 'Player', progressCallback, javaPathOver
   const logoResult = await downloadAndReplaceLogo(customGameDir, progressCallback);
   console.log('Logo@2x.png update result after installation:', logoResult);
 
-  // NEW 2.2.0: No longer create UserData in game installation
+  // NEW 2.1.2: No longer create UserData in game installation
   // UserData is managed in centralized location (getUserDataPath())
   console.log('[InstallGame] UserData is managed in centralized location');
 

backend/managers/modManager.js

@@ -3,7 +3,7 @@ const path = require('path');
 const crypto = require('crypto');
 const axios = require('axios');
 const { getOS } = require('../utils/platformUtils');
-const { getModsPath, getProfilesDir, getHytaleSavesDir } = require('../core/paths');
+const { getModsPath, getProfilesDir } = require('../core/paths');
 const { saveModsToConfig, loadModsFromConfig } = require('../core/config');
 const profileManager = require('./profileManager');
 
@@ -296,9 +296,8 @@ async function syncModsForCurrentProfile() {
     console.log(`[ModManager] Syncing mods for profile: ${activeProfile.name} (${activeProfile.id})`);
 
     // 1. Resolve Paths
-    // centralModsPath is HytaleSaves\Mods (centralized location for active mods)
-    const hytaleSavesDir = getHytaleSavesDir();
-    const centralModsPath = path.join(hytaleSavesDir, 'Mods');
+    // globalModsPath is the one the game uses (symlink target)
+    const globalModsPath = await getModsPath(); 
     // profileModsPath is the real storage for this profile
     const profileModsPath = getProfileModsPath(activeProfile.id);
     const profileDisabledModsPath = path.join(path.dirname(profileModsPath), 'DisabledMods');
@@ -307,51 +306,96 @@ async function syncModsForCurrentProfile() {
       fs.mkdirSync(profileDisabledModsPath, { recursive: true });
     }
 
-    // 2. Copy-based Mod Sync (No symlinks - avoids permission issues)
-    // Ensure HytaleSaves\Mods directory exists
-    if (!fs.existsSync(centralModsPath)) {
-      fs.mkdirSync(centralModsPath, { recursive: true });
-      console.log(`[ModManager] Created centralized mods directory: ${centralModsPath}`);
-    }
-
-    // Check for old symlink and convert to real directory if needed (one-time migration)
+    // 2. Symlink / Migration Logic
+    let needsLink = false;
+    let globalStats = null;
+    
     try {
-      const centralStats = fs.lstatSync(centralModsPath);
-      if (centralStats.isSymbolicLink()) {
-        console.log('[ModManager] Removing old symlink, converting to copy-based system...');
-        fs.unlinkSync(centralModsPath);
-        fs.mkdirSync(centralModsPath, { recursive: true });
-      }
+      globalStats = fs.lstatSync(globalModsPath);
     } catch (e) {
-      // Path doesn't exist, will be created above
+      // Path doesn't exist
     }
 
-    // Copy enabled mods from profile to HytaleSaves\Mods (for game to use)
-    console.log(`[ModManager] Copying enabled mods from ${profileModsPath} to ${centralModsPath}`);
-    
-    // First, clear central mods folder
-    const existingCentralMods = fs.existsSync(centralModsPath) ? fs.readdirSync(centralModsPath) : [];
-    for (const file of existingCentralMods) {
-      const filePath = path.join(centralModsPath, file);
+    if (globalStats) {
+      if (globalStats.isSymbolicLink()) {
+        const linkTarget = fs.readlinkSync(globalModsPath);
+        // Normalize paths for comparison
+        if (path.resolve(linkTarget) !== path.resolve(profileModsPath)) {
+          console.log(`[ModManager] Updating symlink from ${linkTarget} to ${profileModsPath}`);
+          fs.unlinkSync(globalModsPath);
+          needsLink = true;
+        }
+      } else if (globalStats.isDirectory()) {
+        // MIGRATION: It's a real directory. Move contents to profile.
+        console.log('[ModManager] Migrating global mods folder to profile folder...');
+        const files = fs.readdirSync(globalModsPath);
+        for (const file of files) {
+          const src = path.join(globalModsPath, file);
+          const dest = path.join(profileModsPath, file);
+          // Only move if dest doesn't exist to avoid overwriting
+          if (!fs.existsSync(dest)) {
+             fs.renameSync(src, dest);
+          }
+        }
+        
+        // Also migrate DisabledMods if it exists globally
+        const globalDisabledPath = path.join(path.dirname(globalModsPath), 'DisabledMods');
+        if (fs.existsSync(globalDisabledPath) && fs.lstatSync(globalDisabledPath).isDirectory()) {
+             const dFiles = fs.readdirSync(globalDisabledPath);
+             for (const file of dFiles) {
+                 const src = path.join(globalDisabledPath, file);
+                 const dest = path.join(profileDisabledModsPath, file);
+                 if (!fs.existsSync(dest)) {
+                     fs.renameSync(src, dest);
+                 }
+             }
+             // We can remove global DisabledMods now, as it's not used by game
+             try { fs.rmSync(globalDisabledPath, { recursive: true, force: true }); } catch(e) {} 
+        }
+
+        // Remove the directory so we can link it
+        try {
+            let retries = 3;
+            while (retries > 0) {
+                try {
+                    fs.rmSync(globalModsPath, { recursive: true, force: true });
+                    break;
+                } catch (err) {
+                    if ((err.code === 'EPERM' || err.code === 'EBUSY') && retries > 0) {
+                        retries--;
+                        await new Promise(resolve => setTimeout(resolve, 500));
+                    } else {
+                        throw err;
+                    }
+                }
+            }
+            needsLink = true;
+        } catch (e) {
+            console.error('Failed to remove global mods dir:', e);
+             // Throw error to stop.
+             throw new Error('Failed to migrate mods directory. Please clear ' + globalModsPath);
+        }
+      }
+    } else {
+      needsLink = true;
+    }
+
+    if (needsLink) {
+      console.log(`[ModManager] Creating symlink: ${globalModsPath} -> ${profileModsPath}`);
       try {
-        fs.unlinkSync(filePath);
-      } catch (e) {
-        console.warn(`Failed to remove ${file} from central mods:`, e.message);
-      }
-    }
-    
-    // Copy enabled mods to HytaleSaves\Mods
-    const enabledModFiles = fs.existsSync(profileModsPath) ? fs.readdirSync(profileModsPath).filter(f => f.endsWith('.jar') || f.endsWith('.zip')) : [];
-    for (const file of enabledModFiles) {
-      const src = path.join(profileModsPath, file);
-      const dest = path.join(centralModsPath, file);
-      try {
-        fs.copyFileSync(src, dest);
-        console.log(`[ModManager] Copied ${file} to HytaleSaves\\Mods`);
-      } catch (e) {
-        console.error(`Failed to copy ${file}:`, e.message);
+         const symlinkType = getOS() === 'windows' ? 'junction' : 'dir';
+         fs.symlinkSync(profileModsPath, globalModsPath, symlinkType); 
+      } catch (err) {
+        // If we can't create the symlink, try creating the directory first
+        console.error('[ModManager] Failed to create symlink. Falling back to direct folder mode.');
+        console.error(err.message);
+
+    // Fallback: create a real directory so the game still works
+    if (!fs.existsSync(globalModsPath)) {
+      fs.mkdirSync(globalModsPath, { recursive: true });
       }
     }
+  }
 
     // 3. Auto-Repair (Download missing mods)
     const profileModsSnapshot = activeProfile.mods || [];
@@ -416,7 +460,7 @@ async function syncModsForCurrentProfile() {
     }
 
     // 5. Enforce Enabled/Disabled State (Move files between Profile/Mods and Profile/DisabledMods)
-    // Note: Enabled mods are copied to HytaleSaves\Mods, disabled mods stay in Profile/DisabledMods
+    // Note: Since Global/Mods IS Profile/Mods (via symlink), moving out of Profile/Mods disables it for the game.
     
     const disabledFiles = fs.existsSync(profileDisabledModsPath) ? fs.readdirSync(profileDisabledModsPath).filter(f => f.endsWith('.jar') || f.endsWith('.zip')) : [];
     const allFiles = new Set([...enabledFiles, ...disabledFiles]);

backend/services/versionManager.js

@@ -1,17 +1,11 @@
 const axios = require('axios');
-const crypto = require('crypto');
-const fs = require('fs');
-const { getOS, getArch } = require('../utils/platformUtils');
-
-const BASE_PATCH_URL = 'https://game-patches.hytale.com/patches';
-const MANIFEST_API = 'https://files.hytalef2p.com/api/patch_manifest';
 
 async function getLatestClientVersion(branch = 'release') {
   try {
     console.log(`Fetching latest client version from API (branch: ${branch})...`);
     const response = await axios.get('https://files.hytalef2p.com/api/version_client', {
       params: { branch },
-      timeout: 40000,
+      timeout: 5000,
       headers: {
         'User-Agent': 'Hytale-F2P-Launcher'
       }
@@ -22,144 +16,16 @@ async function getLatestClientVersion(branch = 'release') {
       console.log(`Latest client version for ${branch}: ${version}`);
       return version;
     } else {
-      console.log('Warning: Invalid API response, falling back to latest known version (7.pwr)');
-      return '7.pwr';
+      console.log('Warning: Invalid API response, falling back to default version');
+      return '4.pwr';
     }
   } catch (error) {
     console.error('Error fetching client version:', error.message);
-    console.log('Warning: API unavailable, falling back to latest known version (7.pwr)');
-    return '7.pwr';
-  }
-}
-
-function buildArchiveUrl(buildNumber, branch = 'release') {
-  const os = getOS();
-  const arch = getArch();
-  return `${BASE_PATCH_URL}/${os}/${arch}/${branch}/0/${buildNumber}.pwr`;
-}
-
-async function checkArchiveExists(buildNumber, branch = 'release') {
-  const url = buildArchiveUrl(buildNumber, branch);
-  try {
-    const response = await axios.head(url, { timeout: 10000 });
-    return response.status === 200;
-  } catch (error) {
-    return false;
-  }
-}
-
-async function discoverAvailableVersions(latestKnown, branch = 'release', maxProbe = 50) {
-  const available = [];
-  const latest = parseInt(latestKnown.replace('.pwr', ''));
-  
-  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 arch = getArch();
-    const response = await axios.get(MANIFEST_API, {
-      params: { branch, os, arch },
-      timeout: 10000
-    });
-    return response.data.patches || {};
-  } catch (error) {
-    console.error('Failed to fetch patch manifest:', error.message);
-    return {};
-  }
-}
-
-async function extractVersionDetails(targetVersion, branch = 'release') {
-  const buildNumber = parseInt(targetVersion.replace('.pwr', ''));
-  const previousBuild = buildNumber - 1;
-  
-  const manifest = await fetchPatchManifest(branch);
-  const patchInfo = manifest[buildNumber];
-  
-  return {
-    version: targetVersion,
-    buildNumber: buildNumber,
-    buildName: `HYTALE-Build-${buildNumber}`,
-    fullUrl: patchInfo?.original_url || buildArchiveUrl(buildNumber, branch),
-    differentialUrl: patchInfo?.patch_url || null,
-    checksum: patchInfo?.patch_hash || null,
-    sourceVersion: patchInfo?.from ? `${patchInfo.from}.pwr` : (previousBuild > 0 ? `${previousBuild}.pwr` : null),
-    isDifferential: !!patchInfo?.proper_patch,
-    releaseNotes: patchInfo?.patch_note || null
-  };
-}
-
-function canUseDifferentialUpdate(currentVersion, targetDetails) {
-  if (!targetDetails) return false;
-  if (!targetDetails.differentialUrl) return false;
-  if (!targetDetails.isDifferential) return false;
-  
-  if (!currentVersion) return false;
-  
-  const currentBuild = parseInt(currentVersion.replace('.pwr', ''));
-  const expectedSource = parseInt(targetDetails.sourceVersion?.replace('.pwr', '') || '0');
-  
-  return currentBuild === expectedSource;
-}
-
-function needsIntermediatePatches(currentVersion, targetVersion) {
-  if (!currentVersion) return [];
-  
-  const current = parseInt(currentVersion.replace('.pwr', ''));
-  const target = parseInt(targetVersion.replace('.pwr', ''));
-  
-  const intermediates = [];
-  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);
-  });
-}
-
-async function validateChecksum(filePath, expectedChecksum) {
-  if (!expectedChecksum) return true;
-  
-  const actualChecksum = await computeFileChecksum(filePath);
-  return actualChecksum === expectedChecksum;
-}
-
-function getInstalledClientVersion() {
-  try {
-    const { loadVersionClient } = require('../core/config');
-    return loadVersionClient();
-  } catch (err) {
-    return null;
+    console.log('Warning: API unavailable, falling back to default version');
+    return '4.pwr';
   }
 }
 
 module.exports = {
-  getLatestClientVersion,
-  buildArchiveUrl,
-  checkArchiveExists,
-  discoverAvailableVersions,
-  extractVersionDetails,
-  canUseDifferentialUpdate,
-  needsIntermediatePatches,
-  computeFileChecksum,
-  validateChecksum,
-  getInstalledClientVersion
+  getLatestClientVersion
 };

backend/utils/clientPatcher.js

@@ -1,5 +1,10 @@
 const fs = require('fs');
 const path = require('path');
+const crypto = require('crypto');
+const AdmZip = require('adm-zip');
+const { execSync, spawn } = require('child_process');
+const { getJavaExec, getBundledJavaPath } = require('../managers/javaManager');
+const { JRE_DIR } = require('../core/paths');
 
 // Domain configuration
 const ORIGINAL_DOMAIN = 'hytale.com';
@@ -21,13 +26,15 @@ function getTargetDomain() {
 const DEFAULT_NEW_DOMAIN = 'auth.sanasol.ws';
 
 /**
- * Patches HytaleClient binary to replace hytale.com with custom domain
- * Server patching is done via pre-patched JAR download from CDN
+ * Patches HytaleClient and HytaleServer binaries to replace hytale.com with custom domain
+ * This allows the game to connect to a custom authentication server
  *
  * Supports domains from 4 to 16 characters:
  * - All F2P traffic routes to single endpoint: https://{domain} (no subdomains)
  * - Domains <= 10 chars: Direct replacement, subdomains stripped
  * - Domains 11-16 chars: Split mode - first 6 chars replace subdomain prefix, rest replaces domain
+ *
+ * Official hytale.com keeps original subdomain behavior (sessions., account-data., etc.)
  */
 class ClientPatcher {
   constructor() {
@@ -54,6 +61,7 @@ class ClientPatcher {
 
   /**
    * Calculate the domain patching strategy based on length
+   * @returns {object} Strategy with mainDomain and subdomainPrefix
    */
   getDomainStrategy(domain) {
     if (domain.length <= 10) {
@@ -77,10 +85,12 @@ class ClientPatcher {
 
   /**
    * Convert a string to the length-prefixed byte format used by the client
+   * Format: [length byte] [00 00 00 padding] [char1] [00] [char2] [00] ... [lastChar]
    */
   stringToLengthPrefixed(str) {
     const length = str.length;
     const result = Buffer.alloc(4 + length + (length - 1));
+
     result[0] = length;
     result[1] = 0x00;
     result[2] = 0x00;
@@ -93,6 +103,7 @@ class ClientPatcher {
         result[pos++] = 0x00;
       }
     }
+
     return result;
   }
 
@@ -107,6 +118,13 @@ class ClientPatcher {
     return buf;
   }
 
+  /**
+   * Convert a string to UTF-8 bytes (how Java stores strings)
+   */
+  stringToUtf8(str) {
+    return Buffer.from(str, 'utf8');
+  }
+
   /**
    * Find all occurrences of a pattern in a buffer
    */
@@ -124,6 +142,7 @@ class ClientPatcher {
 
   /**
    * Replace bytes in buffer - only overwrites the length of new bytes
+   * Does NOT null-pad to avoid corrupting adjacent data
    */
   replaceBytes(buffer, oldBytes, newBytes) {
     let count = 0;
@@ -135,7 +154,9 @@ class ClientPatcher {
     }
 
     const positions = this.findAllOccurrences(result, oldBytes);
+
     for (const pos of positions) {
+      // Only overwrite the length of the new bytes - don't null-fill!
       newBytes.copy(result, pos);
       count++;
     }
@@ -144,12 +165,37 @@ class ClientPatcher {
   }
 
   /**
-   * Smart domain replacement that handles both null-terminated and non-null-terminated strings
+   * UTF-8 domain replacement for Java JAR files
+   */
+  findAndReplaceDomainUtf8(data, oldDomain, newDomain) {
+    let count = 0;
+    const result = Buffer.from(data);
+
+    const oldUtf8 = this.stringToUtf8(oldDomain);
+    const newUtf8 = this.stringToUtf8(newDomain);
+
+    const positions = this.findAllOccurrences(result, oldUtf8);
+
+    for (const pos of positions) {
+      newUtf8.copy(result, pos);
+      count++;
+    }
+
+    return { buffer: result, count };
+  }
+
+  /**
+   * Smart domain replacement for .NET AOT binaries
    */
   findAndReplaceDomainSmart(data, oldDomain, newDomain) {
     let count = 0;
     const result = Buffer.from(data);
 
+    if (newDomain.length > oldDomain.length) {
+      console.warn(`  Warning: New domain longer than old, skipping smart replacement`);
+      return { buffer: result, count: 0 };
+    }
+
     const oldUtf16NoLast = this.stringToUtf16LE(oldDomain.slice(0, -1));
     const newUtf16NoLast = this.stringToUtf16LE(newDomain.slice(0, -1));
 
@@ -165,17 +211,9 @@ class ClientPatcher {
       const lastCharFirstByte = result[lastCharPos];
 
       if (lastCharFirstByte === oldLastCharByte) {
+        // Only overwrite, don't null-fill
         newUtf16NoLast.copy(result, pos);
         result[lastCharPos] = newLastCharByte;
-
-        if (lastCharPos + 1 < result.length) {
-          const secondByte = result[lastCharPos + 1];
-          if (secondByte === 0x00) {
-            console.log(`  Patched UTF-16LE occurrence at offset 0x${pos.toString(16)}`);
-          } else {
-            console.log(`  Patched length-prefixed occurrence at offset 0x${pos.toString(16)} (metadata: 0x${secondByte.toString(16)})`);
-          }
-        }
         count++;
       }
     }
@@ -193,24 +231,10 @@ class ClientPatcher {
 
     console.log(`  Patching strategy: ${strategy.description}`);
 
-    // 1. Patch telemetry/sentry URL
-    const oldSentry = 'https://ca900df42fcf57d4dd8401a86ddd7da2@sentry.hytale.com/2';
-    const newSentry = `${protocol}t@${domain}/2`;
+    // ULTRA-MINIMAL PATCHING - only domain, no subdomain patches
+    console.log(`  Ultra-minimal mode: only patching main domain`);
 
-    console.log(`  Patching sentry: ${oldSentry.slice(0, 30)}... -> ${newSentry}`);
-    const sentryResult = this.replaceBytes(
-      result,
-      this.stringToLengthPrefixed(oldSentry),
-      this.stringToLengthPrefixed(newSentry)
-    );
-    result = sentryResult.buffer;
-    if (sentryResult.count > 0) {
-      console.log(`    Replaced ${sentryResult.count} sentry occurrence(s)`);
-      totalCount += sentryResult.count;
-    }
-
-    // 2. Patch main domain
-    console.log(`  Patching domain: ${ORIGINAL_DOMAIN} -> ${strategy.mainDomain}`);
+    // Only patch main domain (hytale.com -> mainDomain)
     const domainResult = this.replaceBytes(
       result,
       this.stringToLengthPrefixed(ORIGINAL_DOMAIN),
@@ -218,125 +242,48 @@ class ClientPatcher {
     );
     result = domainResult.buffer;
     if (domainResult.count > 0) {
-      console.log(`    Replaced ${domainResult.count} domain occurrence(s)`);
+      console.log(`  Patched ${domainResult.count} domain occurrence(s)`);
       totalCount += domainResult.count;
     }
 
-    // 3. Patch subdomain prefixes
-    const subdomains = ['https://tools.', 'https://sessions.', 'https://account-data.', 'https://telemetry.'];
-    const newSubdomainPrefix = protocol + strategy.subdomainPrefix;
-
-    for (const sub of subdomains) {
-      console.log(`  Patching subdomain: ${sub} -> ${newSubdomainPrefix}`);
-      const subResult = this.replaceBytes(
-        result,
-        this.stringToLengthPrefixed(sub),
-        this.stringToLengthPrefixed(newSubdomainPrefix)
-      );
-      result = subResult.buffer;
-      if (subResult.count > 0) {
-        console.log(`    Replaced ${subResult.count} occurrence(s)`);
-        totalCount += subResult.count;
-      }
-    }
+    // Skip ALL subdomain patches - let them stay as sessions.hytale.com etc
+    console.log(`  Skipping all subdomain patches (ultra-minimal mode)`);
 
     return { buffer: result, count: totalCount };
   }
 
   /**
-   * Patch Discord invite URLs
+   * Check if the client binary has already been patched
    */
-  patchDiscordUrl(data) {
-    let count = 0;
-    const result = Buffer.from(data);
-
-    const oldUrl = '.gg/hytale';
-    const newUrl = '.gg/hf2pdc';
-
-    const lpResult = this.replaceBytes(
-      result,
-      this.stringToLengthPrefixed(oldUrl),
-      this.stringToLengthPrefixed(newUrl)
-    );
-
-    if (lpResult.count > 0) {
-      return { buffer: lpResult.buffer, count: lpResult.count };
-    }
-
-    // Fallback to UTF-16LE
-    const oldUtf16 = this.stringToUtf16LE(oldUrl);
-    const newUtf16 = this.stringToUtf16LE(newUrl);
-
-    const positions = this.findAllOccurrences(result, oldUtf16);
-    for (const pos of positions) {
-      newUtf16.copy(result, pos);
-      count++;
-    }
-
-    return { buffer: result, count };
-  }
-
-  /**
-   * Check patch status of client binary
-   */
-  getPatchStatus(clientPath) {
+  isPatchedAlready(clientPath) {
     const newDomain = this.getNewDomain();
     const patchFlagFile = clientPath + this.patchedFlag;
 
     if (fs.existsSync(patchFlagFile)) {
       try {
         const flagData = JSON.parse(fs.readFileSync(patchFlagFile, 'utf8'));
-        const currentDomain = flagData.targetDomain;
-
-        if (currentDomain === newDomain) {
+        if (flagData.targetDomain === newDomain) {
+          // Verify the binary actually contains the patched domain
           const data = fs.readFileSync(clientPath);
           const strategy = this.getDomainStrategy(newDomain);
           const domainPattern = this.stringToLengthPrefixed(strategy.mainDomain);
 
           if (data.includes(domainPattern)) {
-            return { patched: true, currentDomain, needsRestore: false };
+            return true;
           } else {
-            console.log('  Flag exists but binary not patched (was updated?), needs re-patching...');
-            return { patched: false, currentDomain: null, needsRestore: false };
+            console.log('  Flag exists but binary not patched (was updated?), re-patching...');
+            return false;
           }
-        } else {
-          console.log(`  Currently patched for "${currentDomain}", need to change to "${newDomain}"`);
-          return { patched: false, currentDomain, needsRestore: true };
         }
       } catch (e) {
         // Flag file corrupt
       }
     }
-    return { patched: false, currentDomain: null, needsRestore: false };
-  }
-
-  /**
-   * Check if client is already patched (backward compat)
-   */
-  isPatchedAlready(clientPath) {
-    return this.getPatchStatus(clientPath).patched;
-  }
-
-  /**
-   * Restore client from backup
-   */
-  restoreFromBackup(clientPath) {
-    const backupPath = clientPath + '.original';
-    if (fs.existsSync(backupPath)) {
-      console.log('  Restoring original binary from backup for re-patching...');
-      fs.copyFileSync(backupPath, clientPath);
-      const patchFlagFile = clientPath + this.patchedFlag;
-      if (fs.existsSync(patchFlagFile)) {
-        fs.unlinkSync(patchFlagFile);
-      }
-      return true;
-    }
-    console.warn('  No backup found to restore - will try patching anyway');
     return false;
   }
 
   /**
-   * Mark client as patched
+   * Mark the client as patched
    */
   markAsPatched(clientPath) {
     const newDomain = this.getNewDomain();
@@ -349,46 +296,40 @@ class ClientPatcher {
       patchMode: strategy.mode,
       mainDomain: strategy.mainDomain,
       subdomainPrefix: strategy.subdomainPrefix,
-      patcherVersion: '2.1.0',
-      verified: 'binary_contents'
+      patcherVersion: '2.1.0'
     };
     fs.writeFileSync(patchFlagFile, JSON.stringify(flagData, null, 2));
   }
 
   /**
-   * Create backup of original client binary
+   * Create a backup of the original client binary
    */
   backupClient(clientPath) {
     const backupPath = clientPath + '.original';
-    try {
-      if (!fs.existsSync(backupPath)) {
-        console.log(`  Creating backup at ${path.basename(backupPath)}`);
-        fs.copyFileSync(clientPath, backupPath);
-        return backupPath;
-      }
-
-      const currentSize = fs.statSync(clientPath).size;
-      const backupSize = fs.statSync(backupPath).size;
-
-      if (currentSize !== backupSize) {
-        const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
-        const oldBackupPath = `${clientPath}.original.${timestamp}`;
-        console.log(`  File updated, archiving old backup to ${path.basename(oldBackupPath)}`);
-        fs.renameSync(backupPath, oldBackupPath);
-        fs.copyFileSync(clientPath, backupPath);
-        return backupPath;
-      }
-
-      console.log('  Backup already exists');
+    if (!fs.existsSync(backupPath)) {
+      console.log(`  Creating backup at ${path.basename(backupPath)}`);
+      fs.copyFileSync(clientPath, backupPath);
       return backupPath;
-    } catch (e) {
-      console.error(`  Failed to create backup: ${e.message}`);
-      return null;
     }
+
+    const currentSize = fs.statSync(clientPath).size;
+    const backupSize = fs.statSync(backupPath).size;
+
+    if (currentSize !== backupSize) {
+      const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+      const oldBackupPath = `${clientPath}.original.${timestamp}`;
+      console.log(`  File updated, archiving old backup to ${path.basename(oldBackupPath)}`);
+      fs.renameSync(backupPath, oldBackupPath);
+      fs.copyFileSync(clientPath, backupPath);
+      return backupPath;
+    }
+
+    console.log('  Backup already exists');
+    return backupPath;
   }
 
   /**
-   * Restore original client binary
+   * Restore the original client binary from backup
    */
   restoreClient(clientPath) {
     const backupPath = clientPath + '.original';
@@ -416,10 +357,6 @@ class ClientPatcher {
     console.log(`Target: ${clientPath}`);
     console.log(`Domain: ${newDomain} (${newDomain.length} chars)`);
     console.log(`Mode: ${strategy.mode}`);
-    if (strategy.mode === 'split') {
-      console.log(`  Subdomain prefix: ${strategy.subdomainPrefix}`);
-      console.log(`  Main domain: ${strategy.mainDomain}`);
-    }
 
     if (!fs.existsSync(clientPath)) {
       const error = `Client binary not found: ${clientPath}`;
@@ -427,26 +364,16 @@ class ClientPatcher {
       return { success: false, error };
     }
 
-    const patchStatus = this.getPatchStatus(clientPath);
-
-    if (patchStatus.patched) {
+    if (this.isPatchedAlready(clientPath)) {
       console.log(`Client already patched for ${newDomain}, skipping`);
       if (progressCallback) progressCallback('Client already patched', 100);
       return { success: true, alreadyPatched: true, patchCount: 0 };
     }
 
-    if (patchStatus.needsRestore) {
-      if (progressCallback) progressCallback('Restoring original for domain change...', 5);
-      this.restoreFromBackup(clientPath);
-    }
-
     if (progressCallback) progressCallback('Preparing to patch client...', 10);
 
     console.log('Creating backup...');
-    const backupResult = this.backupClient(clientPath);
-    if (!backupResult) {
-      console.warn('  Could not create backup - proceeding without backup');
-    }
+    this.backupClient(clientPath);
 
     if (progressCallback) progressCallback('Reading client binary...', 20);
 
@@ -456,15 +383,12 @@ class ClientPatcher {
 
     if (progressCallback) progressCallback('Patching domain references...', 50);
 
-    console.log('Applying domain patches (length-prefixed format)...');
+    console.log('Applying domain patches...');
     const { buffer: patchedData, count } = this.applyDomainPatches(data, newDomain);
 
-    console.log('Patching Discord URLs...');
-    const { buffer: finalData, count: discordCount } = this.patchDiscordUrl(patchedData);
-
-    if (count === 0 && discordCount === 0) {
+    if (count === 0) {
+      // Try legacy UTF-16LE format
       console.log('No occurrences found - trying legacy UTF-16LE format...');
-
       const legacyResult = this.findAndReplaceDomainSmart(data, ORIGINAL_DOMAIN, strategy.mainDomain);
       if (legacyResult.count > 0) {
         console.log(`Found ${legacyResult.count} occurrences with legacy format`);
@@ -473,67 +397,32 @@ class ClientPatcher {
         return { success: true, patchCount: legacyResult.count, format: 'legacy' };
       }
 
-      console.log('No occurrences found - binary may already be modified or has different format');
+      console.log('No occurrences found - binary may already be modified');
       return { success: true, patchCount: 0, warning: 'No occurrences found' };
     }
 
     if (progressCallback) progressCallback('Writing patched binary...', 80);
 
     console.log('Writing patched binary...');
-    fs.writeFileSync(clientPath, finalData);
-
+    fs.writeFileSync(clientPath, patchedData);
     this.markAsPatched(clientPath);
 
     if (progressCallback) progressCallback('Patching complete', 100);
 
-    console.log(`Successfully patched ${count} domain occurrences and ${discordCount} Discord URLs`);
+    console.log(`Successfully patched ${count} occurrences`);
     console.log('=== Patching Complete ===');
 
-    return { success: true, patchCount: count + discordCount };
+    return { success: true, patchCount: count };
   }
 
   /**
-   * Check if server JAR contains DualAuth classes (was patched)
+   * Patch the server JAR by downloading pre-patched version
    */
-  serverJarContainsDualAuth(serverPath) {
-    try {
-      const data = fs.readFileSync(serverPath);
-      // Check for DualAuthContext class signature in JAR
-      const signature = Buffer.from('DualAuthContext', 'utf8');
-      return data.includes(signature);
-    } catch (e) {
-      return false;
-    }
-  }
-
-  /**
-   * Validate downloaded file is not corrupt/partial
-   * Server JAR should be at least 50MB
-   */
-  validateServerJarSize(serverPath) {
-    try {
-      const stats = fs.statSync(serverPath);
-      const minSize = 50 * 1024 * 1024; // 50MB minimum
-      if (stats.size < minSize) {
-        console.error(`  Downloaded JAR too small: ${(stats.size / 1024 / 1024).toFixed(2)} MB (expected >50MB)`);
-        return false;
-      }
-      console.log(`  Downloaded size: ${(stats.size / 1024 / 1024).toFixed(2)} MB`);
-      return true;
-    } catch (e) {
-      return false;
-    }
-  }
-
-  /**
-   * Patch server JAR by downloading pre-patched version from CDN
-   */
-  async patchServer(serverPath, progressCallback, branch = 'release') {
+  async patchServer(serverPath, progressCallback, javaPath = null) {
     const newDomain = this.getNewDomain();
 
-    console.log('=== Server Patcher (Pre-patched Download) ===');
+    console.log('=== Server Patcher ===');
     console.log(`Target: ${serverPath}`);
-    console.log(`Branch: ${branch}`);
     console.log(`Domain: ${newDomain}`);
 
     if (!fs.existsSync(serverPath)) {
@@ -542,80 +431,30 @@ class ClientPatcher {
       return { success: false, error };
     }
 
-    // Check if already patched
     const patchFlagFile = serverPath + '.dualauth_patched';
-    let needsRestore = false;
-
     if (fs.existsSync(patchFlagFile)) {
       try {
         const flagData = JSON.parse(fs.readFileSync(patchFlagFile, 'utf8'));
-        if (flagData.domain === newDomain && flagData.branch === branch) {
-          // Verify JAR actually contains DualAuth classes (game may have auto-updated)
-          if (this.serverJarContainsDualAuth(serverPath)) {
-            console.log(`Server already patched for ${newDomain} (${branch}), skipping`);
-            if (progressCallback) progressCallback('Server already patched', 100);
-            return { success: true, alreadyPatched: true };
-          } else {
-            console.log('  Flag exists but JAR not patched (was auto-updated?), will re-download...');
-            // Delete stale flag file
-            try { fs.unlinkSync(patchFlagFile); } catch (e) { /* ignore */ }
-          }
-        } else {
-          console.log(`Server patched for "${flagData.domain}" (${flagData.branch}), need to change to "${newDomain}" (${branch})`);
-          needsRestore = true;
+        if (flagData.domain === newDomain) {
+          console.log(`Server already patched for ${newDomain}, skipping`);
+          if (progressCallback) progressCallback('Server already patched', 100);
+          return { success: true, alreadyPatched: true };
         }
       } catch (e) {
-        // Flag file corrupt, re-patch
-        console.log('  Flag file corrupt, will re-download');
-        try { fs.unlinkSync(patchFlagFile); } catch (e) { /* ignore */ }
+        // Re-patch
       }
     }
 
-    // Restore backup if patched for different domain
-    if (needsRestore) {
-      const backupPath = serverPath + '.original';
-      if (fs.existsSync(backupPath)) {
-        if (progressCallback) progressCallback('Restoring original for domain change...', 5);
-        console.log('Restoring original JAR from backup for re-patching...');
-        fs.copyFileSync(backupPath, serverPath);
-        if (fs.existsSync(patchFlagFile)) {
-          fs.unlinkSync(patchFlagFile);
-        }
-      } else {
-        console.warn('  No backup found to restore - will download fresh patched JAR');
-      }
-    }
-
-    // Create backup
     if (progressCallback) progressCallback('Creating backup...', 10);
     console.log('Creating backup...');
-    const backupResult = this.backupClient(serverPath);
-    if (!backupResult) {
-      console.warn('  Could not create backup - proceeding without backup');
-    }
+    this.backupClient(serverPath);
 
-    // Only support standard domain (auth.sanasol.ws) via pre-patched download
-    if (newDomain !== 'auth.sanasol.ws' && newDomain !== 'sanasol.ws') {
-      console.error(`Domain "${newDomain}" requires DualAuthPatcher - only auth.sanasol.ws is supported via pre-patched download`);
-      return { success: false, error: `Unsupported domain: ${newDomain}. Only auth.sanasol.ws is supported.` };
-    }
-
-    // Download pre-patched JAR
     if (progressCallback) progressCallback('Downloading patched server JAR...', 30);
-    console.log('Downloading pre-patched HytaleServer.jar...');
+    console.log('Downloading pre-patched HytaleServer.jar');
 
     try {
       const https = require('https');
-      
-      // Use different URL for pre-release vs release
-      let url;
-      if (branch === 'pre-release') {
-        url = 'https://patcher.authbp.xyz/download/patched_prerelease';
-        console.log('  Using pre-release patched server from:', url);
-      } else {
-        url = 'https://patcher.authbp.xyz/download/patched_release';
-        console.log('  Using release patched server from:', url);
-      }
+      const url = 'https://pub-027b315ece074e2e891002ca38384792.r2.dev/HytaleServer.jar';
 
       await new Promise((resolve, reject) => {
         const handleResponse = (response) => {
@@ -625,7 +464,7 @@ class ClientPatcher {
           }
 
           if (response.statusCode !== 200) {
-            reject(new Error(`Failed to download: HTTP ${response.statusCode}`));
+            reject(new Error(`HTTP ${response.statusCode}`));
             return;
           }
 
@@ -656,47 +495,11 @@ class ClientPatcher {
 
       console.log('  Download successful');
 
-      // Verify downloaded JAR size and contents
-      if (progressCallback) progressCallback('Verifying downloaded JAR...', 95);
-
-      if (!this.validateServerJarSize(serverPath)) {
-        console.error('Downloaded JAR appears corrupt or incomplete');
-
-        // Restore backup on verification failure
-        const backupPath = serverPath + '.original';
-        if (fs.existsSync(backupPath)) {
-          fs.copyFileSync(backupPath, serverPath);
-          console.log('Restored backup after verification failure');
-        }
-
-        return { success: false, error: 'Downloaded JAR verification failed - file too small (corrupt/partial download)' };
-      }
-
-      if (!this.serverJarContainsDualAuth(serverPath)) {
-        console.error('Downloaded JAR does not contain DualAuth classes - invalid or corrupt download');
-
-        // Restore backup on verification failure
-        const backupPath = serverPath + '.original';
-        if (fs.existsSync(backupPath)) {
-          fs.copyFileSync(backupPath, serverPath);
-          console.log('Restored backup after verification failure');
-        }
-
-        return { success: false, error: 'Downloaded JAR verification failed - missing DualAuth classes' };
-      }
-      console.log('  Verification successful - DualAuth classes present');
-
-      // Mark as patched
-      const sourceUrl = branch === 'pre-release' 
-        ? 'https://patcher.authbp.xyz/download/patched_prerelease'
-        : 'https://patcher.authbp.xyz/download/patched_release';
-      
       fs.writeFileSync(patchFlagFile, JSON.stringify({
         domain: newDomain,
-        branch: branch,
         patchedAt: new Date().toISOString(),
         patcher: 'PrePatchedDownload',
-        source: sourceUrl
+        source: url
       }));
 
       if (progressCallback) progressCallback('Server patching complete', 100);
@@ -706,7 +509,6 @@ class ClientPatcher {
     } catch (downloadError) {
       console.error(`Failed to download patched JAR: ${downloadError.message}`);
 
-      // Restore backup on failure
       const backupPath = serverPath + '.original';
       if (fs.existsSync(backupPath)) {
         fs.copyFileSync(backupPath, serverPath);
@@ -718,7 +520,40 @@ class ClientPatcher {
   }
 
   /**
-   * Find client binary path based on platform
+   * Find Java executable
+   */
+  findJava() {
+    try {
+      const bundled = getBundledJavaPath(JRE_DIR);
+      if (bundled && fs.existsSync(bundled)) {
+        return bundled;
+      }
+    } catch (e) {}
+
+    try {
+      const javaExec = getJavaExec(JRE_DIR);
+      if (javaExec && fs.existsSync(javaExec)) {
+        return javaExec;
+      }
+    } catch (e) {}
+
+    if (process.env.JAVA_HOME) {
+      const javaBin = path.join(process.env.JAVA_HOME, 'bin', process.platform === 'win32' ? 'java.exe' : 'java');
+      if (fs.existsSync(javaBin)) {
+        return javaBin;
+      }
+    }
+
+    try {
+      execSync('java -version 2>&1', { encoding: 'utf8' });
+      return 'java';
+    } catch (e) {}
+
+    return null;
+  }
+
+  /**
+   * Find the client binary path based on platform
    */
   findClientPath(gameDir) {
     const candidates = [];
@@ -740,9 +575,6 @@ class ClientPatcher {
     return null;
   }
 
-  /**
-   * Find server JAR path
-   */
   findServerPath(gameDir) {
     const candidates = [
       path.join(gameDir, 'Server', 'HytaleServer.jar'),
@@ -760,7 +592,7 @@ class ClientPatcher {
   /**
    * Ensure both client and server are patched before launching
    */
-  async ensureClientPatched(gameDir, progressCallback, javaPath = null, branch = 'release') {
+  async ensureClientPatched(gameDir, progressCallback, javaPath = null) {
     const results = {
       client: null,
       server: null,
@@ -771,9 +603,7 @@ class ClientPatcher {
     if (clientPath) {
       if (progressCallback) progressCallback('Patching client binary...', 10);
       results.client = await this.patchClient(clientPath, (msg, pct) => {
-        if (progressCallback) {
-          progressCallback(`Client: ${msg}`, pct ? pct / 2 : null);
-        }
+        if (progressCallback) progressCallback(`Client: ${msg}`, pct ? pct / 2 : null);
       });
     } else {
       console.warn('Could not find HytaleClient binary');
@@ -784,10 +614,8 @@ class ClientPatcher {
     if (serverPath) {
       if (progressCallback) progressCallback('Patching server JAR...', 50);
       results.server = await this.patchServer(serverPath, (msg, pct) => {
-        if (progressCallback) {
-          progressCallback(`Server: ${msg}`, pct ? 50 + pct / 2 : null);
-        }
-      }, branch);
+        if (progressCallback) progressCallback(`Server: ${msg}`, pct ? 50 + pct / 2 : null);
+      }, javaPath);
     } else {
       console.warn('Could not find HytaleServer.jar');
       results.server = { success: false, error: 'Server JAR not found' };

backend/utils/platformUtils.js

@@ -18,16 +18,11 @@ function isWaylandSession() {
   }
   
   const sessionType = process.env.XDG_SESSION_TYPE;
-  const waylandDisplay = process.env.WAYLAND_DISPLAY;
-
-  // Debug logging
-  console.log(`[PlatformUtils] Checking Wayland: XDG_SESSION_TYPE=${sessionType}, WAYLAND_DISPLAY=${waylandDisplay}`);
-
   if (sessionType && sessionType.toLowerCase() === 'wayland') {
     return true;
   }
   
-  if (waylandDisplay) {
+  if (process.env.WAYLAND_DISPLAY) {
     return true;
   }
   
@@ -49,48 +44,19 @@ function setupWaylandEnvironment() {
   if (process.platform !== 'linux') {
     return {};
   }
-
-  // If the user has manually set SDL_VIDEODRIVER (e.g. to 'x11'), strictly respect it.
-  if (process.env.SDL_VIDEODRIVER) {
-    console.log(`User manually set SDL_VIDEODRIVER=${process.env.SDL_VIDEODRIVER}, ignoring internal Wayland configuration.`);
-    return {};
-  }
   
   if (!isWaylandSession()) {
     console.log('Detected X11 session, using default environment');
     return {};
   }
   
-  console.log('Detected Wayland session, checking for Gamescope/Steam Deck...');
+  console.log('Detected Wayland session, configuring environment...');
   
-  const envVars = {};
-
-  // Only set Ozone hint if not already set by user
-  if (!process.env.ELECTRON_OZONE_PLATFORM_HINT) {
-    envVars.ELECTRON_OZONE_PLATFORM_HINT = 'wayland';
-  }
-
-  // 2. DETECT GAMESCOPE / STEAM DECK
-  // Native Wayland often fails for SDL games in Gaming Mode (gamescope), so we force X11 (XWayland).
-  // Checks:
-  // - XDG_CURRENT_DESKTOP == 'gamescope'
-  // - SteamDeck=1 (often set in SteamOS)
-  const currentDesktop = process.env.XDG_CURRENT_DESKTOP || '';
-  const isGamescope = currentDesktop.toLowerCase() === 'gamescope' || process.env.SteamDeck === '1';
+  const envVars = {
+    SDL_VIDEODRIVER: 'wayland'
+  };
   
-  if (isGamescope) {
-    console.log('Gamescope / Steam Deck detected, forcing SDL_VIDEODRIVER=x11 for compatibility');
-    envVars.SDL_VIDEODRIVER = 'x11';
-  } else {
-    // For standard desktop Wayland (GNOME, KDE), we leave SDL_VIDEODRIVER unset.
-    // This allows SDL3/SDL2 to use its internal preference (Wayland > X11).
-    // EXCEPT if it was somehow force-set to 'wayland' by the parent process (rare but possible),
-    // we strictly want to allow fallback, so we might unset it if it was 'wayland'.
-    // But since we checked process.env.SDL_VIDEODRIVER at the start, we know it's NOT set manually.
-    
-    // So we effectively do nothing for standard Wayland, letting SDL decide.
-    console.log('Standard Wayland session detected, letting SDL decide backend (auto-fallback enabled).');
-  }
+  envVars.ELECTRON_OZONE_PLATFORM_HINT = 'wayland';
   
   console.log('Wayland environment variables:', envVars);
   return envVars;

backend/utils/serverListSync.js

@@ -1,120 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-const axios = require('axios');
-const { v4: uuidv4 } = require('uuid');
-const { getHytaleSavesDir } = require('../core/paths');
-
-const SERVER_LIST_URL = 'https://assets.authbp.xyz/server.json';
-
-
-function getLocalDateTime() {
-  return formatLocalDateTime(new Date());
-}
-
-function formatLocalDateTime(date) {
-  const year = date.getFullYear();
-  const month = String(date.getMonth() + 1).padStart(2, '0');
-  const day = String(date.getDate()).padStart(2, '0');
-  const hours = String(date.getHours()).padStart(2, '0');
-  const minutes = String(date.getMinutes()).padStart(2, '0');
-  const seconds = String(date.getSeconds()).padStart(2, '0');
-  const milliseconds = String(date.getMilliseconds()).padStart(3, '0');
-    const offsetMinutes = -date.getTimezoneOffset();
-  const offsetHours = Math.floor(Math.abs(offsetMinutes) / 60);
-  const offsetMins = Math.abs(offsetMinutes) % 60;
-  const offsetSign = offsetMinutes >= 0 ? '+' : '-';
-  const offset = `${offsetSign}${String(offsetHours).padStart(2, '0')}:${String(offsetMins).padStart(2, '0')}`;
-  
-  return `${year}-${month}-${day}T${hours}:${minutes}:${seconds}.${milliseconds}0000${offset}`;
-}
-
-async function syncServerList() {
-  try {
-    const hytaleSavesDir = getHytaleSavesDir();
-    const serverListPath = path.join(hytaleSavesDir, 'ServerList.json');
-    console.log('[ServerListSync] Fetching server list from', SERVER_LIST_URL);
-    let remoteData;
-    try {
-      const response = await axios.get(SERVER_LIST_URL, {
-        timeout: 40000,
-        headers: {
-          'User-Agent': 'Hytale-F2P-Launcher'
-        }
-      });
-      remoteData = response.data;
-    } catch (fetchError) {
-      console.warn('[ServerListSync] Failed to fetch remote server list:', fetchError.message);
-      remoteData = { SavedServers: [] };
-    }
-    let localData = { SavedServers: [] };
-    if (fs.existsSync(serverListPath)) {
-      try {
-        const localContent = fs.readFileSync(serverListPath, 'utf-8');
-        localData = JSON.parse(localContent);
-        console.log('[ServerListSync] Loaded existing local server list with', localData.SavedServers?.length || 0, 'servers');
-      } catch (parseError) {
-        console.warn('[ServerListSync] Failed to parse local server list, creating new one:', parseError.message);
-        localData = { SavedServers: [] };
-      }
-    } else {
-      console.log('[ServerListSync] Local server list does not exist, creating new one');
-    }
-
-    if (!localData.SavedServers) {
-      localData.SavedServers = [];
-    }
-    if (!remoteData.SavedServers) {
-      remoteData.SavedServers = [];
-    }
-
-    const existingServersByAddress = new Map();
-    const userServers = [];
-    
-    for (const server of localData.SavedServers) {
-      existingServersByAddress.set(server.Address.toLowerCase(), server);
-    }
-
-    const remoteAddresses = new Set(remoteData.SavedServers.map(s => s.Address.toLowerCase()));
-    for (const server of localData.SavedServers) {
-      if (!remoteAddresses.has(server.Address.toLowerCase())) {
-        userServers.push(server);
-      }
-    }
-    
-    const currentDate = getLocalDateTime();
-    
-    
-    const apiServers = [];
-    for (const remoteServer of remoteData.SavedServers) {
-      const serverToAdd = {
-        Id: uuidv4(), 
-        Name: "@ " + remoteServer.Name, 
-        Address: remoteServer.Address,
-        DateSaved: currentDate,
-        img_Banner: remoteServer.img_Banner || null // Copy banner if exists
-      };
-      apiServers.push(serverToAdd);
-      console.log('[ServerListSync] Added/Updated server with new ID:', remoteServer.Name);
-    }
-    
-    localData.SavedServers = [...apiServers, ...userServers];
-    
-    const addedCount = apiServers.length;
-
-    if (!fs.existsSync(hytaleSavesDir)) {
-      fs.mkdirSync(hytaleSavesDir, { recursive: true });
-    }
-    
-    fs.writeFileSync(serverListPath, JSON.stringify(localData, null, 2), 'utf-8');
-    console.log('[ServerListSync] Server list synchronized:', addedCount, 'API servers added, total:', localData.SavedServers.length);
-
-    return { success: true, added: addedCount, total: localData.SavedServers.length };
-  } catch (error) {
-    console.error('[ServerListSync] Failed to synchronize server list:', error.message);
-    return { success: false, error: error.message };
-  }
-}
-
-module.exports = {
-  syncServerList
-};

backend/utils/userDataMigration.js

@@ -4,7 +4,7 @@ const { getHytaleSavesDir, getResolvedAppDir } = require('../core/paths');
 const { loadConfig, saveConfig } = require('../core/config');
 
 /**
- * NEW SYSTEM (2.2.0+): UserData Migration to Centralized Location
+ * NEW SYSTEM (2.1.2+): UserData Migration to Centralized Location
  * 
  * UserData is now stored in a centralized location instead of inside game installation:
  * - Windows: %LOCALAPPDATA%\HytaleSaves\
@@ -31,7 +31,7 @@ function markMigrationCompleted() {
 }
 
 /**
- * Find old UserData location (pre-2.2.0)
+ * Find old UserData location (pre-2.1.2)
  * Searches in: installPath/branch/package/game/latest/Client/UserData
  */
 function findOldUserDataPath() {
@@ -77,7 +77,7 @@ function findOldUserDataPath() {
 
 /**
  * Migrate UserData from old location to new centralized location
- * One-time operation when upgrading to 2.2.0
+ * One-time operation when upgrading to 2.1.2
  */
 async function migrateUserDataToCentralized() {
   // Check if already migrated
@@ -149,7 +149,7 @@ async function migrateUserDataToCentralized() {
 }
 
 /**
- * Get the centralized UserData path (always use this in 2.2.0+)
+ * Get the centralized UserData path (always use this in 2.1.2+)
  * Ensures directory exists
  */
 function getUserDataPath() {

build/entitlements.mac.plist

@@ -1,18 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-    <key>com.apple.security.cs.allow-jit</key>
-    <true/>
-    <key>com.apple.security.cs.allow-unsigned-executable-memory</key>
-    <true/>
-    <key>com.apple.security.cs.disable-library-validation</key>
-    <true/>
-    <key>com.apple.security.network.client</key>
-    <true/>
-    <key>com.apple.security.network.server</key>
-    <true/>
-    <key>com.apple.security.files.user-selected.read-write</key>
-    <true/>
-</dict>
-</plist>

docs/STEAMDECK_CRASH_INVESTIGATION.md

@@ -1,10 +1,10 @@
 # Steam Deck / Ubuntu LTS Crash Investigation
 
-## Status: SOLVED
+## Status: UNSOLVED
 
 **Last updated:** 2026-01-27
 
-**Solution:** Replace bundled `libzstd.so` with system version.
+No stable solution found. jemalloc helps occasionally but crashes still occur randomly.
 
 ---
 
@@ -30,81 +30,96 @@ The crash occurs after successful authentication, specifically right after "Fini
 - Windows
 - Older Arch Linux (glibc < 2.41)
 
----
-
-## Root Cause
-
-The **bundled `libzstd.so`** in the game client is incompatible with glibc 2.41's stricter heap validation. When the game decompresses assets using this library, it triggers heap corruption detected by glibc 2.41.
-
-The crash occurs in `libzstd.so` during `free()` after "Finished handling RequiredAssets" (asset decompression).
+**Critical Finding:** The UNPATCHED original binary works fine on Steam Deck. The crash is caused by ANY binary patching.
 
 ---
 
-## Solution
-
-Replace the bundled `libzstd.so` with the system's `libzstd.so.1`.
-
-### Automatic (Launcher)
-
-The launcher automatically detects and replaces `libzstd.so` on Linux systems. No manual action needed.
-
-### Manual
-
-```bash
-cd ~/.hytalef2p/release/package/game/latest/Client
-
-# Backup bundled version
-mv libzstd.so libzstd.so.bundled
-
-# Link to system version
-# Steam Deck / Arch Linux:
-ln -s /usr/lib/libzstd.so.1 libzstd.so
-
-# Debian / Ubuntu:
-ln -s /usr/lib/x86_64-linux-gnu/libzstd.so.1 libzstd.so
-
-# Fedora / RHEL:
-ln -s /usr/lib64/libzstd.so.1 libzstd.so
-```
-
-### Restore Original
-
-```bash
-cd ~/.hytalef2p/release/package/game/latest/Client
-rm libzstd.so
-mv libzstd.so.bundled libzstd.so
-```
-
----
-
-## Why This Works
-
-1. The bundled `libzstd.so` was likely compiled with different allocator settings or an older toolchain
-2. glibc 2.41 has stricter heap validation that catches invalid memory operations
-3. The system `libzstd.so.1` is compiled with the system's glibc and uses compatible memory allocation patterns
-4. By using the system library, we avoid the incompatibility entirely
-
----
-
-## Previous Investigation (for reference)
-
-### What Was Tried Before Finding Solution
+## What Was Tried (All Failed)
 
+### Memory Allocators
 | Approach | Result |
 |----------|--------|
-| jemalloc allocator | Worked ~30% of time, not stable |
-| GLIBC_TUNABLES | No effect |
-| taskset (CPU pinning) | Single core too slow |
-| nice/chrt (scheduling) | No effect |
-| Various patching approaches | All crashed |
+| `LD_PRELOAD=/usr/lib/libjemalloc.so.2` | Works randomly (3/10 times), not stable |
+| `MALLOC_CHECK_=0` | No effect |
+| `MALLOC_PERTURB_=255` | No effect |
+| `GLIBC_TUNABLES=glibc.malloc.tcache_count=0` | No effect |
 
-### Key Insight
+### Process/Scheduling
+| Approach | Result |
+|----------|--------|
+| `taskset -c 0` (single core) | Game too slow, stuck at connecting |
+| `taskset -c 0,1` or `0-3` | Still crashes |
+| `nice -n 19` | No effect |
+| `chrt --idle 0` | No effect |
+| `strace -f` | No effect |
 
-The crash was in `libzstd.so`, not in our patched code. The patching just changed timing enough to expose the libzstd incompatibility more frequently.
+### Linker/Loading
+| Approach | Result |
+|----------|--------|
+| `LD_BIND_NOW=1` | No effect |
+| Wrapper script with LD_PRELOAD | No effect |
+| Shell spawn with inline LD_PRELOAD | No effect |
+
+### Patching Variations
+| Approach | Result |
+|----------|--------|
+| Null-padding after replacement | Crashes (made it worse) |
+| No null-padding (develop behavior) | Still crashes |
+| Minimal patches (3 instead of 6) | Still crashes |
+| Ultra-minimal (1 patch - domain only) | Still crashes |
+| Skip sentry patch | Still crashes |
+| Skip subdomain patches | Still crashes |
+
+**Key Finding:** Even patching just 1 string (main domain only) causes the crash.
 
 ---
 
-## GDB Stack Trace (Historical)
+## String Occurrences Found
+
+### Length-Prefixed Format
+Found by default patcher mode:
+
+| Offset | Content | Notes |
+|--------|---------|-------|
+| 0x1bc5d63 | `hytale.com` | **Surrounded by x86 code!** |
+
+### UTF-16LE Format (3 occurrences)
+| Offset | Content |
+|--------|---------|
+| 0x1bc5ad7 | `sentry.hytale.com/...` |
+| 0x1bc5b3f | `https://hytale.com/help...` |
+| 0x1bc5bc9 | `store.hytale.com/?...` |
+
+---
+
+## Binary Analysis
+
+When patching with length-prefixed mode:
+
+```
+< 01bc5d60: 5933 b80a 0000 0068 0079 0074 0061 006c  Y3.....h.y.t.a.l
+< 01bc5d70: 0065 002e 0063 006f 006d 8933 8807 0000  .e...c.o.m.3....
+---
+> 01bc5d60: 5933 b80a 0000 0073 0061 006e 0061 0073  Y3.....s.a.n.a.s
+> 01bc5d70: 006f 006c 002e 0077 0073 8933 8807 0000  .o.l...w.s.3....
+```
+
+**Structure:**
+```
+5933 b8 | 0a000000 | h.y.t.a.l.e...c.o.m | 8933 8807 0000
+???????? | len=10   | string content      | mov [rbx],esi?
+```
+
+- `5933 b8` before string - could be code or metadata
+- `0a 00 00 00` - .NET length prefix (10 characters)
+- String content in UTF-16LE
+- `89 33` after - this is `mov [rbx], esi` in x86-64!
+
+**The string is embedded near executable code, not in a clean data section.**
+
+---
+
+## GDB Stack Trace
 
 ```
 #0  0x00007ffff7d3f5a4 in ?? () from /usr/lib/libc.so.6
@@ -112,12 +127,105 @@ The crash was in `libzstd.so`, not in our patched code. The patching just change
 #2  abort () from /usr/lib/libc.so.6
 #3-#4  ?? () from /usr/lib/libc.so.6
 #5  free () from /usr/lib/libc.so.6
-#6  ?? () from libzstd.so    <-- CRASH POINT (bundled library)
+#6  ?? () from libzstd.so    <-- CRASH POINT
 #7-#24  HytaleClient code (asset decompression)
 ```
 
+Crash occurs in `libzstd.so` during `free()` after "Finished handling RequiredAssets".
+
+---
+
+## Hypotheses
+
+### 1. .NET AOT String Metadata (Most Likely)
+.NET AOT may have precomputed hashes, checksums, or relocation info for strings. Modifying string content breaks internal consistency, causing memory corruption when the runtime tries to use related data structures.
+
+### 2. Code/Data Interleaving
+The strings are embedded near x86 code (`89 33` = `mov [rbx], esi`). .NET AOT may use relative offsets that get invalidated when we modify nearby bytes.
+
+### 3. Binary Checksums
+The binary may have integrity checks for certain sections that we're invalidating by patching.
+
+### 4. Timing-Dependent Race Condition
+The fact that it works randomly (~30% of the time with jemalloc) suggests a race condition that's affected by:
+- Memory layout changes from patching
+- Allocator behavior differences
+- CPU scheduling
+
+---
+
+## Valgrind Results (Misleading)
+
+- Valgrind showed NO memory corruption errors
+- Game ran successfully under Valgrind (slower execution)
+- This suggested jemalloc would fix it, but it doesn't consistently work
+
+The slowdown from Valgrind likely masks the race condition timing.
+
+---
+
+## Current Launcher Implementation
+
+The launcher attempts:
+1. Auto-detect jemalloc at common paths
+2. Auto-install jemalloc via pkexec if not found
+3. Launch game with `LD_PRELOAD` via shell command
+
+But this doesn't provide stable results.
+
+---
+
+## Potential Alternative Approaches (Not Yet Tried)
+
+### 1. LD_PRELOAD Network Hooking
+Instead of patching the binary, hook `getaddrinfo()` / `connect()` to redirect network calls at runtime. No binary modification needed.
+
+### 2. Local Proxy + Certificate
+Run a local HTTPS proxy that intercepts hytale.com traffic and redirects to custom server. Requires installing a custom CA certificate.
+
+### 3. DNS + iptables Redirect
+Use local DNS to resolve hytale.com to localhost, then iptables to redirect to actual custom server. Requires root/sudo.
+
+### 4. Container with Older glibc
+Run the game in a container with glibc < 2.41 where the stricter validation doesn't exist.
+
+### 5. Different Patching Location
+Find strings in a pure data section rather than code-adjacent areas.
+
+---
+
+## Files Reference
+
+**Binary:** `HytaleClient` (ELF 64-bit, ~39.9 MB)
+
+**Branch:** `fix/steamdeck-jemalloc-crash`
+
+---
+
+## Install jemalloc (Partial Mitigation)
+
+jemalloc may help in some cases (~30% success rate):
+
+```bash
+# Steam Deck / Arch Linux
+sudo pacman -S jemalloc
+
+# Ubuntu / Debian
+sudo apt install libjemalloc2
+
+# Fedora / RHEL
+sudo dnf install jemalloc
+```
+
+The launcher automatically uses jemalloc if found. To disable:
+```bash
+HYTALE_NO_JEMALLOC=1 npm start
+```
+
 ---
 
-## Branch
+## Conclusion
 
-`fix/steamdeck-libzstd`
+**No stable solution found.** The binary patching approach may be fundamentally incompatible with glibc 2.41's stricter heap validation when modifying .NET AOT compiled binaries.
+
+Alternative approaches (network hooking, proxy, container) may be required for reliable Steam Deck / Ubuntu LTS support.

docs/STEAMDECK_DEBUG_COMMANDS.md

@@ -1,65 +1,95 @@
 # Steam Deck / Linux Crash Fix
 
-## SOLUTION: Use system libzstd
+## SOLUTION: Use jemalloc ✓
 
-The crash is caused by the bundled `libzstd.so` being incompatible with glibc 2.41's stricter heap validation.
+The crash is caused by glibc 2.41's stricter heap validation. Using jemalloc as the memory allocator fixes the issue.
 
-### Automatic Fix
-
-The launcher automatically replaces `libzstd.so` with the system version. No manual action needed.
-
-### Manual Fix
+### Install jemalloc
 
 ```bash
-cd ~/.hytalef2p/release/package/game/latest/Client
+# Steam Deck / Arch Linux
+sudo pacman -S jemalloc
 
-# Backup and replace
-mv libzstd.so libzstd.so.bundled
-ln -s /usr/lib/libzstd.so.1 libzstd.so
+# Ubuntu / Debian
+sudo apt install libjemalloc2
+
+# Fedora / RHEL
+sudo dnf install jemalloc
 ```
 
-### Restore Original
+### Launcher Auto-Detection
+
+The launcher automatically uses jemalloc when installed. No manual configuration needed.
+
+To disable (for testing):
+```bash
+HYTALE_NO_JEMALLOC=1 npm start
+```
+
+### Manual Launch with jemalloc
 
 ```bash
-cd ~/.hytalef2p/release/package/game/latest/Client
-rm libzstd.so
-mv libzstd.so.bundled libzstd.so
+cd ~/.hytalef2p/release/package/game/latest
+
+LD_PRELOAD=/usr/lib/libjemalloc.so.2 ./Client/HytaleClient --app-dir /home/deck/.hytalef2p/release/package/game/latest --java-exec /home/deck/.hytalef2p/release/package/jre/latest/bin/java --auth-mode authenticated --uuid YOUR_UUID --name Player --identity-token YOUR_TOKEN --session-token YOUR_TOKEN --user-dir /home/deck/.hytalesaves
 ```
 
 ---
 
 ## Debug Commands (for troubleshooting)
 
-### Check libzstd Status
-
+### Base Command
 ```bash
-# Check if symlinked
-ls -la ~/.hytalef2p/release/package/game/latest/Client/libzstd.so
+cd ~/.hytalef2p/release/package/game/latest
+```
 
-# Find system libzstd
-find /usr/lib -name "libzstd.so*"
+### GDB Stack Trace (for crash analysis)
+```bash
+gdb -ex "run --app-dir ..." ./Client/HytaleClient
+
+# After crash:
+bt
+bt full
+info registers
+quit
+```
+
+### Test glibc tunables (alternative fixes that didn't work reliably)
+
+**Disable tcache:**
+```bash
+GLIBC_TUNABLES=glibc.malloc.tcache_count=0 ./Client/HytaleClient ...
+```
+
+**Disable heap validation:**
+```bash
+MALLOC_CHECK_=0 ./Client/HytaleClient ...
 ```
 
 ### Binary Validation
-
 ```bash
 file ~/.hytalef2p/release/package/game/latest/Client/HytaleClient
 ldd ~/.hytalef2p/release/package/game/latest/Client/HytaleClient
 ```
 
-### Restore Client Binary
-
+### Hex Dump Commands
 ```bash
-cd ~/.hytalef2p/release/package/game/latest/Client
-cp HytaleClient.original HytaleClient
-rm -f HytaleClient.patched_custom
+# Search for hytale.com UTF-16LE
+xxd ~/.hytalef2p/release/package/game/latest/Client/HytaleClient.original | grep "6800 7900 7400 6100 6c00 6500 2e00 6300 6f00 6d00"
 ```
 
 ---
 
-## Environment Variables
+## Test Different Patch Modes
 
-| Variable | Description | Example |
-|----------|-------------|---------|
-| `HYTALE_AUTH_DOMAIN` | Custom auth domain | `auth.sanasol.ws` |
-| `HYTALE_NO_LIBZSTD_FIX` | Disable libzstd replacement | `1` |
+```bash
+# Restore original
+cp ~/.hytalef2p/release/package/game/latest/Client/HytaleClient.original ~/.hytalef2p/release/package/game/latest/Client/HytaleClient
+rm ~/.hytalef2p/release/package/game/latest/Client/HytaleClient.patched_custom
+
+# Test UTF-16LE mode
+HYTALE_PATCH_MODE=utf16le HYTALE_AUTH_DOMAIN=sanasol.ws npm start
+
+# Test length-prefixed mode (default)
+HYTALE_AUTH_DOMAIN=sanasol.ws npm start
+```

main.js

@@ -3,7 +3,7 @@ require('dotenv').config({ path: path.join(__dirname, '.env') });
 const { app, BrowserWindow, ipcMain, dialog, shell } = require('electron');
 const { autoUpdater } = require('electron-updater');
 const fs = require('fs');
-const { launchGame, launchGameWithVersionCheck, installGame, saveUsername, loadUsername, saveJavaPath, loadJavaPath, saveInstallPath, loadInstallPath, saveDiscordRPC, loadDiscordRPC, saveLanguage, loadLanguage, saveCloseLauncherOnStart, loadCloseLauncherOnStart, saveLauncherHardwareAcceleration, loadLauncherHardwareAcceleration, isGameInstalled, uninstallGame, repairGame, getHytaleNews, handleFirstLaunchCheck, proposeGameUpdate, markAsLaunched, loadConfig, saveConfig } = require('./backend/launcher');
+const { launchGame, launchGameWithVersionCheck, installGame, saveUsername, loadUsername, saveChatUsername, loadChatUsername, saveChatColor, loadChatColor, saveJavaPath, loadJavaPath, saveInstallPath, loadInstallPath, saveDiscordRPC, loadDiscordRPC, saveLanguage, loadLanguage, saveCloseLauncherOnStart, loadCloseLauncherOnStart, saveLauncherHardwareAcceleration, loadLauncherHardwareAcceleration, isGameInstalled, uninstallGame, repairGame, getHytaleNews, handleFirstLaunchCheck, proposeGameUpdate, markAsLaunched } = require('./backend/launcher');
 const { retryPWRDownload } = require('./backend/managers/gameManager');
 const { migrateUserDataToCentralized } = require('./backend/utils/userDataMigration');
 
@@ -86,10 +86,6 @@ function setDiscordActivity() {
         {
           label: 'GitHub',
           url: 'https://github.com/amiayweb/Hytale-F2P'
-        },
-        {
-          label: 'Discord',
-          url: 'https://discord.gg/hf2pdc'
         }
       ]
     });
@@ -180,8 +176,7 @@ function createWindow() {
   initDiscordRPC();
 
   // Configure and initialize electron-updater
-  // Enable auto-download so updates start immediately when available
-  autoUpdater.autoDownload = true;
+  autoUpdater.autoDownload = false;
   autoUpdater.autoInstallOnAppQuit = true;
 
   autoUpdater.on('checking-for-update', () => {
@@ -206,20 +201,6 @@ function createWindow() {
 
   autoUpdater.on('error', (err) => {
     console.error('Error in auto-updater:', err);
-
-    // Handle macOS code signing errors - requires manual download
-    if (mainWindow && !mainWindow.isDestroyed()) {
-      const isMacSigningError = process.platform === 'darwin' &&
-        (err.code === 'ERR_UPDATER_INVALID_SIGNATURE' ||
-         err.message.includes('signature') ||
-         err.message.includes('code sign'));
-
-      mainWindow.webContents.send('update-error', {
-        message: err.message,
-        isMacSigningError: isMacSigningError,
-        requiresManualDownload: isMacSigningError || process.platform === 'darwin'
-      });
-    }
   });
 
   autoUpdater.on('download-progress', (progressObj) => {
@@ -237,10 +218,7 @@ function createWindow() {
     console.log('Update downloaded:', info.version);
     if (mainWindow && !mainWindow.isDestroyed()) {
       mainWindow.webContents.send('update-downloaded', {
-        version: info.version,
-        platform: process.platform,
-        // macOS auto-install often fails on unsigned apps
-        autoInstallSupported: process.platform !== 'darwin'
+        version: info.version
       });
     }
   });
@@ -551,7 +529,7 @@ ipcMain.handle('install-game', async (event, playerName, javaPath, installPath,
       console.log('[Main] Processing Butler error with retry context');
       errorData.retryData = {
         branch: error.branch || 'release',
-        fileName: error.fileName || '7.pwr',
+        fileName: error.fileName || '4.pwr',
         cacheDir: error.cacheDir
       };
       errorData.canRetry = error.canRetry !== false;
@@ -571,7 +549,7 @@ ipcMain.handle('install-game', async (event, playerName, javaPath, installPath,
       console.log('[Main] Processing generic error, creating default retry data');
       errorData.retryData = {
         branch: 'release',
-        fileName: '7.pwr'
+        fileName: '4.pwr'
       };
       // For generic errors, assume it's retryable unless specified
       errorData.canRetry = error.canRetry !== false;
@@ -603,6 +581,22 @@ ipcMain.handle('save-username', (event, username) => {
 ipcMain.handle('load-username', () => {
   return loadUsername();
 });
+ipcMain.handle('save-chat-username', async (event, chatUsername) => {
+  saveChatUsername(chatUsername);
+});
+
+ipcMain.handle('load-chat-username', async () => {
+  return loadChatUsername();
+});
+
+ipcMain.handle('save-chat-color', (event, color) => {
+  saveChatColor(color);
+  return { success: true };
+});
+
+ipcMain.handle('load-chat-color', () => {
+  return loadChatColor();
+});
 
 ipcMain.handle('save-java-path', (event, javaPath) => {
   saveJavaPath(javaPath);
@@ -660,15 +654,6 @@ ipcMain.handle('load-launcher-hw-accel', () => {
   return loadLauncherHardwareAcceleration();
 });
 
-ipcMain.handle('load-config', () => {
-  return loadConfig();
-});
-
-ipcMain.handle('save-config', (event, configUpdate) => {
-  saveConfig(configUpdate);
-  return { success: true };
-});
-
 ipcMain.handle('select-install-path', async () => {
 
   const result = await dialog.showOpenDialog(mainWindow, {
@@ -799,7 +784,7 @@ ipcMain.handle('retry-download', async (event, retryData) => {
       console.log('[IPC] Invalid retry data, using PWR defaults');
       retryData = {
         branch: 'release',
-        fileName: '7.pwr'
+        fileName: '4.pwr'
       };
     }
 
@@ -833,7 +818,7 @@ ipcMain.handle('retry-download', async (event, retryData) => {
         } :
         {
           branch: retryData?.branch || 'release',
-          fileName: retryData?.fileName || '7.pwr',
+          fileName: retryData?.fileName || '4.pwr',
           cacheDir: retryData?.cacheDir
         };
 
@@ -874,17 +859,6 @@ ipcMain.handle('open-external', async (event, url) => {
   }
 });
 
-ipcMain.handle('open-download-page', async () => {
-  try {
-    // Open GitHub releases page for manual download
-    await shell.openExternal('https://github.com/amiayweb/Hytale-F2P/releases/latest');
-    return { success: true };
-  } catch (error) {
-    console.error('Failed to open download page:', error);
-    return { success: false, error: error.message };
-  }
-});
-
 ipcMain.handle('open-game-location', async () => {
   try {
     const { getResolvedAppDir, loadVersionBranch } = require('./backend/launcher');
@@ -1112,37 +1086,8 @@ ipcMain.handle('download-update', async () => {
   }
 });
 
-ipcMain.handle('install-update', async () => {
-  console.log('[AutoUpdater] Installing update...');
-
-  // On macOS, quitAndInstall often fails silently
-  // Use a more aggressive approach
-  if (process.platform === 'darwin') {
-    console.log('[AutoUpdater] macOS detected, using force quit approach');
-    // Give user feedback that something is happening
-    if (mainWindow && !mainWindow.isDestroyed()) {
-      mainWindow.webContents.send('update-installing');
-    }
-
-    // Small delay to show the "Installing..." state
-    await new Promise(resolve => setTimeout(resolve, 500));
-
-    try {
-      autoUpdater.quitAndInstall(false, true);
-    } catch (err) {
-      console.error('[AutoUpdater] quitAndInstall failed:', err);
-      // Force quit the app - the update should install on next launch
-      app.exit(0);
-    }
-
-    // If quitAndInstall didn't work, force exit after a delay
-    setTimeout(() => {
-      console.log('[AutoUpdater] Force exiting app...');
-      app.exit(0);
-    }, 2000);
-  } else {
-    autoUpdater.quitAndInstall(false, true);
-  }
+ipcMain.handle('install-update', () => {
+  autoUpdater.quitAndInstall(false, true);
 });
 
 ipcMain.handle('get-launcher-version', () => {
@@ -1376,4 +1321,3 @@ ipcMain.handle('profile-update', async (event, id, updates) => {
     return { error: error.message };
   }
 });
-

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "hytale-f2p-launcher",
-  "version": "2.1.2",
+  "version": "2.1.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "hytale-f2p-launcher",
-      "version": "2.1.2",
+      "version": "2.1.1",
       "license": "MIT",
       "dependencies": {
         "adm-zip": "^0.5.10",
@@ -19,7 +19,6 @@
         "uuid": "^9.0.1"
       },
       "devDependencies": {
-        "@electron/notarize": "^2.5.0",
         "electron": "^40.0.0",
         "electron-builder": "^26.4.0"
       }

package.json

@@ -45,7 +45,6 @@
   },
   "license": "MIT",
   "devDependencies": {
-    "@electron/notarize": "^2.5.0",
     "electron": "^40.0.0",
     "electron-builder": "^26.4.0"
   },
@@ -121,30 +120,19 @@
         {
           "target": "dmg",
           "arch": [
-            "arm64",
-            "x64"
+            "universal"
           ]
         },
         {
           "target": "zip",
           "arch": [
-            "arm64",
-            "x64"
+            "universal"
           ]
         }
       ],
       "icon": "build/icon.icns",
-      "category": "public.app-category.games",
-      "hardenedRuntime": true,
-      "gatekeeperAssess": false,
-      "entitlements": "build/entitlements.mac.plist",
-      "entitlementsInherit": "build/entitlements.mac.plist",
-      "forceCodeSigning": true,
-      "strictVerify": true,
-      "type": "distribution",
-      "notarize": false
+      "category": "public.app-category.games"
     },
-    "afterSign": "scripts/notarize.js",
     "nsis": {
       "oneClick": false,
       "allowToChangeInstallationDirectory": true,

preload.js

@@ -9,6 +9,10 @@ contextBridge.exposeInMainWorld('electronAPI', {
   getVersion: () => ipcRenderer.invoke('get-version'),
   saveUsername: (username) => ipcRenderer.invoke('save-username', username),
   loadUsername: () => ipcRenderer.invoke('load-username'),
+  saveChatUsername: (chatUsername) => ipcRenderer.invoke('save-chat-username', chatUsername),
+  loadChatUsername: () => ipcRenderer.invoke('load-chat-username'),
+  saveChatColor: (chatColor) => ipcRenderer.invoke('save-chat-color', chatColor),
+  loadChatColor: () => ipcRenderer.invoke('load-chat-color'),
   saveJavaPath: (javaPath) => ipcRenderer.invoke('save-java-path', javaPath),
   loadJavaPath: () => ipcRenderer.invoke('load-java-path'),
   saveInstallPath: (installPath) => ipcRenderer.invoke('save-install-path', installPath),
@@ -19,10 +23,8 @@ contextBridge.exposeInMainWorld('electronAPI', {
   loadLanguage: () => ipcRenderer.invoke('load-language'),
   saveCloseLauncher: (enabled) => ipcRenderer.invoke('save-close-launcher', enabled),
   loadCloseLauncher: () => ipcRenderer.invoke('load-close-launcher'),
-  loadConfig: () => ipcRenderer.invoke('load-config'),
-  saveConfig: (configUpdate) => ipcRenderer.invoke('save-config', configUpdate),
 
-  // Hardware Acceleration
+  // Harwadre Acceleration
   saveLauncherHardwareAcceleration: (enabled) => ipcRenderer.invoke('save-launcher-hw-accel', enabled),
   loadLauncherHardwareAcceleration: () => ipcRenderer.invoke('load-launcher-hw-accel'),
 
@@ -48,7 +50,14 @@ contextBridge.exposeInMainWorld('electronAPI', {
   selectModFiles: () => ipcRenderer.invoke('select-mod-files'),
   copyModFile: (sourcePath, modsPath) => ipcRenderer.invoke('copy-mod-file', sourcePath, modsPath),
   onProgressUpdate: (callback) => {
-    ipcRenderer.on('progress-update', (event, data) => callback(data));
+    ipcRenderer.on('progress-update', (event, data) => {
+      // Ensure data includes retry state if available
+      if (data && typeof data === 'object') {
+        callback(data);
+      } else {
+        callback(data);
+      }
+    });
   },
   onProgressComplete: (callback) => {
     ipcRenderer.on('progress-complete', () => callback());
@@ -60,6 +69,7 @@ contextBridge.exposeInMainWorld('electronAPI', {
     ipcRenderer.on('installation-end', () => callback());
   },
   getUserId: () => ipcRenderer.invoke('get-user-id'),
+  checkForUpdates: () => ipcRenderer.invoke('check-for-updates'),
   openDownloadPage: () => ipcRenderer.invoke('open-download-page'),
   getUpdateInfo: () => ipcRenderer.invoke('get-update-info'),
   onUpdatePopup: (callback) => {
@@ -116,7 +126,6 @@ contextBridge.exposeInMainWorld('electronAPI', {
   checkForUpdates: () => ipcRenderer.invoke('check-for-updates'),
   downloadUpdate: () => ipcRenderer.invoke('download-update'),
   installUpdate: () => ipcRenderer.invoke('install-update'),
-  quitAndInstallUpdate: () => ipcRenderer.invoke('install-update'),  // Alias for update.js compatibility
   getLauncherVersion: () => ipcRenderer.invoke('get-launcher-version'),
   onUpdateAvailable: (callback) => {
     ipcRenderer.on('update-available', (event, data) => callback(data));

scripts/notarize.js

@@ -1,92 +0,0 @@
-console.log('[Notarize] Script loaded');
-
-let notarize;
-try {
-  notarize = require('@electron/notarize').notarize;
-  console.log('[Notarize] @electron/notarize loaded successfully');
-} catch (err) {
-  console.error('[Notarize] Failed to load @electron/notarize:', err.message);
-  throw err;
-}
-
-const path = require('path');
-
-// Timeout for notarization (30 minutes max)
-const NOTARIZE_TIMEOUT_MS = 30 * 60 * 1000;
-
-function withTimeout(promise, ms, message) {
-  return Promise.race([
-    promise,
-    new Promise((_, reject) =>
-      setTimeout(() => reject(new Error(message)), ms)
-    )
-  ]);
-}
-
-exports.default = async function notarizing(context) {
-  console.log('[Notarize] afterSign hook called');
-  console.log('[Notarize] Context:', JSON.stringify({
-    platform: context.electronPlatformName,
-    appOutDir: context.appOutDir,
-    outDir: context.outDir
-  }, null, 2));
-
-  const { electronPlatformName, appOutDir } = context;
-
-  // Only notarize macOS builds
-  if (electronPlatformName !== 'darwin') {
-    console.log('[Notarize] Skipping: not macOS');
-    return;
-  }
-
-  // Check if notarization is disabled via env var
-  if (process.env.SKIP_NOTARIZE === 'true') {
-    console.log('[Notarize] Skipping: SKIP_NOTARIZE=true');
-    return;
-  }
-
-  // Check credentials
-  const hasAppleId = !!process.env.APPLE_ID;
-  const hasPassword = !!process.env.APPLE_APP_SPECIFIC_PASSWORD;
-  const hasTeamId = !!process.env.APPLE_TEAM_ID;
-
-  console.log('[Notarize] Credentials check:', { hasAppleId, hasPassword, hasTeamId });
-
-  if (!hasAppleId || !hasPassword || !hasTeamId) {
-    console.log('[Notarize] Skipping: missing credentials');
-    return;
-  }
-
-  const appName = context.packager.appInfo.productFilename;
-  const appPath = path.join(appOutDir, `${appName}.app`);
-
-  console.log('[Notarize] Starting notarization...');
-  console.log('[Notarize] App path:', appPath);
-  console.log('[Notarize] Team ID:', process.env.APPLE_TEAM_ID);
-  console.log('[Notarize] Timeout:', NOTARIZE_TIMEOUT_MS / 1000, 'seconds');
-
-  try {
-    await withTimeout(
-      notarize({
-        appPath,
-        appleId: process.env.APPLE_ID,
-        appleIdPassword: process.env.APPLE_APP_SPECIFIC_PASSWORD,
-        teamId: process.env.APPLE_TEAM_ID,
-      }),
-      NOTARIZE_TIMEOUT_MS,
-      `Notarization timed out after ${NOTARIZE_TIMEOUT_MS / 1000} seconds`
-    );
-    console.log('[Notarize] Notarization complete!');
-  } catch (error) {
-    console.error('[Notarize] Notarization failed:', error.message);
-
-    // Don't fail the build if notarization times out or fails
-    // The app will still be code-signed, just not notarized
-    if (process.env.NOTARIZE_FAIL_ON_ERROR !== 'true') {
-      console.warn('[Notarize] Continuing build without notarization (set NOTARIZE_FAIL_ON_ERROR=true to fail)');
-      return;
-    }
-
-    throw error;
-  }
-};