fix(macos): improve notarization with timeout and graceful failure

Changes:
- Add 30 minute timeout for notarization (fail fast)
- Add SKIP_NOTARIZE=true env var to skip notarization entirely
- Don't fail build if notarization fails (app still code-signed)
- Add NOTARIZE_FAIL_ON_ERROR=true to fail build on notarization error
- Add forceCodeSigning, strictVerify, type=distribution to mac config
- Disable electron-builder built-in notarize (using custom script)

This prevents CI from hanging forever waiting for Apple's notarization
service and reduces wasted GitHub Actions minutes.

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

.env.example

@@ -1,2 +0,0 @@
-CURSEFORGE_API_KEY=$1234asdxXXXXXXkQCXXXXXXXXXXASDb32
-DISCORD_CLIENT_ID=561263XXXXXX

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -3,6 +3,13 @@ description: Create a report to help us improve
 title: "[BUG] "
 labels: ["bug"]
 body:
+  - type: markdown
+    attributes:
+      value: |
+        Bug is a problem which impairs or prevents the functions of the launcher from working as intended.
+        Thanks for taking the time to fill out a bug report! 
+        Please provide as much information as you can to help us understand and reproduce the issue.
+        
   - type: textarea
     id: description
     attributes:
@@ -34,17 +41,26 @@ body:
       required: true
 
   - type: textarea
-    id: screenshots
+    id: proof
     attributes:
-      label: Screenshots
+      label: Screenshots/Recordings
-      description: If applicable, add screenshots to help explain your problem.
+      description: If applicable, add Screenshots/Recordings to help explain your problem.
 
   - type: input
     id: version
     attributes:
       label: Version
-      description: What version of the project are you running?
+      description: What version of the launcher are you running?
-      placeholder: "e.g. v1.2.3"
+      placeholder: "e.g. \"v2.2.0 stable\""
+    validations:
+      required: true
+
+  - type: textarea
+    id: hardwarespec
+    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"
     validations:
       required: true
 
@@ -54,28 +70,22 @@ body:
       label: Operating System
       description: What operating system are you using?
       options:
-        - Windows
+        - Windows 11/10
-        - macOS
+        - macOS (Apple Silicon, M1/M2/M3)
-        - Linux
+        - Linux Ubuntu/Debian-based (Linux Mint, Pop!_OS, etc.)
-        - iOS
+        - Linux Fedora/RHEL-based (Fedora, CentOS, etc.)
-        - Android
+        - Linux Arch-based (Steamdeck, CachyOS, etc.)
-        - Other
     validations:
       required: true
 
-  - type: dropdown
+  - type: textarea
-    id: browser
+    id: logs
     attributes:
-      label: Browser (if applicable)
+      label: Logs or Error Messages
-      description: What browser are you using?
+      description: If applicable, paste any error messages or logs here.
-      options:
+      render: shell
-        - Chrome
+    validations:
-        - Firefox
+      required: true
-        - Safari
-        - Edge
-        - Opera
-        - Other
-        - N/A
 
   - type: textarea
     id: additional

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -16,8 +16,10 @@ body:
     id: problem
     attributes:
       label: Is your feature request related to a problem? Please describe.
-      description: A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+      description: A clear and concise description of what the problem is.
       placeholder: "Ex. I'm always frustrated when [...]"
+    validations:
+      required: true
 
   - type: textarea
     id: solution
@@ -34,6 +36,14 @@ body:
       label: Describe alternatives you've considered
       description: A clear and concise description of any alternative solutions or features you've considered.
       placeholder: "Describe any alternative solutions or features you've considered."
+    validations:
+      required: true
+
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: Screenshots (Optional)
+      description: If applicable, add screenshots to help explain your request.
 
   - type: textarea
     id: additional

.github/ISSUE_TEMPLATE/new_translation_request.yml

@@ -0,0 +1,24 @@
+name: New Translation Request
+description: Request new language translation for text or content on the launcher
+title: "[TRANSLATION REQUEST] "
+labels: ["translation request"]
+body:
+  - type: input
+    id: language
+    attributes:
+      label: Request New Language
+      description: What language do you want our launcher to support?
+      placeholder: "e.g. German (de-DE), Russian (ru-RU), etc."
+    validations:
+      required: true
+
+  - type: dropdown
+    id: contriution_willingness
+    attributes:
+      label: Willingness to Contribute
+      description: Are you willing to help with the translation effort?
+      options:
+        - Yes, I can help translate from English to the requested language!
+        - No, I just want to request the language.
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/support_request.yml

@@ -1,8 +1,29 @@
 name: Support Request
 description: Request help or support
-title: "[SUPPORT] "
+title: "[SUPPORT] <ADD YOUR TITLE HERE>"
 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: |
+        If you need help or support with using the launcher, please fill out this support request.
+        Provide as much detail as possible so we can assist you effectively.
+        **Need a quick assistance?** Please Open-A-Ticket in our [Discord Server](https://discord.gg/gME8rUy3MB)!
+
   - type: textarea
     id: question
     attributes:
@@ -17,14 +38,38 @@ body:
     attributes:
       label: Context
       description: Provide any relevant context or background information.
-      placeholder: "I've tried..., I expected..., but got..."
+      placeholder: "I've tried these steps, but got..."
+    validations:
+      required: true
 
-  - type: input
+  - type: textarea
+    id: proof
+    attributes:
+      label: Screenshots/Recordings
+      description: If applicable, add Screenshots/Recordings to help explain your problem.
+
+  - type: textarea
+    id: hardwarespec
+    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 | VRAM: 24 GB | RAM: 32 GB"
+    validations:
+      required: true
+
+  - type: dropdown
     id: version
     attributes:
       label: Version
-      description: What version are you using?
+      description: What launcher version are you using?
-      placeholder: "e.g. v1.2.3"
+      options:
+        - v2.2.0
+        - v2.1.1
+        - v2.1.0
+        - v2.0.11
+        - v2.0.2
+    validations:
+      required: true
 
   - type: dropdown
     id: platform
@@ -32,13 +77,13 @@ body:
       label: Platform
       description: What platform are you using?
       options:
-        - Windows
+        - Windows 11/10
-        - macOS
+        - macOS (Apple Silicon, M1/M2/M3)
-        - Linux
+        - Linux Ubuntu/Debian-based (Linux Mint, Pop!_OS, etc.)
-        - iOS
+        - Linux Fedora/RHEL-based (Fedora, CentOS, etc.)
-        - Android
+        - Linux Arch-based (Steamdeck, CachyOS, etc.)
-        - Web Browser
+    validations:
-        - Other
+      required: true
 
   - type: textarea
     id: logs
@@ -46,6 +91,8 @@ body:
       label: Logs or Error Messages
       description: If applicable, paste any error messages or logs here.
       render: shell
+    validations:
+      required: true
 
   - type: textarea
     id: additional

.github/ISSUE_TEMPLATE/translation_fix_request.yml

@@ -0,0 +1,41 @@
+name: Translation Fix Request
+description: Request a fix of translation for text or content in the launcher
+title: "[TRANSLATION FIX] "
+labels: ["translation fix"]
+body:
+  - type: input
+    id: language
+    attributes:
+      label: Target Language
+      description: What language do you want to translate to?
+      placeholder: "e.g. Spanish (es-ES), Portuguese (pt-BR), etc."
+    validations:
+      required: true
+
+  - type: textarea
+    id: source_text
+    attributes:
+      label: Source Text
+      description: The original text that needs to be translated.
+      placeholder: "Paste the text here..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Context
+      description: Provide context about where this text appears or how it's used.
+      placeholder: "This text appears in..., It's used for..."
+
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: Screenshots
+      description: If applicable, add screenshots to help explain your problem.
+
+  - type: textarea
+    id: notes
+    attributes:
+      label: Additional Notes
+      description: Any specific instructions or notes for the translator.

.github/workflows/release.yml

@@ -2,51 +2,11 @@ name: Build and Release
 
 on:
   push:
-    branches:
-      - release
     tags:
       - 'v*'
   workflow_dispatch:
 
 jobs:
-  build-linux:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      # FIX Install bsdtar for Pacman builds
-      - name: Install build dependencies
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y libarchive-tools
-          
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '22'
-          cache: 'npm'
-      - run: npm ci
-
-      - name: Create .env file
-        env:
-          CF_KEY: ${{ secrets.CURSEFORGE_API_KEY }}
-          DISCORD_ID: ${{ secrets.DISCORD_CLIENT_ID }}
-        run: |
-          echo "CURSEFORGE_API_KEY=$CF_KEY" > .env
-          echo "DISCORD_CLIENT_ID=$DISCORD_ID" >> .env
-
-      - name: Build Linux Packages
-        run: |
-          npx electron-builder --linux --x64 --arm64 --publish never
-      - uses: actions/upload-artifact@v4
-        with:
-          name: linux-builds
-          path: |
-            dist/*.AppImage
-            dist/*.AppImage.blockmap
-            dist/*.deb
-            dist/*.rpm
-            dist/*.pacman
-            dist/latest-linux.yml
-
   build-windows:
     runs-on: windows-latest
     steps:
@@ -57,14 +17,6 @@ jobs:
           cache: 'npm'
       - run: npm ci
 
-      - name: Create .env file
-        env:
-          CF_KEY: ${{ secrets.CURSEFORGE_API_KEY }}
-          DISCORD_ID: ${{ secrets.DISCORD_CLIENT_ID }}
-        run: |
-          echo "CURSEFORGE_API_KEY=$CF_KEY" > .env
-          echo "DISCORD_CLIENT_ID=$DISCORD_ID" >> .env
-
       - name: Build Windows Packages
         run: npx electron-builder --win --publish never
       - uses: actions/upload-artifact@v4
@@ -75,8 +27,10 @@ jobs:
             dist/*.exe.blockmap
             dist/latest.yml
 
-  build-macos:
+  # macOS ARM64 build (Apple Silicon)
-    runs-on: macos-latest
+  build-macos-arm64:
+    runs-on: macos-latest  # ARM64 runner for native Apple Silicon builds
+    timeout-minutes: 120
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
@@ -85,44 +39,188 @@ jobs:
           cache: 'npm'
       - run: npm ci
 
-      - name: Create .env file
+      - name: Build macOS ARM64 Package
         env:
-          CF_KEY: ${{ secrets.CURSEFORGE_API_KEY }}
+          # Code signing
-          DISCORD_ID: ${{ secrets.DISCORD_CLIENT_ID }}
+          CSC_LINK: ${{ secrets.CSC_LINK }}
-        run: |
+          CSC_KEY_PASSWORD: ${{ secrets.CSC_KEY_PASSWORD }}
-          echo "CURSEFORGE_API_KEY=$CF_KEY" > .env
+          # Notarization
-          echo "DISCORD_CLIENT_ID=$DISCORD_ID" >> .env
+          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 Windows Packages
-        run: npx electron-builder --mac --publish never
       - uses: actions/upload-artifact@v4
         with:
-          name: macos-builds
+          name: macos-arm64-builds
           path: |
             dist/*.dmg
             dist/*.zip
-            dist/latest-mac.yml
 
+  # 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
+          path: |
+            dist/*.dmg
+            dist/*.zip
+
+  build-linux:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install build dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libarchive-tools
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+      - run: npm ci
+
+      - name: Build Linux Packages
+        run: |
+          npx electron-builder --linux AppImage deb rpm --publish never
+      - uses: actions/upload-artifact@v4
+        with:
+          name: linux-builds
+          path: |
+            dist/*.AppImage
+            dist/*.AppImage.blockmap
+            dist/*.deb
+            dist/*.rpm
+            dist/latest-linux.yml
+
+  build-arch:
+    runs-on: ubuntu-latest
+    container:
+      image: archlinux:latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Install base packages
+        run: |
+          pacman -Syu --noconfirm
+          pacman -S --noconfirm \
+            base-devel \
+            git \
+            nodejs \
+            npm \
+            rpm-tools \
+            libxcrypt-compat
+
+      - name: Create build user
+        run: |
+          useradd -m builder
+          echo "builder ALL=(ALL) NOPASSWD: ALL" >> /etc/sudoers
+
+      - name: Fix Permissions
+        run: chown -R builder:builder .
+
+      - name: Build Arch Package
+        run: |
+          sudo -u builder bash << 'EOF'
+          set -e
+          makepkg --printsrcinfo > .SRCINFO
+          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
+            .SRCINFO
+          include-hidden-files: true
+
+  # Create release with Windows, Linux, Arch (fast builds)
   release:
-    needs: [build-linux, build-windows, build-macos]
+    needs: [build-windows, build-linux, build-arch]
     runs-on: ubuntu-latest
     if: |
       startsWith(github.ref, 'refs/tags/v') ||
-      github.ref == 'refs/heads/release' || 
+      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 all artifacts
+      - name: Download Windows artifacts
         uses: actions/download-artifact@v4
         with:
-          path: artifacts
+          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
 
       - name: Display structure of downloaded files
         run: ls -R artifacts
@@ -134,15 +232,75 @@ jobs:
       - name: Create Release
         uses: softprops/action-gh-release@v2
         with:
-          # If it's a tag, use the tag. 
+          tag_name: ${{ github.ref_name }}
-          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/linux-builds/**/*
+            artifacts/arch-package/*.pkg.tar.zst
-            artifacts/windows-builds/**/*
+            artifacts/arch-package/*.src.tar.zst
-            artifacts/macos-builds/**/*
+            artifacts/arch-package/.SRCINFO
+            artifacts/linux-builds/*
+            artifacts/windows-builds/*
           generate_release_notes: true
           draft: true
-          # DYNAMIC FLAGS: Mark as pre-release ONLY IF it's NOT a tag (meaning it's a branch push)
+          prerelease: false
-          prerelease: ${{ github.ref_type != 'tag' }}
+
+  # 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

.gitignore

@@ -1,14 +1,23 @@
-dist/*
+# General / Node
-node_modules/*
+node_modules/
-bun.lock
+dist/
-
-# Build artifacts
-src/
-pkg/
-
-# Package files
-*.tar.zst
-*.zst.DS_Store
-*.zst
-bun.lockb
 .env
+
+# Arch Linux / makepkg: Ignore folders created when running 'makepkg' locally
+/src/
+/pkg/
+
+# Built packages: {revents committing large binaries
+*.pkg.tar.zst
+*.pkg.tar.xz
+
+# Source downloads used by PKGBUILD
+*.src.tar.gz
+
+# Project Specific: Downloaded patcher (from hytale-auth-server)
+backend/patcher/
+
+# macOS Specific
+.DS_Store
+*.zst.DS_Store
+bun.lock

GUI/index.html

@@ -35,6 +35,10 @@
                     <i class="fas fa-play"></i>
                     <span class="nav-tooltip" data-i18n="nav.play">Play</span>
                 </div>
+                <div class="nav-item" data-page="featured">
+                    <i class="fas fa-server"></i>
+                    <span class="nav-tooltip">Featured Servers</span>
+                </div>
                 <div class="nav-item" data-page="mods">
                     <i class="fas fa-box"></i>
                     <span class="nav-tooltip" data-i18n="nav.mods">Mods</span>
@@ -43,10 +47,6 @@
                     <i class="fas fa-newspaper"></i>
                     <span class="nav-tooltip" data-i18n="nav.news">News</span>
                 </div>
-                <div class="nav-item" data-page="chat">
-                    <i class="fas fa-comments"></i>
-                    <span class="nav-tooltip" data-i18n="nav.chat">Players Chat</span>
-                </div>
                 <div class="nav-item" data-page="settings">
                     <i class="fas fa-cog"></i>
                     <span class="nav-tooltip" data-i18n="nav.settings">Settings</span>
@@ -55,6 +55,10 @@
                     <i class="fas fa-terminal"></i>
                     <span class="nav-tooltip">Logs</span>
                 </div>
+                <div class="nav-item" onclick="openDiscordExternal()">
+                    <i class="fab fa-discord"></i>
+                    <span class="nav-tooltip">Discord</span>
+                </div>
             </div>
 
 
@@ -112,7 +116,7 @@
                             <h1 class="install-title">
                                 HY<span class="title-accent">TALE</span>
                             </h1>
-                            <p class="install-subtitle" data-i18n="install.title">FREE TO PLAY LAUNCHER</p>
+                            <p class="install-subtitle" data-i18n="install.title">UNOFFICIAL HYTALE LAUNCHER</p>
                         </div>
 
                         <div class="install-form">
@@ -120,7 +124,30 @@
                                 <label class="form-label" data-i18n="install.playerName">Player Name</label>
                                 <input type="text" id="installPlayerName"
                                     data-i18n-placeholder="install.playerNamePlaceholder" class="form-input"
-                                    value="Player" />
+                                    value="Player" maxlength="16" />
+                            </div>
+
+                            <div class="form-group">
+                                <label class="form-label" data-i18n="install.gameBranch">Game Version</label>
+                                <div class="radio-group">
+                                    <label class="radio-label">
+                                        <input type="radio" name="installBranch" value="release" class="custom-radio"
+                                            checked>
+                                        <span class="radio-text">
+                                            <i class="fas fa-check-circle mr-2"></i>
+                                            <span data-i18n="install.releaseVersion">Release (Stable)</span>
+                                        </span>
+                                    </label>
+                                    <label class="radio-label">
+                                        <input type="radio" name="installBranch" value="pre-release"
+                                            class="custom-radio">
+                                        <span class="radio-text">
+                                            <i class="fas fa-flask mr-2"></i>
+                                            <span data-i18n="install.preReleaseVersion">Pre-Release
+                                                (Experimental)</span>
+                                        </span>
+                                    </label>
+                                </div>
                             </div>
 
                             <div class="form-group">
@@ -189,6 +216,38 @@
                         </div>
                     </div>
 
+                    <div id="featured-page" class="page">
+                        <div class="featured-layout">
+                            <div class="featured-left">
+                                <div class="featured-header">
+                                    <h2 class="featured-title">
+                                        <i class="fas fa-star mr-2"></i>
+                                        <span>FEATURED SERVERS</span>
+                                    </h2>
+                                </div>
+                                <div id="featuredServersList" class="featured-list">
+                                    <div class="loading-spinner">
+                                        <i class="fas fa-spinner fa-spin fa-2x"></i>
+                                    </div>
+                                </div>
+                            </div>
+                            
+                            <div class="featured-right">
+                                <div class="featured-header">
+                                    <h2 class="featured-title">
+                                        <i class="fas fa-server mr-2"></i>
+                                        <span>HF2P SERVERS</span>
+                                    </h2>
+                                </div>
+                                <div id="myServersList" class="featured-list">
+                                    <div class="loading-spinner">
+                                        <i class="fas fa-spinner fa-spin fa-2x"></i>
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+
                     <div id="mods-page" class="page">
                         <div class="mods-header">
                             <div class="mods-search-container">
@@ -233,50 +292,6 @@
                         <div id="allNewsGrid" class="news-grid-full"></div>
                     </div>
 
-                    <div id="chat-page" class="page">
-                        <div class="chat-container">
-                            <div class="chat-header">
-                                <h2 class="chat-title">
-                                    <i class="fas fa-comments mr-2"></i>
-                                    <span data-i18n="chat.title">PLAYERS CHAT</span>
-                                </h2>
-                                <div class="chat-header-actions">
-                                    <button id="chatColorBtn" class="chat-color-btn">
-                                        <i class="fas fa-palette"></i>
-                                        <span data-i18n="chat.pickColor">Color</span>
-                                    </button>
-                                    <div class="chat-online-badge">
-                                        <i class="fas fa-circle"></i>
-                                        <span id="chatOnlineCount">0</span> <span data-i18n="chat.online">online</span>
-                                    </div>
-                                </div>
-                            </div>
-
-                            <div class="chat-body">
-                                <div id="chatMessages" class="chat-messages">
-                                </div>
-                            </div>
-
-                            <div class="chat-footer">
-                                <div class="chat-input-container">
-                                    <textarea id="chatInput" class="chat-input"
-                                        data-i18n-placeholder="chat.inputPlaceholder" rows="1"
-                                        maxlength="500"></textarea>
-                                    <button id="chatSendBtn" class="chat-send-btn">
-                                        <i class="fas fa-paper-plane"></i>
-                                    </button>
-                                </div>
-                                <div class="chat-footer-info">
-                                    <span class="chat-char-counter" id="chatCharCounter">0/500</span>
-                                    <span class="chat-warning-text">
-                                        <i class="fas fa-shield-alt"></i>
-                                        <span data-i18n="chat.secureChat">Secure chat - Links are censored</span>
-                                    </span>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-
                     <div id="settings-page" class="page">
                         <div class="settings-container">
                             <div class="settings-header">
@@ -287,6 +302,7 @@
                             </div>
 
                             <div class="settings-content">
+                                <div class="settings-column">
                                     <div class="settings-section">
                                         <h3 class="settings-section-title">
                                             <i class="fas fa-gamepad"></i>
@@ -337,14 +353,40 @@
                                                     </div>
                                                 </button>
                                             </div>
+                                        </div>
     
-
+                                        <div class="settings-option">
                                             <div class="settings-input-group">
+                                                <label class="settings-input-label" data-i18n="settings.gameBranch">Game
+                                                    Branch</label>
+                                                <div class="segmented-control">
+                                                    <input type="radio" id="branch-release" name="gameBranch"
+                                                        value="release" checked>
+                                                    <label for="branch-release"
+                                                        data-i18n="settings.branchRelease">Release</label>
+                                                    <input type="radio" id="branch-pre-release" name="gameBranch"
+                                                        value="pre-release">
+                                                    <label for="branch-pre-release"
+                                                        data-i18n="settings.branchPreRelease">Pre-Release</label>
+                                                </div>
+                                                <p class="settings-hint">
+                                                    <i class="fas fa-info-circle"></i>
+                                                    <span data-i18n="settings.branchHint">Switch between stable release and
+                                                        experimental pre-release versions</span>
+                                                </p>
+                                                <p class="settings-hint" style="color: #f39c12;">
+                                                    <i class="fas fa-exclamation-triangle"></i>
+                                                    <span data-i18n="settings.branchWarning">Changing branch will download
+                                                        and install a different game version</span>
+                                                </p>
+                                            </div>
+                                        </div>
+    
+                                        <div class="settings-option">
                                             <label class="settings-input-label" data-i18n="settings.gpuPreference">GPU
                                                 Preference</label>
                                             <div class="segmented-control">
-                                                <input type="radio" id="gpu-auto" name="gpuPreference" value="auto"
+                                                <input type="radio" id="gpu-auto" name="gpuPreference" value="auto" checked>
-                                                    checked>
                                                 <label for="gpu-auto" data-i18n="settings.gpuAuto">Auto</label>
                                                 <input type="radio" id="gpu-integrated" name="gpuPreference"
                                                     value="integrated">
@@ -357,14 +399,55 @@
                                             </div>
                                             <p class="settings-hint">
                                                 <i class="fas fa-info-circle"></i>
-                                                <span data-i18n="settings.gpuHint">Select your preferred GPU (Linux:
+                                                <span data-i18n="settings.gpuHint">Laptop-only feature; set to Integrated if on PC</span>
-                                                    affects DRI_PRIME)</span>
                                             </p>
                                             <div id="gpu-detection-info" class="gpu-detection-info"></div>
                                         </div>
                                     </div>
+
+                                    <div class="settings-section">
+                                        <h3 class="settings-section-title">
+                                            <i class="fas fa-coffee"></i>
+                                            <span data-i18n="settings.java">Java Runtime</span>
+                                        </h3>
+    
+                                        <div class="settings-option">
+                                            <label class="settings-checkbox">
+                                                <input type="checkbox" id="customJavaCheck" />
+                                                <span class="checkmark"></span>
+                                                <div class="checkbox-content">
+                                                    <div class="checkbox-title" data-i18n="settings.useCustomJava">Use
+                                                        Custom Java Path</div>
+                                                    <div class="checkbox-description" data-i18n="settings.javaDescription">
+                                                        Override the bundled Java runtime with
+                                                        your own installation</div>
+                                                </div>
+                                            </label>
                                         </div>
     
+                                        <div id="customJavaOptions" class="custom-java-options" style="display: none;">
+                                            <div class="settings-input-group">
+                                                <label class="settings-input-label" data-i18n="settings.javaPath">Java
+                                                    Executable Path</label>
+                                                <div class="settings-input-with-button">
+                                                    <input type="text" id="customJavaPath" class="settings-input"
+                                                        data-i18n-placeholder="settings.javaPathPlaceholder" readonly />
+                                                    <button id="browseJavaBtn" class="settings-browse-btn">
+                                                        <i class="fas fa-folder-open"></i>
+                                                        <span data-i18n="settings.javaBrowse">Browse</span>
+                                                    </button>
+                                                </div>
+                                                <p class="settings-hint">
+                                                    <i class="fas fa-info-circle"></i>
+                                                    <span data-i18n="settings.javaHint">Select the Java installation folder
+                                                        (supports Windows, Mac, Linux)</span>
+                                                </p>
+                                            </div>
+                                        </div>
+                                    </div>
+                                </div>
+                                
+                                <div class="settings-column">
                                     <div class="settings-section">
                                         <h3 class="settings-section-title">
                                             <i class="fas fa-fingerprint"></i>
@@ -409,28 +492,6 @@
                                         </div>
                                     </div>
 
-                                <div class="settings-section">
-                                    <h3 class="settings-section-title">
-                                        <i class="fab fa-discord"></i>
-                                        <span data-i18n="settings.discord">Discord Integration</span>
-                                    </h3>
-
-                                    <div class="settings-option">
-                                        <label class="settings-checkbox">
-                                            <input type="checkbox" id="discordRPCCheck" checked />
-                                            <span class="checkmark"></span>
-                                            <div class="checkbox-content">
-                                                <div class="checkbox-title" data-i18n="settings.enableRPC">Enable
-                                                    Discord Rich Presence</div>
-                                                <div class="checkbox-description"
-                                                    data-i18n="settings.discordDescription">Show your launcher activity
-                                                    on Discord
-                                                </div>
-                                            </div>
-                                        </label>
-                                    </div>
-                                </div>
-
                                     <div class="settings-section">
                                         <h3 class="settings-section-title">
                                             <i class="fas fa-window-close"></i>
@@ -442,55 +503,28 @@
                                                 <input type="checkbox" id="closeLauncherCheck" />
                                                 <span class="checkmark"></span>
                                                 <div class="checkbox-content">
-                                                <div class="checkbox-title" data-i18n="settings.closeOnStart">Close Launcher on game start</div>
+                                                    <div class="checkbox-title" data-i18n="settings.closeOnStart">Close Launcher
-                                                <div class="checkbox-description" data-i18n="settings.closeOnStartDescription">
+                                                        on game start</div>
+                                                    <div class="checkbox-description"
+                                                        data-i18n="settings.closeOnStartDescription">
                                                         Automatically close the launcher after Hytale has launched
                                                     </div>
                                                 </div>
                                             </label>
                                         </div>
-                                </div>
-
-
-                                <div class="settings-section">
-                                    <h3 class="settings-section-title">
-                                        <i class="fas fa-coffee"></i>
-                                        <span data-i18n="settings.java">Java Runtime</span>
-                                    </h3>
-
                                         <div class="settings-option">
                                             <label class="settings-checkbox">
-                                            <input type="checkbox" id="customJavaCheck" />
+                                                <input type="checkbox" id="launcherHwAccelCheck" />
                                                 <span class="checkmark"></span>
                                                 <div class="checkbox-content">
-                                                <div class="checkbox-title" data-i18n="settings.useCustomJava">Use
+                                                    <div class="checkbox-title" data-i18n="settings.hwAccel">Launcher Hardware
-                                                    Custom Java Path</div>
+                                                        Acceleration</div>
-                                                <div class="checkbox-description" data-i18n="settings.javaDescription">
+                                                    <div class="checkbox-description" data-i18n="settings.hwAccelDescription">
-                                                    Override the bundled Java runtime with
+                                                        Enable hardware acceleration for the launcher UI (Requires restart)
-                                                    your own installation</div>
+                                                    </div>
                                                 </div>
                                             </label>
                                         </div>
-
-                                    <div id="customJavaOptions" class="custom-java-options" style="display: none;">
-                                        <div class="settings-input-group">
-                                            <label class="settings-input-label" data-i18n="settings.javaPath">Java
-                                                Executable Path</label>
-                                            <div class="settings-input-with-button">
-                                                <input type="text" id="customJavaPath" class="settings-input"
-                                                    data-i18n-placeholder="settings.javaPathPlaceholder" readonly />
-                                                <button id="browseJavaBtn" class="settings-browse-btn">
-                                                    <i class="fas fa-folder-open"></i>
-                                                    <span data-i18n="settings.javaBrowse">Browse</span>
-                                                </button>
-                                            </div>
-                                            <p class="settings-hint">
-                                                <i class="fas fa-info-circle"></i>
-                                                <span data-i18n="settings.javaHint">Select the Java installation folder
-                                                    (supports Windows, Mac, Linux)</span>
-                                            </p>
-                                        </div>
-                                    </div>
                                     </div>
     
                                     <div class="settings-section">
@@ -501,14 +535,38 @@
     
                                         <div class="settings-option">
                                             <div class="settings-input-group">
-                                            <label class="settings-input-label"
+                                                <label class="settings-input-label" data-i18n="settings.selectLanguage">Select
-                                                data-i18n="settings.selectLanguage">Select Language</label>
+                                                    Language</label>
                                                 <select id="languageSelect" class="settings-input">
                                                     <!-- Options populated by i18n.js -->
                                                 </select>
                                             </div>
                                         </div>
                                     </div>
+
+                                    <div class="settings-section">
+                                        <h3 class="settings-section-title">
+                                            <i class="fab fa-discord"></i>
+                                            <span data-i18n="settings.discord">Discord Integration</span>
+                                        </h3>
+    
+                                        <div class="settings-option">
+                                            <label class="settings-checkbox">
+                                                <input type="checkbox" id="discordRPCCheck" checked />
+                                                <span class="checkmark"></span>
+                                                <div class="checkbox-content">
+                                                    <div class="checkbox-title" data-i18n="settings.enableRPC">Enable
+                                                        Discord Rich Presence</div>
+                                                    <div class="checkbox-description" data-i18n="settings.discordDescription">
+                                                        Show your launcher activity
+                                                        on Discord
+                                                    </div>
+                                                </div>
+                                            </label>
+                                        </div>
+                                    </div>
+                                </div>
+                        </div>
                     </div>
                 </div>
                 </div>
@@ -575,54 +633,22 @@
                 <span id="progressSpeed"></span>
                 <span id="progressSize"></span>
             </div>
-        </div>
+            <div id="progressErrorContainer" class="progress-error-container" style="display: none;">
-    </div>
+                <div id="progressErrorMessage" class="progress-error-message"></div>
-
+                <div class="progress-retry-section">
-    <!-- Installation effects overlay -->
+                    <span id="progressRetryInfo" class="progress-retry-info"></span>
-    <div id="installationEffects" class="installation-effects" style="display: none;">
+                    <div class="progress-retry-buttons">
-        <div class="space-effects">
+                        <button id="progressJRRetryBtn" class="progress-retry-btn" style="display: none;">
-            <div class="warp-line"></div>
+                            Retry Java Download
-            <div class="warp-line"></div>
-            <div class="warp-line"></div>
-            <div class="warp-line"></div>
-            <div class="warp-line"></div>
-            <div class="warp-line"></div>
-            <div class="warp-line"></div>
-            <div class="warp-line"></div>
-        </div>
-    </div>
-
-    <div id="chatUsernameModal" class="chat-username-modal" style="display: none;">
-        <div class="chat-username-modal-content">
-            <div class="chat-username-modal-header">
-                <h2 class="chat-username-modal-title">
-                    <i class="fas fa-comments mr-2"></i>
-                    <span data-i18n="chat.joinChat">Join Chat</span>
-                </h2>
-            </div>
-            <div class="chat-username-modal-body">
-                <p class="chat-username-modal-description" data-i18n="chat.chooseUsername">
-                    Choose a username to join the Players Chat
-                </p>
-                <div class="chat-username-input-group">
-                    <label for="chatUsernameInput" class="chat-username-label"
-                        data-i18n="chat.username">Username</label>
-                    <input type="text" id="chatUsernameInput" class="chat-username-input"
-                        data-i18n-placeholder="chat.usernamePlaceholder" maxlength="20" autocomplete="off" />
-                    <span class="chat-username-hint" data-i18n="chat.usernameHint">3-20 characters, letters, numbers, -
-                        and _ only</span>
-                    <span id="chatUsernameError" class="chat-username-error"></span>
-                </div>
-            </div>
-            <div class="chat-username-modal-footer">
-                <button id="chatUsernameCancel" class="chat-username-btn-cancel">
-                    <i class="fas fa-times"></i>
-                    <span data-i18n="common.cancel">Cancel</span>
                         </button>
-                <button id="chatUsernameSubmit" class="chat-username-btn-submit">
+                        <button id="progressPWRRetryBtn" class="progress-retry-btn" style="display: none;">
-                    <i class="fas fa-check"></i>
+                            Retry Game Download
-                    <span data-i18n="chat.joinButton">Join Chat</span>
                         </button>
+                        <button id="progressRetryBtn" class="progress-retry-btn" style="display: none;">
+                            Retry Download
+                        </button>
+                    </div>
+                </div>
             </div>
         </div>
     </div>
@@ -720,7 +746,6 @@
 
     <div class="version-display-bottom">
         <i class="fas fa-code-branch"></i>
-        <span id="launcherVersion">Loading...</span>
     </div>
 
     <footer class="fixed bottom-0 left-0 right-0 z-50 bg-black/80 backdrop-blur-sm px-4 py-2">
@@ -742,74 +767,56 @@
                 <a href="https://github.com/ericiskoolbeans" target="_blank"
                     class="text-blue-400 hover:text-blue-300 transition-colors">@ericiskoolbeans</a>,
                 <a href="https://github.com/fazrigading" target="_blank"
-                    class="text-blue-400 hover:text-blue-300 transition-colors">@fazrigading</a>
+                    class="text-blue-400 hover:text-blue-300 transition-colors">@fazrigading</a>,
+                <a href="https://github.com/Rahul-Sahani04" target="_blank"
+                    class="text-blue-400 hover:text-blue-300 transition-colors">@Rahul-Sahani04</a>,
+                <a href="https://github.com/xSamiVS" target="_blank"
+                    class="text-blue-400 hover:text-blue-300 transition-colors">@xSamiVS</a>
             </span>
         </div>
     </footer>
 
-    <script type="module" src="js/script.js"></script> <!-- Discord Notification -->
+    <script type="module" src="js/script.js"></script>
-    <div id="discordNotification" class="discord-notification">
+
-        <div class="notification-content">
+    <div id="discordPopupModal" class="modal-overlay" style="display: none;">
+        <div class="modal-content discord-popup-modal">
+            <div class="modal-header">
+                <div class="discord-popup-header">
                     <i class="fab fa-discord"></i>
-            <span class="notification-text" data-i18n="discord.notificationText">Join our Discord community!</span>
+                    <h2 class="modal-title">Join Our Discord Community</h2>
-            <button class="notification-action"
-                onclick="window.electronAPI?.openExternal('https://discord.gg/n6HZ7NwSQd')">
-                <span data-i18n="discord.joinButton">Join Discord</span>
-            </button>
                 </div>
-        <button class="notification-close" onclick="closeDiscordNotification()">
-            <i class="fas fa-times"></i>
-        </button>
             </div>
+            <div class="modal-body">
+                <div class="discord-popup-body">
+                    <p class="discord-popup-text">
+                        Join our community of over <strong>5000 members</strong> and stay connected!
+                    </p>
+                    <p class="discord-popup-text">
+                        Get the latest news, updates, and announcements about the launcher.
+                    </p>
+                    <p class="discord-popup-text">
+                        Find help, report bugs, share your feedback, and connect with other players.
+                    </p>
                    
-    <!-- Modal pour sélectionner la couleur du chat -->
+                    <div class="discord-popup-actions">
-    <div id="chatColorModal" class="chat-color-modal" style="display: none;">
+                        <button class="discord-popup-btn primary" onclick="joinDiscord()">
-        <div class="chat-color-modal-content">
+                            <i class="fab fa-discord"></i>
-            <div class="chat-color-modal-header">
+                            Join Discord
-                <h3 class="chat-color-modal-title">
+                        </button>
-                    <i class="fas fa-palette"></i>
+                        <button class="discord-popup-btn secondary" onclick="closeDiscordPopup()">
-                    <span data-i18n="chat.colorModal.title">Customize Username Color</span>
+                            Maybe Later
-                </h3>
-                <button class="modal-close-btn" onclick="closeChatColorModal()">
-                    <i class="fas fa-times"></i>
                         </button>
                     </div>
-            <div class="chat-color-modal-body">
-                <div id="solidColorSection" class="color-section">
-                    <h4 data-i18n="chat.colorModal.chooseSolid">Choose a solid color:</h4>
-                    <div class="predefined-colors">
-                        <div class="color-option" data-color="#3498db" style="background: #3498db;"></div>
-                        <div class="color-option" data-color="#e74c3c" style="background: #e74c3c;"></div>
-                        <div class="color-option" data-color="#2ecc71" style="background: #2ecc71;"></div>
-                        <div class="color-option" data-color="#f39c12" style="background: #f39c12;"></div>
-                        <div class="color-option" data-color="#9b59b6" style="background: #9b59b6;"></div>
-                        <div class="color-option" data-color="#1abc9c" style="background: #1abc9c;"></div>
-                        <div class="color-option" data-color="#e91e63" style="background: #e91e63;"></div>
-                        <div class="color-option" data-color="#ff5722" style="background: #ff5722;"></div>
                 </div>
-                    <div class="custom-color-input">
-                        <label for="customColor" data-i18n="chat.colorModal.customColor">Custom color:</label>
-                        <input type="color" id="customColor" value="#3498db">
-                    </div>
-                </div>
-
-                <div class="color-preview">
-                    <h4 data-i18n="chat.colorModal.preview">Preview:</h4>
-                    <div id="colorPreview" class="preview-username" data-i18n="chat.colorModal.previewUsername">
-                        YourUsername</div>
-                </div>
-            </div>
-            <div class="chat-color-modal-footer">
-                <button class="btn-secondary" onclick="closeChatColorModal()"><span
-                        data-i18n="common.cancel">Cancel</span></button>
-                <button class="btn-primary" onclick="applyChatColor()"><span data-i18n="chat.colorModal.apply">Apply
-                        Color</span></button>
             </div>
         </div>
     </div>
 
     <script src="js/i18n.js"></script>
+    <script src="js/featured.js"></script>
+    <script type="module" src="js/settings.js"></script>
     <script type="module" src="js/update.js"></script>
+    <!-- updater.js disabled - using update.js instead which has skip button and macOS handling -->
 </body>
 
 

GUI/js/chat.js

@@ -1,500 +0,0 @@
-
-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

@@ -0,0 +1,176 @@
+// 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,8 +4,15 @@ const i18n = (() => {
   let translations = {};
   const availableLanguages = [
     { code: 'en', name: 'English' },
-    { code: 'es', name: 'Español' },
+    { code: 'de-DE', name: 'German (Germany)' },
-    { code: 'pt-BR', name: 'Português (Brasil)' }
+    { code: 'es-ES', name: 'Spanish (Spain)' },
+    { code: 'fr-FR', name: 'French (France)' },
+    { code: 'pl-PL', name: 'Polish (Poland)' },
+    { 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)' }
   ];
 
   // Load single language file

GUI/js/install.js

@@ -40,28 +40,30 @@ export function setupInstallation() {
     });
   }
 
-  // Setup installation effects listeners
-  if (window.electronAPI && window.electronAPI.onInstallationStart) {
-    window.electronAPI.onInstallationStart(() => {
-      showInstallationEffects();
-    });
-  }
-
-  if (window.electronAPI && window.electronAPI.onInstallationEnd) {
-    window.electronAPI.onInstallationEnd(() => {
-      hideInstallationEffects();
-    });
-  }
 }
 
 export async function installGame() {
   if (isDownloading || (installBtn && installBtn.disabled)) return;
   
-  const playerName = (installPlayerName ? installPlayerName.value.trim() : '') || 'Player';
+  let 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';
+  
+  console.log(`[Install] Installing game with branch: ${selectedBranch}`);
+  
   if (window.LauncherUI) window.LauncherUI.showProgress();
   isDownloading = true;
+  lockInstallForm();
   if (installBtn) {
     installBtn.disabled = true;
     installText.textContent = window.i18n ? window.i18n.t('install.installing') : 'INSTALLING...';
@@ -69,7 +71,7 @@ export async function installGame() {
   
   try {
     if (window.electronAPI && window.electronAPI.installGame) {
-      const result = await window.electronAPI.installGame(playerName, '', installPath);
+      const result = await window.electronAPI.installGame(playerName, '', installPath, selectedBranch);
       
       if (result.success) {
         const successMsg = window.i18n ? window.i18n.t('progress.installationComplete') : 'Installation completed successfully!';
@@ -78,8 +80,11 @@ 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);
         }
@@ -92,12 +97,7 @@ export async function installGame() {
   } catch (error) {
     const errorMsg = window.i18n ? window.i18n.t('progress.installationFailed').replace('{error}', error.message) : `Installation failed: ${error.message}`;
     
-    // Hide installation effects on error
+    // Reset button state and unlock form on error
-    if (window.hideInstallationEffects) {
-      window.hideInstallationEffects();
-    }
-    
-    // Reset button state on error
     resetInstallButton();
     
     if (window.LauncherUI) {
@@ -136,8 +136,11 @@ 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);
         }
@@ -152,6 +155,35 @@ function resetInstallButton() {
     installBtn.disabled = false;
     installText.textContent = 'INSTALL HYTALE';
   }
+  unlockInstallForm();
+}
+
+function lockInstallForm() {
+  const playerNameInput = document.getElementById('installPlayerName');
+  const installPathInput = document.getElementById('installPath');
+  const customCheckbox = document.getElementById('installCustomCheck');
+  const branchRadios = document.querySelectorAll('input[name="installBranch"]');
+  const browseBtn = document.querySelector('.browse-btn');
+  
+  if (playerNameInput) playerNameInput.disabled = true;
+  if (installPathInput) installPathInput.disabled = true;
+  if (customCheckbox) customCheckbox.disabled = true;
+  if (browseBtn) browseBtn.disabled = true;
+  branchRadios.forEach(radio => radio.disabled = true);
+}
+
+function unlockInstallForm() {
+  const playerNameInput = document.getElementById('installPlayerName');
+  const installPathInput = document.getElementById('installPath');
+  const customCheckbox = document.getElementById('installCustomCheck');
+  const branchRadios = document.querySelectorAll('input[name="installBranch"]');
+  const browseBtn = document.querySelector('.browse-btn');
+  
+  if (playerNameInput) playerNameInput.disabled = false;
+  if (installPathInput) installPathInput.disabled = false;
+  if (customCheckbox) customCheckbox.disabled = false;
+  if (browseBtn) browseBtn.disabled = false;
+  branchRadios.forEach(radio => radio.disabled = false);
 }
 
 export async function browseInstallPath() {
@@ -170,7 +202,16 @@ export async function browseInstallPath() {
 async function savePlayerName() {
   try {
     if (window.electronAPI && window.electronAPI.saveSettings) {
-      const playerName = (installPlayerName ? installPlayerName.value.trim() : '') || 'Player';
+      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;
+        }
+      }
+      
       await window.electronAPI.saveSettings({ playerName });
     }
   } catch (error) {
@@ -228,9 +269,3 @@ document.addEventListener('DOMContentLoaded', async () => {
   setupInstallation();
   await checkGameStatusAndShowInterface();
 });
-window.browseInstallPath = browseInstallPath;
-
-document.addEventListener('DOMContentLoaded', async () => {
-  setupInstallation();
-  await checkGameStatusAndShowInterface();
-});

GUI/js/mods.js

@@ -1,5 +1,5 @@
 
-let API_KEY = null;
+let API_KEY = "$2a$10$bqk254NMZOWVTzLVJCcxEOmhcyUujKxA5xk.kQCN9q0KNYFJd5b32";
 const CURSEFORGE_API = 'https://api.curseforge.com/v1';
 const HYTALE_GAME_ID = 70216;
 
@@ -13,7 +13,6 @@ let modsTotalPages = 1;
 export async function initModsManager() {
   try {
     if (window.electronAPI && window.electronAPI.getEnvVar) {
-      API_KEY = await window.electronAPI.getEnvVar('CURSEFORGE_API_KEY');
       console.log('Loaded API Key:', API_KEY ? 'Yes' : 'No');
     }
   } catch (err) {
@@ -201,10 +200,15 @@ async function loadBrowseMods() {
       browseContainer.innerHTML = `
         <div class=\"empty-browse-mods\">
           <i class=\"fas fa-key\"></i>
-          <h4>API Key Required</h4>
+          <h4 data-i18n="mods.apiKeyRequired">API Key Required</h4>
-          <p>CurseForge API key is needed to browse mods</p>
+          <p data-i18n="mods.apiKeyRequiredDesc">CurseForge API key is needed to browse mods</p>
         </div>
       `;
+      if (window.i18n) {
+        const container = modsContainer.querySelector('.empty-browse-mods');
+        container.querySelector('h4').textContent = window.i18n.t('mods.apiKeyRequired');
+        container.querySelector('p').textContent = window.i18n.t('mods.apiKeyRequiredDesc');
+      }
       return;
     }
 

GUI/js/script.js

@@ -4,23 +4,66 @@ 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) {
@@ -51,32 +94,9 @@ function updateLanguageSelector() {
 }
 
 document.addEventListener('DOMContentLoaded', () => {
-  // Populate language selector (wait for i18n if needed)
   if (i18nInitialized) {
     updateLanguageSelector();
   }
   
-  // Discord notification
+  checkDiscordPopup();
-  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

@@ -6,7 +6,9 @@ let browseJavaBtn;
 let settingsPlayerName;
 let discordRPCCheck;
 let closeLauncherCheck;
+let launcherHwAccelCheck;
 let gpuPreferenceRadios;
+let gameBranchRadios;
 
 
 // UUID Management elements
@@ -151,9 +153,9 @@ function showCustomConfirm(message, title, onConfirm, onCancel = null, confirmTe
 }
 
 
-export function initSettings() {
+export async function initSettings() {
   setupSettingsElements();
-  loadAllSettings();
+  await loadAllSettings();
 }
 
 function setupSettingsElements() {
@@ -164,7 +166,11 @@ function setupSettingsElements() {
   settingsPlayerName = document.getElementById('settingsPlayerName');
   discordRPCCheck = document.getElementById('discordRPCCheck');
   closeLauncherCheck = document.getElementById('closeLauncherCheck');
+  launcherHwAccelCheck = document.getElementById('launcherHwAccelCheck');
   gpuPreferenceRadios = document.querySelectorAll('input[name="gpuPreference"]');
+  gameBranchRadios = document.querySelectorAll('input[name="gameBranch"]');
+
+  console.log('[Settings] gameBranchRadios found:', gameBranchRadios.length);
 
 
   // UUID Management elements
@@ -202,6 +208,10 @@ function setupSettingsElements() {
     closeLauncherCheck.addEventListener('change', saveCloseLauncher);
   }
 
+  if (launcherHwAccelCheck) {
+    launcherHwAccelCheck.addEventListener('change', saveLauncherHwAccel);
+  }
+
 
   // UUID event listeners
   if (copyUuidBtn) {
@@ -252,6 +262,12 @@ function setupSettingsElements() {
       });
     });
   }
+
+  if (gameBranchRadios) {
+    gameBranchRadios.forEach(radio => {
+      radio.addEventListener('change', handleBranchChange);
+    });
+  }
 }
 
 function toggleCustomJava() {
@@ -381,6 +397,35 @@ async function loadCloseLauncher() {
   }
 }
 
+async function saveLauncherHwAccel() {
+  try {
+    if (window.electronAPI && window.electronAPI.saveLauncherHardwareAcceleration && launcherHwAccelCheck) {
+      const enabled = launcherHwAccelCheck.checked;
+      await window.electronAPI.saveLauncherHardwareAcceleration(enabled);
+
+      const msg = window.i18n ? window.i18n.t('notifications.hwAccelSaved') : 'Setting saved. Please restart the launcher to apply changes.';
+      showNotification(msg, 'success');
+    }
+  } catch (error) {
+    console.error('Error saving hardware acceleration setting:', error);
+    const msg = window.i18n ? window.i18n.t('notifications.hwAccelSaveFailed') : 'Failed to save setting';
+    showNotification(msg, 'error');
+  }
+}
+
+async function loadLauncherHwAccel() {
+  try {
+    if (window.electronAPI && window.electronAPI.loadLauncherHardwareAcceleration) {
+      const enabled = await window.electronAPI.loadLauncherHardwareAcceleration();
+      if (launcherHwAccelCheck) {
+        launcherHwAccelCheck.checked = enabled;
+      }
+    }
+  } catch (error) {
+    console.error('Error loading hardware acceleration setting:', error);
+  }
+}
+
 
 async function savePlayerName() {
   try {
@@ -394,6 +439,13 @@ 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');
@@ -497,7 +549,9 @@ async function loadAllSettings() {
   await loadCurrentUuid();
   await loadDiscordRPC();
   await loadCloseLauncher();
+  await loadLauncherHwAccel();
   await loadGpuPreference();
+  await loadVersionBranch();
 }
 
 
@@ -532,7 +586,8 @@ document.addEventListener('DOMContentLoaded', initSettings);
 
 window.SettingsAPI = {
   getCurrentJavaPath,
-  getCurrentPlayerName
+  getCurrentPlayerName,
+  reloadBranch: loadVersionBranch
 };
 
 async function loadCurrentUuid() {
@@ -755,7 +810,7 @@ async function setCustomUuid() {
   }
 }
 
-  async function performSetCustomUuid(uuid) {
+async function performSetCustomUuid(uuid) {
   try {
     if (window.electronAPI && window.electronAPI.setUuidForUser) {
       const username = getCurrentPlayerName();
@@ -779,9 +834,9 @@ async function setCustomUuid() {
     const msg = window.i18n ? window.i18n.t('notifications.uuidSetFailed').replace('{error}', error.message) : `Failed to set custom UUID: ${error.message}`;
     showNotification(msg, 'error');
   }
-  }
+}
 
-window.copyUuid = async function(uuid) {
+window.copyUuid = async function (uuid) {
   try {
     if (navigator.clipboard) {
       await navigator.clipboard.writeText(uuid);
@@ -795,7 +850,7 @@ window.copyUuid = async function(uuid) {
   }
 };
 
-window.deleteUuid = async function(username) {
+window.deleteUuid = async function (username) {
   try {
     const message = window.i18n ? window.i18n.t('confirm.deleteUuidMessage').replace('{username}', username) : `Are you sure you want to delete the UUID for "${username}"? This action cannot be undone.`;
     const title = window.i18n ? window.i18n.t('confirm.deleteUuidTitle') : 'Delete UUID';
@@ -891,4 +946,198 @@ function showNotification(message, type = 'info') {
       }
     }, 300);
   }, 3000);
+}// Append this to settings.js for branch management
+
+// === Game Branch Management ===
+async function handleBranchChange(event) {
+  const newBranch = event.target.value;
+  const currentBranch = await loadVersionBranch();
+
+  if (newBranch === currentBranch) {
+    return; // No change
+  }
+
+  // Confirm branch change
+  const branchName = window.i18n ?
+    window.i18n.t(`settings.branch${newBranch === 'pre-release' ? 'PreRelease' : 'Release'}`) :
+    newBranch;
+
+  const message = window.i18n ?
+    window.i18n.t('settings.branchWarning') :
+    'Changing branch will download and install a different game version';
+
+  showCustomConfirm(
+    message,
+    window.i18n ? window.i18n.t('settings.gameBranch') : 'Game Branch',
+    async () => {
+      await switchBranch(newBranch);
+    },
+    () => {
+      // Cancel: revert radio selection
+      loadVersionBranch().then(branch => {
+        const radioToCheck = document.querySelector(`input[name="gameBranch"][value="${branch}"]`);
+        if (radioToCheck) {
+          radioToCheck.checked = true;
+        }
+      });
+    }
+  );
+}
+
+async function switchBranch(newBranch) {
+  try {
+    const switchingMsg = window.i18n ?
+      window.i18n.t('settings.branchSwitching').replace('{branch}', newBranch) :
+      `Switching to ${newBranch}...`;
+
+    showNotification(switchingMsg, 'info');
+
+    // Lock play button
+    const playButton = document.getElementById('playButton');
+    if (playButton) {
+      playButton.disabled = true;
+      playButton.classList.add('disabled');
+    }
+
+    // DON'T save branch yet - wait for installation confirmation
+
+    // Suggest reinstalling
+    setTimeout(() => {
+      const branchLabel = newBranch === 'release' ?
+        (window.i18n ? window.i18n.t('install.releaseVersion') : 'Release') :
+        (window.i18n ? window.i18n.t('install.preReleaseVersion') : 'Pre-Release');
+
+      const confirmMsg = window.i18n ?
+        window.i18n.t('settings.branchInstallConfirm').replace('{branch}', branchLabel) :
+        `The game will be installed for the ${branchLabel} branch. Continue?`;
+
+      showCustomConfirm(
+        confirmMsg,
+        window.i18n ? window.i18n.t('settings.installRequired') : 'Installation Required',
+        async () => {
+          // Show progress and trigger game installation
+          if (window.LauncherUI) {
+            window.LauncherUI.showProgress();
+          }
+
+          try {
+            const playerName = await window.electronAPI.loadUsername();
+            const result = await window.electronAPI.installGame(playerName || 'Player', '', '', newBranch);
+
+            if (result.success) {
+              // Save branch ONLY after successful installation
+              await window.electronAPI.saveVersionBranch(newBranch);
+
+              const switchedMsg = window.i18n ?
+                window.i18n.t('settings.branchSwitched').replace('{branch}', newBranch) :
+                `Switched to ${newBranch} successfully!`;
+
+              const successMsg = window.i18n ?
+                window.i18n.t('progress.installationComplete') :
+                'Installation completed successfully!';
+
+              showNotification(switchedMsg, 'success');
+              showNotification(successMsg, 'success');
+
+              // Refresh radio buttons to reflect the new branch
+              await loadVersionBranch();
+              console.log('[Settings] Radio buttons updated after branch switch');
+
+              setTimeout(() => {
+                if (window.LauncherUI) {
+                  window.LauncherUI.hideProgress();
+                }
+
+                // Unlock play button
+                const playButton = document.getElementById('playButton');
+                if (playButton) {
+                  playButton.disabled = false;
+                  playButton.classList.remove('disabled');
+                }
+              }, 2000);
+            } else {
+              throw new Error(result.error || 'Installation failed');
+            }
+          } catch (error) {
+            console.error('Installation error:', error);
+            const errorMsg = window.i18n ?
+              window.i18n.t('progress.installationFailed').replace('{error}', error.message) :
+              `Installation failed: ${error.message}`;
+
+            showNotification(errorMsg, 'error');
+
+            if (window.LauncherUI) {
+              window.LauncherUI.hideProgress();
+            }
+
+            // Revert radio selection to old branch
+            loadVersionBranch().then(oldBranch => {
+              const radioToCheck = document.querySelector(`input[name="gameBranch"][value="${oldBranch}"]`);
+              if (radioToCheck) {
+                radioToCheck.checked = true;
+              }
+            });
+
+            // Unlock play button
+            const playButton = document.getElementById('playButton');
+            if (playButton) {
+              playButton.disabled = false;
+              playButton.classList.remove('disabled');
+            }
+          }
+        },
+        () => {
+          // Cancel - unlock play button
+          const playButton = document.getElementById('playButton');
+          if (playButton) {
+            playButton.disabled = false;
+            playButton.classList.remove('disabled');
+          }
+        },
+        window.i18n ? window.i18n.t('common.install') : 'Install',
+        window.i18n ? window.i18n.t('common.cancel') : 'Cancel'
+      );
+    }, 500);
+
+  } catch (error) {
+    console.error('Error switching branch:', error);
+    showNotification(`Failed to switch branch: ${error.message}`, 'error');
+
+    // Revert radio selection
+    loadVersionBranch().then(branch => {
+      const radioToCheck = document.querySelector(`input[name="gameBranch"][value="${branch}"]`);
+      if (radioToCheck) {
+        radioToCheck.checked = true;
+      }
+    });
+  }
+}
+
+async function loadVersionBranch() {
+  try {
+    if (window.electronAPI && window.electronAPI.loadVersionBranch) {
+      const branch = await window.electronAPI.loadVersionBranch();
+      console.log('[Settings] Loaded version_branch from config:', branch);
+
+      // Use default if branch is null/undefined
+      const selectedBranch = branch || 'release';
+      console.log('[Settings] Selected branch:', selectedBranch);
+
+      // Update radio buttons
+      if (gameBranchRadios && gameBranchRadios.length > 0) {
+        gameBranchRadios.forEach(radio => {
+          radio.checked = radio.value === selectedBranch;
+          console.log(`[Settings] Radio ${radio.value}: ${radio.checked ? 'checked' : 'unchecked'}`);
+        });
+      } else {
+        console.warn('[Settings] gameBranchRadios not found or empty');
+      }
+
+      return selectedBranch;
+    }
+    return 'release'; // Default
+  } catch (error) {
+    console.error('Error loading version branch:', error);
+    return 'release';
+  }
 }

GUI/js/ui.js

@@ -6,6 +6,24 @@ let progressText;
 let progressPercent;
 let progressSpeed;
 let progressSize;
+let progressErrorContainer;
+let progressErrorMessage;
+let progressRetryInfo;
+let progressRetryBtn;
+let progressJRRetryBtn;
+let progressPWRRetryBtn;
+
+// Download retry state
+let currentDownloadState = {
+    isDownloading: false,
+    canRetry: false,
+    retryData: null,
+    lastError: null,
+    errorType: null,
+    branch: null,
+    fileName: null,
+    cacheDir: null
+};
 
 function showPage(pageId) {
   const pages = document.querySelectorAll('.page');
@@ -13,6 +31,15 @@ function showPage(pageId) {
     if (page.id === pageId) {
       page.classList.add('active');
       page.style.display = '';
+      
+      // Reload settings when settings page becomes visible
+      if (pageId === 'settings-page') {
+        console.log('[UI] Settings page activated, reloading branch...');
+        // Dynamically import and call loadVersionBranch from settings
+        if (window.SettingsAPI && window.SettingsAPI.reloadBranch) {
+          window.SettingsAPI.reloadBranch();
+        }
+      }
     } else {
       page.classList.remove('active');
       page.style.display = 'none';
@@ -36,8 +63,10 @@ function handleNavigation() {
   navItems.forEach(item => {
     item.addEventListener('click', () => {
       const page = item.getAttribute('data-page');
+      if (page) {
         showPage(`${page}-page`);
         setActiveNav(page);
+      }
     });
   });
 }
@@ -144,6 +173,12 @@ function hideProgress() {
 }
 
 function updateProgress(data) {
+  // Handle retry state
+  if (data.retryState) {
+    currentDownloadState.retryData = data.retryState;
+    updateRetryState(data.retryState);
+  }
+
   if (data.message && progressText) {
     progressText.textContent = data.message;
   }
@@ -162,6 +197,120 @@ function updateProgress(data) {
     if (progressSpeed) progressSpeed.textContent = `${speedMB} MB/s`;
     if (progressSize) progressSize.textContent = `${downloadedMB} / ${totalMB} MB`;
   }
+
+  // Handle error states with enhanced categorization
+  // Don't show error during automatic retries - let the retry message display instead
+  if ((data.error || (data.message && data.message.includes('failed'))) && 
+      !(data.retryState && data.retryState.isAutomaticRetry)) {
+    const errorType = categorizeError(data.message);
+    console.log('[UI] Showing download error:', { message: data.message, canRetry: data.canRetry, errorType });
+    showDownloadError(data.message, data.canRetry, errorType, data);
+  } else if (data.percent === 100) {
+    hideDownloadError();
+  } else if (data.retryState && data.retryState.isAutomaticRetry) {
+    // Hide any existing error during automatic retries
+    hideDownloadError();
+  }
+}
+
+function updateRetryState(retryState) {
+  if (!progressRetryInfo) return;
+
+  if (retryState.isAutomaticRetry && retryState.automaticStallRetries > 0) {
+    // Show automatic stall retry count
+    progressRetryInfo.textContent = `Auto-retry ${retryState.automaticStallRetries}/3`;
+    progressRetryInfo.style.display = 'block';
+    progressRetryInfo.style.background = 'rgba(255, 193, 7, 0.2)'; // Light orange background for auto-retries
+    progressRetryInfo.style.color = '#ff9800'; // Orange text for auto-retries
+  } else if (retryState.attempts > 1) {
+    // Show manual retry count
+    progressRetryInfo.textContent = `Attempt ${retryState.attempts}/${retryState.maxRetries}`;
+    progressRetryInfo.style.display = 'block';
+    progressRetryInfo.style.background = ''; // Reset background
+    progressRetryInfo.style.color = ''; // Reset color
+  } else {
+    progressRetryInfo.style.display = 'none';
+    progressRetryInfo.style.background = ''; // Reset background
+    progressRetryInfo.style.color = ''; // Reset color
+  }
+}
+
+function showDownloadError(errorMessage, canRetry = true, errorType = 'general', data = null) {
+  if (!progressErrorContainer || !progressErrorMessage) return;
+
+  console.log('[UI] showDownloadError called with:', { errorMessage, canRetry, errorType, data });
+  console.log('[UI] Data properties:', {
+    hasData: !!data,
+    hasRetryData: !!(data && data.retryData),
+    dataErrorType: data && data.errorType,
+    dataIsJREError: data && data.retryData && data.retryData.isJREError
+  });
+  
+  currentDownloadState.lastError = errorMessage;
+  currentDownloadState.canRetry = canRetry;
+  currentDownloadState.errorType = errorType;
+  
+  // Update retry context if available
+  if (data && data.retryData) {
+    currentDownloadState.branch = data.retryData.branch;
+    currentDownloadState.fileName = data.retryData.fileName;
+    currentDownloadState.cacheDir = data.retryData.cacheDir;
+    // Override errorType if specified in data
+    if (data.errorType) {
+      currentDownloadState.errorType = data.errorType;
+    }
+  }
+
+  // Hide all retry buttons first
+  if (progressRetryBtn) progressRetryBtn.style.display = 'none';
+  if (progressJRRetryBtn) progressJRRetryBtn.style.display = 'none';
+  if (progressPWRRetryBtn) progressPWRRetryBtn.style.display = 'none';
+
+  // User-friendly error messages
+  const userMessage = getErrorMessage(errorMessage, errorType);
+  progressErrorMessage.textContent = userMessage;
+  progressErrorContainer.style.display = 'block';
+
+  // Show appropriate retry button based on error type
+  if (canRetry) {
+    if (errorType === 'jre') {
+      if (progressJRRetryBtn) {
+        console.log('[UI] Showing JRE retry button');
+        progressJRRetryBtn.style.display = 'block';
+      }
+    } else {
+      // All other errors use PWR retry button (game download, butler, etc.)
+      if (progressPWRRetryBtn) {
+        console.log('[UI] Showing PWR retry button');
+        progressPWRRetryBtn.style.display = 'block';
+      }
+    }
+  }
+
+  // Add visual indicators based on error type
+  progressErrorContainer.className = `progress-error-container error-${errorType}`;
+
+  if (progressOverlay) {
+    progressOverlay.classList.add('error-state');
+  }
+}
+
+function hideDownloadError() {
+  if (!progressErrorContainer) return;
+
+  // Hide all retry buttons
+  if (progressRetryBtn) progressRetryBtn.style.display = 'none';
+  if (progressJRRetryBtn) progressJRRetryBtn.style.display = 'none';
+  if (progressPWRRetryBtn) progressPWRRetryBtn.style.display = 'none';
+
+  progressErrorContainer.style.display = 'none';
+  currentDownloadState.canRetry = false;
+  currentDownloadState.lastError = null;
+  currentDownloadState.errorType = null;
+
+  if (progressOverlay) {
+    progressOverlay.classList.remove('error-state');
+  }
 }
 
 function setupAnimations() {
@@ -478,10 +627,19 @@ function setupUI() {
   progressPercent = document.getElementById('progressPercent');
   progressSpeed = document.getElementById('progressSpeed');
   progressSize = document.getElementById('progressSize');
+  progressErrorContainer = document.getElementById('progressErrorContainer');
+  progressErrorMessage = document.getElementById('progressErrorMessage');
+  progressRetryInfo = document.getElementById('progressRetryInfo');
+  progressRetryBtn = document.getElementById('progressRetryBtn');
+  progressJRRetryBtn = document.getElementById('progressJRRetryBtn');
+  progressPWRRetryBtn = document.getElementById('progressPWRRetryBtn');
 
   // Setup draggable progress bar
   setupProgressDrag();
 
+  // Setup retry button
+  setupRetryButton();
+
   lockPlayButton(true);
 
   setTimeout(() => {
@@ -501,6 +659,10 @@ function setupUI() {
   setupAnimations();
   setupFirstLaunchHandlers();
   loadLauncherVersion();
+  checkGameInstallation().catch(err => {
+    console.error('Critical error in checkGameInstallation:', err);
+    lockPlayButton(false);
+  });
 
   document.body.focus();
 }
@@ -520,6 +682,53 @@ async function loadLauncherVersion() {
   }
 }
 
+// Check game installation status on startup
+async function checkGameInstallation() {
+  try {
+    console.log('Checking game installation status...');
+    
+    // Verify electronAPI is available
+    if (!window.electronAPI || !window.electronAPI.isGameInstalled) {
+      console.error('electronAPI not available, unlocking play button as fallback');
+      lockPlayButton(false);
+      return;
+    }
+    
+    // Check if game is installed
+    const isInstalled = await window.electronAPI.isGameInstalled();
+    
+    // Load version_client from config
+    let versionClient = null;
+    if (window.electronAPI.loadVersionClient) {
+      versionClient = await window.electronAPI.loadVersionClient();
+    }
+    
+    console.log(`Game installed: ${isInstalled}, version_client: ${versionClient}`);
+    
+    lockPlayButton(false);
+    
+    // If version_client is null and game is not installed, show install page
+    if (versionClient === null && !isInstalled) {
+      console.log('Game not installed and version_client is null, showing install page...');
+      
+      // Show installation page
+      const installPage = document.getElementById('install-page');
+      const launcher = document.getElementById('launcher-container');
+      const sidebar = document.querySelector('.sidebar');
+      
+      if (installPage) {
+        installPage.style.display = 'block';
+        if (launcher) launcher.style.display = 'none';
+        if (sidebar) sidebar.style.pointerEvents = 'none';
+      }
+    }
+  } catch (error) {
+    console.error('Error checking game installation:', error);
+    // Unlock on error to prevent permanent lock
+    lockPlayButton(false);
+  }
+}
+
 window.LauncherUI = {
   showPage,
   setActiveNav,
@@ -530,8 +739,7 @@ window.LauncherUI = {
 };
 
 // Make installation effects globally available
-window.showInstallationEffects = showInstallationEffects;
+
-window.hideInstallationEffects = hideInstallationEffects;
 
 // Draggable progress bar functionality
 function setupProgressDrag() {
@@ -591,21 +799,6 @@ function setupProgressDrag() {
   }
 }
 
-// Show/hide installation effects
-function showInstallationEffects() {
-  const installationEffects = document.getElementById('installationEffects');
-  if (installationEffects) {
-    installationEffects.style.display = 'block';
-  }
-}
-
-function hideInstallationEffects() {
-  const installationEffects = document.getElementById('installationEffects');
-  if (installationEffects) {
-    installationEffects.style.display = 'none';
-  }
-}
-
 // Toggle maximize/restore window function
 function toggleMaximize() {
   if (window.electronAPI && window.electronAPI.maximizeWindow) {
@@ -613,7 +806,306 @@ function toggleMaximize() {
   }
 }
 
-// Make toggleMaximize globally available
+// Error categorization and user-friendly messages
+function categorizeError(message) {
+  const msg = message.toLowerCase();
+  
+  if (msg.includes('network') || msg.includes('connection') || msg.includes('offline')) {
+    return 'network';
+  } else if (msg.includes('stalled') || msg.includes('timeout')) {
+    return 'stall';
+  } else if (msg.includes('file') || msg.includes('disk')) {
+    return 'file';
+  } else if (msg.includes('permission') || msg.includes('access')) {
+    return 'permission';
+  } else if (msg.includes('server') || msg.includes('5')) {
+    return 'server';
+  } else if (msg.includes('corrupted') || msg.includes('pwr file') || msg.includes('unexpected eof')) {
+    return 'corruption';
+  } else if (msg.includes('butler') || msg.includes('patch installation')) {
+    return 'butler';
+  } else if (msg.includes('space') || msg.includes('full') || msg.includes('device full')) {
+    return 'space';
+  } else if (msg.includes('conflict') || msg.includes('already exists')) {
+    return 'conflict';
+  } else if (msg.includes('jre') || msg.includes('java runtime')) {
+    return 'jre';
+  } else {
+    return 'general';
+  }
+}
+
+function getErrorMessage(technicalMessage, errorType) {
+  // Technical errors go to console, user gets friendly messages
+  console.error(`Download error [${errorType}]:`, technicalMessage);
+  
+  switch (errorType) {
+    case 'network':
+      return 'Network connection lost. Please check your internet connection and retry.';
+    case 'stall':
+      return 'Download stalled due to slow connection. Please retry.';
+    case 'file':
+      return 'Unable to save file. Check permissions. Please retry.';
+    case 'permission':
+      return 'Permission denied. Check if launcher has write access. Please retry.';
+    case 'server':
+      return 'Server error. Please wait a moment and retry.';
+    case 'corruption':
+      return 'Corrupted PWR file detected. File deleted and will retry.';
+    case 'butler':
+      return 'Patch installation failed. Please retry.';
+    case 'space':
+      return 'Insufficient disk space. Free up space and retry.';
+    case 'conflict':
+      return 'Installation directory conflict. Please retry.';
+    case 'jre':
+      return 'Java runtime download failed. Please retry.';
+    default:
+      return 'Download failed. Please retry.';
+  }
+}
+
+// Connection quality indicator (simplified)
+function updateConnectionQuality(quality) {
+  if (!progressSize) return;
+  
+  const qualityColors = {
+    'Good': '#10b981',
+    'Fair': '#fbbf24', 
+    'Poor': '#f87171'
+  };
+  
+  const color = qualityColors[quality] || '#6b7280';
+  progressSize.style.color = color;
+  
+  // Add subtle quality indicator
+  if (progressSize.dataset.quality !== quality) {
+    progressSize.dataset.quality = quality;
+    progressSize.style.transition = 'color 0.5s ease';
+  }
+}
+
+// Enhanced retry button setup
+function setupRetryButton() {
+  // Setup JRE retry button
+  if (progressJRRetryBtn) {
+    progressJRRetryBtn.addEventListener('click', async () => {
+      if (!currentDownloadState.canRetry || currentDownloadState.isDownloading) {
+        return;
+      }
+      progressJRRetryBtn.disabled = true;
+      progressJRRetryBtn.textContent = 'Retrying...';
+      progressJRRetryBtn.classList.add('retrying');
+      currentDownloadState.isDownloading = true;
+
+      try {
+        hideDownloadError();
+        
+        if (progressRetryInfo) {
+          progressRetryInfo.style.background = '';
+          progressRetryInfo.style.color = '';
+        }
+        
+        if (progressText) {
+          progressText.textContent = 'Re-downloading Java runtime...';
+        }
+
+        if (!currentDownloadState.retryData || currentDownloadState.errorType !== 'jre') {
+          currentDownloadState.retryData = {
+            isJREError: true,
+            jreUrl: '',
+            fileName: 'jre.tar.gz',
+            cacheDir: '',
+            osName: 'linux',
+            arch: 'amd64'
+          };
+          console.log('[UI] Created default JRE retry data:', currentDownloadState.retryData);
+        }
+
+        if (window.electronAPI && window.electronAPI.retryDownload) {
+          const result = await window.electronAPI.retryDownload(currentDownloadState.retryData);
+          if (!result.success) {
+            throw new Error(result.error || 'JRE retry failed');
+          }
+        } else {
+          console.warn('electronAPI.retryDownload not available, simulating JRE retry...');
+          await new Promise(resolve => setTimeout(resolve, 2000));
+          throw new Error('JRE retry API not available');
+        }
+
+      } catch (error) {
+        console.error('JRE retry failed:', error);
+        showDownloadError(`JRE retry failed: ${error.message}`, true, 'jre');
+      } finally {
+        if (progressJRRetryBtn) {
+          progressJRRetryBtn.disabled = false;
+          progressJRRetryBtn.textContent = 'Retry Java Download';
+          progressJRRetryBtn.classList.remove('retrying');
+        }
+        currentDownloadState.isDownloading = false;
+      }
+    });
+  }
+
+  // Setup PWR retry button
+  if (progressPWRRetryBtn) {
+    progressPWRRetryBtn.addEventListener('click', async () => {
+      if (!currentDownloadState.canRetry || currentDownloadState.isDownloading) {
+        return;
+      }
+      progressPWRRetryBtn.disabled = true;
+      progressPWRRetryBtn.textContent = 'Retrying...';
+      progressPWRRetryBtn.classList.add('retrying');
+      currentDownloadState.isDownloading = true;
+
+      try {
+        hideDownloadError();
+        
+        if (progressRetryInfo) {
+          progressRetryInfo.style.background = '';
+          progressRetryInfo.style.color = '';
+        }
+        
+        if (progressText) {
+          const contextMessage = getRetryContextMessage();
+          progressText.textContent = contextMessage;
+        }
+
+        if (!currentDownloadState.retryData || currentDownloadState.errorType === 'jre') {
+          currentDownloadState.retryData = {
+            branch: 'release',
+            fileName: '7.pwr'
+          };
+          console.log('[UI] Created default PWR retry data:', currentDownloadState.retryData);
+        }
+
+        if (window.electronAPI && window.electronAPI.retryDownload) {
+          const result = await window.electronAPI.retryDownload(currentDownloadState.retryData);
+          if (!result.success) {
+            throw new Error(result.error || 'Game retry failed');
+          }
+        } else {
+          console.warn('electronAPI.retryDownload not available, simulating PWR retry...');
+          await new Promise(resolve => setTimeout(resolve, 2000));
+          throw new Error('Game retry API not available');
+        }
+
+      } catch (error) {
+        console.error('PWR retry failed:', error);
+        const errorType = categorizeError(error.message);
+        showDownloadError(`Game retry failed: ${error.message}`, true, errorType, error);
+      } finally {
+        if (progressPWRRetryBtn) {
+          progressPWRRetryBtn.disabled = false;
+          progressPWRRetryBtn.textContent = error && error.isJREError ? 'Retry Java Download' : 'Retry Game Download';
+          progressPWRRetryBtn.classList.remove('retrying');
+        }
+        currentDownloadState.isDownloading = false;
+      }
+    });
+  }
+
+  // Setup generic retry button (fallback)
+  if (progressRetryBtn) {
+    progressRetryBtn.addEventListener('click', async () => {
+      if (!currentDownloadState.canRetry || currentDownloadState.isDownloading) {
+        return;
+      }
+      progressRetryBtn.disabled = true;
+      progressRetryBtn.textContent = 'Retrying...';
+      progressRetryBtn.classList.add('retrying');
+      currentDownloadState.isDownloading = true;
+
+      try {
+        hideDownloadError();
+        
+        if (progressRetryInfo) {
+          progressRetryInfo.style.background = '';
+          progressRetryInfo.style.color = '';
+        }
+        
+        if (progressText) {
+          const contextMessage = getRetryContextMessage();
+          progressText.textContent = contextMessage;
+        }
+
+        if (!currentDownloadState.retryData) {
+          if (currentDownloadState.errorType === 'jre') {
+            currentDownloadState.retryData = {
+              isJREError: true,
+              jreUrl: '',
+              fileName: 'jre.tar.gz',
+              cacheDir: '',
+              osName: 'linux',
+              arch: 'amd64'
+            };
+          } else {
+            currentDownloadState.retryData = {
+              branch: 'release',
+              fileName: '7.pwr'
+            };
+          }
+          console.log('[UI] Created default retry data:', currentDownloadState.retryData);
+        }
+
+        if (window.electronAPI && window.electronAPI.retryDownload) {
+          const result = await window.electronAPI.retryDownload(currentDownloadState.retryData);
+          if (!result.success) {
+            throw new Error(result.error || 'Retry failed');
+          }
+        } else {
+          console.warn('electronAPI.retryDownload not available, simulating retry...');
+          await new Promise(resolve => setTimeout(resolve, 2000));
+          throw new Error('Retry API not available');
+        }
+
+      } catch (error) {
+        console.error('Retry failed:', error);
+        const errorType = categorizeError(error.message);
+        showDownloadError(`Retry failed: ${error.message}`, true, errorType);
+      } finally {
+        if (progressRetryBtn) {
+          progressRetryBtn.disabled = false;
+          progressRetryBtn.textContent = 'Retry Download';
+          progressRetryBtn.classList.remove('retrying');
+        }
+        currentDownloadState.isDownloading = false;
+      }
+    });
+  }
+}
+
+function getRetryContextMessage() {
+  const errorType = currentDownloadState.errorType;
+  
+  switch (errorType) {
+    case 'network':
+      return 'Reconnecting and retrying download...';
+    case 'stall':
+      return 'Resuming stalled download...';
+    case 'server':
+      return 'Waiting for server and retrying...';
+    case 'corruption':
+      return 'Re-downloading corrupted PWR file...';
+    case 'butler':
+      return 'Re-attempting patch installation...';
+    case 'space':
+      return 'Retrying after clearing disk space...';
+    case 'permission':
+      return 'Retrying with corrected permissions...';
+    case 'conflict':
+      return 'Retrying after resolving conflicts...';
+    case 'jre':
+      return 'Re-downloading Java runtime...';
+    default:
+      return 'Initiating retry download...';
+  }
+}
+
+window.openDiscordExternal = function() {
+  window.electronAPI?.openExternal('https://discord.gg/hf2pdc');
+};
+
 window.toggleMaximize = toggleMaximize;
 
 document.addEventListener('DOMContentLoaded', setupUI);

GUI/js/update.js

@@ -6,12 +6,12 @@ class ClientUpdateManager {
     }
 
     init() {
-        window.electronAPI.onUpdatePopup((updateInfo) => {
+        console.log('🔧 ClientUpdateManager initializing...');
-            this.showUpdatePopup(updateInfo);
-        });
 
-        // Listen for electron-updater events
+        // Listen for electron-updater events from main.js
+        // This is the primary update trigger - main.js checks for updates on startup
         window.electronAPI.onUpdateAvailable((updateInfo) => {
+            console.log('📥 update-available event received:', updateInfo);
             this.showUpdatePopup(updateInfo);
         });
 
@@ -20,18 +20,30 @@ 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);
         });
 
-        this.checkForUpdatesOnDemand();
+        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.
     }
 
     showUpdatePopup(updateInfo) {
-        if (this.updatePopupVisible) return;
+        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;
+        }
 
         this.updatePopupVisible = true;
         
@@ -92,7 +104,10 @@ class ClientUpdateManager {
                     </div>
 
                     <div class="update-popup-footer">
-                        This popup cannot be closed until you update the launcher
+                        <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>
                     </div>
                 </div>
             </div>
@@ -119,10 +134,37 @@ class ClientUpdateManager {
 
                 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:';
+                        }
+                    }
                 }
             });
         }
@@ -138,9 +180,14 @@ class ClientUpdateManager {
                 
                 try {
                     await window.electronAPI.openDownloadPage();
-                    console.log('✅ Download page opened, launcher will close...');
+                    console.log('✅ Download page opened');
 
-                    downloadBtn.innerHTML = '<i class="fas fa-check" style="margin-right: 0.5rem;"></i>Launcher closing...';
+                    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);
 
                 } catch (error) {
                     console.error('❌ Error opening download page:', error);
@@ -161,9 +208,39 @@ 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');
@@ -197,25 +274,86 @@ 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');
 
-        if (statusText) {
+        // Remove breathing/pulse animation when download is complete
-            statusText.textContent = 'Update downloaded! Ready to install.';
+        if (popupContainer) {
+            popupContainer.classList.remove('update-popup-pulse');
         }
 
         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';
         }
 
-        console.log('✅ Update downloaded, ready to install');
+        // 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);
     }
 
     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);
@@ -289,6 +427,16 @@ 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');
     }
 
@@ -300,13 +448,35 @@ class ClientUpdateManager {
 
         document.body.classList.add('no-select');
 
-        document.addEventListener('keydown', this.blockKeyEvents.bind(this), true);
+        // Store bound functions so we can remove them later
+        this._boundBlockKeyEvents = this.blockKeyEvents.bind(this);
+        this._boundBlockContextMenu = this.blockContextMenu.bind(this);
 
-        document.addEventListener('contextmenu', this.blockContextMenu.bind(this), true);
+        document.addEventListener('keydown', this._boundBlockKeyEvents, true);
+        document.addEventListener('contextmenu', this._boundBlockContextMenu, 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/js/updater.js

@@ -0,0 +1,149 @@
+// Launcher Update Manager UI
+
+let updateModal = null;
+let downloadProgressBar = null;
+
+function initUpdater() {
+  // Listen for update events from main process
+  if (window.electronAPI && window.electronAPI.onUpdateAvailable) {
+    window.electronAPI.onUpdateAvailable((updateInfo) => {
+      showUpdateModal(updateInfo);
+    });
+  }
+
+  if (window.electronAPI && window.electronAPI.onUpdateDownloadProgress) {
+    window.electronAPI.onUpdateDownloadProgress((progress) => {
+      updateDownloadProgress(progress);
+    });
+  }
+
+  if (window.electronAPI && window.electronAPI.onUpdateDownloaded) {
+    window.electronAPI.onUpdateDownloaded((info) => {
+      showInstallUpdatePrompt(info);
+    });
+  }
+}
+
+function showUpdateModal(updateInfo) {
+  if (updateModal) {
+    updateModal.remove();
+  }
+
+  updateModal = document.createElement('div');
+  updateModal.className = 'update-modal-overlay';
+  updateModal.innerHTML = `
+    <div class="update-modal">
+      <div class="update-header">
+        <i class="fas fa-download"></i>
+        <h2>Launcher Update Available</h2>
+      </div>
+      <div class="update-content">
+        <p class="update-version">Version ${updateInfo.newVersion} is available!</p>
+        <p class="current-version">Current version: ${updateInfo.currentVersion}</p>
+        ${updateInfo.releaseNotes ? `<div class="release-notes">${updateInfo.releaseNotes}</div>` : ''}
+      </div>
+      <div class="update-progress" style="display: none;">
+        <div class="progress-bar-container">
+          <div class="progress-bar" id="updateProgressBar"></div>
+        </div>
+        <p class="progress-text" id="updateProgressText">Downloading...</p>
+      </div>
+      <div class="update-actions">
+        <button class="btn-primary" onclick="downloadUpdate()">
+          <i class="fas fa-download"></i> Download Update
+        </button>
+      </div>
+    </div>
+  `;
+
+  document.body.appendChild(updateModal);
+}
+
+async function downloadUpdate() {
+  const downloadBtn = updateModal.querySelector('.btn-primary');
+  const progressDiv = updateModal.querySelector('.update-progress');
+  
+  // Disable button and show progress
+  downloadBtn.disabled = true;
+  progressDiv.style.display = 'block';
+
+  try {
+    await window.electronAPI.downloadUpdate();
+  } catch (error) {
+    console.error('Failed to download update:', error);
+    alert('Failed to download update. Please try again later.');
+    dismissUpdateModal();
+  }
+}
+
+function updateDownloadProgress(progress) {
+  if (!updateModal) return;
+
+  const progressBar = document.getElementById('updateProgressBar');
+  const progressText = document.getElementById('updateProgressText');
+
+  if (progressBar) {
+    progressBar.style.width = `${progress.percent}%`;
+  }
+
+  if (progressText) {
+    const mbTransferred = (progress.transferred / 1024 / 1024).toFixed(2);
+    const mbTotal = (progress.total / 1024 / 1024).toFixed(2);
+    const speed = (progress.bytesPerSecond / 1024 / 1024).toFixed(2);
+    progressText.textContent = `Downloading... ${mbTransferred}MB / ${mbTotal}MB (${speed} MB/s)`;
+  }
+}
+
+function showInstallUpdatePrompt(info) {
+  if (updateModal) {
+    updateModal.remove();
+  }
+
+  updateModal = document.createElement('div');
+  updateModal.className = 'update-modal-overlay';
+  updateModal.innerHTML = `
+    <div class="update-modal">
+      <div class="update-header">
+        <i class="fas fa-check-circle"></i>
+        <h2>Update Downloaded</h2>
+      </div>
+      <div class="update-content">
+        <p>Version ${info.version} has been downloaded and is ready to install.</p>
+        <p class="update-note">The launcher will restart to complete the installation.</p>
+      </div>
+      <div class="update-actions">
+        <button class="btn-primary" onclick="installUpdate()">
+          <i class="fas fa-sync-alt"></i> Restart & Install
+        </button>
+      </div>
+    </div>
+  `;
+
+  document.body.appendChild(updateModal);
+}
+
+async function installUpdate() {
+  try {
+    await window.electronAPI.installUpdate();
+  } catch (error) {
+    console.error('Failed to install update:', error);
+  }
+}
+
+function dismissUpdateModal() {
+  if (updateModal) {
+    updateModal.remove();
+    updateModal = null;
+  }
+}
+
+// Initialize when DOM is ready
+document.addEventListener('DOMContentLoaded', initUpdater);
+
+// Export functions
+window.UpdaterUI = {
+  showUpdateModal,
+  dismissUpdateModal,
+  downloadUpdate,
+  installUpdate
+};

GUI/locales/de-DE.json

@@ -0,0 +1,250 @@
+{
+  "nav": {
+    "play": "Spielen",
+    "mods": "Mods",
+    "news": "Neuigkeiten",
+    "chat": "Spieler-Chat",
+    "settings": "Einstellungen"
+  },
+  "header": {
+    "playersLabel": "Spieler:",
+    "manageProfiles": "Profile verwalten",
+    "defaultProfile": "Standard"
+  },
+  "install": {
+    "title": "KOSTENLOSER LAUNCHER",
+    "playerName": "Spielername",
+    "playerNamePlaceholder": "Namen eingeben",
+    "gameBranch": "Spielversion",
+    "releaseVersion": "Release (Stabil)",
+    "preReleaseVersion": "Pre-Release (Experimentell)",
+    "customInstallation": "Benutzerdefinierte Installation",
+    "installationFolder": "Installationsordner",
+    "pathPlaceholder": "Standardspeicherort",
+    "browse": "Durchsuchen",
+    "installButton": "HYTALE INSTALLIEREN",
+    "installing": "INSTALLIERE..."
+  },
+  "play": {
+    "ready": "BEREIT ZUM SPIELEN",
+    "subtitle": "Starte Hytale und beginne das Abenteuer",
+    "playButton": "HYTALE SPIELEN",
+    "latestNews": "NEUESTE NACHRICHTEN",
+    "viewAll": "ALLE ANZEIGEN",
+    "checking": "ÜBERPRÜFE...",
+    "play": "SPIELEN"
+  },
+  "mods": {
+    "searchPlaceholder": "Mods suchen...",
+    "myMods": "MEINE MODS",
+    "previous": "ZURÜCK",
+    "next": "WEITER",
+    "page": "Seite",
+    "of": "von",
+    "modalTitle": "MEINE MODS",
+    "noModsFound": "Keine Mods gefunden",
+    "noModsFoundDesc": "Versuche deine Suche anzupassen",
+    "noModsInstalled": "Keine Mods installiert",
+    "noModsInstalledDesc": "Füge Mods von CurseForge hinzu oder importiere lokale Dateien",
+    "view": "ANZEIGEN",
+    "install": "INSTALLIEREN",
+    "installed": "INSTALLIERT",
+    "enable": "AKTIVIEREN",
+    "disable": "DEAKTIVIEREN",
+    "active": "AKTIV",
+    "disabled": "DEAKTIVIERT",
+    "delete": "Mod löschen",
+    "noDescription": "Keine Beschreibung verfügbar",
+    "confirmDelete": "Möchtest du \"{name}\" wirklich löschen?",
+    "confirmDeleteDesc": "Diese Aktion kann nicht rückgängig gemacht werden.",
+    "confirmDeletion": "Löschung bestätigen",
+    "apiKeyRequired": "API-Schlüssel erforderlich",
+    "apiKeyRequiredDesc": "CurseForge API-Schlüssel wird benötigt, um Mods zu durchsuchen"
+  },
+  "news": {
+    "title": "ALLE NACHRICHTEN",
+    "readMore": "Mehr lesen"
+  },
+  "chat": {
+    "title": "SPIELER-CHAT",
+    "pickColor": "Farbe",
+    "inputPlaceholder": "Nachricht eingeben...",
+    "send": "Senden",
+    "online": "online",
+    "charCounter": "{current}/{max}",
+    "secureChat": "Sicherer Chat - Links werden zensiert",
+    "joinChat": "Chat beitreten",
+    "chooseUsername": "Wähle einen Benutzernamen, um dem Spieler-Chat beizutreten",
+    "username": "Benutzername",
+    "usernamePlaceholder": "Benutzernamen eingeben...",
+    "usernameHint": "3-20 Zeichen, nur Buchstaben, Zahlen, - und _",
+    "joinButton": "Chat beitreten",
+    "colorModal": {
+      "title": "Benutzernamenfarbe anpassen",
+      "chooseSolid": "Wähle eine einfarbige Farbe:",
+      "customColor": "Benutzerdefinierte Farbe:",
+      "preview": "Vorschau:",
+      "previewUsername": "Benutzername",
+      "apply": "Farbe anwenden"
+    }
+  },
+  "settings": {
+    "title": "EINSTELLUNGEN",
+    "java": "Java Runtime",
+    "useCustomJava": "Benutzerdefinierten Java-Pfad verwenden",
+    "javaDescription": "Ersetze die mitgelieferte Java-Installation durch deine eigene",
+    "javaPath": "Java-Ausführungsdatei-Pfad",
+    "javaPathPlaceholder": "Java-Pfad auswählen...",
+    "javaBrowse": "Durchsuchen",
+    "javaHint": "Wähle den Java-Installationsordner (unterstützt Windows, Mac, Linux)",
+    "discord": "Discord-Integration",
+    "enableRPC": "Discord Rich Presence aktivieren",
+    "discordDescription": "Zeige deine Launcher-Aktivität auf Discord",
+    "game": "Spieloptionen",
+    "playerName": "Spielername",
+    "playerNamePlaceholder": "Spielernamen eingeben",
+    "playerNameHint": "Dieser Name wird im Spiel verwendet (1-16 Zeichen)",
+    "openGameLocation": "Spielordner öffnen",
+    "openGameLocationDesc": "Öffne den Spielinstallationsordner",
+    "account": "Spieler-UUID-Verwaltung",
+    "currentUUID": "Aktuelle UUID",
+    "uuidPlaceholder": "UUID wird geladen...",
+    "copyUUID": "UUID kopieren",
+    "regenerateUUID": "UUID neu generieren",
+    "uuidHint": "Deine eindeutige Spielerkennung für diesen Benutzernamen",
+    "manageUUIDs": "Alle UUIDs verwalten",
+    "manageUUIDsDesc": "Alle Spieler-UUIDs anzeigen und verwalten",
+    "language": "Sprache",
+    "selectLanguage": "Sprache auswählen",
+    "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.",
+    "gpuAuto": "Auto",
+    "gpuIntegrated": "Integriert",
+    "gpuDedicated": "Dediziert",
+    "logs": "SYSTEMPROTOKOLLE",
+    "logsCopy": "Kopieren",
+    "logsRefresh": "Aktualisieren",
+    "logsFolder": "Ordner öffnen",
+    "logsLoading": "Protokolle werden geladen...",
+    "closeLauncher": "Launcher-Verhalten",
+    "closeOnStart": "Launcher beim Spielstart schließen",
+    "closeOnStartDescription": "Schließe den Launcher automatisch, nachdem Hytale gestartet wurde",
+    "hwAccel": "Hardware-Beschleunigung",
+    "hwAccelDescription": "Hardware-Beschleunigung für den Launcher aktivieren",
+    "gameBranch": "Spiel-Branch",
+    "branchRelease": "Release",
+    "branchPreRelease": "Pre-Release",
+    "branchHint": "Wechsel zwischen stabiler Release- und experimenteller Pre-Release-Version",
+    "branchWarning": "Das Ändern des Branches lädt eine andere Spielversion herunter und installiert sie",
+    "branchSwitching": "Wechsle zu {branch}...",
+    "branchSwitched": "Erfolgreich zu {branch} gewechselt!",
+    "installRequired": "Installation erforderlich",
+    "branchInstallConfirm": "Das Spiel wird für den {branch}-Branch installiert. Fortfahren?"
+  },
+  "uuid": {
+    "modalTitle": "UUID-Verwaltung",
+    "currentUserUUID": "Aktuelle Benutzer-UUID",
+    "allPlayerUUIDs": "Alle Spieler-UUIDs",
+    "generateNew": "Neue UUID generieren",
+    "loadingUUIDs": "UUIDs werden geladen...",
+    "setCustomUUID": "Benutzerdefinierte UUID festlegen",
+    "customPlaceholder": "Benutzerdefinierte UUID eingeben (Format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)",
+    "setUUID": "UUID festlegen",
+    "warning": "Warnung: Das Festlegen einer benutzerdefinierten UUID ändert deine aktuelle Spieleridentität",
+    "copyTooltip": "UUID kopieren",
+    "regenerateTooltip": "Neue UUID generieren"
+  },
+  "profiles": {
+    "modalTitle": "Profile verwalten",
+    "newProfilePlaceholder": "Neuer Profilname",
+    "createProfile": "Profil erstellen"
+  },
+  "discord": {
+    "notificationText": "Tritt unserer Discord-Community bei!",
+    "joinButton": "Discord beitreten"
+  },
+  "common": {
+    "confirm": "Bestätigen",
+    "cancel": "Abbrechen",
+    "save": "Speichern",
+    "close": "Schließen",
+    "delete": "Löschen",
+    "edit": "Bearbeiten",
+    "loading": "Lädt...",
+    "apply": "Anwenden",
+    "install": "Installieren"
+  },
+  "notifications": {
+    "gameDataNotFound": "Fehler: Spieldaten nicht gefunden",
+    "gameUpdatedSuccess": "Spiel erfolgreich aktualisiert! 🎉",
+    "updateFailed": "Update fehlgeschlagen: {error}",
+    "updateError": "Update-Fehler: {error}",
+    "discordEnabled": "Discord Rich Presence aktiviert",
+    "discordDisabled": "Discord Rich Presence deaktiviert",
+    "discordSaveFailed": "Discord-Einstellung konnte nicht gespeichert werden",
+    "playerNameRequired": "Bitte gib einen gültigen Spielernamen ein",
+    "playerNameSaved": "Spielername erfolgreich gespeichert",
+    "playerNameSaveFailed": "Spielername konnte nicht gespeichert werden",
+    "uuidCopied": "UUID in die Zwischenablage kopiert!",
+    "uuidCopyFailed": "UUID konnte nicht kopiert werden",
+    "uuidRegenNotAvailable": "UUID-Neugenerierung nicht verfügbar",
+    "uuidRegenFailed": "UUID konnte nicht neu generiert werden",
+    "uuidGenerated": "Neue UUID erfolgreich generiert!",
+    "uuidGeneratedShort": "Neue UUID generiert!",
+    "uuidGenerateFailed": "Neue UUID konnte nicht generiert werden",
+    "uuidRequired": "Bitte gib eine UUID ein",
+    "uuidInvalidFormat": "Ungültiges UUID-Format",
+    "uuidSetFailed": "Benutzerdefinierte UUID konnte nicht festgelegt werden",
+    "uuidSetSuccess": "Benutzerdefinierte UUID erfolgreich festgelegt!",
+    "uuidDeleteFailed": "UUID konnte nicht gelöscht werden",
+    "uuidDeleteSuccess": "UUID erfolgreich gelöscht!",
+    "modsDownloading": "{name} wird heruntergeladen...",
+    "modsTogglingMod": "Mod wird umgeschaltet...",
+    "modsDeletingMod": "Mod wird gelöscht...",
+    "modsLoadingMods": "Mods von CurseForge werden geladen...",
+    "modsInstalledSuccess": "{name} erfolgreich installiert! 🎉",
+    "modsDeletedSuccess": "{name} erfolgreich gelöscht",
+    "modsDownloadFailed": "Mod konnte nicht heruntergeladen werden: {error}",
+    "modsToggleFailed": "Mod konnte nicht umgeschaltet werden: {error}",
+    "modsDeleteFailed": "Mod konnte nicht gelöscht werden: {error}",
+    "modsModNotFound": "Mod-Informationen nicht gefunden",
+    "hwAccelSaved": "Hardware-Beschleunigungseinstellung gespeichert",
+    "hwAccelSaveFailed": "Hardware-Beschleunigungseinstellung konnte nicht gespeichert werden"
+  },
+  "confirm": {
+    "defaultTitle": "Aktion bestätigen",
+    "regenerateUuidTitle": "Neue UUID generieren",
+    "regenerateUuidMessage": "Möchtest du wirklich eine neue UUID generieren? Dies ändert deine Spieleridentität.",
+    "regenerateUuidButton": "Generieren",
+    "setCustomUuidTitle": "Benutzerdefinierte UUID festlegen",
+    "setCustomUuidMessage": "Möchtest du wirklich diese benutzerdefinierte UUID festlegen? Dies ändert deine Spieleridentität.",
+    "setCustomUuidButton": "UUID festlegen",
+    "deleteUuidTitle": "UUID löschen",
+    "deleteUuidMessage": "Möchtest du wirklich die UUID für \"{username}\" löschen? Diese Aktion kann nicht rückgängig gemacht werden.",
+    "deleteUuidButton": "Löschen",
+    "uninstallGameTitle": "Spiel deinstallieren",
+    "uninstallGameMessage": "Möchtest du Hytale wirklich deinstallieren? Alle Spieldateien werden gelöscht.",
+    "uninstallGameButton": "Deinstallieren"
+  },
+  "progress": {
+    "initializing": "Initialisiere...",
+    "downloading": "Lädt herunter...",
+    "installing": "Installiere...",
+    "extracting": "Entpacke...",
+    "verifying": "Überprüfe...",
+    "switchingProfile": "Profil wird gewechselt...",
+    "profileSwitched": "Profil gewechselt!",
+    "startingGame": "Spiel wird gestartet...",
+    "launching": "STARTET...",
+    "uninstallingGame": "Spiel wird deinstalliert...",
+    "gameUninstalled": "Spiel erfolgreich deinstalliert!",
+    "uninstallFailed": "Deinstallation fehlgeschlagen: {error}",
+    "startingUpdate": "Obligatorisches Spiel-Update wird gestartet...",
+    "installationComplete": "Installation erfolgreich abgeschlossen!",
+    "installationFailed": "Installation fehlgeschlagen: {error}",
+    "installingGameFiles": "Spieldateien werden installiert...",
+    "installComplete": "Installation abgeschlossen!"
+  }
+}

GUI/locales/en.json

@@ -15,6 +15,9 @@
     "title": "FREE TO PLAY LAUNCHER",
     "playerName": "Player Name",
     "playerNamePlaceholder": "Enter your name",
+    "gameBranch": "Game Version",
+    "releaseVersion": "Release (Stable)",
+    "preReleaseVersion": "Pre-Release (Experimental)",
     "customInstallation": "Custom Installation",
     "installationFolder": "Installation Folder",
     "pathPlaceholder": "Default location",
@@ -54,7 +57,9 @@
     "noDescription": "No description available",
     "confirmDelete": "Are you sure you want to delete \"{name}\"?",
     "confirmDeleteDesc": "This action cannot be undone.",
-    "confirmDeletion": "Confirm Deletion"
+    "confirmDeletion": "Confirm Deletion",
+    "apiKeyRequired": "API Key Required",
+    "apiKeyRequiredDesc": "CurseForge API key is needed to browse mods"
   },
   "news": {
     "title": "ALL NEWS",
@@ -114,7 +119,7 @@
     "repairGame": "Repair Game",
     "reinstallGame": "Reinstall game files (preserves data)",
     "gpuPreference": "GPU Preference",
-    "gpuHint": "Select your preferred GPU (Linux: affects DRI_PRIME)",
+    "gpuHint": "Laptop-only feature; set to Integrated if on PC",
     "gpuAuto": "Auto",
     "gpuIntegrated": "Integrated",
     "gpuDedicated": "Dedicated",
@@ -125,7 +130,18 @@
     "logsLoading": "Loading logs...",
     "closeLauncher": "Launcher Behavior",
     "closeOnStart": "Close Launcher on game start",
-    "closeOnStartDescription": "Automatically close the launcher after Hytale has launched"
+    "closeOnStartDescription": "Automatically close the launcher after Hytale has launched",
+    "hwAccel": "Hardware Acceleration",
+    "hwAccelDescription": "Enable hardware acceleration for the launcher",
+    "gameBranch": "Game Branch",
+    "branchRelease": "Release",
+    "branchPreRelease": "Pre-Release",
+    "branchHint": "Switch between stable release and experimental pre-release versions",
+    "branchWarning": "Changing branch will download and install a different game version",
+    "branchSwitching": "Switching to {branch}...",
+    "branchSwitched": "Switched to {branch} successfully!",
+    "installRequired": "Installation Required",
+    "branchInstallConfirm": "The game will be installed for the {branch} branch. Continue?"
   },
   "uuid": {
     "modalTitle": "UUID Management",
@@ -157,7 +173,8 @@
     "delete": "Delete",
     "edit": "Edit",
     "loading": "Loading...",
-    "apply": "Apply"
+    "apply": "Apply",
+    "install": "Install"
   },
   "notifications": {
     "gameDataNotFound": "Error: Game data not found",
@@ -192,7 +209,9 @@
     "modsDownloadFailed": "Failed to download mod: {error}",
     "modsToggleFailed": "Failed to toggle mod: {error}",
     "modsDeleteFailed": "Failed to delete mod: {error}",
-    "modsModNotFound": "Mod information not found"
+    "modsModNotFound": "Mod information not found",
+    "hwAccelSaved": "Hardware acceleration setting saved",
+    "hwAccelSaveFailed": "Failed to save hardware acceleration setting"
   },
   "confirm": {
     "defaultTitle": "Confirm action",

GUI/locales/es-ES.json

@@ -15,6 +15,9 @@
     "title": "LAUNCHER GRATUITO",
     "playerName": "Nombre del Jugador",
     "playerNamePlaceholder": "Ingresa tu nombre",
+    "gameBranch": "Versión del Juego",
+    "releaseVersion": "Lanzamiento (Estable)",
+    "preReleaseVersion": "Pre-Lanzamiento (Experimental)",
     "customInstallation": "Instalación Personalizada",
     "installationFolder": "Carpeta de Instalación",
     "pathPlaceholder": "Ubicación predeterminada",
@@ -54,7 +57,9 @@
     "noDescription": "Sin descripción disponible",
     "confirmDelete": "¿Estás seguro de que quieres eliminar \"{name}\"?",
     "confirmDeleteDesc": "Esta acción no se puede deshacer.",
-    "confirmDeletion": "Confirmar eliminación"
+    "confirmDeletion": "Confirmar eliminación",
+    "apiKeyRequired": "Clave API Requerida",
+    "apiKeyRequiredDesc": "Se necesita una clave API de CurseForge para explorar mods"
   },
   "news": {
     "title": "TODAS LAS NOTICIAS",
@@ -114,7 +119,7 @@
     "repairGame": "Reparar juego",
     "reinstallGame": "Reinstalar archivos del juego (conserva los datos)",
     "gpuPreference": "Preferencia de GPU",
-    "gpuHint": "Selecciona tu GPU preferida (Linux: afecta DRI_PRIME)",
+    "gpuHint": "Función exclusiva para computadora portátil; configúrela como Integrada si está en una PC",
     "gpuAuto": "Automático",
     "gpuIntegrated": "Integrada",
     "gpuDedicated": "Dedicada",
@@ -125,7 +130,18 @@
     "logsLoading": "Cargando registros...",
     "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"
+    "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",
+    "branchHint": "Cambia entre la versión estable y la versión experimental de pre-lanzamiento",
+    "branchWarning": "Cambiar de rama descargará e instalará una versión diferente del juego",
+    "branchSwitching": "Cambiando a {branch}...",
+    "branchSwitched": "¡Cambiado a {branch} con éxito!",
+    "installRequired": "Instalación Requerida",
+    "branchInstallConfirm": "El juego se instalará para la rama {branch}. ¿Continuar?"
   },
   "uuid": {
     "modalTitle": "Gestión de UUID",
@@ -157,7 +173,8 @@
     "delete": "Eliminar",
     "edit": "Editar",
     "loading": "Cargando...",
-    "apply": "Aplicar"
+    "apply": "Aplicar",
+    "install": "Instalar"
   },
   "notifications": {
     "gameDataNotFound": "Error: No se encontraron datos del juego",
@@ -192,7 +209,9 @@
     "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"
+    "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"
   },
   "confirm": {
     "defaultTitle": "Confirmar acción",

GUI/locales/fr-FR.json

@@ -0,0 +1,250 @@
+{
+  "nav": {
+    "play": "Jouer",
+    "mods": "Mods",
+    "news": "Actualités",
+    "chat": "Chat Joueurs",
+    "settings": "Paramètres"
+  },
+  "header": {
+    "playersLabel": "Joueurs:",
+    "manageProfiles": "Gérer les Profils",
+    "defaultProfile": "Par défaut"
+  },
+  "install": {
+    "title": "LAUNCHER GRATUIT",
+    "playerName": "Nom du Joueur",
+    "playerNamePlaceholder": "Entrez votre nom",
+    "gameBranch": "Version du Jeu",
+    "releaseVersion": "Release (Stable)",
+    "preReleaseVersion": "Pré-Release (Expérimental)",
+    "customInstallation": "Installation Personnalisée",
+    "installationFolder": "Dossier d'Installation",
+    "pathPlaceholder": "Emplacement par défaut",
+    "browse": "Parcourir",
+    "installButton": "INSTALLER HYTALE",
+    "installing": "INSTALLATION..."
+  },
+  "play": {
+    "ready": "PRÊT À JOUER",
+    "subtitle": "Lancez Hytale et entrez dans l'aventure",
+    "playButton": "JOUER À HYTALE",
+    "latestNews": "DERNIÈRES ACTUALITÉS",
+    "viewAll": "VOIR TOUT",
+    "checking": "VÉRIFICATION...",
+    "play": "JOUER"
+  },
+  "mods": {
+    "searchPlaceholder": "Rechercher des mods...",
+    "myMods": "MES MODS",
+    "previous": "PRÉCÉDENT",
+    "next": "SUIVANT",
+    "page": "Page",
+    "of": "sur",
+    "modalTitle": "MES MODS",
+    "noModsFound": "Aucun Mod Trouvé",
+    "noModsFoundDesc": "Essayez d'ajuster votre recherche",
+    "noModsInstalled": "Aucun Mod Installé",
+    "noModsInstalledDesc": "Ajoutez des mods depuis CurseForge ou importez des fichiers locaux",
+    "view": "VOIR",
+    "install": "INSTALLER",
+    "installed": "INSTALLÉ",
+    "enable": "ACTIVER",
+    "disable": "DÉSACTIVER",
+    "active": "ACTIF",
+    "disabled": "DÉSACTIVÉ",
+    "delete": "Supprimer le mod",
+    "noDescription": "Aucune description disponible",
+    "confirmDelete": "Êtes-vous sûr de vouloir supprimer \"{name}\" ?",
+    "confirmDeleteDesc": "Cette action est irréversible.",
+    "confirmDeletion": "Confirmer la Suppression",
+    "apiKeyRequired": "Clé API Requise",
+    "apiKeyRequiredDesc": "Une clé API CurseForge est nécessaire pour parcourir les mods"
+  },
+  "news": {
+    "title": "TOUTES LES ACTUALITÉS",
+    "readMore": "Lire Plus"
+  },
+  "chat": {
+    "title": "CHAT JOUEURS",
+    "pickColor": "Couleur",
+    "inputPlaceholder": "Tapez votre message...",
+    "send": "Envoyer",
+    "online": "en ligne",
+    "charCounter": "{current}/{max}",
+    "secureChat": "Chat sécurisé - Les liens sont censurés",
+    "joinChat": "Rejoindre le Chat",
+    "chooseUsername": "Choisissez un nom d'utilisateur pour rejoindre le Chat Joueurs",
+    "username": "Nom d'utilisateur",
+    "usernamePlaceholder": "Entrez votre nom d'utilisateur...",
+    "usernameHint": "3-20 caractères, lettres, chiffres, - et _ uniquement",
+    "joinButton": "Rejoindre le Chat",
+    "colorModal": {
+      "title": "Personnaliser la Couleur du Nom",
+      "chooseSolid": "Choisissez une couleur unie:",
+      "customColor": "Couleur personnalisée:",
+      "preview": "Aperçu:",
+      "previewUsername": "Nom d'utilisateur",
+      "apply": "Appliquer la Couleur"
+    }
+  },
+  "settings": {
+    "title": "PARAMÈTRES",
+    "java": "Java Runtime",
+    "useCustomJava": "Utiliser un Chemin Java Personnalisé",
+    "javaDescription": "Remplacer le Java intégré par votre propre installation",
+    "javaPath": "Chemin de l'Exécutable Java",
+    "javaPathPlaceholder": "Sélectionnez le chemin Java...",
+    "javaBrowse": "Parcourir",
+    "javaHint": "Sélectionnez le dossier d'installation de Java (compatible Windows, Mac, Linux)",
+    "discord": "Intégration Discord",
+    "enableRPC": "Activer Discord Rich Presence",
+    "discordDescription": "Afficher votre activité du launcher sur Discord",
+    "game": "Options de Jeu",
+    "playerName": "Nom du Joueur",
+    "playerNamePlaceholder": "Entrez le nom du joueur",
+    "playerNameHint": "Ce nom sera utilisé en jeu (1-16 caractères)",
+    "openGameLocation": "Ouvrir l'Emplacement du Jeu",
+    "openGameLocationDesc": "Ouvrir le dossier d'installation du jeu",
+    "account": "Gestion UUID Joueur",
+    "currentUUID": "UUID Actuel",
+    "uuidPlaceholder": "Chargement UUID...",
+    "copyUUID": "Copier UUID",
+    "regenerateUUID": "Régénérer UUID",
+    "uuidHint": "Votre identifiant unique de joueur pour ce nom d'utilisateur",
+    "manageUUIDs": "Gérer Tous les UUIDs",
+    "manageUUIDsDesc": "Voir et gérer tous les UUIDs de joueurs",
+    "language": "Langue",
+    "selectLanguage": "Sélectionner la Langue",
+    "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",
+    "gpuAuto": "Auto",
+    "gpuIntegrated": "Intégré",
+    "gpuDedicated": "Dédié",
+    "logs": "JOURNAUX SYSTÈME",
+    "logsCopy": "Copier",
+    "logsRefresh": "Actualiser",
+    "logsFolder": "Ouvrir le Dossier",
+    "logsLoading": "Chargement des journaux...",
+    "closeLauncher": "Comportement du Launcher",
+    "closeOnStart": "Fermer le Launcher au démarrage du jeu",
+    "closeOnStartDescription": "Fermer automatiquement le launcher après le lancement d'Hytale",
+    "hwAccel": "Accélération Matérielle",
+    "hwAccelDescription": "Activer l'accélération matérielle pour le launcher",
+    "gameBranch": "Branche du Jeu",
+    "branchRelease": "Release",
+    "branchPreRelease": "Pré-Release",
+    "branchHint": "Basculer entre la version stable release et la pré-release expérimentale",
+    "branchWarning": "Changer de branche téléchargera et installera une version différente du jeu",
+    "branchSwitching": "Passage à {branch}...",
+    "branchSwitched": "Passage à {branch} réussi!",
+    "installRequired": "Installation Requise",
+    "branchInstallConfirm": "Le jeu sera installé pour la branche {branch}. Continuer?"
+  },
+  "uuid": {
+    "modalTitle": "Gestion UUID",
+    "currentUserUUID": "UUID Utilisateur Actuel",
+    "allPlayerUUIDs": "Tous les UUIDs Joueurs",
+    "generateNew": "Générer Nouvel UUID",
+    "loadingUUIDs": "Chargement des UUIDs...",
+    "setCustomUUID": "Définir UUID Personnalisé",
+    "customPlaceholder": "Entrez UUID personnalisé (format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)",
+    "setUUID": "Définir UUID",
+    "warning": "Attention: Définir un UUID personnalisé changera votre identité de joueur actuelle",
+    "copyTooltip": "Copier UUID",
+    "regenerateTooltip": "Générer Nouvel UUID"
+  },
+  "profiles": {
+    "modalTitle": "Gérer les Profils",
+    "newProfilePlaceholder": "Nom du Nouveau Profil",
+    "createProfile": "Créer un Profil"
+  },
+  "discord": {
+    "notificationText": "Rejoignez notre communauté Discord!",
+    "joinButton": "Rejoindre Discord"
+  },
+  "common": {
+    "confirm": "Confirmer",
+    "cancel": "Annuler",
+    "save": "Sauvegarder",
+    "close": "Fermer",
+    "delete": "Supprimer",
+    "edit": "Modifier",
+    "loading": "Chargement...",
+    "apply": "Appliquer",
+    "install": "Installer"
+  },
+  "notifications": {
+    "gameDataNotFound": "Erreur: Données du jeu introuvables",
+    "gameUpdatedSuccess": "Jeu mis à jour avec succès! 🎉",
+    "updateFailed": "Mise à jour échouée: {error}",
+    "updateError": "Erreur de mise à jour: {error}",
+    "discordEnabled": "Discord Rich Presence activé",
+    "discordDisabled": "Discord Rich Presence désactivé",
+    "discordSaveFailed": "Échec de la sauvegarde des paramètres Discord",
+    "playerNameRequired": "Veuillez entrer un nom de joueur valide",
+    "playerNameSaved": "Nom du joueur sauvegardé avec succès",
+    "playerNameSaveFailed": "Échec de la sauvegarde du nom du joueur",
+    "uuidCopied": "UUID copié dans le presse-papiers!",
+    "uuidCopyFailed": "Échec de la copie de l'UUID",
+    "uuidRegenNotAvailable": "Régénération UUID non disponible",
+    "uuidRegenFailed": "Échec de la régénération de l'UUID",
+    "uuidGenerated": "Nouvel UUID généré avec succès!",
+    "uuidGeneratedShort": "Nouvel UUID généré!",
+    "uuidGenerateFailed": "Échec de la génération du nouvel UUID",
+    "uuidRequired": "Veuillez entrer un UUID",
+    "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!"
+  }
+}

GUI/locales/id-ID.json

@@ -0,0 +1,250 @@
+{
+  "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

@@ -0,0 +1,250 @@
+{
+  "nav": {
+    "play": "Graj",
+    "mods": "Mody",
+    "news": "Wiadomości",
+    "chat": "Chat z graczami",
+    "settings": "Ustawienia"
+  },
+  "header": {
+    "playersLabel": "Graczy:",
+    "manageProfiles": "Zarządzaj Profilami",
+    "defaultProfile": "Domyślny"
+  },
+  "install": {
+    "title": "DARMOWY 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",
+    "browse": "Przeglądaj",
+    "installButton": "ZAINSTALUJ HYTALE",
+    "installing": "INSTALOWANIE..."
+  },
+  "play": {
+    "ready": "GOTOWE",
+    "subtitle": "Uruchom Hytale i rozpocznij przygodę",
+    "playButton": "GRAJ W HYTALE",
+    "latestNews": "NAJNOWSZE WIADOMOŚCI",
+    "viewAll": "ZOBACZ CAŁOŚĆ",
+    "checking": "SPRAWDZANIE...",
+    "play": "GRAJ"
+  },
+  "mods": {
+    "searchPlaceholder": "Wyszukaj mody...",
+    "myMods": "MOJE MODY",
+    "previous": "POPRZEDNIA",
+    "next": "NASTĘPNA",
+    "page": "Strona",
+    "of": "z",
+    "modalTitle": "MOJE MODY",
+    "noModsFound": "Nie Znaleziono Modów",
+    "noModsFoundDesc": "Spróbuj dostosować wyszukiwanie",
+    "noModsInstalled": "Brak Zainstalowanych Modów",
+    "noModsInstalledDesc": "Dodaj mody z CurseForge lub zaimportuj lokalne pliki",
+    "view": "WIDOK",
+    "install": "ZAINSTALUJ",
+    "installed": "ZAINSTALOWANE",
+    "enable": "WŁĄCZ",
+    "disable": "WYŁĄCZ",
+    "active": "AKTYWNE",
+    "disabled": "WYŁĄCZONE",
+    "delete": "Usuń mod",
+    "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"
+  },
+  "news": {
+    "title": "WSZYSTKIE WIADOMOŚCI",
+    "readMore": "Zobacz Więcej"
+  },
+  "chat": {
+    "title": "Chat z graczami",
+    "pickColor": "Kolor",
+    "inputPlaceholder": "Wprowadź swoją wiadomość...",
+    "send": "Wyślij",
+    "online": "online",
+    "charCounter": "{current}/{max}",
+    "secureChat": "Bezpieczny czat – Linki są ocenzurowane",
+    "joinChat": "Dołącz do Czatu",
+    "chooseUsername": "Wybierz nazwę użytkownika, aby dołączyć do Czatu z graczami",
+    "username": "Nazwa Gracza",
+    "usernamePlaceholder": "Wprowadź swoją nazwę...",
+    "usernameHint": "Między 3-20 znaków, tylko litery, cyfry i znaki - i _",
+    "joinButton": "Dołącz do Czatu",
+    "colorModal": {
+      "title": "Dostosuj Kolor Użytkownika",
+      "chooseSolid": "Wybierz jednolity kolor:",
+      "customColor": "Kolor niestandardowy:",
+      "preview": "Podgląd:",
+      "previewUsername": "Nazwa",
+      "apply": "Zastosuj Kolor"
+    }
+  },
+  "settings": {
+    "title": "USTAWIENIA",
+    "java": "Środowisko Java",
+    "useCustomJava": "Użyj niestandardowej ścieżki Java",
+    "javaDescription": "Zastąp dołączone środowisko wykonawcze Java własnym",
+    "javaPath": "Ścieżka Wykonywalna Java",
+    "javaPathPlaceholder": "Wybierz ścieżkę Java...",
+    "javaBrowse": "Przeglądaj",
+    "javaHint": "Wybierz folder instalacyjny Java (obsługiwane Windows, Mac, Linux)",
+    "discord": "Integracja z Discordem",
+    "enableRPC": "Włącz Discord Rich Presence",
+    "discordDescription": "Pokaż swoją aktywność na Discordzie",
+    "game": "Opcje gry",
+    "playerName": "Nazwa Gracza",
+    "playerNamePlaceholder": "Wprowadź swoją nazwę",
+    "playerNameHint": "Ta nazwa będzie używana w grze (1-16 znaków)",
+    "openGameLocation": "Otwórz Lokalizację Gry",
+    "openGameLocationDesc": "Otwórz folder instalacyjny gry",
+    "account": "Zarządzanie identyfikatorami UUID gracza",
+    "currentUUID": "Obecny UUID",
+    "uuidPlaceholder": "Ładowanie UUID...",
+    "copyUUID": "Skopiuj UUID",
+    "regenerateUUID": "Generuj UUID",
+    "uuidHint": "Twój unikalny identyfikator gracza dla tej nazwy użytkownika",
+    "manageUUIDs": "Zarządzaj wszystkimi UUID",
+    "manageUUIDsDesc": "Wyświetl i zarządzaj wszystkimi identyfikatorami UUID graczy",
+    "language": "Język",
+    "selectLanguage": "Wybierz Język",
+    "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",
+    "gpuAuto": "Auto",
+    "gpuIntegrated": "Zintegrowana",
+    "gpuDedicated": "Dedykowana",
+    "logs": "DZIENNIKI SYSTEMOWE",
+    "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ć?"
+  },
+  "uuid": {
+    "modalTitle": "Zarządzanie UUID",
+    "currentUserUUID": "Aktualny UUID użytkownika",
+    "allPlayerUUIDs": "Wszystkie identyfikatory UUID graczy",
+    "generateNew": "Wygeneruj nowy UUID",
+    "loadingUUIDs": "Ładowanie UUID...",
+    "setCustomUUID": "Ustaw niestandardowy UUID",
+    "customPlaceholder": "Wprowadź niestandardowy UUID (format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)",
+    "setUUID": "Ustaw UUID",
+    "warning": "Ostrzeżenie: Ustawienie niestandardowego identyfikatora UUID spowoduje zmianę Twojego obecnego identyfikatora gracza",
+    "copyTooltip": "Kopiuj UUID",
+    "regenerateTooltip": "Wygeneruj nowy UUID"
+  },
+  "profiles": {
+    "modalTitle": "Zarządzaj Profilami",
+    "newProfilePlaceholder": "Nowa Nazwa Profilu",
+    "createProfile": "Utwórz Profil"
+  },
+  "discord": {
+    "notificationText": "Dołącz do naszej społeczności Discord!",
+    "joinButton": "Dołącz Discord"
+  },
+  "common": {
+    "confirm": "Potwierdź",
+    "cancel": "Anuluj",
+    "save": "Zapisz",
+    "close": "Zamknij",
+    "delete": "Usuń",
+    "edit": "Edytuj",
+    "loading": "Ładowanie...",
+    "apply": "Zastosuj",
+    "install": "Zainstaluj"
+  },
+  "notifications": {
+    "gameDataNotFound": "Błąd: Nie znaleziono danych gry",
+    "gameUpdatedSuccess": "Gra została zaktualizowana pomyślnie! 🎉",
+    "updateFailed": "Aktualizacja nie powiodła się: {error}",
+    "updateError": "Błąd aktualizacji: {error}",
+    "discordEnabled": "Discord Rich Presence włączony",
+    "discordDisabled": "Discord Rich Presence wyłączony",
+    "discordSaveFailed": "Nie udało się zapisać ustawień Discorda",
+    "playerNameRequired": "Proszę podać prawidłową nazwę gracza",
+    "playerNameSaved": "Nazwa gracza została zapisana pomyślnie",
+    "playerNameSaveFailed": "Nie udało się zapisać nazwy gracza",
+    "uuidCopied": "Identyfikator UUID skopiowany do schowka!",
+    "uuidCopyFailed": "Nie udało się skopiować UUID",
+    "uuidRegenNotAvailable": "Ponowna gerowanie UUID niedostępne",
+    "uuidRegenFailed": "Nie udało się ponownie wygenerować UUID",
+    "uuidGenerated": "Nowy UUID został pomyślnie wygenerowany!",
+    "uuidGeneratedShort": "Wygenerowano nowy UUID!",
+    "uuidGenerateFailed": "Nie udało się wygenerować nowego UUID",
+    "uuidRequired": "Wprowadzić UUID",
+    "uuidInvalidFormat": "Nieprawidłowy format UUID",
+    "uuidSetFailed": "Nie udało się ustawić niestandardowego UUID",
+    "uuidSetSuccess": "Niestandardowy UUID został ustawiony pomyślnie!",
+    "uuidDeleteFailed": "Nie udało się usunąć UUID",
+    "uuidDeleteSuccess": "UUID został pomyślnie usunięty!",
+    "modsDownloading": "Pobieranie {name}...",
+    "modsTogglingMod": "Przełączanie moda...",
+    "modsDeletingMod": "Usuwanie moda...",
+    "modsLoadingMods": "Ładowanie modów z CurseForge...",
+    "modsInstalledSuccess": "{name} zainstalowany pomyślnie! 🎉",
+    "modsDeletedSuccess": "{name} usunięto pomyślnie",
+    "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"
+  },
+  "confirm": {
+    "defaultTitle": "Potwierdź działanie",
+    "regenerateUuidTitle": "Wygeneruj nowy UUID",
+    "regenerateUuidMessage": "Czy na pewno chcesz wygenerować nowy UUID? To spowoduje zmianę Twojego identyfikatora gracza.",
+    "regenerateUuidButton": "Generuj",
+    "setCustomUuidTitle": "Ustaw niestandardowy UUID",
+    "setCustomUuidMessage": "Czy na pewno chcesz ustawić ten UUID? To spowoduje zmianę Twojego identyfikatora gracza.",
+    "setCustomUuidButton": "Ustaw UUID",
+    "deleteUuidTitle": "Usuń UUID",
+    "deleteUuidMessage": "Czy na pewno chcesz usunąć UUID dla \"{username}\"? Tej czynności nie można cofnąć.",
+    "deleteUuidButton": "Usuń",
+    "uninstallGameTitle": "Odinstaluj grę",
+    "uninstallGameMessage": "Czy na pewno chcesz odinstalować Hytale? Wszystkie pliki gry zostaną usunięte.",
+    "uninstallGameButton": "Odinstaluj"
+  },
+  "progress": {
+    "initializing": "Inicjalizacja...",
+    "downloading": "Pobieranie...",
+    "installing": "Instalowanie...",
+    "extracting": "Ekstraktowanie...",
+    "verifying": "Weryfikowanie...",
+    "switchingProfile": "Przełączanie profilu...",
+    "profileSwitched": "Profil zmieniony!",
+    "startingGame": "Uruchamianie gry...",
+    "launching": "URUCHAMIANIE...",
+    "uninstallingGame": "Odinstalowywanie gry...",
+    "gameUninstalled": "Gra została pomyślnie odinstalowana!",
+    "uninstallFailed": "Odinstalowanie nie powiodło się: {error}",
+    "startingUpdate": "Rozpoczynanie obowiązkowej aktualizacji gry...",
+    "installationComplete": "Instalacja zakończona pomyślnie!",
+    "installationFailed": "Instalacja nie powiodła się: {error}",
+    "installingGameFiles": "Instalowanie plików gry...",
+    "installComplete": "Instalacja zakończona!"
+  }
+}

GUI/locales/pt-BR.json

@@ -15,6 +15,9 @@
     "title": "LANÇADOR JOGO GRATUITO",
     "playerName": "Nome do Jogador",
     "playerNamePlaceholder": "Digite seu nome",
+    "gameBranch": "Versão do Jogo",
+    "releaseVersion": "Lançamento (Estável)",
+    "preReleaseVersion": "Pré-Lançamento (Experimental)",
     "customInstallation": "Instalação Personalizada",
     "installationFolder": "Pasta de Instalação",
     "pathPlaceholder": "Local padrão",
@@ -54,7 +57,9 @@
     "noDescription": "Nenhuma descrição disponível",
     "confirmDelete": "Tem certeza de que deseja excluir \"{name}\"?",
     "confirmDeleteDesc": "Esta ação não pode ser desfeita.",
-    "confirmDeletion": "Confirmar exclusão"
+    "confirmDeletion": "Confirmar exclusão",
+    "apiKeyRequired": "Chave de API Necessária",
+    "apiKeyRequiredDesc": "Chave de API do CurseForge é necessária para procurar mods"
   },
   "news": {
     "title": "TODAS AS NOTÍCIAS",
@@ -114,7 +119,7 @@
     "repairGame": "Reparar jogo",
     "reinstallGame": "Reinstalar arquivos do jogo (mantém os dados)",
     "gpuPreference": "Preferência de GPU",
-    "gpuHint": "Selecione sua GPU preferida (Linux: afeta o DRI_PRIME)",
+    "gpuHint": "Recurso exclusivo para laptops; defina como Integrado se estiver em um PC.",
     "gpuAuto": "Automático",
     "gpuIntegrated": "Integrada",
     "gpuDedicated": "Dedicada",
@@ -125,7 +130,18 @@
     "logsLoading": "Carregando registros...",
     "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"
+    "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",
+    "branchHint": "Alterne entre a versão estável e a versão experimental de pré-lançamento",
+    "branchWarning": "Mudar de versão irá baixar e instalar uma versão diferente do jogo",
+    "branchSwitching": "Mudando para {branch}...",
+    "branchSwitched": "Mudado para {branch} com sucesso!",
+    "installRequired": "Instalação Necessária",
+    "branchInstallConfirm": "O jogo será instalado para o ramo {branch}. Continuar?"
   },
   "uuid": {
     "modalTitle": "Gerenciamento de UUID",
@@ -149,7 +165,6 @@
     "notificationText": "Junte-se à nossa comunidade do Discord!",
     "joinButton": "Entrar no Discord"
   },
-
   "common": {
     "confirm": "Confirmar",
     "cancel": "Cancelar",
@@ -158,7 +173,8 @@
     "delete": "Excluir",
     "edit": "Editar",
     "loading": "Carregando...",
-    "apply": "Aplicar"
+    "apply": "Aplicar",
+    "install": "Instalar"
   },
   "notifications": {
     "gameDataNotFound": "Erro: Dados do jogo não encontrados",
@@ -193,7 +209,9 @@
     "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"
+    "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"
   },
   "confirm": {
     "defaultTitle": "Confirmar ação",

GUI/locales/ru-RU.json

@@ -0,0 +1,250 @@
+{
+  "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-SE.json

@@ -0,0 +1,250 @@
+{
+  "nav": {
+    "play": "Spela",
+    "mods": "Moddar",
+    "news": "Nyheter",
+    "chat": "Spelarchatt",
+    "settings": "Inställningar"
+  },
+  "header": {
+    "playersLabel": "Spelare:",
+    "manageProfiles": "Hantera profiler",
+    "defaultProfile": "Standard"
+  },
+  "install": {
+    "title": "GRATIS LAUNCHER",
+    "playerName": "Spelarnamn",
+    "playerNamePlaceholder": "Ange ditt namn",
+    "gameBranch": "Spelversion",
+    "releaseVersion": "Release (Stabil)",
+    "preReleaseVersion": "Pre-Release (Experimentell)",
+    "customInstallation": "Anpassad installation",
+    "installationFolder": "Installationsmapp",
+    "pathPlaceholder": "Standardplats",
+    "browse": "Bläddra",
+    "installButton": "INSTALLERA HYTALE",
+    "installing": "INSTALLERAR..."
+  },
+  "play": {
+    "ready": "REDO ATT SPELA",
+    "subtitle": "Starta Hytale och börja äventyret",
+    "playButton": "SPELA HYTALE",
+    "latestNews": "SENASTE NYHETERNA",
+    "viewAll": "VISA ALLA",
+    "checking": "KONTROLLERAR...",
+    "play": "SPELA"
+  },
+  "mods": {
+    "searchPlaceholder": "Sök moddar...",
+    "myMods": "MINA MODDAR",
+    "previous": "FÖREGÅENDE",
+    "next": "NÄSTA",
+    "page": "Sida",
+    "of": "av",
+    "modalTitle": "MINA MODDAR",
+    "noModsFound": "Inga moddar hittades",
+    "noModsFoundDesc": "Försök justera din sökning",
+    "noModsInstalled": "Inga moddar installerade",
+    "noModsInstalledDesc": "Lägg till moddar från CurseForge eller importera lokala filer",
+    "view": "VISA",
+    "install": "INSTALLERA",
+    "installed": "INSTALLERAD",
+    "enable": "AKTIVERA",
+    "disable": "INAKTIVERA",
+    "active": "AKTIV",
+    "disabled": "INAKTIVERAD",
+    "delete": "Ta bort modd",
+    "noDescription": "Ingen beskrivning tillgänglig",
+    "confirmDelete": "Är du säker på att du vill ta bort \"{name}\"?",
+    "confirmDeleteDesc": "Denna åtgärd kan inte ångras.",
+    "confirmDeletion": "Bekräfta borttagning",
+    "apiKeyRequired": "API-nyckel krävs",
+    "apiKeyRequiredDesc": "CurseForge API-nyckel behövs för att bläddra bland moddar"
+  },
+  "news": {
+    "title": "ALLA NYHETER",
+    "readMore": "Läs mer"
+  },
+  "chat": {
+    "title": "SPELARCHATT",
+    "pickColor": "Färg",
+    "inputPlaceholder": "Skriv ditt meddelande...",
+    "send": "Skicka",
+    "online": "online",
+    "charCounter": "{current}/{max}",
+    "secureChat": "Säker chatt - Länkar är censurerade",
+    "joinChat": "Gå med i chatten",
+    "chooseUsername": "Välj ett användarnamn för att gå med i spelarchartten",
+    "username": "Användarnamn",
+    "usernamePlaceholder": "Ange ditt användarnamn...",
+    "usernameHint": "3-20 tecken, endast bokstäver, siffror, - och _",
+    "joinButton": "Gå med i chatten",
+    "colorModal": {
+      "title": "Anpassa användarnamnsfargen",
+      "chooseSolid": "Välj en enfärgad färg:",
+      "customColor": "Anpassad färg:",
+      "preview": "Förhandsvisning:",
+      "previewUsername": "Användarnamn",
+      "apply": "Använd färg"
+    }
+  },
+  "settings": {
+    "title": "INSTÄLLNINGAR",
+    "java": "Java Runtime",
+    "useCustomJava": "Använd anpassad Java-sökväg",
+    "javaDescription": "Ersätt den medföljande Java-installationen med din egen",
+    "javaPath": "Java-körbar fil-sökväg",
+    "javaPathPlaceholder": "Välj Java-sökväg...",
+    "javaBrowse": "Bläddra",
+    "javaHint": "Välj Java-installationsmappen (stöder Windows, Mac, Linux)",
+    "discord": "Discord-integration",
+    "enableRPC": "Aktivera Discord Rich Presence",
+    "discordDescription": "Visa din launcher-aktivitet på Discord",
+    "game": "Spelalternativ",
+    "playerName": "Spelarnamn",
+    "playerNamePlaceholder": "Ange spelarnamn",
+    "playerNameHint": "Detta namn kommer att användas i spelet (1-16 tecken)",
+    "openGameLocation": "Öppna spelplats",
+    "openGameLocationDesc": "Öppna spelinstallationsmappen",
+    "account": "Spelare UUID-hantering",
+    "currentUUID": "Nuvarande UUID",
+    "uuidPlaceholder": "Laddar UUID...",
+    "copyUUID": "Kopiera UUID",
+    "regenerateUUID": "Återskapa UUID",
+    "uuidHint": "Din unika spelaridentifierare för detta användarnamn",
+    "manageUUIDs": "Hantera alla UUID:er",
+    "manageUUIDsDesc": "Visa och hantera alla spelare-UUID:er",
+    "language": "Språk",
+    "selectLanguage": "Välj språk",
+    "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",
+    "gpuAuto": "Auto",
+    "gpuIntegrated": "Integrerad",
+    "gpuDedicated": "Dedikerad",
+    "logs": "SYSTEMLOGGAR",
+    "logsCopy": "Kopiera",
+    "logsRefresh": "Uppdatera",
+    "logsFolder": "Öppna mapp",
+    "logsLoading": "Laddar loggar...",
+    "closeLauncher": "Launcher-beteende",
+    "closeOnStart": "Stäng launcher vid spelstart",
+    "closeOnStartDescription": "Stäng automatiskt launcher efter att Hytale har startats",
+    "hwAccel": "Hårdvaruacceleration",
+    "hwAccelDescription": "Aktivera hårdvaruacceleration för launchern",
+    "gameBranch": "Spelgren",
+    "branchRelease": "Release",
+    "branchPreRelease": "Pre-Release",
+    "branchHint": "Växla mellan stabil release- och experimentell pre-release-version",
+    "branchWarning": "Att byta gren kommer att ladda ner och installera en annan spelversion",
+    "branchSwitching": "Byter till {branch}...",
+    "branchSwitched": "Bytte framgångsrikt till {branch}!",
+    "installRequired": "Installation krävs",
+    "branchInstallConfirm": "Spelet kommer att installeras för {branch}-grenen. Fortsätt?"
+  },
+  "uuid": {
+    "modalTitle": "UUID-hantering",
+    "currentUserUUID": "Nuvarande användar-UUID",
+    "allPlayerUUIDs": "Alla spelare-UUID:er",
+    "generateNew": "Generera ny UUID",
+    "loadingUUIDs": "Laddar UUID:er...",
+    "setCustomUUID": "Ange anpassad UUID",
+    "customPlaceholder": "Ange anpassad UUID (format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)",
+    "setUUID": "Ange UUID",
+    "warning": "Varning: Att ange en anpassad UUID kommer att ändra din nuvarande spelaridentitet",
+    "copyTooltip": "Kopiera UUID",
+    "regenerateTooltip": "Generera ny UUID"
+  },
+  "profiles": {
+    "modalTitle": "Hantera profiler",
+    "newProfilePlaceholder": "Nytt profilnamn",
+    "createProfile": "Skapa profil"
+  },
+  "discord": {
+    "notificationText": "Gå med i vår Discord-gemenskap!",
+    "joinButton": "Gå med i Discord"
+  },
+  "common": {
+    "confirm": "Bekräfta",
+    "cancel": "Avbryt",
+    "save": "Spara",
+    "close": "Stäng",
+    "delete": "Ta bort",
+    "edit": "Redigera",
+    "loading": "Laddar...",
+    "apply": "Verkställ",
+    "install": "Installera"
+  },
+  "notifications": {
+    "gameDataNotFound": "Fel: Speldata hittades inte",
+    "gameUpdatedSuccess": "Spelet uppdaterades framgångsrikt! 🎉",
+    "updateFailed": "Uppdatering misslyckades: {error}",
+    "updateError": "Uppdateringsfel: {error}",
+    "discordEnabled": "Discord Rich Presence aktiverad",
+    "discordDisabled": "Discord Rich Presence inaktiverad",
+    "discordSaveFailed": "Misslyckades med att spara Discord-inställning",
+    "playerNameRequired": "Ange ett giltigt spelarnamn",
+    "playerNameSaved": "Spelarnamn sparat framgångsrikt",
+    "playerNameSaveFailed": "Misslyckades med att spara spelarnamn",
+    "uuidCopied": "UUID kopierad till urklipp!",
+    "uuidCopyFailed": "Misslyckades med att kopiera UUID",
+    "uuidRegenNotAvailable": "UUID-återgenerering ej tillgänglig",
+    "uuidRegenFailed": "Misslyckades med att återgenerera UUID",
+    "uuidGenerated": "Ny UUID genererad framgångsrikt!",
+    "uuidGeneratedShort": "Ny UUID genererad!",
+    "uuidGenerateFailed": "Misslyckades med att generera ny UUID",
+    "uuidRequired": "Ange en UUID",
+    "uuidInvalidFormat": "Ogiltigt UUID-format",
+    "uuidSetFailed": "Misslyckades med att ange anpassad UUID",
+    "uuidSetSuccess": "Anpassad UUID angiven framgångsrikt!",
+    "uuidDeleteFailed": "Misslyckades med att ta bort UUID",
+    "uuidDeleteSuccess": "UUID borttagen framgångsrikt!",
+    "modsDownloading": "Laddar ner {name}...",
+    "modsTogglingMod": "Växlar modd...",
+    "modsDeletingMod": "Tar bort modd...",
+    "modsLoadingMods": "Laddar moddar från CurseForge...",
+    "modsInstalledSuccess": "{name} installerad framgångsrikt! 🎉",
+    "modsDeletedSuccess": "{name} borttagen framgångsrikt",
+    "modsDownloadFailed": "Misslyckades med att ladda ner modd: {error}",
+    "modsToggleFailed": "Misslyckades med att växla modd: {error}",
+    "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"
+  },
+  "confirm": {
+    "defaultTitle": "Bekräfta åtgärd",
+    "regenerateUuidTitle": "Generera ny UUID",
+    "regenerateUuidMessage": "Är du säker på att du vill generera en ny UUID? Detta kommer att ändra din spelaridentitet.",
+    "regenerateUuidButton": "Generera",
+    "setCustomUuidTitle": "Ange anpassad UUID",
+    "setCustomUuidMessage": "Är du säker på att du vill ange denna anpassade UUID? Detta kommer att ändra din spelaridentitet.",
+    "setCustomUuidButton": "Ange UUID",
+    "deleteUuidTitle": "Ta bort UUID",
+    "deleteUuidMessage": "Är du säker på att du vill ta bort UUID:n för \"{username}\"? Denna åtgärd kan inte ångras.",
+    "deleteUuidButton": "Ta bort",
+    "uninstallGameTitle": "Avinstallera spel",
+    "uninstallGameMessage": "Är du säker på att du vill avinstallera Hytale? Alla spelfiler kommer att tas bort.",
+    "uninstallGameButton": "Avinstallera"
+  },
+  "progress": {
+    "initializing": "Initierar...",
+    "downloading": "Laddar ner...",
+    "installing": "Installerar...",
+    "extracting": "Extraherar...",
+    "verifying": "Verifierar...",
+    "switchingProfile": "Byter profil...",
+    "profileSwitched": "Profil bytt!",
+    "startingGame": "Startar spel...",
+    "launching": "STARTAR...",
+    "uninstallingGame": "Avinstallerar spel...",
+    "gameUninstalled": "Spel avinstallerat framgångsrikt!",
+    "uninstallFailed": "Avinstallation misslyckades: {error}",
+    "startingUpdate": "Startar obligatorisk speluppdatering...",
+    "installationComplete": "Installation slutförd framgångsrikt!",
+    "installationFailed": "Installation misslyckades: {error}",
+    "installingGameFiles": "Installerar spelfiler...",
+    "installComplete": "Installation slutförd!"
+  }
+}

GUI/locales/tr-TR.json

@@ -0,0 +1,250 @@
+{
+  "nav": {
+    "play": "Oyna",
+    "mods": "Modlar",
+    "news": "Haberler",
+    "chat": "Oyuncu Sohbeti",
+    "settings": "Ayarlar"
+  },
+  "header": {
+    "playersLabel": "Oyuncular:",
+    "manageProfiles": "Profilleri Yönet",
+    "defaultProfile": "Varsayılan"
+  },
+  "install": {
+    "title": "ÜCRETSİZ OYNA BAŞLATICI",
+    "playerName": "Oyuncu Adı",
+    "playerNamePlaceholder": "Adınızı girin",
+    "gameBranch": "Oyun Sürümü",
+    "releaseVersion": "Yayın (Stabil)",
+    "preReleaseVersion": "Ön-Yayın (Deneysel)",
+    "customInstallation": "Özel Kurulum",
+    "installationFolder": "Kurulum Klasörü",
+    "pathPlaceholder": "Varsayılan konum",
+    "browse": "Gözat",
+    "installButton": "HYTALE KURU",
+    "installing": "KURULUYOR..."
+  },
+  "play": {
+    "ready": "OYNAMAYA HAZIR",
+    "subtitle": "Hytale'i başlat ve maceraya başla",
+    "playButton": "HYTALE'YI OYNA",
+    "latestNews": "SON HABERLER",
+    "viewAll": "HEPSINI GÖR",
+    "checking": "KONTROL EDİLİYOR...",
+    "play": "OYNA"
+  },
+  "mods": {
+    "searchPlaceholder": "Modları ara...",
+    "myMods": "BENİM MODLARIM",
+    "previous": "ÖNCEKİ",
+    "next": "SONRAKİ",
+    "page": "Sayfa",
+    "of": "nın",
+    "modalTitle": "BENİM MODLARIM",
+    "noModsFound": "Mod Bulunamadı",
+    "noModsFoundDesc": "Aramanızı ayarlamayı deneyin",
+    "noModsInstalled": "Hiçbir Mod Kurulu Değil",
+    "noModsInstalledDesc": "CurseForge'dan modlar ekleyin veya yerel dosyalar içe aktarın",
+    "view": "GÖR",
+    "install": "KURU",
+    "installed": "KURULU",
+    "enable": "ETKİNLEŞTİR",
+    "disable": "DEĞİ",
+    "active": "AKTİF",
+    "disabled": "DEĞİ",
+    "delete": "Modı sil",
+    "noDescription": "Açıklama yok",
+    "confirmDelete": "\"{name}\" öğesini silmek istediğinizden emin misiniz?",
+    "confirmDeleteDesc": "Bu işlem geri alınamaz.",
+    "confirmDeletion": "Silmeyi Onayla",
+    "apiKeyRequired": "API Anahtarı Gerekli",
+    "apiKeyRequiredDesc": "Modlara göz atmak için CurseForge API anahtarı gereklidir"
+  },
+  "news": {
+    "title": "TÜM HABERLER",
+    "readMore": "Daha Fazla Oku"
+  },
+  "chat": {
+    "title": "OYUNCU SOHBETI",
+    "pickColor": "Renk",
+    "inputPlaceholder": "Mesajınızı yazın...",
+    "send": "Gönder",
+    "online": "çevrimiçi",
+    "charCounter": "{current}/{max}",
+    "secureChat": "Güvenli sohbet - Bağlantılar sansürlenir",
+    "joinChat": "Sohbete Katıl",
+    "chooseUsername": "Oyuncu Sohbetine katılmak için bir kullanıcı adı seçin",
+    "username": "Kullanıcı Adı",
+    "usernamePlaceholder": "Kullanıcı adınızı girin...",
+    "usernameHint": "3-20 karakter, yalnızca harfler, sayılar, - ve _",
+    "joinButton": "Sohbete Katıl",
+    "colorModal": {
+      "title": "Kullanıcı Adı Rengini Özelleştir",
+      "chooseSolid": "Düz bir renk seçin:",
+      "customColor": "Özel renk:",
+      "preview": "Ön izleme:",
+      "previewUsername": "Kullanıcı Adı",
+      "apply": "Rengi Uygula"
+    }
+  },
+  "settings": {
+    "title": "AYARLAR",
+    "java": "Java Çalışma Zamanı",
+    "useCustomJava": "Özel Java Yolunu Kullan",
+    "javaDescription": "Yüklü Java çalışma zamanını kendi kurulumunuzla geçersiz kılın",
+    "javaPath": "Java Çalıştırılabilir Yolu",
+    "javaPathPlaceholder": "Java yolunu seçin...",
+    "javaBrowse": "Gözat",
+    "javaHint": "Java kurulum klasörünü seçin (Windows, Mac, Linux destekler)",
+    "discord": "Discord Entegrasyonu",
+    "enableRPC": "Discord Rich Presence'ı Etkinleştir",
+    "discordDescription": "Başlatıcı etkinliğinizi Discord'da gösterin",
+    "game": "Oyun Seçenekleri",
+    "playerName": "Oyuncu Adı",
+    "playerNamePlaceholder": "Oyuncu adınızı girin",
+    "playerNameHint": "Bu ad oyun içinde kullanılacak (1-16 karakter)",
+    "openGameLocation": "Oyun Konumunu Aç",
+    "openGameLocationDesc": "Oyun kurulum klasörünü açın",
+    "account": "Oyuncu UUID Yönetimi",
+    "currentUUID": "Geçerli UUID",
+    "uuidPlaceholder": "UUID yükleniyor...",
+    "copyUUID": "UUID'yi Kopyala",
+    "regenerateUUID": "UUID'yi Yeniden Oluştur",
+    "uuidHint": "Bu kullanıcı adı için benzersiz oyuncu tanımlayıcınız",
+    "manageUUIDs": "Tüm UUID'leri Yönet",
+    "manageUUIDsDesc": "Tüm oyuncu UUID'lerini görüntüleyin ve yönetin",
+    "language": "Dil",
+    "selectLanguage": "Dil Seçin",
+    "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.",
+    "gpuAuto": "Otomatik",
+    "gpuIntegrated": "Entegre",
+    "gpuDedicated": "Ayrılmış",
+    "logs": "SİSTEM KAYITLARI",
+    "logsCopy": "Kopyala",
+    "logsRefresh": "Yenile",
+    "logsFolder": "Klasörü Aç",
+    "logsLoading": "Loglar yükleniyor...",
+    "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",
+    "branchHint": "Stabil yayın ve deneysel ön-yayın sürümleri arasında geçiş yapın",
+    "branchWarning": "Dalı değiştirmek farklı bir oyun sürümünü indirecek ve kuracaktır",
+    "branchSwitching": "{branch} sürümüne geçiliyor...",
+    "branchSwitched": "{branch} sürümüne başarıyla geçildi!",
+    "installRequired": "Kurulum Gerekli",
+    "branchInstallConfirm": "Oyun {branch} dalı için kurulacak. Devam et?"
+  },
+  "uuid": {
+    "modalTitle": "UUID Yönetimi",
+    "currentUserUUID": "Geçerli Kullanıcı UUID",
+    "allPlayerUUIDs": "Tüm Oyuncu UUID'leri",
+    "generateNew": "Yeni UUID Oluştur",
+    "loadingUUIDs": "UUID'ler yükleniyor...",
+    "setCustomUUID": "Özel UUID Ayarla",
+    "customPlaceholder": "Özel UUID girin (format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)",
+    "setUUID": "UUID Ayarla",
+    "warning": "Uyarı: Özel bir UUID ayarlamak geçerli oyuncu kimliğinizi değiştirecektir",
+    "copyTooltip": "UUID'yi Kopyala",
+    "regenerateTooltip": "Yeni UUID Oluştur"
+  },
+  "profiles": {
+    "modalTitle": "Profilleri Yönet",
+    "newProfilePlaceholder": "Yeni Profil Adı",
+    "createProfile": "Profil Oluştur"
+  },
+  "discord": {
+    "notificationText": "Discord topluluğumuza katılın!",
+    "joinButton": "Discord'a Katıl"
+  },
+  "common": {
+    "confirm": "Onayla",
+    "cancel": "İptal",
+    "save": "Kaydet",
+    "close": "Kapat",
+    "delete": "Sil",
+    "edit": "Düzenle",
+    "loading": "Yükleniyor...",
+    "apply": "Uygula",
+    "install": "Kur"
+  },
+  "notifications": {
+    "gameDataNotFound": "Hata: Oyun verileri bulunamadı",
+    "gameUpdatedSuccess": "Oyun başarıyla güncellendi! 🎉",
+    "updateFailed": "Güncelleme başarısız: {error}",
+    "updateError": "Güncelleme hatası: {error}",
+    "discordEnabled": "Discord Rich Presence etkinleştirildi",
+    "discordDisabled": "Discord Rich Presence devre dışı bırakıldı",
+    "discordSaveFailed": "Discord ayarı kaydedilemedi",
+    "playerNameRequired": "Lütfen geçerli bir oyuncu adı girin",
+    "playerNameSaved": "Oyuncu adı başarıyla kaydedildi",
+    "playerNameSaveFailed": "Oyuncu adı kaydedilemedi",
+    "uuidCopied": "UUID panoya kopyalandı!",
+    "uuidCopyFailed": "UUID kopyalanamadı",
+    "uuidRegenNotAvailable": "UUID yeniden oluşturma kullanılamıyor",
+    "uuidRegenFailed": "UUID yeniden oluşturulamadı",
+    "uuidGenerated": "Yeni UUID başarıyla oluşturuldu!",
+    "uuidGeneratedShort": "Yeni UUID oluşturuldu!",
+    "uuidGenerateFailed": "Yeni UUID oluşturulamadı",
+    "uuidRequired": "Lütfen bir UUID girin",
+    "uuidInvalidFormat": "Geçersiz UUID formatı",
+    "uuidSetFailed": "Özel UUID ayarlanamadı",
+    "uuidSetSuccess": "Özel UUID başarıyla ayarlandı!",
+    "uuidDeleteFailed": "UUID silinemedi",
+    "uuidDeleteSuccess": "UUID başarıyla silindi!",
+    "modsDownloading": "{name} indiriliyor...",
+    "modsTogglingMod": "Mod değiştiriliyor...",
+    "modsDeletingMod": "Mod siliniyor...",
+    "modsLoadingMods": "CurseForge'dan modlar yükleniyor...",
+    "modsInstalledSuccess": "{name} başarıyla kuruldu! 🎉",
+    "modsDeletedSuccess": "{name} başarıyla silindi",
+    "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"
+  },
+  "confirm": {
+    "defaultTitle": "Eylemi onayla",
+    "regenerateUuidTitle": "Yeni UUID oluştur",
+    "regenerateUuidMessage": "Yeni bir UUID oluşturmak istediğinizden emin misiniz? Bu oyuncu kimliğinizi değiştirecektir.",
+    "regenerateUuidButton": "Oluştur",
+    "setCustomUuidTitle": "Özel UUID ayarla",
+    "setCustomUuidMessage": "Bu özel UUID'yi ayarlamak istediğinizden emin misiniz? Bu oyuncu kimliğinizi değiştirecektir.",
+    "setCustomUuidButton": "UUID Ayarla",
+    "deleteUuidTitle": "UUID'yi sil",
+    "deleteUuidMessage": "\"{username}\" için UUID'yi silmek istediğinizden emin misiniz? Bu işlem geri alınamaz.",
+    "deleteUuidButton": "Sil",
+    "uninstallGameTitle": "Oyunu kaldır",
+    "uninstallGameMessage": "Hytale'yi kaldırmak istediğinizden emin misiniz? Tüm oyun dosyaları silinecektir.",
+    "uninstallGameButton": "Kaldır"
+  },
+  "progress": {
+    "initializing": "Başlatılıyor...",
+    "downloading": "İndiriliyor...",
+    "installing": "Kuruluyur...",
+    "extracting": "Ayıklanıyor...",
+    "verifying": "Doğrulanıyor...",
+    "switchingProfile": "Profil değiştiriliyor...",
+    "profileSwitched": "Profil değiştirildi!",
+    "startingGame": "Oyun başlatılıyor...",
+    "launching": "BAŞLATILIYOR...",
+    "uninstallingGame": "Oyun kaldırılıyor...",
+    "gameUninstalled": "Oyun başarıyla kaldırıldı!",
+    "uninstallFailed": "Kaldırma başarısız: {error}",
+    "startingUpdate": "Zorunlu oyun güncellemesi başlatılıyor...",
+    "installationComplete": "Kurulum başarıyla tamamlandı!",
+    "installationFailed": "Kurulum başarısız: {error}",
+    "installingGameFiles": "Oyun dosyaları kuruluyor...",
+    "installComplete": "Kurulum tamamlandı!"
+  }
+}

PKGBUILD

@@ -1,31 +1,30 @@
 # Maintainer: Terromur <terromuroz@proton.me>
 # Maintainer: Fazri Gading <fazrigading@gmail.com>
-pkgname=Hytale-F2P-git
+# This PKGBUILD is for Github Releases
-_pkgname=Hytale-F2P
+pkgname=Hytale-F2P
-pkgver=2.0.11.r120.gb05aeef
+pkgver=2.2.0
 pkgrel=1
 pkgdesc="Hytale-F2P - unofficial Hytale Launcher for free to play with multiplayer support"
 arch=('x86_64')
 url="https://github.com/amiayweb/Hytale-F2P"
 license=('custom')
-makedepends=('npm' 'git' 'rpm-tools' 'libxcrypt-compat')
+depends=('gtk3' 'nss' 'libxcrypt-compat')
-source=("git+$url.git" "Hytale-F2P.desktop")
+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')
 
-pkgver() {
-  cd "$_pkgname"
-  printf "2.0.11.r%s.g%s" "$(git rev-list --count HEAD)" "$(git rev-parse --short HEAD)"
-}
-
 build() {
-   cd "$_pkgname"
+   cd "$pkgname-$pkgver"
-   npm install
+   npm ci
-   npm run build:linux
+   npm run build:arch
 }
 
 package() {
-  mkdir -p "$pkgdir/opt/$_pkgname"
+  cd "$pkgname-$pkgver"
-  cp -r "$_pkgname/dist/linux-unpacked/"* "$pkgdir/opt/$_pkgname"
+  install -d "$pkgdir/opt/$pkgname"
-  install -Dm644 "$_pkgname.desktop" "$pkgdir/usr/share/applications/$_pkgname.desktop"
+  cp -r dist/linux-unpacked/* "$pkgdir/opt/$pkgname"
-  install -Dm644 "$_pkgname/icon.png" "$pkgdir/usr/share/icons/hicolor/512x512/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"
 }

PKGBUILD-git

@@ -0,0 +1,34 @@
+# Maintainer: Terromur <terromuroz@proton.me>
+# Maintainer: Fazri Gading <fazrigading@gmail.com>
+pkgname=Hytale-F2P-git
+_pkgname=Hytale-F2P
+pkgver=0
+pkgrel=1
+pkgdesc="Hytale-F2P - Unofficial Hytale Launcher for free to play with multiplayer support (rolling git build)"
+arch=('x86_64')
+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"
+  git describe --tags --long | sed 's/^v//;s/-/.r/;s/-/./'
+}
+
+build() {
+   cd "$_pkgname"
+   npm ci
+   npm run build:arch
+}
+
+package() {
+  mkdir -p "$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"
+}

README.md

@@ -1,19 +1,34 @@
-# 🎮 Hytale F2P Launcher | Multiplayer Support [Windows, MacOS, Linux]
-
 <div align="center">
 
-![Version](https://img.shields.io/badge/Version-2.0.2-green?style=for-the-badge)
+<header>
-![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey?style=for-the-badge)
+  <h1>🎮 Hytale F2P Launcher 🚀</h1>
-![License](https://img.shields.io/badge/License-Educational-blue?style=for-the-badge)
+  <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>
+</header>
 
-**A modern, cross-platform launcher for Hytale with automatic updates and multiplayer support (all OS supported)**
+![GitHub Downloads](https://img.shields.io/github/downloads/amiayweb/Hytale-F2P/total?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!** ⭐
+⭐ **If you find this project useful, please give it a STAR!** ⭐
 
-🛑 **Found a problem? Join the Discord: https://discord.gg/gME8rUy3MB** 🛑
+### ⚠️ **READ [QUICK START](README.md#-quick-start) before Downloading & Installing the Launcher!** ⚠️
+
+#### 🛑 **Found a problem? Join the Discord and Select #Open-A-Ticket!: https://discord.gg/gME8rUy3MB** 🛑
+
+<p>
+  👍 If you like the project, <b>feel free to support us via Buy Me a Coffee!</b> ☕<br>
+  Any support is appreciated and helps keep the project going.
+</p>
+
+<a href="https://buymeacoffee.com/hf2p">
+  <img src="https://media3.giphy.com/media/v1.Y2lkPTc5MGI3NjExem14OW1tanN3eHlyYmR4NW1sYmJkOTZmbmJxejdjZXB6MXY5cW12MSZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9cw/TDQOtnWgsBx99cNoyH/giphy.gif" width="120">
+</a>
 
 </div>
 
@@ -21,12 +36,42 @@
 ## 📸 Screenshots
 
 <div align="center">
-
+  <img src="https://i.imgur.com/wwuuMUf.png" alt="Hytale F2P Launcher" width="1000">
-![Hytale F2P Launcher](https://i.imgur.com/9iDuzST.png)
+  <details>
-![Hytale F2P Mods](https://i.imgur.com/NaareIS.png)
+    <summary><b>View Gallery</b></summary>
-![Hytale F2P News](https://i.imgur.com/n1nEqRS.png)
+    <table style="width: 100%; border-spacing: 15px; border-collapse: separate;">
-![Hytale F2P Chat](https://i.imgur.com/Y4hL3sx.png)
+      <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%">
+        </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%">
+        </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%">
+        </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%">
+        </td>
+      </tr>
+      <tr>
+        <td align="center" style="vertical-align: top; width: 50%;">
+          <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>
+          <img src="https://i.imgur.com/3iRScPa.png" alt="Hytale F2P In-Game Screenshot-2" width="100%">
+        </td>
+      </tr>
+    </table>
+  </details>
 </div>
 
 ---
@@ -35,7 +80,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, Linux (X11/Wayland), and macOS
+- 🌐 **Cross-Platform** - Full support for Windows x64, Linux x64 (X11/Wayland, SteamDeck), and macOS Silicon
 - ☕ **Java Management** - Automatic Java runtime detection and installation
 - 🎮 **Multiplayer Support** - Automatic multiplayer client installation (Windows, macOS & Linux !)
 
@@ -43,75 +88,267 @@
 - 📁 **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
 
 ---
 
-## 🚀 Quick Start
+# 🚀 Quick Start
 
-### 📥 Installation
+## 🖥️ System Requirements
 
-#### Windows
+### 🎮 Hytale Hardware Requirements
-1. Download the latest `Hytale-F2P.exe` from [**Releases**](https://github.com/amiayweb/Hytale-F2P/releases)
-2. Run the installer
-3. Launch from desktop or start menu
 
-#### Linux
+> [!IMPORTANT]
-See [BUILD.md](BUILD.md) for detailed build instructions or [**Releases**](https://github.com/amiayweb/Hytale-F2P/releases) section.
+> Hytale is designed to be accessible while scaling for high-end performance. 
+> Below are the [official system requirements for the Early Access](https://hytale.com/news/2025/12/hytale-hardware-requirements) release.
 
-#### macOS  
+<div align="center">
-See [BUILD.md](BUILD.md) for detailed build instructions or [**Releases**](https://github.com/amiayweb/Hytale-F2P/releases) section.
 
-#### 🖥️ How to play online on F2P?
+<table>
-See [SERVER.md](SERVER.md)
+  <thead>
+    <tr>
+      <th>Component</th>
+      <th>🥉 Minimum (1080p @ 30 FPS)</th>
+      <th>🥈 Recommended (1080p @ 60 FPS)</th>
+      <th>🥇 Best (1440p @ 60 FPS)</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><b>🖥️ OS</b></td>
+      <td colspan="3" align="center">
+        Windows 10/11 (64-bit X64) | Linux (x64) | macOS (ARM64/Apple Silicon)
+        <br />
+        <small><i>⚠️ Note: ARM64 (Windows & Linux), macOS (x86/Intel) <b>are not supported!</b> ⚠️</i></small>
+      </td>
+    </tr>
+    <tr>
+      <td><b>⚙️ CPU</b></td>
+      <td>Intel i5-7500 / Ryzen 3 1200 / Apple M1</td>
+      <td>Intel i5-10400 / Ryzen 5 3600 / Apple M2</td>
+      <td>Intel i7-10700K / Ryzen 9 3800X / Apple M3</td>
+    </tr>
+    <tr>
+      <td><b>🧠 RAM</b></td>
+      <td>8GB (dGPU) / 12GB (iGPU)<sup><a href="#fn1" id="ref1">1</a></sup></td>
+      <td>16 GB</td>
+      <td>32 GB</td>
+    </tr>
+    <tr>
+      <td><b>🎮 GPU</b></td>
+      <td>GTX 900 / RX 400 / UHD 620</td>
+      <td>GTX 1060 / RX 580 / Iris Xe</td>
+      <td>RTX 30 Series / RX 7000 Series</td>
+    </tr>
+    <tr>
+      <td><b>💾 Storage</b></td>
+      <td>20 GB (SATA SSD)</td>
+      <td>20 GB (NVMe SSD)</td>
+      <td>50 GB+ (NVMe SSD)</td>
+    </tr>
+    <tr>
+      <td><b>🌐 Network</b></td>
+      <td>2 Mbit/s</td>
+      <td>8 Mbit/s</td>
+      <td>10+ Mbit/s</td>
+    </tr>
+  </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>
 
+> [!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.
 
 ---
 
-## 🛠️ Building from Source
+### 🪟 Windows Prequisites
+* **Java JDK 25:**
+  * [Oracle](https://www.oracle.com/java/technologies/downloads/#jdk25-windows)
+  * [Adoptium](https://adoptium.net/temurin/releases/?version=25)
+  * [Microsoft](https://learn.microsoft.com/en-us/java/openjdk/download), has Windows ARM64 support in version 25.
+* **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/)
 
-See [BUILD.md](BUILD.md) for comprehensive build instructions.
+### 🐧 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:
+  * `libpng16-16 libpng-dev` for Ubuntu/Debian-based Distro
+  * `libpng libpng-devel` for Fedora/RHEL-based Distro
+  * `libpng` for Arch-based Distro
 
 ---
 
-## 📌 Versioning Policy
+## 📥 Installation
 
-**⚠️ Important: Semantic Versioning Required**
+### 🪟 Windows Installation
 
-This project follows **strict semantic versioning** with **numerical versions only**:
+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**.
+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.
 
-- ✅ **Valid**: `2.0.1`, `2.0.11`, `2.1.0`, `3.0.0`
+### 🐧 Linux Installation
-- ❌ **Invalid**: `2.0.2b`, `2.0.2a`, `2.0.1-beta`, `v2.0.2b`
 
-**Format**: `MAJOR.MINOR.PATCH` (e.g., `2.0.11`)
+1. **Prerequisites:** Ensure you have installed all [**Linux Prerequisites**](https://github.com/amiayweb/Hytale-F2P/tree/main?tab=readme-ov-file#-linux-prequisites) above.
+2. **Download:** Choose the package that fits your distribution from the [**Releases**](https://github.com/amiayweb/Hytale-F2P/releases/latest/) page:
+   * **Universal:** `.AppImage`
+   * **Arch Linux:** `.pkg.tar.zst`
+   * **Fedora/RHEL/openSUSE:** `.rpm`
+   * **Debian/Ubuntu:** `.deb`
+3. **Permissions & Execution:**
+   * **AppImage:** Make the file executable and run it:
+     ```bash
+     chmod +x hytale-f2p-launcher.AppImage
+     ./hytale-f2p-launcher.AppImage
+     ```
+   * **Ubuntu/Debian-based or Fedora/RHEL-based:** Install the DEB/RPM:
+     ```bash
+     # 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 dpkg -i hytale-f2p-launcher.deb
+     ```
+   * **Arch Linux (pacman):** Install the package using:
+     ```bash
+     # Stable Build
+     sudo pacman -U hytale-f2p-launcher.pkg.tar.zst
+     # Development Build
+     yay -S hytale-f2p-git # or
+     paru -S hytale-f2p-git
+     # Manual Build
+     git clone https://aur.archlinux.org/hytale-f2p-git.git
+     cd hytale-f2p-git
+     makepkg -si
+     ```
 
-- **MAJOR**: Breaking changes
+> [!NOTE]
-- **MINOR**: New features (backward compatible)
+> Make sure to adjust the filename correctly with the version and the architecture type. TIP: Use `cd` command to the package location.
-- **PATCH**: Bug fixes (backward compatible)
 
-**Why?** The auto-update system requires semantic versioning for proper version comparison. Letter suffixes (like `2.0.2b`) are not supported and will cause update detection issues.
+### 🍎 macOS Installation  
+
+> [!NOTE]
+> Apple Silicon Users: If you are on an M1, M2, or M3 Mac, you may be prompted to install Rosetta 2 the first time you run the launcher. This is normal and required for compatibility.
+
+1. **Download:** Get the latest `.dmg` file from the [**Releases**](https://github.com/amiayweb/Hytale-F2P/releases/latest/) page.
+2. **Mount:** Double-click the `.dmg` file to open it.
+3. **Install:** Drag the **Hytale F2P Launcher** icon into your **Applications** folder.
+4. **First Run:** If macOS prevents the app from opening because it is from an "unidentified developer":
+    * Open **System Settings** > **Privacy & Security**.
+    * Scroll down to the **Security** section.
+    * Look for the message regarding "Hytale F2P Launcher" and click **Open Anyway**.
+    * Authenticate with your password and click **Open**.
+
+#### **Advanced macOS: 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`).
+2. **Remove Quarantine:** macOS often "quarantines" apps downloaded via browser. If the app won't open, open **Terminal** and run:
+   ```bash
+   xattr -rd com.apple.quarantine /path/to/Hytale-F2P-Launcher.app
+   ```
+> [!TIP]
+> Type the first part of the command, then drag the app icon into the Terminal window to auto-fill the path.
+
+--- 
+
+# 📢 How to Host a Server
+
+## 🌐 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.
+
+## 🖧 Host a 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.
+
+> [!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.
+
+> [!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. 
+
+---
+
+## 🔧 Troubleshooting
+
+See [TROUBLESHOOTING.md](TROUBLESHOOTING.md) for detailed Troubleshooting guide.
+
+---
+
+## 🔨 Building from Source
+
+See [BUILD.md](docs/BUILD.md) for comprehensive build instructions.
 
 ---
 
 ## 📋 Changelog
 
-### 🆕 v2.0.2b *(Minor Update: Performance & Utilities)*  
+### 🆕 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
+- 🛠️ **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. 
+
+### 🔄 v2.1.0
+- 🚨 **Auto-Retry Downloads and Auto-Patch Files** — 
+- ⚡ **Hardware Acceleration** — 
+- 🔎 **Browse CurseForge Mods** — Browsing mods now easier with our dedicated CurseForge API Key.
+- 🌎 **Fixes and Release New Translation** — Fixed 🇪🇸 🇧🇷 and added more translation for current build. Turkish 🇹🇷 language now added.
+
+### 🔄 v2.0.2b *(Minor Update: Performance & Utilities)*  
 - 🌎 **Language Translation** — A big welcome for Spanish 🇪🇸 and Portuguese (Brazil) 🇧🇷 players! **Language setting can be found in the bottom part of Settings pane.**
 - 💻 **Laptop/Hybrid GPU Performance Issue Fix** — Added automatic GPU detection system and options to choose which GPU will be used for the game, *specifically for Linux users*.
 - 👨‍💻 **In-App Logging** — Reporting bugs and issues to `Github Issues` tab or `Open A Ticket` channel in our Discord Server has been made easier for players, no more finding logs file manually.
 - 🛠️ **Repair Button** — Your game's broken? One button will fix them, go to Settings pane to Repair your game in one-click, **without losing any data**. If doing so did not fix your issue, please report it to us immediately!
 - 🐛 **Fixed Bugs** — Fixed issue [#84](https://github.com/amiayweb/Hytale-F2P/issues/84) where mods disappearing when game starts in previous launcher (v2.0.2a).
 
-### 🆕 v2.0.2a *(Minor Update)*  
+
+### 🔄 v2.0.2a *(Minor Update)*  
 - 🧑‍🚀 **Profiles System** — Added proper profile management: create, switch, and delete profiles. Each profile now has its own **isolated mod list**.  
 - 🔒 **Mod Isolation** — Fixed ModManager so mods are **strictly scoped to the active profile**. Browsing and installing now only affects the selected profile.  
-- 🚨 **Critical Path Fix** — Resolved a macOS bug where mods were being saved to a Windows path (`~/AppData/Local`) instead of `~/Library/Application Support`. Mods now save to the **correct location** and load properly in-game.  
+- 🚨 **Critical Path Fix** — Resolved a macOS bug where mods were being saved to a Windows path (`~/AppData/Local`) instead of `~/Library/Application Support`.
 - 🛡️ **Stability Improvements** — Added an **auto-sync step before every launch** to ensure the physical mods folder always matches the active profile.  
 - 🎨 **UI Enhancements** — Added a **profile selector dropdown** and a **profile management modal**.
   
-### 🆕 v2.0.2 
+### 🔄 v2.0.2 
 - 🎮 **Discord RPC Integration** - Added Discord Rich Presence with toggle in settings (enabled by default)
 - 🌐 **Cross-Platform Multiplayer** - Added multiplayer patch support for Windows, Linux, and macOS
 - 🎨 **Chat Improvements** - Simplified chat color system
@@ -156,6 +393,7 @@ This project follows **strict semantic versioning** with **numerical versions on
 - ☕ **Java Management** - Automatic Java runtime handling
 - 🎨 **Modern Interface** - Clean, intuitive design
 - 🌟 **First Release** - Core launcher functionality
+</details>
 
 ---
 
@@ -173,14 +411,27 @@ This project follows **strict semantic versioning** with **numerical versions on
 - [**@amiayweb**](https://github.com/amiayweb) - *Lead Developer & Project Creator*
 - [**@Relyz1993**](https://github.com/Relyz1993) - *Server Helper & Second Developer & Project Creator*
 
-### 🌟 Contributors  
+### 🌟 Main 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*
+- [**@fazrigading**](https://github.com/fazrigading) - *Main Issues fixer | Beta tester | Github Release Maintainer*
 - [**@ericiskoolbeans**](https://github.com/ericiskoolbeans) - *Beta Tester*
 - [**@chasem-dev**](https://github.com/chasem-dev) - *Issues fixer*
-- [**@crimera**](https://github.com/crimera) - *Issues fixer*  
+- [**@Rahul-Sahani04**](https://github.com/Rahul-Sahani04) - *Issues fixer*
-- [**@Citeli-py**](https://github.com/Citeli-py) - *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*
 
 ---
 
@@ -224,7 +475,7 @@ This launcher is created for **educational purposes only**.
 
 🛑 **Takedown Policy** - If Hypixel Studios or Hytale requests removal, this project will be taken down immediately.
 
-❤️ **Support Official** - Please support the official game by purchasing it when available.
+❤️ **Support Official** - Please support the official game by **purchasing** it legally when available.
 
 ---
 
@@ -232,7 +483,8 @@ This launcher is created for **educational purposes only**.
 
 **⭐ Star this project if you found it helpful! ⭐**
 
-*Made with ❤️ by [@amiayweb](https://github.com/amiayweb) and the amazing community*
+*Made with ❤️ by [@amiayweb](https://github.com/amiayweb) and the legendary contributors with amazing community*
+
 [![Star History Chart](https://api.star-history.com/svg?repos=amiayweb/Hytale-F2P&type=date&legend=top-left)](https://www.star-history.com/#amiayweb/Hytale-F2P&type=date&legend=top-left)
 </div>
 

SERVER.md

@@ -1,34 +1,99 @@
-# 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 HERE: https://discord.gg/MEyWUxt77m
+### **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`.
 
 ---
 
-## Part 1: Playing with Friends (Online Play)
+# 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
 
 The easiest way to play with friends - no manual server setup required!
+*The game automatically handles networking using UPnP/STUN/NAT traversal.*
 
-### How It Works
+**For Online Play to work, you need:**
-
-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)
 
-### Common Issues
+> [!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!
 
-#### "NAT Type: Carrier-Grade NAT (CGNAT)" Warning
+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>
 
 If you see this message:
 ```
@@ -40,14 +105,13 @@ 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 Radmin VPN or Playit.gg** - Create a virtual LAN with friends (see below)
+3. **Use Playit.gg / Tailscale / Radmin VPN** - Create a virtual LAN with friends (see below)
 4. **Have a friend with public IP host instead**
+</details>
 
-#### "UPnP Failed" or "Port Mapping Failed"
+<details><summary><b>b. "UPnP Failed" or "Port Mapping Failed" Warning</b></summary>
-
 **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")
@@ -56,117 +120,138 @@ 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" section below
+- See "Port Forwarding" or "Workarounds or NAT/CGNAT" sections below
-
+</details>
-#### "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 Radmin VPN as workaround
+3. Use Playit.gg / Tailscale / Radmin VPN as workaround
+</details>
 
-### Workarounds for NAT/CGNAT Issues
+## 2. Using Tailscale
+Tailscale creates mesh VPN service that streamlines connecting devices and services securely across different networks. And **works crossplatform!!**
 
-#### Option 1: playit.gg (Recommended)
+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) ✅
 
 Free tunneling service - only the host needs to install it:
 
-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)  
+1. Go to https://playit.gg/login and **Log In** with your existing account, **Create Account** if you don't have one
-2. **Add a tunnel** - Select "UDP", tunnel description of "Hytale Server", port count `1`, and local port `5520`
+2. Press "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`
+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. **Share the address** - Friends connect directly using this address
+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.
 
-Works with both Online Play and dedicated servers. No software needed for players joining.
+## 2. Using Radmin VPN
-
-#### 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
+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
+2. One person create a room/network, others join with network name/password
-3. **Host via Online Play** - Use your Radmin VPN IP instead
+3. Host joined the world, others will connect to it.
-4. **Friends connect** - They'll see you on the virtual LAN
+4. Open Hytale Game > Servers > Add Servers > Direct Connect > Type IP Address of the Host from Radmin.
 
-Both options bypass all NAT/CGNAT issues. But for **Windows machines only!**
+These 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]
 ---
 
-## Part 2: Dedicated Server (Advanced)
+# C. 24/7 Dedicated Server (Advanced)
 
 For 24/7 servers, custom configurations, or hosting on a VPS/dedicated machine.
 
-### Quick Start
+## Step 1: Get the Files Ready
 
-#### Step 1: Get the Server JAR
+### Prequisites
 
-The server scripts will automatically download the pre-patched server JAR if it's not present.
+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
 
-**Option A:** Let the scripts download automatically (requires `HYTALE_SERVER_URL` to be configured)
+> [!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 B:** Manually place `HytaleServer.jar` (pre-patched for F2P) in the Server directory:
+> [!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`. 
 
-- **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 2: Place `HytaleServer.jar` in the `Server` directory
 
-#### Step 2: Run the 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
 
 **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.
-
 ---
 
-## Network Setup (Dedicated Server)
+# D. Tinkering Guides
 
-### Local Network (LAN)
+## 1. Network Setup
+
+### a. 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`
 
-### Port Forwarding (Internet Play)
+### b. 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
@@ -179,36 +264,35 @@ netsh advfirewall firewall add rule name="Hytale Server" dir=in action=allow pro
 
 ---
 
-## Configuration
+## 2. Configuration
 
-### Environment Variables
+### a. Environment Variables
 
-Set these before running to customize your server:
+Write this in the script file `.BAT`/`.SH` or set these manually in command 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) |
-| `HYTALE_AUTH_DOMAIN` | `sanasol.ws` | Auth server domain |
+| `BIND_ADRESS` | `0.0.0.0:5520` | Server IP and port |
-| `HYTALE_BIND` | `0.0.0.0:5520` | Server IP and port |
+| `AUTH_MODE` | `authenticated` | Auth mode (see below) |
-| `HYTALE_AUTH_MODE` | `authenticated` | Auth mode (see below) |
+| `SERVER_NAME` | `My Hytale Server` | Server display name |
-| `HYTALE_SERVER_NAME` | `My Hytale Server` | Server display name |
+| `ASSETS_PATH` | `./Assets.zip` | Assets file location |
-| `HYTALE_GAME_PATH` | (auto-detected) | Override game location |
 | `JVM_XMS` | `2G` | Minimum Java memory |
 | `JVM_XMX` | `4G` | Maximum Java memory |
 
 **Example (Windows):**
 ```batch
-set HYTALE_SERVER_NAME=My Awesome Server
+set SERVER_NAME=My Awesome Server
 set JVM_XMX=8G
 run_server.bat
 ```
 
 **Example (Linux/macOS):**
 ```bash
-HYTALE_SERVER_NAME="My Awesome Server" JVM_XMX=8G ./run_server.sh
+SERVER_NAME="My Awesome Server" JVM_XMX=8G ./run_server.sh
 ```
 
-### Authentication Modes
+### b. Authentication Modes
 
 | Mode | Description | Use Case |
 |------|-------------|----------|
@@ -218,7 +302,7 @@ HYTALE_SERVER_NAME="My Awesome Server" JVM_XMX=8G ./run_server.sh
 
 ---
 
-## RAM Allocation Guide
+## 3. RAM Allocation Guide
 
 Adjust memory based on your system:
 
@@ -242,7 +326,7 @@ JVM_XMS=4G JVM_XMX=12G ./run_server.sh
 
 ---
 
-## Server Commands
+## 4. Server Commands
 
 Once running, use these commands in the console:
 
@@ -259,9 +343,12 @@ 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.
+
 ---
 
-## Command Line Options
+## 5. Command Line Options
 
 Pass these when starting the server:
 
@@ -290,7 +377,7 @@ Pass these when starting the server:
 
 ---
 
-## File Structure
+## 6. File Structure
 
 ```
 <game_path>/
@@ -308,21 +395,21 @@ Pass these when starting the server:
 
 ---
 
-## Backups
+## 7. Backups
 
-### Automatic Backups
+### a. Automatic Backups
 
 ```bash
 ./run_server.sh --backup --backup-dir ./backups --backup-frequency 30
 ```
 
-### Manual Backup
+### b. Manual Backup
 
 1. Use `save` command or stop the server
 2. Copy the `universe/` folder
 3. Store in a safe location
 
-### Restore
+### c. Restore
 
 1. Stop the server
 2. Delete/rename current `universe/`
@@ -331,9 +418,9 @@ Pass these when starting the server:
 
 ---
 
-## Troubleshooting
+## 8. Troubleshooting
 
-### "Java not found" or "Java version too old"
+### a. "Java not found" or "Java version too old"
 
 **Java 21 is REQUIRED** (the server uses class file version 65.0).
 
@@ -352,30 +439,20 @@ export PATH="$JAVA_HOME/bin:$PATH"
 ```
 Add these lines to `~/.zshrc` or `~/.bash_profile` to make permanent.
 
-### "Game directory not found"
+### b. "Port already in use"
-
-- 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
 ```
 
-### "Out of memory"
+### c. "Out of memory"
 
 Increase JVM_XMX:
 ```bash
 JVM_XMX=6G ./run_server.sh
 ```
 
-### Players can't connect
+### d. Players can't connect
 
 1. Server shows "Server Ready"?
 2. Using F2P Launcher (not official)?
@@ -383,7 +460,7 @@ JVM_XMX=6G ./run_server.sh
 4. Port forwarding configured (for internet)?
 5. Try `--auth-mode unauthenticated` for testing
 
-### "Authentication failed"
+### e. "Authentication failed"
 
 - Ensure players use F2P Launcher
 - Auth server may be temporarily down
@@ -391,7 +468,7 @@ JVM_XMX=6G ./run_server.sh
 
 ---
 
-## Docker Deployment (Advanced)
+## 9. Docker Deployment (Advanced)
 
 For production servers, use Docker:
 
@@ -400,7 +477,7 @@ docker run -d \
   --name hytale-server \
   -p 5520:5520/udp \
   -v ./data:/data \
-  -e HYTALE_AUTH_DOMAIN=sanasol.ws \
+  -e HYTALE_AUTH_DOMAIN=auth.sanasol.ws \
   -e HYTALE_SERVER_NAME="My Server" \
   -e JVM_XMX=8G \
   ghcr.io/hybrowse/hytale-server-docker:latest
@@ -410,40 +487,7 @@ See [Docker documentation](https://github.com/Hybrowse/hytale-server-docker) for
 
 ---
 
-## Server Settings Summary
+## 10. Getting Help
-
-### 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
@@ -452,8 +496,9 @@ JVM_XMX=8G \
 
 ---
 
-## Credits
+# Credits
 
 - Hytale F2P Project
 - [Hybrowse Docker Image](https://github.com/Hybrowse/hytale-server-docker)
 - Auth Server: sanasol.ws
+

TROUBLESHOOTING.md

@@ -0,0 +1,460 @@
+# 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/appUpdater.js

@@ -15,12 +15,6 @@ class AppUpdater {
   }
 
   setupAutoUpdater() {
-    // Enable dev mode for testing (reads dev-app-update.yml)
-    // Only enable in development, not in production builds
-    if (process.env.NODE_ENV === 'development' || !app.isPackaged) {
-      autoUpdater.forceDevUpdateConfig = true;
-      console.log('Dev update mode enabled - using dev-app-update.yml');
-    }
 
     // Configure logger for electron-updater
     // Create a compatible logger interface
@@ -176,7 +170,7 @@ class AppUpdater {
         console.warn('macOS update error: App may not be code-signed. Auto-update requires code signing.');
         if (this.mainWindow && !this.mainWindow.isDestroyed()) {
           this.mainWindow.webContents.send('update-error', {
-            message: 'Auto-update requires code signing. Please download manually from GitHub.',
+            message: 'Please download manually from GitHub.',
             code: err.code,
             isMacSigningError: true,
             requiresManualDownload: true,

backend/core/config.js

@@ -4,7 +4,7 @@ const os = require('os');
 
 
 // Default auth domain - can be overridden by env var or config
-const DEFAULT_AUTH_DOMAIN = 'sanasol.ws';
+const DEFAULT_AUTH_DOMAIN = 'auth.sanasol.ws';
 
 // Get auth domain from env, config, or default
 function getAuthDomain() {
@@ -26,9 +26,10 @@ function getAuthDomain() {
 }
 
 // Get full auth server URL
+// Domain already includes subdomain (auth.sanasol.ws), so use directly
 function getAuthServerUrl() {
   const domain = getAuthDomain();
-  return `https://sessions.${domain}`;
+  return `https://${domain}`;
 }
 
 // Save auth domain to config
@@ -83,15 +84,6 @@ 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();
@@ -165,6 +157,15 @@ function loadCloseLauncherOnStart() {
   return config.closeLauncherOnStart !== undefined ? config.closeLauncherOnStart : false;
 }
 
+function saveLauncherHardwareAcceleration(enabled) {
+  saveConfig({ launcherHardwareAcceleration: !!enabled });
+}
+
+function loadLauncherHardwareAcceleration() {
+  const config = loadConfig();
+  return config.launcherHardwareAcceleration !== undefined ? config.launcherHardwareAcceleration : true;
+}
+
 function saveModsToConfig(mods) {
   try {
     const config = loadConfig();
@@ -284,17 +285,6 @@ 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' });
 }
@@ -304,15 +294,35 @@ function loadGpuPreference() {
   return config.gpuPreference || 'auto';
 }
 
+function saveVersionClient(versionClient) {
+  saveConfig({ version_client: versionClient });
+}
+
+function loadVersionClient() {
+  const config = loadConfig();
+  return config.version_client !== undefined ? config.version_client : null;
+}
+
+function saveVersionBranch(versionBranch) {
+  const branch = versionBranch || 'release';
+  if (branch !== 'release' && branch !== 'pre-release') {
+    console.warn(`Invalid branch "${branch}", defaulting to "release"`);
+    saveConfig({ version_branch: 'release' });
+  } else {
+    saveConfig({ version_branch: branch });
+  }
+}
+
+function loadVersionBranch() {
+  const config = loadConfig();
+  return config.version_branch || 'release';
+}
+
 module.exports = {
   loadConfig,
   saveConfig,
   saveUsername,
   loadUsername,
-  saveChatUsername,
-  loadChatUsername,
-  saveChatColor,
-  loadChatColor,
   getUuidForUser,
   saveJavaPath,
   loadJavaPath,
@@ -343,5 +353,15 @@ module.exports = {
   loadGpuPreference,
   // Close Launcher export
   saveCloseLauncherOnStart,
-  loadCloseLauncherOnStart
+  loadCloseLauncherOnStart,
+
+  // Hardware Acceleration functions
+  saveLauncherHardwareAcceleration,
+  loadLauncherHardwareAcceleration,
+
+  // Version Management exports
+  saveVersionClient,
+  loadVersionClient,
+  saveVersionBranch,
+  loadVersionBranch
 };

backend/core/paths.js

@@ -1,6 +1,7 @@
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
+const { loadVersionBranch } = require('./config');
 
 function getAppDir() {
   const home = os.homedir();
@@ -13,6 +14,21 @@ function getAppDir() {
   }
 }
 
+/**
+ * Get centralized UserData saves directory (NEW in 2.2.0)
+ * UserData is now stored separately from game installation
+ */
+function getHytaleSavesDir() {
+  const home = os.homedir();
+  if (process.platform === 'win32') {
+    return path.join(home, 'AppData', 'Local', 'HytaleSaves');
+  } else if (process.platform === 'darwin') {
+    return path.join(home, 'Library', 'Application Support', 'HytaleSaves');
+  } else {
+    return path.join(home, '.hytalesaves');
+  }
+}
+
 const DEFAULT_APP_DIR = getAppDir();
 
 function getResolvedAppDir(customPath) {
@@ -48,8 +64,20 @@ function expandHome(inputPath) {
 const APP_DIR = DEFAULT_APP_DIR;
 const CACHE_DIR = path.join(APP_DIR, 'cache');
 const TOOLS_DIR = path.join(APP_DIR, 'butler');
-const GAME_DIR = path.join(APP_DIR, 'release', 'package', 'game', 'latest');
+
-const JRE_DIR = path.join(APP_DIR, 'release', 'package', 'jre', 'latest');
+// Dynamic GAME_DIR and JRE_DIR based on version_branch from config
+function getGameDir() {
+  const branch = loadVersionBranch();
+  return path.join(APP_DIR, branch, 'package', 'game', 'latest');
+}
+
+function getJreDir() {
+  const branch = loadVersionBranch();
+  return path.join(APP_DIR, branch, 'package', 'jre', 'latest');
+}
+
+const GAME_DIR = getGameDir();
+const JRE_DIR = getJreDir();
 const PLAYER_ID_FILE = path.join(APP_DIR, 'player_id.json');
 
 function getClientCandidates(gameLatest) {
@@ -156,7 +184,8 @@ async function getModsPath(customInstallPath = null) {
       installPath = getAppDir();
     }
 
-    const gameLatest = path.join(installPath, 'release', 'package', 'game', 'latest');
+    const branch = loadVersionBranch();
+    const gameLatest = path.join(installPath, branch, 'package', 'game', 'latest');
 
     const userDataPath = findUserDataPath(gameLatest);
 
@@ -165,9 +194,29 @@ async function getModsPath(customInstallPath = null) {
     const profilesPath = path.join(userDataPath, 'Profiles');
 
     if (!fs.existsSync(modsPath)) {
-      // Ensure the Mods directory exists
+      // Check for broken symlink to avoid EEXIST/EPERM on mkdir
+      let isBrokenLink = false;
+      let pathExists = false;
+      try {
+          const stats = fs.lstatSync(modsPath);
+          pathExists = true;
+          if (stats.isSymbolicLink()) {
+              // Check if target exists
+              try {
+                  fs.statSync(modsPath);
+              } catch {
+                  isBrokenLink = true;
+              }
+          }
+      } catch (e) { /* path doesn't exist at all */ }
+
+      if (isBrokenLink) {
+        fs.unlinkSync(modsPath); // Remove broken symlink
+      }
+      if (!pathExists || isBrokenLink) {
         fs.mkdirSync(modsPath, { recursive: true });
       }
+    }
     if (!fs.existsSync(disabledModsPath)) {
       fs.mkdirSync(disabledModsPath, { recursive: true });
     }
@@ -184,19 +233,8 @@ async function getModsPath(customInstallPath = null) {
 
 function getProfilesDir(customInstallPath = null) {
   try {
-    // get UserData path
+    // NEW 2.2.0: Use centralized UserData location
-    let installPath = customInstallPath;
+    const userDataPath = getHytaleSavesDir();
-    if (!installPath) {
-        const configFile = path.join(DEFAULT_APP_DIR, 'config.json');
-        if (fs.existsSync(configFile)) {
-            const config = JSON.parse(fs.readFileSync(configFile, 'utf8'));
-            installPath = config.installPath || '';
-        }
-    }
-    if (!installPath) installPath = getAppDir();
-    
-    const gameLatest = path.join(installPath, 'release', 'package', 'game', 'latest');
-    const userDataPath = findUserDataPath(gameLatest);
     const profilesDir = path.join(userDataPath, 'Profiles');
     
     if (!fs.existsSync(profilesDir)) {
@@ -212,6 +250,7 @@ function getProfilesDir(customInstallPath = null) {
 
 module.exports = {
   getAppDir,
+  getHytaleSavesDir,
   getResolvedAppDir,
   expandHome,
   APP_DIR,
@@ -219,6 +258,8 @@ module.exports = {
   TOOLS_DIR,
   GAME_DIR,
   JRE_DIR,
+  getGameDir,
+  getJreDir,
   PLAYER_ID_FILE,
   getClientCandidates,
   findClientPath,

backend/core/testConfig.js

@@ -0,0 +1,7 @@
+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,10 +5,6 @@
 const {
   saveUsername,
   loadUsername,
-  saveChatUsername,
-  loadChatUsername,
-  saveChatColor,
-  loadChatColor,
   saveJavaPath,
   loadJavaPath,
   saveInstallPath,
@@ -19,6 +15,13 @@ const {
   loadLanguage,
   saveCloseLauncherOnStart,
   loadCloseLauncherOnStart,
+
+  saveLauncherHardwareAcceleration,
+  loadLauncherHardwareAcceleration,
+
+  loadConfig,
+  saveConfig,
+
   saveModsToConfig,
   loadModsFromConfig,
   getUuidForUser,
@@ -33,7 +36,12 @@ const {
   resetCurrentUserUuid,
   // GPU Preference
   saveGpuPreference,
-  loadGpuPreference
+  loadGpuPreference,
+  // Version Management
+  saveVersionClient,
+  loadVersionClient,
+  saveVersionBranch,
+  loadVersionBranch
 } = require('./core/config');
 
 const { getResolvedAppDir, getModsPath } = require('./core/paths');
@@ -71,7 +79,6 @@ const {
 
 // Services
 const {
-  getInstalledClientVersion,
   getLatestClientVersion
 } = require('./services/versionManager');
 
@@ -103,10 +110,6 @@ module.exports = {
   // User configuration functions
   saveUsername,
   loadUsername,
-  saveChatUsername,
-  loadChatUsername,
-  saveChatColor,
-  loadChatColor,
   getUuidForUser,
 
   // Java configuration functions
@@ -130,14 +133,25 @@ module.exports = {
   saveCloseLauncherOnStart,
   loadCloseLauncherOnStart,
 
+  // Hardware Acceleration functions
+  saveLauncherHardwareAcceleration,
+  loadLauncherHardwareAcceleration,
+
+  // Config functions
+  loadConfig,
+  saveConfig,
+
   // GPU Preference functions
   saveGpuPreference,
   loadGpuPreference,
   detectGpu,
 
   // Version functions
-  getInstalledClientVersion,
   getLatestClientVersion,
+  saveVersionClient,
+  loadVersionClient,
+  saveVersionBranch,
+  loadVersionBranch,
 
   // News functions
   getHytaleNews,

backend/logger.js

@@ -85,7 +85,7 @@ class Logger {
       
       fs.appendFileSync(this.logFile, message, 'utf8');
     } catch (error) {
-      this.originalConsole.error('Impossible d\'écrire dans le fichier de log:', error.message);
+      this.originalConsole.error('Unable to write to log file:', error.message);
     }
   }
 

backend/managers/differentialUpdateManager.js

@@ -0,0 +1,272 @@
+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

@@ -7,11 +7,14 @@ const { spawn } = require('child_process');
 const { v4: uuidv4 } = require('uuid');
 const { getResolvedAppDir, findClientPath } = require('../core/paths');
 const { setupWaylandEnvironment, setupGpuEnvironment } = require('../utils/platformUtils');
-const { saveUsername, saveInstallPath, loadJavaPath, getUuidForUser, getAuthServerUrl, getAuthDomain } = require('../core/config');
+const { saveUsername, saveInstallPath, loadJavaPath, getUuidForUser, getAuthServerUrl, getAuthDomain, loadVersionBranch, loadVersionClient, saveVersionClient } = require('../core/config');
 const { resolveJavaPath, getJavaExec, getBundledJavaPath, detectSystemJava, JAVA_EXECUTABLE } = require('./javaManager');
-const { getInstalledClientVersion, getLatestClientVersion } = require('../services/versionManager');
+const { getLatestClientVersion } = require('../services/versionManager');
-const { updateGameFiles } = require('./gameManager');
+const { FORCE_CLEAN_INSTALL_VERSION, CLEAN_INSTALL_TEST_VERSION } = require('../core/testConfig');
+const { ensureGameInstalled } = require('./differentialUpdateManager');
 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;
@@ -101,11 +104,22 @@ function generateLocalTokens(uuid, name) {
   };
 }
 
-async function launchGame(playerName = 'Player', progressCallback, javaPathOverride, installPathOverride, gpuPreference = 'auto') {
+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, 'release', 'package', 'game', 'latest');
+  const customGameDir = path.join(customAppDir, branch, 'package', 'game', 'latest');
-  const customJreDir = path.join(customAppDir, 'release', 'package', 'jre', 'latest');
+  const customJreDir = path.join(customAppDir, branch, 'package', 'jre', 'latest');
-  const userDataDir = path.join(customGameDir, 'Client', 'UserData');
+  
+  // NEW 2.2.0: Use centralized UserData location
+  const userDataDir = getUserDataPath();
 
   const gameLatest = customGameDir;
   let clientPath = findClientPath(gameLatest);
@@ -151,25 +165,23 @@ async function launchGame(playerName = 'Player', progressCallback, javaPathOverr
   const { identityToken, sessionToken } = await fetchAuthTokens(uuid, playerName);
 
   // Patch client and server binaries to use custom auth server (BEFORE signing on macOS)
+  // FORCE patch on every launch to ensure consistency
   const authDomain = getAuthDomain();
   if (clientPatcher) {
     try {
       if (progressCallback) {
         progressCallback('Patching game for custom server...', null, null, null, null);
       }
-      console.log(`Patching game binaries for ${authDomain}...`);
+      console.log(`Force patching game binaries for ${authDomain}...`);
 
       const patchResult = await clientPatcher.ensureClientPatched(gameLatest, (msg, percent) => {
-        console.log(`[Patcher] ${msg}`);
+        // console.log(`[Patcher] ${msg}`);
         if (progressCallback && msg) {
           progressCallback(msg, percent, null, null, null);
         }
-      });
+       }, null, branch);
 
       if (patchResult.success) {
-        if (patchResult.alreadyPatched) {
-          console.log(`Game already patched for ${authDomain}`);
-        } else {
         console.log(`Game patched successfully (${patchResult.patchCount} total occurrences)`);
         if (patchResult.client) {
           console.log(`  Client: ${patchResult.client.patchCount || 0} occurrences`);
@@ -177,7 +189,6 @@ async function launchGame(playerName = 'Player', progressCallback, javaPathOverr
         if (patchResult.server) {
           console.log(`  Server: ${patchResult.server.patchCount || 0} occurrences`);
         }
-        }
       } else {
         console.warn('Game patching failed:', patchResult.error);
       }
@@ -284,6 +295,55 @@ 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');
+
+    // 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 systemLibzstd = null;
+    for (const p of systemLibzstdPaths) {
+      if (fs.existsSync(p)) {
+        systemLibzstd = p;
+        break;
+      }
+    }
+
+    if (systemLibzstd && fs.existsSync(bundledLibzstd)) {
+      try {
+        const stats = fs.lstatSync(bundledLibzstd);
+
+        // 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}`);
+      }
+    }
+  }
+
   try {
     let spawnOptions = {
       stdio: ['ignore', 'pipe', 'pipe'],
@@ -333,6 +393,7 @@ exec "$REAL_JAVA" "\${ARGS[@]}"
       }
     });
 
+    // Monitor game process status in background
     setTimeout(() => {
       if (!hasExited) {
         console.log('Game appears to be running successfully');
@@ -345,6 +406,7 @@ exec "$REAL_JAVA" "\${ARGS[@]}"
       }
     }, 3000);
 
+    // Return immediately, don't wait for setTimeout
     return { success: true, installed: true, launched: true, pid: child.pid };
   } catch (spawnError) {
     console.error(`Error spawning game process: ${spawnError.message}`);
@@ -355,23 +417,23 @@ exec "$REAL_JAVA" "\${ARGS[@]}"
   }
 }
 
-async function launchGameWithVersionCheck(playerName = 'Player', progressCallback, javaPathOverride, installPathOverride, gpuPreference = 'auto') {
+async function launchGameWithVersionCheck(playerName = 'Player', progressCallback, javaPathOverride, installPathOverride, gpuPreference = 'auto', branchOverride = null) {
   try {
+    const branch = branchOverride || loadVersionBranch();
+    
     if (progressCallback) {
       progressCallback('Checking for updates...', 0, null, null, null);
     }
 
-    const [installedVersion, latestVersion] = await Promise.all([
+    const installedVersion = loadVersionClient();
-      getInstalledClientVersion(),
+    const latestVersion = await getLatestClientVersion(branch);
-      getLatestClientVersion()
-    ]);
 
-    console.log(`Installed version: ${installedVersion}, Latest version: ${latestVersion}`);
+    console.log(`Installed version: ${installedVersion}, Latest version: ${latestVersion} (branch: ${branch})`);
 
     let needsUpdate = false;
-    if (installedVersion && latestVersion && installedVersion !== latestVersion) {
+    if (!installedVersion || installedVersion !== latestVersion) {
       needsUpdate = true;
-      console.log('Version mismatch detected, update required');
+      console.log('Version mismatch or not installed, update required');
     }
 
     if (needsUpdate) {
@@ -380,13 +442,19 @@ async function launchGameWithVersionCheck(playerName = 'Player', progressCallbac
       }
 
       const customAppDir = getResolvedAppDir(installPathOverride);
-      const customGameDir = path.join(customAppDir, 'release', 'package', 'game', 'latest');
+      const customGameDir = path.join(customAppDir, branch, 'package', 'game', 'latest');
       const customToolsDir = path.join(customAppDir, 'butler');
       const customCacheDir = path.join(customAppDir, 'cache');
 
       try {
-        await updateGameFiles(latestVersion, progressCallback, customGameDir, customToolsDir, customCacheDir);
+        let versionToInstall = latestVersion;
-        console.log('Game updated successfully, waiting before launch...');
+        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);
+        console.log('Game updated successfully, patching will be forced on launch...');
 
         if (progressCallback) {
           progressCallback('Preparing game launch...', 90, null, null, null);
@@ -406,13 +474,22 @@ async function launchGameWithVersionCheck(playerName = 'Player', progressCallbac
       progressCallback('Launching game...', 80, null, null, null);
     }
 
-    return await launchGame(playerName, progressCallback, javaPathOverride, installPathOverride, gpuPreference);
+    const launchResult = await launchGame(playerName, progressCallback, javaPathOverride, installPathOverride, gpuPreference, branch);
+    
+    // Ensure we always return a result
+    if (!launchResult) {
+      console.error('launchGame returned null/undefined, creating fallback response');
+      return { success: false, error: 'Game launch failed - no response from launcher' };
+    }
+    
+    return launchResult;
   } catch (error) {
     console.error('Error in version check and launch:', error);
     if (progressCallback) {
       progressCallback(`Error: ${error.message}`, -1, null, null, null);
     }
-    throw error;
+    // Always return an error response instead of throwing
+    return { success: false, error: error.message || 'Unknown launch error' };
   }
 }
 

backend/managers/gameManager.js

@@ -3,14 +3,16 @@ const path = require('path');
 const { execFile } = require('child_process');
 const { getResolvedAppDir, findClientPath, findUserDataPath, findUserDataRecursive, GAME_DIR, CACHE_DIR, TOOLS_DIR } = require('../core/paths');
 const { getOS, getArch } = require('../utils/platformUtils');
-const { downloadFile } = require('../utils/fileManager');
+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 } = require('../core/config');
+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(version = 'release', fileName = '4.pwr', progressCallback, cacheDir = CACHE_DIR) {
+async function downloadPWR(branch = 'release', fileName = '7.pwr', progressCallback, cacheDir = CACHE_DIR, manualRetry = false) {
   const osName = getOS();
   const arch = getArch();
 
@@ -18,24 +20,143 @@ async function downloadPWR(version = 'release', fileName = '4.pwr', progressCall
     throw new Error('Hytale x86_64 Intel Mac Support has not been released yet. Please check back later.');
   }
 
-  const url = `https://game-patches.hytale.com/patches/${osName}/${arch}/${version}/0/${fileName}`;
+  const url = `https://game-patches.hytale.com/patches/${osName}/${arch}/${branch}/0/${fileName}`;
+  const dest = path.join(cacheDir, `${branch}_${fileName}`);
 
-  const dest = path.join(cacheDir, fileName);
+  // Check if file exists and validate it
-
+  if (fs.existsSync(dest) && !manualRetry) {
-  if (fs.existsSync(dest)) {
     console.log('PWR file found in cache:', dest);
-    return dest;
+    
+    // Validate file size (PWR files should be > 1MB and >= 1.5GB for complete downloads)
+    const stats = fs.statSync(dest);
+    if (stats.size < 1024 * 1024) {
+      return false;
+    }
+    
+    // Check if file is under 1.5 GB (incomplete download)
+    const sizeInMB = stats.size / 1024 / 1024;
+    if (sizeInMB < 1500) {
+      console.log(`[PWR Validation] File appears incomplete: ${sizeInMB.toFixed(2)} MB < 1.5 GB`);
+      return false;
+    }
   }
 
   console.log('Fetching PWR patch file:', url);
+  
+  try {
+    if (manualRetry) {
+      await retryDownload(url, dest, progressCallback);
+    } else {
       await downloadFile(url, dest, progressCallback);
+    }
+  } catch (error) {
+    // Check for automatic stall retry conditions (only for stall errors, not manual retries)
+    if (!manualRetry && 
+        error.message && 
+        error.message.includes('stalled') && 
+        error.canRetry !== false && // Explicitly check it's not false
+        (!error.retryState || error.retryState.automaticStallRetries < MAX_AUTOMATIC_STALL_RETRIES)) {
+      
+      console.log(`[PWR] Automatic stall retry triggered (${(error.retryState && error.retryState.automaticStallRetries || 0) + 1}/${MAX_AUTOMATIC_STALL_RETRIES})`);
+      
+      try {
+        await retryStalledDownload(url, dest, progressCallback, error);
+        console.log('[PWR] Automatic stall retry successful');
+        
+        // After successful automatic retry, continue with normal flow - the file should be valid now
+        const retryStats = fs.statSync(dest);
+        console.log(`PWR file downloaded (auto-retry), size: ${(retryStats.size / 1024 / 1024).toFixed(2)} MB`);
+        
+        if (!validatePWRFile(dest)) {
+          console.log(`[PWR Validation] PWR file validation failed after auto-retry, deleting corrupted file: ${dest}`);
+          fs.unlinkSync(dest);
+          throw new Error('Downloaded PWR file is corrupted or invalid after automatic retry. Please retry manually');
+        }
+
+        
+      } catch (retryError) {
+        console.error('[PWR] Automatic stall retry failed:', retryError.message);
+        
+        // Create enhanced error with updated retry state
+        const enhancedError = new Error(`PWR download failed after automatic retries: ${retryError.message}`);
+        enhancedError.originalError = retryError;
+        enhancedError.retryState = retryError.retryState || error.retryState || null;
+        enhancedError.canRetry = true; // Still allow manual retry
+        enhancedError.pwrUrl = url;
+        enhancedError.pwrDest = dest;
+        enhancedError.branch = branch;
+        enhancedError.fileName = fileName;
+        enhancedError.cacheDir = cacheDir;
+        enhancedError.automaticRetriesExhausted = true;
+        throw enhancedError;
+      }
+    }
+    
+    // Enhanced error handling for retry UI (non-stall errors or exhausted automatic retries)
+    const enhancedError = new Error(`PWR download failed: ${error.message}`);
+    enhancedError.originalError = error;
+    enhancedError.retryState = error.retryState || null;
+    enhancedError.canRetry = error.isConnectionLost ? false : (error.canRetry !== false); // Don't allow retry for connection lost
+    enhancedError.pwrUrl = url;
+    enhancedError.pwrDest = dest;
+    enhancedError.branch = branch;
+    enhancedError.fileName = fileName;
+    enhancedError.cacheDir = cacheDir;
+    enhancedError.isConnectionLost = error.isConnectionLost || false;
+    
+    console.log(`[PWR] Error handling:`, {
+      message: enhancedError.message,
+      isConnectionLost: enhancedError.isConnectionLost,
+      canRetry: enhancedError.canRetry,
+      retryState: enhancedError.retryState
+    });
+    
+    throw enhancedError;
+  }
+  
+  // Enhanced PWR file validation
+  const stats = fs.statSync(dest);
+  console.log(`PWR file downloaded, size: ${(stats.size / 1024 / 1024).toFixed(2)} MB`);
+  
+  if (!validatePWRFile(dest)) {
+    console.log(`[PWR Validation] PWR file validation failed, deleting corrupted file: ${dest}`);
+    fs.unlinkSync(dest);
+    throw new Error('Downloaded PWR file is corrupted or invalid. Please retry');
+  }
+  
   console.log('PWR saved to:', dest);
+  console.log(`[PWR Validation] PWR file validation passed: ${dest}`);
 
   return dest;
 }
 
-async function applyPWR(pwrFile, progressCallback, gameDir = GAME_DIR, toolsDir = TOOLS_DIR) {
+// Manual retry function for PWR downloads
+async function retryPWRDownload(branch, fileName, progressCallback, cacheDir = CACHE_DIR) {
+  console.log('Initiating manual PWR retry...');
+  return await downloadPWR(branch, fileName, progressCallback, cacheDir, true);
+}
+
+async function applyPWR(pwrFile, progressCallback, gameDir = GAME_DIR, toolsDir = TOOLS_DIR, branch = 'release', cacheDir = CACHE_DIR) {
+  console.log(`[Butler] Starting PWR application with:`);
+  console.log(`[Butler] - PWR file: ${pwrFile}`);
+  console.log(`[Butler] - Staging dir: ${path.join(gameDir, 'staging-temp')}`);
+  console.log(`[Butler] - Game dir: ${gameDir}`);
+  console.log(`[Butler] - Branch: ${branch}`);
+  console.log(`[Butler] - Cache dir: ${cacheDir}`);
+  
+  // Validate PWR file exists and get diagnostic info
+  if (!pwrFile || typeof pwrFile !== 'string' || !fs.existsSync(pwrFile)) {
+    throw new Error(`PWR file not found: ${pwrFile || 'undefined'}. Please retry download.`);
+  }
+  
+  const pwrStats = fs.statSync(pwrFile);
+  console.log(`[Butler] PWR file size: ${(pwrStats.size / 1024 / 1024).toFixed(2)} MB`);
+  console.log(`[Butler] PWR file exists: ${fs.existsSync(pwrFile)}`);
+  
   const butlerPath = await installButler(toolsDir);
+  console.log(`[Butler] Butler path: ${butlerPath}`);
+  console.log(`[Butler] Butler executable: ${fs.existsSync(butlerPath)}`);
+  
   const gameLatest = gameDir;
   const stagingDir = path.join(gameLatest, 'staging-temp');
 
@@ -46,12 +167,11 @@ async function applyPWR(pwrFile, progressCallback, gameDir = GAME_DIR, toolsDir
     return;
   }
 
-  if (!fs.existsSync(gameLatest)) {
+  // Validate and prepare directories
-    fs.mkdirSync(gameLatest, { recursive: true });
+  validateGameDirectory(gameLatest, stagingDir);
-  }
+  
-  if (!fs.existsSync(stagingDir)) {
+  console.log(`[Butler] Game directory validated: ${gameLatest}`);
-    fs.mkdirSync(stagingDir, { recursive: true });
+  console.log(`[Butler] Staging directory validated: ${stagingDir}`);
-  }
 
   if (progressCallback) {
     progressCallback('Installing game patch...', null, null, null, null);
@@ -75,6 +195,8 @@ async function applyPWR(pwrFile, progressCallback, gameDir = GAME_DIR, toolsDir
     gameLatest
   ];
 
+  console.log(`[Butler] Executing command: ${butlerPath} ${args.join(' ')}`);
+
   try {
     await new Promise((resolve, reject) => {
       const child = execFile(butlerPath, args, {
@@ -82,35 +204,146 @@ async function applyPWR(pwrFile, progressCallback, gameDir = GAME_DIR, toolsDir
         timeout: 600000
       }, (error, stdout, stderr) => {
         if (error) {
-          console.error('Butler stderr:', stderr);
+          console.error('[Butler] stderr:', stderr);
-          console.error('Butler stdout:', stdout);
+          console.error('[Butler] stdout:', stdout);
-          reject(new Error(`Patch installation failed: ${error.message}${stderr ? '\n' + stderr : ''}`));
+          console.error('[Butler] error code:', error.code);
+          console.error('[Butler] error signal:', error.signal);
+          
+          // Enhanced error pattern detection
+          const errorPatterns = {
+            'unexpected EOF': {
+              message: 'Corrupted PWR file detected and deleted. Please try launching the game again.',
+              shouldDeletePWR: true
+            },
+            'permission denied': {
+              message: 'Permission denied. Check file permissions and try again.',
+              shouldDeletePWR: false
+            },
+            'no space left': {
+              message: 'Insufficient disk space. Free up space and try again.',
+              shouldDeletePWR: false
+            },
+            'device full': {
+              message: 'Insufficient disk space. Free up space and try again.',
+              shouldDeletePWR: false
+            },
+            'already exists': {
+              message: 'Installation directory conflict. Clean directories and retry.',
+              shouldDeletePWR: false
+            },
+            'network error': {
+              message: 'Network error during patch installation. Please retry.',
+              shouldDeletePWR: false
+            },
+            'connection refused': {
+              message: 'Connection refused. Check network and retry.',
+              shouldDeletePWR: false
+            }
+          };
+          
+          let enhancedMessage = `Patch installation failed: ${error.message}${stderr ? '\n' + stderr : ''}`;
+          let shouldDeletePWR = false;
+          
+          // Check error patterns
+          const errorText = (stderr + ' ' + error.message).toLowerCase();
+          for (const [pattern, config] of Object.entries(errorPatterns)) {
+            if (errorText.includes(pattern)) {
+              enhancedMessage = config.message;
+              shouldDeletePWR = config.shouldDeletePWR;
+              console.log(`[Butler] Pattern matched: ${pattern}`);
+              break;
+            }
+          }
+          
+          // Delete corrupted PWR file if needed
+          if (shouldDeletePWR) {
+            try {
+              if (fs.existsSync(pwrFile)) {
+                fs.unlinkSync(pwrFile);
+                console.log('[Butler] Corrupted PWR file deleted:', pwrFile);
+              }
+            } catch (delErr) {
+              console.error('[Butler] Failed to delete corrupted PWR file:', delErr);
+            }
+          }
+          
+          // Enhanced error with retry context
+          const enhancedError = new Error(enhancedMessage);
+          enhancedError.canRetry = true;
+          enhancedError.branch = branch;
+          enhancedError.fileName = path.basename(pwrFile);
+          enhancedError.cacheDir = cacheDir;
+          enhancedError.butlerError = true;
+          enhancedError.errorCode = error.code;
+          enhancedError.stderr = stderr;
+          enhancedError.stdout = stdout;
+          
+          console.log('[Butler] Enhanced error created with retry context');
+          reject(enhancedError);
         } else {
+          console.log('[Butler] Patch installation completed successfully');
           resolve();
         }
       });
     });
   } catch (error) {
-    throw error;
+    console.error('[Butler] Exception during Butler execution:', error);
+    const enhancedError = new Error(`Butler execution failed: ${error.message}`);
+    enhancedError.canRetry = true;
+    enhancedError.branch = branch;
+    enhancedError.fileName = path.basename(pwrFile);
+    enhancedError.cacheDir = cacheDir;
+    enhancedError.butlerError = true;
+    throw enhancedError;
   }
 
   if (fs.existsSync(stagingDir)) {
     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);
   }
   console.log('Installation complete');
 }
 
-async function updateGameFiles(newVersion, progressCallback, gameDir = GAME_DIR, toolsDir = TOOLS_DIR, cacheDir = CACHE_DIR) {
+async function updateGameFiles(newVersion, progressCallback, gameDir = GAME_DIR, toolsDir = TOOLS_DIR, cacheDir = CACHE_DIR, branchOverride = null) {
   let tempUpdateDir;
+  const branch = branchOverride || loadVersionBranch();
+  const installPath = path.dirname(path.dirname(path.dirname(path.dirname(gameDir))));
+  
+  const config = loadConfig();
+  const oldBranch = config.version_branch || 'release';
+  console.log(`[UpdateGameFiles] Switching from ${oldBranch} to ${branch}`);
+  
   try {
-    if (progressCallback) {
+    // NEW 2.2.0: Ensure UserData migration to centralized location
-      progressCallback('Updating game files...', 0, null, null, null);
+    try {
+      console.log('[UpdateGameFiles] Ensuring UserData migration...');
+      const migrationResult = await migrateUserDataToCentralized();
+      if (migrationResult.migrated) {
+        console.log('[UpdateGameFiles] ✓ UserData migrated to centralized location');
+      } else if (migrationResult.alreadyMigrated) {
+        console.log('[UpdateGameFiles] ✓ UserData already in centralized location');
       }
-    console.log(`Updating game files to version: ${newVersion}`);
+    } catch (migrationError) {
+      console.warn('[UpdateGameFiles] UserData migration warning:', migrationError.message);
+    }
+
+    if (progressCallback) {
+      progressCallback('Updating game files...', 10, null, null, null);
+    }
+    console.log(`Updating game files to version: ${newVersion} (branch: ${branch})`);
 
     tempUpdateDir = path.join(gameDir, '..', 'temp_update');
 
@@ -120,51 +353,46 @@ async function updateGameFiles(newVersion, progressCallback, gameDir = GAME_DIR,
     fs.mkdirSync(tempUpdateDir, { recursive: true });
 
     if (progressCallback) {
-      progressCallback('Downloading new game version...', 10, null, null, null);
+      progressCallback('Downloading new game version...', 20, null, null, null);
     }
 
-    const pwrFile = await downloadPWR('release', newVersion, progressCallback, cacheDir);
+    const pwrFile = await downloadPWR(branch, newVersion, progressCallback, cacheDir);
 
     if (progressCallback) {
-      progressCallback('Extracting new files...', 50, null, null, null);
+      progressCallback('Extracting new files...', 60, null, null, null);
     }
 
-    await applyPWR(pwrFile, progressCallback, tempUpdateDir, toolsDir);
+    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);
     }
 
-    let userDataBackup = null;
-    const userDataPath = findUserDataRecursive(gameDir);
-
-    if (userDataPath && fs.existsSync(userDataPath)) {
-      userDataBackup = path.join(gameDir, '..', 'UserData_backup_' + Date.now());
-      console.log(`Backing up UserData from ${userDataPath} to: ${userDataBackup}`);
-
-      function copyRecursive(src, dest) {
-        const stat = fs.statSync(src);
-        if (stat.isDirectory()) {
-          if (!fs.existsSync(dest)) {
-            fs.mkdirSync(dest, { recursive: true });
-          }
-          const files = fs.readdirSync(src);
-          for (const file of files) {
-            copyRecursive(path.join(src, file), path.join(dest, file));
-          }
-        } else {
-          fs.copyFileSync(src, dest);
-        }
-      }
-
-      copyRecursive(userDataPath, userDataBackup);
-    } else {
-      console.log('No UserData folder found in game directory');
-    }
-
     if (fs.existsSync(gameDir)) {
       console.log('Removing old game files...');
+      let retries = 3;
+      while (retries > 0) {
+        try {
           fs.rmSync(gameDir, { recursive: true, force: true });
+          break;
+        } catch (err) {
+          if ((err.code === 'EPERM' || err.code === 'EBUSY') && retries > 0) {
+            retries--;
+            console.log(`[UpdateGameFiles] Removal failed with ${err.code}, retrying in 1s... (${retries} retries left)`);
+            await new Promise(resolve => setTimeout(resolve, 1000));
+          } else {
+            throw err;
+          }
+        }
+      }
     }
 
     fs.renameSync(tempUpdateDir, gameDir);
@@ -175,44 +403,16 @@ async function updateGameFiles(newVersion, progressCallback, gameDir = GAME_DIR,
     const logoResult = await downloadAndReplaceLogo(gameDir, progressCallback);
     console.log('Logo@2x.png update result after update:', logoResult);
 
-    if (userDataBackup && fs.existsSync(userDataBackup)) {
+    // NEW 2.2.0: No longer create UserData in game installation
-      const newUserDataPath = findUserDataPath(gameDir);
+    // UserData is now in centralized location (getUserDataPath())
-      const userDataParent = path.dirname(newUserDataPath);
+    console.log('[UpdateGameFiles] UserData is managed in centralized location');
-
-      if (!fs.existsSync(userDataParent)) {
-        fs.mkdirSync(userDataParent, { recursive: true });
-      }
-
-      console.log(`Restoring UserData to: ${newUserDataPath}`);
-
-      function copyRecursive(src, dest) {
-        const stat = fs.statSync(src);
-        if (stat.isDirectory()) {
-          if (!fs.existsSync(dest)) {
-            fs.mkdirSync(dest, { recursive: true });
-          }
-          const files = fs.readdirSync(src);
-          for (const file of files) {
-            copyRecursive(path.join(src, file), path.join(dest, file));
-          }
-        } else {
-          fs.copyFileSync(src, dest);
-        }
-      }
-
-      copyRecursive(userDataBackup, newUserDataPath);
-    }
 
     console.log(`Game files updated successfully to version: ${newVersion}`);
     
-    if (userDataBackup && fs.existsSync(userDataBackup)) {
+    // Save the updated version and branch to config
-      try {
+    saveVersionClient(newVersion);
-        fs.rmSync(userDataBackup, { recursive: true, force: true });
+    const { saveVersionBranch } = require('../core/config');
-        console.log('UserData backup cleaned up');
+    saveVersionBranch(branch);
-      } catch (cleanupError) {
-        console.warn('Could not clean up UserData backup:', cleanupError.message);
-      }
-    }
 
     console.log('Waiting for file system sync...');
     await new Promise(resolve => setTimeout(resolve, 2000));
@@ -225,15 +425,6 @@ async function updateGameFiles(newVersion, progressCallback, gameDir = GAME_DIR,
   } catch (error) {
     console.error('Error updating game files:', error);
 
-    if (userDataBackup && fs.existsSync(userDataBackup)) {
-      try {
-        fs.rmSync(userDataBackup, { recursive: true, force: true });
-        console.log('UserData backup cleaned up after error');
-      } catch (cleanupError) {
-        console.warn('Could not clean up UserData backup:', cleanupError.message);
-      }
-    }
-
     if (tempUpdateDir && fs.existsSync(tempUpdateDir)) {
       fs.rmSync(tempUpdateDir, { recursive: true, force: true });
     }
@@ -242,20 +433,38 @@ async function updateGameFiles(newVersion, progressCallback, gameDir = GAME_DIR,
   }
 }
 
-function isGameInstalled() {
+function isGameInstalled(branchOverride = null) {
+  const branch = branchOverride || loadVersionBranch();
   const appDir = getResolvedAppDir();
-  const gameDir = path.join(appDir, 'release', 'package', 'game', 'latest');
+  const gameDir = path.join(appDir, branch, 'package', 'game', 'latest');
   const clientPath = findClientPath(gameDir);
   return clientPath !== null;
 }
 
-async function installGame(playerName = 'Player', progressCallback, javaPathOverride, installPathOverride) {
+async function installGame(playerName = 'Player', progressCallback, javaPathOverride, installPathOverride, branchOverride = null) {
+  console.log(`[InstallGame] branchOverride parameter received: ${branchOverride}`);
+  const loadedBranch = loadVersionBranch();
+  console.log(`[InstallGame] loadVersionBranch() returned: ${loadedBranch}`);
+  const branch = branchOverride || loadedBranch;
+  console.log(`[InstallGame] Final branch selected: ${branch}`);
   const customAppDir = getResolvedAppDir(installPathOverride);
   const customCacheDir = path.join(customAppDir, 'cache');
   const customToolsDir = path.join(customAppDir, 'butler');
-  const customGameDir = path.join(customAppDir, 'release', 'package', 'game', 'latest');
+  const customGameDir = path.join(customAppDir, branch, 'package', 'game', 'latest');
-  const customJreDir = path.join(customAppDir, 'release', 'package', 'jre', 'latest');
+  const customJreDir = path.join(customAppDir, branch, 'package', 'jre', 'latest');
-  const userDataDir = path.join(customGameDir, 'Client', 'UserData');
+
+  // NEW 2.2.0: Ensure UserData migration to centralized location
+  try {
+    console.log('[InstallGame] Ensuring UserData migration...');
+    const migrationResult = await migrateUserDataToCentralized();
+    if (migrationResult.migrated) {
+      console.log('[InstallGame] ✓ UserData migrated to centralized location');
+    } else if (migrationResult.alreadyMigrated) {
+      console.log('[InstallGame] ✓ UserData already in centralized location');
+    }
+  } catch (migrationError) {
+    console.warn('[InstallGame] UserData migration warning:', migrationError.message);
+  }
 
   [customAppDir, customCacheDir, customToolsDir].forEach(dir => {
     if (!fs.existsSync(dir)) {
@@ -263,10 +472,6 @@ async function installGame(playerName = 'Player', progressCallback, javaPathOver
     }
   });
 
-  if (!fs.existsSync(userDataDir)) {
-    fs.mkdirSync(userDataDir, { recursive: true });
-  }
-
   saveUsername(playerName);
   if (installPathOverride) {
     saveInstallPath(installPathOverride);
@@ -297,9 +502,17 @@ async function installGame(playerName = 'Player', progressCallback, javaPathOver
     try {
       await downloadJRE(progressCallback, customCacheDir, customJreDir);
     } catch (error) {
+      // Don't immediately fall back to system Java for JRE download errors - let user retry
+      if (error.isJREError) {
+        console.error('[Install] JRE download failed, allowing user retry:', error.message);
+        throw error; // Re-throw JRE errors to trigger retry UI
+      }
+      
+      // For non-download JRE errors, fall back to system Java
       const fallback = await detectSystemJava();
       if (fallback) {
         javaBin = fallback;
+        console.log('[Install] Using system Java as fallback');
       } else {
         throw error;
       }
@@ -313,11 +526,38 @@ async function installGame(playerName = 'Player', progressCallback, javaPathOver
   if (progressCallback) {
     progressCallback('Fetching game files...', null, null, null, null);
   }
-  console.log('Installing game files...');
+  console.log(`Installing game files for branch: ${branch}...`);
 
-  const latestVersion = await getLatestClientVersion();
+  const latestVersion = await getLatestClientVersion(branch);
-  const pwrFile = await downloadPWR('release', latestVersion, progressCallback, customCacheDir);
+  const targetVersion = FORCE_CLEAN_INSTALL_VERSION ? CLEAN_INSTALL_TEST_VERSION : latestVersion;
-  await applyPWR(pwrFile, progressCallback, customGameDir, customToolsDir);
+  
+  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);
+    
+    if (!pwrFile) {
+      console.log('[Install] PWR file not found or invalid, attempting retry...');
+      pwrFile = await retryPWRDownload(branch, targetVersion, progressCallback, customCacheDir);
+    }
+    
+    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;
+  }
+  
+  await applyPWR(pwrFile, progressCallback, customGameDir, customToolsDir, branch, customCacheDir);
+
+  saveVersionClient(targetVersion);
+  const { saveVersionBranch } = require('../core/config');
+  saveVersionBranch(branch);
 
   const homeUIResult = await downloadAndReplaceHomePageUI(customGameDir, progressCallback);
   console.log('HomePage.ui update result after installation:', homeUIResult);
@@ -325,6 +565,10 @@ 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
+  // UserData is managed in centralized location (getUserDataPath())
+  console.log('[InstallGame] UserData is managed in centralized location');
+
   if (progressCallback) {
     progressCallback('Installation complete', 100, null, null, null);
   }
@@ -357,8 +601,9 @@ async function uninstallGame() {
   }
 }
 
-function checkExistingGameInstallation() {
+function checkExistingGameInstallation(branchOverride = null) {
   try {
+    const branch = branchOverride || loadVersionBranch();
     const config = loadConfig();
 
     if (!config.installPath || !config.installPath.trim()) {
@@ -366,7 +611,7 @@ function checkExistingGameInstallation() {
     }
 
     const installPath = config.installPath.trim();
-    const gameDir = path.join(installPath, 'HytaleF2P', 'release', 'package', 'game', 'latest');
+    const gameDir = path.join(installPath, 'HytaleF2P', branch, 'package', 'game', 'latest');
 
     if (!fs.existsSync(gameDir)) {
       return null;
@@ -384,7 +629,8 @@ function checkExistingGameInstallation() {
       clientPath: clientPath,
       userDataPath: userDataPath,
       installPath: installPath,
-      hasUserData: userDataPath && fs.existsSync(userDataPath)
+      hasUserData: userDataPath && fs.existsSync(userDataPath),
+      branch: branch
     };
   } catch (error) {
     console.error('Error checking existing game installation:', error);
@@ -392,40 +638,32 @@ function checkExistingGameInstallation() {
   }
 }
 
-async function repairGame(progressCallback) {
+async function repairGame(progressCallback, branchOverride = null) {
+  const branch = branchOverride || loadVersionBranch();
   const appDir = getResolvedAppDir();
-  const gameDir = path.join(appDir, 'release', 'package', 'game', 'latest');
+  const gameDir = path.join(appDir, branch, 'package', 'game', 'latest');
+  const installPath = appDir;
+  let backupPath = null;
+
+  // Vérifier si on a version_client et version_branch dans config.json
+  const config = loadConfig();
+  const hasVersionConfig = !!(config.version_client && config.version_branch);
+  console.log(`[RepairGame] hasVersionConfig: ${hasVersionConfig}`);
 
   // Check if game exists
   if (!fs.existsSync(gameDir)) {
     throw new Error('Game directory not found. Cannot repair.');
   }
 
-  // Locate UserData
-  const userDataPath = findUserDataRecursive(gameDir);
-  let userDataBackup = null;
-
   if (progressCallback) {
     progressCallback('Backing up user data...', 10, null, null, null);
   }
 
-  // Backup UserData
+  // Backup UserData using new system
-  if (userDataPath && fs.existsSync(userDataPath)) {
+  try {
-    userDataBackup = path.join(appDir, 'UserData_backup_repair_' + Date.now());
+    backupPath = await userDataBackup.backupUserData(installPath, branch, hasVersionConfig);
-    console.log(`Backing up UserData during repair from ${userDataPath} to ${userDataBackup}`);
+  } catch (backupError) {
-
+    console.warn('UserData backup failed during repair:', backupError.message);
-    // Copy function
-    function copyRecursive(src, dest) {
-      const stat = fs.statSync(src);
-      if (stat.isDirectory()) {
-        if (!fs.existsSync(dest)) fs.mkdirSync(dest, { recursive: true });
-        fs.readdirSync(src).forEach(child => copyRecursive(path.join(src, child), path.join(dest, child)));
-      } else {
-        fs.copyFileSync(src, dest);
-      }
-    }
-
-    copyRecursive(userDataPath, userDataBackup);
   }
 
   if (progressCallback) {
@@ -446,39 +684,21 @@ async function repairGame(progressCallback) {
 
   // Passing null/undefined for overrides to use defaults/saved configs
   // installGame calls progressCallback internally
-  await installGame('Player', progressCallback);
+  await installGame('Player', progressCallback, null, null, branch);
 
-  // Restore UserData
+  // Restore UserData using new system
-  if (userDataBackup && fs.existsSync(userDataBackup)) {
+  if (backupPath) {
     if (progressCallback) {
       progressCallback('Restoring user data...', 90, null, null, null);
     }
 
-    // installGame creates: path.join(customGameDir, 'Client', 'UserData')
+    try {
-    const newGameDir = path.join(appDir, 'release', 'package', 'game', 'latest');
+      await userDataBackup.restoreUserData(backupPath, installPath, branch);
-    const newUserDataPath = path.join(newGameDir, 'Client', 'UserData');
+      await userDataBackup.cleanupBackup(backupPath);
-
+      console.log('UserData restored successfully after repair');
-    if (!fs.existsSync(newUserDataPath)) {
+    } catch (restoreError) {
-      fs.mkdirSync(newUserDataPath, { recursive: true });
+      console.warn('UserData restore failed after repair:', restoreError.message);
     }
-
-    console.log(`Restoring UserData to ${newUserDataPath}`);
-
-    function copyRecursive(src, dest) {
-      const stat = fs.statSync(src);
-      if (stat.isDirectory()) {
-        if (!fs.existsSync(dest)) fs.mkdirSync(dest, { recursive: true });
-        fs.readdirSync(src).forEach(child => copyRecursive(path.join(src, child), path.join(dest, child)));
-      } else {
-        fs.copyFileSync(src, dest);
-      }
-    }
-
-    copyRecursive(userDataBackup, newUserDataPath);
-
-    // Cleanup Backup
-    console.log('Cleaning up repair backup...');
-    fs.rmSync(userDataBackup, { recursive: true, force: true });
   }
 
   if (progressCallback) {
@@ -488,8 +708,79 @@ async function repairGame(progressCallback) {
   return { success: true, repaired: true };
 }
 
+// Directory validation and cleanup function
+function validateGameDirectory(gameDir, stagingDir) {
+  try {
+    // Ensure game directory exists and is writable
+    if (!fs.existsSync(gameDir)) {
+      fs.mkdirSync(gameDir, { recursive: true });
+      console.log(`[Butler] Created game directory: ${gameDir}`);
+    }
+    
+    // Test write permissions
+    const testFile = path.join(gameDir, '.permission_test');
+    fs.writeFileSync(testFile, 'test');
+    fs.unlinkSync(testFile);
+    console.log(`[Butler] Game directory is writable: ${gameDir}`);
+    
+    // Clean and ensure staging directory
+    if (fs.existsSync(stagingDir)) {
+      console.log(`[Butler] Cleaning existing staging directory: ${stagingDir}`);
+      fs.rmSync(stagingDir, { recursive: true, force: true });
+    }
+    fs.mkdirSync(stagingDir, { recursive: true });
+    console.log(`[Butler] Created clean staging directory: ${stagingDir}`);
+    
+    // Check disk space (basic check)
+    const freeSpace = fs.statSync(gameDir);
+    console.log(`[Butler] Directory validation completed successfully`);
+    
+  } catch (error) {
+    throw new Error(`Directory validation failed: ${error.message}. Please check permissions and disk space.`);
+  }
+}
+
+// Enhanced PWR file validation
+function validatePWRFile(filePath) {
+  try {
+    if (!fs.existsSync(filePath)) {
+      return false;
+    }
+    
+    const stats = fs.statSync(filePath);
+    const sizeInMB = stats.size / 1024 / 1024;
+    
+    if (stats.size < 1024 * 1024) {
+      return false;
+    }
+    
+    // Check if file is under 1.5 GB (incomplete download)
+    if (sizeInMB < 1500) {
+      console.log(`[PWR Validation] File appears incomplete: ${sizeInMB.toFixed(2)} MB < 1.5 GB`);
+      return false;
+    }
+    
+    // Basic file header validation (PWR files should have specific headers)
+    const buffer = fs.readFileSync(filePath, { start: 0, end: 20 });
+    if (buffer.length < 10) {
+      return false;
+    }
+    
+    // Check for common PWR magic bytes or patterns
+    // This is a basic check - could be enhanced with actual PWR format specification
+    const header = buffer.toString('hex', 0, 10);
+    console.log(`[PWR Validation] File header: ${header}`);
+    
+    return true;
+  } catch (error) {
+    console.error(`[PWR Validation] Error:`, error.message);
+    return false;
+  }
+}
+
 module.exports = {
   downloadPWR,
+  retryPWRDownload,
   applyPWR,
   updateGameFiles,
   isGameInstalled,

backend/managers/javaManager.js

@@ -9,7 +9,7 @@ const tar = require('tar');
 const { expandHome, JRE_DIR } = require('../core/paths');
 const { getOS, getArch } = require('../utils/platformUtils');
 const { loadConfig } = require('../core/config');
-const { downloadFile } = require('../utils/fileManager');
+const { downloadFile, retryDownload } = require('../utils/fileManager');
 
 const execFileAsync = promisify(execFile);
 const JAVA_EXECUTABLE = 'java' + (process.platform === 'win32' ? '.exe' : '');
@@ -188,6 +188,20 @@ async function getJavaDetection() {
   };
 }
 
+// Manual retry function for JRE downloads
+async function retryJREDownload(url, cacheFile, progressCallback) {
+  console.log('Initiating manual JRE retry...');
+  
+  // Ensure cache directory exists before retrying
+  const cacheDir = path.dirname(cacheFile);
+  if (!fs.existsSync(cacheDir)) {
+    console.log('Creating JRE cache directory:', cacheDir);
+    fs.mkdirSync(cacheDir, { recursive: true });
+  }
+  
+  return await retryDownload(url, cacheFile, progressCallback);
+}
+
 async function downloadJRE(progressCallback, cacheDir, jreDir = JRE_DIR) {
   if (!fs.existsSync(cacheDir)) {
     fs.mkdirSync(cacheDir, { recursive: true });
@@ -230,7 +244,40 @@ async function downloadJRE(progressCallback, cacheDir, jreDir = JRE_DIR) {
       progressCallback('Fetching Java runtime...', null, null, null, null);
     }
     console.log('Fetching Java runtime...');
-    await downloadFile(platform.url, cacheFile, progressCallback);
+    let jreFile;
+    try {
+      jreFile = await downloadFile(platform.url, cacheFile, progressCallback);
+      
+      // If downloadFile returns false or undefined, it means the download failed
+      // We should retry the download with a manual retry
+      if (!jreFile || typeof jreFile !== 'string') {
+        console.log('[JRE Download] JRE file download failed or incomplete, attempting retry...');
+        jreFile = await retryJREDownload(platform.url, cacheFile, progressCallback);
+      }
+      
+      // Double-check we have a valid file
+      if (!jreFile || typeof jreFile !== 'string') {
+        throw new Error(`JRE download failed: received invalid path ${jreFile}. Please retry download.`);
+      }
+      
+    } catch (downloadError) {
+      console.error('[JRE Download] JRE download failed:', downloadError.message);
+      
+      // Enhance error with retry information for the UI
+      const enhancedError = new Error(`JRE download failed: ${downloadError.message}`);
+      enhancedError.originalError = downloadError;
+      enhancedError.canRetry = downloadError.isConnectionLost ? false : (downloadError.canRetry !== false);
+      enhancedError.jreUrl = platform.url;
+      enhancedError.jreDest = cacheFile;
+      enhancedError.osName = osName;
+      enhancedError.arch = arch;
+      enhancedError.fileName = fileName;
+      enhancedError.cacheDir = cacheDir;
+      enhancedError.isJREError = true; // Flag to identify JRE errors
+      enhancedError.isConnectionLost = downloadError.isConnectionLost || false;
+      
+      throw enhancedError;
+    }
     console.log('Download finished');
   }
 
@@ -359,5 +406,6 @@ module.exports = {
   getJavaDetection,
   downloadJRE,
   extractJRE,
+  retryJREDownload,
   JAVA_EXECUTABLE
 };

backend/managers/modManager.js

@@ -2,11 +2,12 @@ const fs = require('fs');
 const path = require('path');
 const crypto = require('crypto');
 const axios = require('axios');
-const { getModsPath, getProfilesDir } = require('../core/paths');
+const { getOS } = require('../utils/platformUtils');
+const { getModsPath, getProfilesDir, getHytaleSavesDir } = require('../core/paths');
 const { saveModsToConfig, loadModsFromConfig } = require('../core/config');
 const profileManager = require('./profileManager');
 
-const API_KEY = process.env.CURSEFORGE_API_KEY;
+const API_KEY = "$2a$10$bqk254NMZOWVTzLVJCcxEOmhcyUujKxA5xk.kQCN9q0KNYFJd5b32";
 
 /**
  * Get the physical mods path for a specific profile.
@@ -295,8 +296,9 @@ async function syncModsForCurrentProfile() {
     console.log(`[ModManager] Syncing mods for profile: ${activeProfile.name} (${activeProfile.id})`);
 
     // 1. Resolve Paths
-    // globalModsPath is the one the game uses (symlink target)
+    // centralModsPath is HytaleSaves\Mods (centralized location for active mods)
-    const globalModsPath = await getModsPath(); 
+    const hytaleSavesDir = getHytaleSavesDir();
+    const centralModsPath = path.join(hytaleSavesDir, 'Mods');
     // profileModsPath is the real storage for this profile
     const profileModsPath = getProfileModsPath(activeProfile.id);
     const profileDisabledModsPath = path.join(path.dirname(profileModsPath), 'DisabledMods');
@@ -305,77 +307,50 @@ async function syncModsForCurrentProfile() {
       fs.mkdirSync(profileDisabledModsPath, { recursive: true });
     }
 
-    // 2. Symlink / Migration Logic
+    // 2. Copy-based Mod Sync (No symlinks - avoids permission issues)
-    let needsLink = false;
+    // Ensure HytaleSaves\Mods directory exists
-
+    if (!fs.existsSync(centralModsPath)) {
-    if (fs.existsSync(globalModsPath)) {
+      fs.mkdirSync(centralModsPath, { recursive: true });
-      const stats = fs.lstatSync(globalModsPath);
+      console.log(`[ModManager] Created centralized mods directory: ${centralModsPath}`);
-      
-      if (stats.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 (stats.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
+    // Check for old symlink and convert to real directory if needed (one-time migration)
-        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 {
-            fs.rmSync(globalModsPath, { recursive: true, force: true });
+      const centralStats = fs.lstatSync(centralModsPath);
-            needsLink = true;
+      if (centralStats.isSymbolicLink()) {
+        console.log('[ModManager] Removing old symlink, converting to copy-based system...');
+        fs.unlinkSync(centralModsPath);
+        fs.mkdirSync(centralModsPath, { recursive: true });
+      }
     } catch (e) {
-            console.error('Failed to remove global mods dir:', e);
+      // Path doesn't exist, will be created above
-             // Throw error to stop.
-             throw new Error('Failed to migrate mods directory. Please clear ' + globalModsPath);
-        }
-      }
-    } else {
-      needsLink = true;
     }
 
-    if (needsLink) {
+    // Copy enabled mods from profile to HytaleSaves\Mods (for game to use)
-      console.log(`[ModManager] Creating symlink: ${globalModsPath} -> ${profileModsPath}`);
+    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);
       try {
-         // 'junction' is key for Windows without admin
+        fs.unlinkSync(filePath);
-         fs.symlinkSync(profileModsPath, globalModsPath, 'junction'); 
+      } catch (e) {
-      } catch (err) {
+        console.warn(`Failed to remove ${file} from central mods:`, e.message);
-        // 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 });
       }
     }
+    
+    // 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);
+      }
     }
 
     // 3. Auto-Repair (Download missing mods)
@@ -441,7 +416,7 @@ async function syncModsForCurrentProfile() {
     }
 
     // 5. Enforce Enabled/Disabled State (Move files between Profile/Mods and Profile/DisabledMods)
-    // Note: Since Global/Mods IS Profile/Mods (via symlink), moving out of Profile/Mods disables it for the game.
+    // Note: Enabled mods are copied to HytaleSaves\Mods, disabled mods stay in Profile/DisabledMods
     
     const disabledFiles = fs.existsSync(profileDisabledModsPath) ? fs.readdirSync(profileDisabledModsPath).filter(f => f.endsWith('.jar') || f.endsWith('.zip')) : [];
     const allFiles = new Set([...enabledFiles, ...disabledFiles]);

backend/services/firstLaunch.js

@@ -1,6 +1,6 @@
 const path = require('path');
 const fs = require('fs');
-const { markAsLaunched, loadConfig } = require('../core/config');
+const { markAsLaunched, loadConfig, saveVersionBranch, saveVersionClient, loadVersionBranch, loadVersionClient } = require('../core/config');
 const { checkExistingGameInstallation, updateGameFiles } = require('../managers/gameManager');
 const { getInstalledClientVersion, getLatestClientVersion } = require('./versionManager');
 
@@ -56,6 +56,14 @@ async function handleFirstLaunchCheck(progressCallback) {
   try {
     const config = loadConfig();
     
+    // Initialize version_client if not set (but don't force version_branch)
+    const currentVersion = loadVersionClient();
+    
+    if (currentVersion === undefined || currentVersion === null) {
+      console.log('Initializing version_client to null (will trigger installation)');
+      saveVersionClient(null);
+    }
+    
     if (config.hasLaunchedBefore === true) {
       return { isFirstLaunch: false, needsUpdate: false };
     }

backend/services/versionManager.js

@@ -1,10 +1,17 @@
 const axios = require('axios');
+const crypto = require('crypto');
+const fs = require('fs');
+const { getOS, getArch } = require('../utils/platformUtils');
 
-async function getLatestClientVersion() {
+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...');
+    console.log(`Fetching latest client version from API (branch: ${branch})...`);
     const response = await axios.get('https://files.hytalef2p.com/api/version_client', {
-      timeout: 5000,
+      params: { branch },
+      timeout: 40000,
       headers: {
         'User-Agent': 'Hytale-F2P-Launcher'
       }
@@ -12,45 +19,147 @@ async function getLatestClientVersion() {
 
     if (response.data && response.data.client_version) {
       const version = response.data.client_version;
-      console.log(`Latest client version: ${version}`);
+      console.log(`Latest client version for ${branch}: ${version}`);
       return version;
     } else {
-      console.log('Warning: Invalid API response, falling back to default version');
+      console.log('Warning: Invalid API response, falling back to latest known version (7.pwr)');
-      return '4.pwr';
+      return '7.pwr';
     }
   } catch (error) {
     console.error('Error fetching client version:', error.message);
-    console.log('Warning: API unavailable, falling back to default version');
+    console.log('Warning: API unavailable, falling back to latest known version (7.pwr)');
-    return '4.pwr';
+    return '7.pwr';
   }
 }
 
-async function getInstalledClientVersion() {
+function buildArchiveUrl(buildNumber, branch = 'release') {
-  try {
+  const os = getOS();
-    console.log('Fetching installed client version from API...');
+  const arch = getArch();
-    const response = await axios.get('https://files.hytalef2p.com/api/clientCheck', {
+  return `${BASE_PATCH_URL}/${os}/${arch}/${branch}/0/${buildNumber}.pwr`;
-      timeout: 5000,
+}
-      headers: {
-        'User-Agent': 'Hytale-F2P-Launcher'
-      }
-    });
 
-    if (response.data && response.data.client_version) {
+async function checkArchiveExists(buildNumber, branch = 'release') {
-      const version = response.data.client_version;
+  const url = buildArchiveUrl(buildNumber, branch);
-      console.log(`Installed client version: ${version}`);
+  try {
-      return version;
+    const response = await axios.head(url, { timeout: 10000 });
-    } else {
+    return response.status === 200;
-      console.log('Warning: Invalid clientCheck API response');
-      return null;
-    }
   } catch (error) {
-    console.error('Error fetching installed client version:', error.message);
+    return false;
-    console.log('Warning: clientCheck API unavailable');
+  }
+}
+
+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;
   }
 }
 
 module.exports = {
   getLatestClientVersion,
+  buildArchiveUrl,
+  checkArchiveExists,
+  discoverAvailableVersions,
+  extractVersionDetails,
+  canUseDifferentialUpdate,
+  needsIntermediatePatches,
+  computeFileChecksum,
+  validateChecksum,
   getInstalledClientVersion
 };

backend/updateManager.js

@@ -1,73 +0,0 @@
-const axios = require('axios');
-
-const UPDATE_CHECK_URL = 'https://files.hytalef2p.com/api/version_launcher';
-const CURRENT_VERSION = '2.0.2';
-const GITHUB_DOWNLOAD_URL = 'https://github.com/amiayweb/Hytale-F2P/';
-
-class UpdateManager {
-    constructor() {
-        this.updateAvailable = false;
-        this.remoteVersion = null;
-    }
-
-    async checkForUpdates() {
-        try {
-            console.log('Checking for updates...');
-            console.log(`Local version: ${CURRENT_VERSION}`);
-            
-            const response = await axios.get(UPDATE_CHECK_URL, {
-                timeout: 5000,
-                headers: {
-                    'User-Agent': 'Hytale-F2P-Launcher'
-                }
-            });
-
-            if (response.data && response.data.launcher_version) {
-                this.remoteVersion = response.data.launcher_version;
-                console.log(`Remote version: ${this.remoteVersion}`);
-                
-                if (this.remoteVersion !== CURRENT_VERSION) {
-                    this.updateAvailable = true;
-                    console.log('Update available!');
-                    return {
-                        updateAvailable: true,
-                        currentVersion: CURRENT_VERSION,
-                        newVersion: this.remoteVersion,
-                        downloadUrl: GITHUB_DOWNLOAD_URL
-                    };
-                } else {
-                    console.log('Launcher is up to date');
-                    return {
-                        updateAvailable: false,
-                        currentVersion: CURRENT_VERSION,
-                        newVersion: this.remoteVersion
-                    };
-                }
-            } else {
-                throw new Error('Invalid API response');
-            }
-        } catch (error) {
-            console.error('Error checking for updates:', error.message);
-            return {
-                updateAvailable: false,
-                error: error.message,
-                currentVersion: CURRENT_VERSION
-            };
-        }
-    }
-
-    getDownloadUrl() {
-        return GITHUB_DOWNLOAD_URL;
-    }
-
-    getUpdateInfo() {
-        return {
-            updateAvailable: this.updateAvailable,
-            currentVersion: CURRENT_VERSION,
-            remoteVersion: this.remoteVersion,
-            downloadUrl: this.getDownloadUrl()
-        };
-    }
-}
-
-module.exports = UpdateManager;

backend/utils/clientPatcher.js

@@ -1,10 +1,10 @@
 const fs = require('fs');
 const path = require('path');
-const crypto = require('crypto');
-const AdmZip = require('adm-zip');
 
 // Domain configuration
 const ORIGINAL_DOMAIN = 'hytale.com';
+const MIN_DOMAIN_LENGTH = 4;
+const MAX_DOMAIN_LENGTH = 16;
 
 function getTargetDomain() {
   if (process.env.HYTALE_AUTH_DOMAIN) {
@@ -14,15 +14,20 @@ function getTargetDomain() {
     const { getAuthDomain } = require('../core/config');
     return getAuthDomain();
   } catch (e) {
-    return 'sanasol.ws';
+    return 'auth.sanasol.ws';
   }
 }
 
-const DEFAULT_NEW_DOMAIN = 'sanasol.ws';
+const DEFAULT_NEW_DOMAIN = 'auth.sanasol.ws';
 
 /**
- * Patches HytaleClient and HytaleServer binaries to replace hytale.com with custom domain
+ * Patches HytaleClient binary to replace hytale.com with custom domain
- * This allows the game to connect to a custom authentication server
+ * Server patching is done via pre-patched JAR download from CDN
+ *
+ * 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
  */
 class ClientPatcher {
   constructor() {
@@ -34,14 +39,63 @@ class ClientPatcher {
    */
   getNewDomain() {
     const domain = getTargetDomain();
-    if (domain.length !== ORIGINAL_DOMAIN.length) {
+    if (domain.length < MIN_DOMAIN_LENGTH) {
-      console.warn(`Warning: Domain "${domain}" length (${domain.length}) doesn't match original "${ORIGINAL_DOMAIN}" (${ORIGINAL_DOMAIN.length})`);
+      console.warn(`Warning: Domain "${domain}" is too short (min ${MIN_DOMAIN_LENGTH} chars)`);
+      console.warn(`Using default domain: ${DEFAULT_NEW_DOMAIN}`);
+      return DEFAULT_NEW_DOMAIN;
+    }
+    if (domain.length > MAX_DOMAIN_LENGTH) {
+      console.warn(`Warning: Domain "${domain}" is too long (max ${MAX_DOMAIN_LENGTH} chars)`);
       console.warn(`Using default domain: ${DEFAULT_NEW_DOMAIN}`);
       return DEFAULT_NEW_DOMAIN;
     }
     return domain;
   }
 
+  /**
+   * Calculate the domain patching strategy based on length
+   */
+  getDomainStrategy(domain) {
+    if (domain.length <= 10) {
+      return {
+        mode: 'direct',
+        mainDomain: domain,
+        subdomainPrefix: '',
+        description: `Direct replacement: hytale.com -> ${domain}`
+      };
+    } else {
+      const prefix = domain.slice(0, 6);
+      const suffix = domain.slice(6);
+      return {
+        mode: 'split',
+        mainDomain: suffix,
+        subdomainPrefix: prefix,
+        description: `Split mode: subdomain prefix="${prefix}", main domain="${suffix}"`
+      };
+    }
+  }
+
+  /**
+   * Convert a string to the length-prefixed byte format used by the client
+   */
+  stringToLengthPrefixed(str) {
+    const length = str.length;
+    const result = Buffer.alloc(4 + length + (length - 1));
+    result[0] = length;
+    result[1] = 0x00;
+    result[2] = 0x00;
+    result[3] = 0x00;
+
+    let pos = 4;
+    for (let i = 0; i < length; i++) {
+      result[pos++] = str.charCodeAt(i);
+      if (i < length - 1) {
+        result[pos++] = 0x00;
+      }
+    }
+    return result;
+  }
+
   /**
    * Convert a string to UTF-16LE bytes (how .NET stores strings)
    */
@@ -53,13 +107,6 @@ 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
    */
@@ -76,32 +123,28 @@ class ClientPatcher {
   }
 
   /**
-   * UTF-8 domain replacement for Java JAR files.
+   * Replace bytes in buffer - only overwrites the length of new bytes
-   * Java stores strings in UTF-8 format in the constant pool.
    */
-  findAndReplaceDomainUtf8(data, oldDomain, newDomain) {
+  replaceBytes(buffer, oldBytes, newBytes) {
     let count = 0;
-    const result = Buffer.from(data);
+    const result = Buffer.from(buffer);
 
-    const oldUtf8 = this.stringToUtf8(oldDomain);
+    if (newBytes.length > oldBytes.length) {
-    const newUtf8 = this.stringToUtf8(newDomain);
+      console.warn(`  Warning: New pattern (${newBytes.length}) longer than old (${oldBytes.length}), skipping`);
-
+      return { buffer: result, count: 0 };
-    const positions = this.findAllOccurrences(result, oldUtf8);
+    }
 
+    const positions = this.findAllOccurrences(result, oldBytes);
     for (const pos of positions) {
-      newUtf8.copy(result, pos);
+      newBytes.copy(result, pos);
       count++;
-      console.log(`  Patched UTF-8 occurrence at offset 0x${pos.toString(16)}`);
     }
 
     return { buffer: result, count };
   }
 
   /**
-   * Smart domain replacement that handles both null-terminated and non-null-terminated strings.
+   * Smart domain replacement that handles both null-terminated and non-null-terminated strings
-   * .NET AOT stores some strings in various formats:
-   * - Standard UTF-16LE (each char is 2 bytes with \x00 high byte)
-   * - Length-prefixed where last char may have metadata byte instead of \x00
    */
   findAndReplaceDomainSmart(data, oldDomain, newDomain) {
     let count = 0;
@@ -109,8 +152,6 @@ class ClientPatcher {
 
     const oldUtf16NoLast = this.stringToUtf16LE(oldDomain.slice(0, -1));
     const newUtf16NoLast = this.stringToUtf16LE(newDomain.slice(0, -1));
-    const oldLastChar = this.stringToUtf16LE(oldDomain.slice(-1));
-    const newLastChar = this.stringToUtf16LE(newDomain.slice(-1));
 
     const oldLastCharByte = oldDomain.charCodeAt(oldDomain.length - 1);
     const newLastCharByte = newDomain.charCodeAt(newDomain.length - 1);
@@ -125,7 +166,6 @@ class ClientPatcher {
 
       if (lastCharFirstByte === oldLastCharByte) {
         newUtf16NoLast.copy(result, pos);
-
         result[lastCharPos] = newLastCharByte;
 
         if (lastCharPos + 1 < result.length) {
@@ -144,20 +184,90 @@ class ClientPatcher {
   }
 
   /**
-   * Patch Discord invite URLs from .gg/hytale to .gg/MHkEjepMQ7
+   * Apply all domain patches using length-prefixed format
+   */
+  applyDomainPatches(data, domain, protocol = 'https://') {
+    let result = Buffer.from(data);
+    let totalCount = 0;
+    const strategy = this.getDomainStrategy(domain);
+
+    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`;
+
+    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}`);
+    const domainResult = this.replaceBytes(
+      result,
+      this.stringToLengthPrefixed(ORIGINAL_DOMAIN),
+      this.stringToLengthPrefixed(strategy.mainDomain)
+    );
+    result = domainResult.buffer;
+    if (domainResult.count > 0) {
+      console.log(`    Replaced ${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;
+      }
+    }
+
+    return { buffer: result, count: totalCount };
+  }
+
+  /**
+   * Patch Discord invite URLs
    */
   patchDiscordUrl(data) {
     let count = 0;
     const result = Buffer.from(data);
 
     const oldUrl = '.gg/hytale';
-    const newUrl = '.gg/MHkEjepMQ7';
+    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++;
@@ -167,54 +277,118 @@ class ClientPatcher {
   }
 
   /**
-   * Check if the client binary has already been patched
+   * Check patch status of client binary
    */
-  isPatchedAlready(clientPath) {
+  getPatchStatus(clientPath) {
     const newDomain = this.getNewDomain();
     const patchFlagFile = clientPath + this.patchedFlag;
+
     if (fs.existsSync(patchFlagFile)) {
       try {
         const flagData = JSON.parse(fs.readFileSync(patchFlagFile, 'utf8'));
-        if (flagData.targetDomain === newDomain) {
+        const currentDomain = flagData.targetDomain;
-          return true;
+
+        if (currentDomain === newDomain) {
+          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 };
+          } else {
+            console.log('  Flag exists but binary not patched (was updated?), needs re-patching...');
+            return { patched: false, currentDomain: null, needsRestore: 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 the client as patched
+   * Mark client as patched
    */
   markAsPatched(clientPath) {
     const newDomain = this.getNewDomain();
+    const strategy = this.getDomainStrategy(newDomain);
     const patchFlagFile = clientPath + this.patchedFlag;
     const flagData = {
       patchedAt: new Date().toISOString(),
       originalDomain: ORIGINAL_DOMAIN,
       targetDomain: newDomain,
-      patcherVersion: '1.0.0'
+      patchMode: strategy.mode,
+      mainDomain: strategy.mainDomain,
+      subdomainPrefix: strategy.subdomainPrefix,
+      patcherVersion: '2.1.0',
+      verified: 'binary_contents'
     };
     fs.writeFileSync(patchFlagFile, JSON.stringify(flagData, null, 2));
   }
 
   /**
-   * Create a backup of the original client binary
+   * Create backup of 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;
       }
-    console.log('  Backup already exists');
+
+      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;
+    } catch (e) {
+      console.error(`  Failed to create backup: ${e.message}`);
+      return null;
+    }
+  }
+
   /**
-   * Restore the original client binary from backup
+   * Restore original client binary
    */
   restoreClient(clientPath) {
     const backupPath = clientPath + '.original';
@@ -233,15 +407,19 @@ class ClientPatcher {
 
   /**
    * Patch the client binary to use the custom domain
-   * @param {string} clientPath - Path to the HytaleClient binary
-   * @param {function} progressCallback - Optional callback for progress updates
-   * @returns {object} Result object with success status and details
    */
   async patchClient(clientPath, progressCallback) {
     const newDomain = this.getNewDomain();
-    console.log('=== Client Patcher ===');
+    const strategy = this.getDomainStrategy(newDomain);
+
+    console.log('=== Client Patcher v2.1 ===');
     console.log(`Target: ${clientPath}`);
-    console.log(`Replacing: ${ORIGINAL_DOMAIN} -> ${newDomain}`);
+    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}`;
@@ -249,56 +427,64 @@ class ClientPatcher {
       return { success: false, error };
     }
 
-    if (this.isPatchedAlready(clientPath)) {
+    const patchStatus = this.getPatchStatus(clientPath);
+
+    if (patchStatus.patched) {
       console.log(`Client already patched for ${newDomain}, skipping`);
-      if (progressCallback) {
+      if (progressCallback) progressCallback('Client already patched', 100);
-        progressCallback('Client already patched', 100);
-      }
       return { success: true, alreadyPatched: true, patchCount: 0 };
     }
 
-    if (progressCallback) {
+    if (patchStatus.needsRestore) {
-      progressCallback('Preparing to patch client...', 10);
+      if (progressCallback) progressCallback('Restoring original for domain change...', 5);
+      this.restoreFromBackup(clientPath);
     }
 
+    if (progressCallback) progressCallback('Preparing to patch client...', 10);
+
     console.log('Creating backup...');
-    this.backupClient(clientPath);
+    const backupResult = this.backupClient(clientPath);
-
+    if (!backupResult) {
-    if (progressCallback) {
+      console.warn('  Could not create backup - proceeding without backup');
-      progressCallback('Reading client binary...', 20);
     }
 
+    if (progressCallback) progressCallback('Reading client binary...', 20);
+
     console.log('Reading client binary...');
     const data = fs.readFileSync(clientPath);
     console.log(`Binary size: ${(data.length / 1024 / 1024).toFixed(2)} MB`);
 
-    if (progressCallback) {
+    if (progressCallback) progressCallback('Patching domain references...', 50);
-      progressCallback('Patching domain references...', 50);
-    }
 
-    console.log('Patching domain references...');
+    console.log('Applying domain patches (length-prefixed format)...');
-    const { buffer: patchedData, count } = this.findAndReplaceDomainSmart(data, ORIGINAL_DOMAIN, newDomain);
+    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) {
+      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`);
+        fs.writeFileSync(clientPath, legacyResult.buffer);
+        this.markAsPatched(clientPath);
+        return { success: true, patchCount: legacyResult.count, format: 'legacy' };
+      }
+
       console.log('No occurrences found - binary may already be modified or has different format');
       return { success: true, patchCount: 0, warning: 'No occurrences found' };
     }
 
-    if (progressCallback) {
+    if (progressCallback) progressCallback('Writing patched binary...', 80);
-      progressCallback('Writing patched binary...', 80);
-    }
 
     console.log('Writing patched binary...');
     fs.writeFileSync(clientPath, finalData);
 
     this.markAsPatched(clientPath);
 
-    if (progressCallback) {
+    if (progressCallback) progressCallback('Patching complete', 100);
-      progressCallback('Patching complete', 100);
-    }
 
     console.log(`Successfully patched ${count} domain occurrences and ${discordCount} Discord URLs`);
     console.log('=== Patching Complete ===');
@@ -307,17 +493,48 @@ class ClientPatcher {
   }
 
   /**
-   * Patch the server JAR to use the custom domain
+   * Check if server JAR contains DualAuth classes (was patched)
-   * JAR files are ZIP archives, so we need to extract, patch class files, and repackage
-   * @param {string} serverPath - Path to the HytaleServer.jar
-   * @param {function} progressCallback - Optional callback for progress updates
-   * @returns {object} Result object with success status and details
    */
-  async patchServer(serverPath, progressCallback) {
+  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') {
     const newDomain = this.getNewDomain();
-    console.log('=== Server Patcher ===');
+
+    console.log('=== Server Patcher (Pre-patched Download) ===');
     console.log(`Target: ${serverPath}`);
-    console.log(`Replacing: ${ORIGINAL_DOMAIN} -> ${newDomain}`);
+    console.log(`Branch: ${branch}`);
+    console.log(`Domain: ${newDomain}`);
 
     if (!fs.existsSync(serverPath)) {
       const error = `Server JAR not found: ${serverPath}`;
@@ -325,82 +542,183 @@ class ClientPatcher {
       return { success: false, error };
     }
 
-    if (this.isPatchedAlready(serverPath)) {
+    // Check if already patched
-      console.log(`Server already patched for ${newDomain}, skipping`);
+    const patchFlagFile = serverPath + '.dualauth_patched';
-      if (progressCallback) {
+    let needsRestore = false;
-        progressCallback('Server already patched', 100);
+
+    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;
+        }
+      } catch (e) {
+        // Flag file corrupt, re-patch
+        console.log('  Flag file corrupt, will re-download');
+        try { fs.unlinkSync(patchFlagFile); } catch (e) { /* ignore */ }
       }
-      return { success: true, alreadyPatched: true, patchCount: 0 };
     }
 
-    if (progressCallback) {
+    // Restore backup if patched for different domain
-      progressCallback('Preparing to patch server...', 10);
+    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...');
-    this.backupClient(serverPath);
+    const backupResult = this.backupClient(serverPath);
-
+    if (!backupResult) {
-    if (progressCallback) {
+      console.warn('  Could not create backup - proceeding without backup');
-      progressCallback('Extracting server JAR...', 20);
     }
 
-    console.log('Opening server JAR...');
+    // Only support standard domain (auth.sanasol.ws) via pre-patched download
-    const zip = new AdmZip(serverPath);
+    if (newDomain !== 'auth.sanasol.ws' && newDomain !== 'sanasol.ws') {
-    const entries = zip.getEntries();
+      console.error(`Domain "${newDomain}" requires DualAuthPatcher - only auth.sanasol.ws is supported via pre-patched download`);
-    console.log(`JAR contains ${entries.length} entries`);
+      return { success: false, error: `Unsupported domain: ${newDomain}. Only auth.sanasol.ws is supported.` };
-
-    if (progressCallback) {
-      progressCallback('Patching class files...', 40);
     }
 
-    let totalCount = 0;
+    // Download pre-patched JAR
-    const oldUtf8 = this.stringToUtf8(ORIGINAL_DOMAIN);
+    if (progressCallback) progressCallback('Downloading patched server JAR...', 30);
-    const newUtf8 = this.stringToUtf8(newDomain);
+    console.log('Downloading pre-patched HytaleServer.jar...');
 
-    for (const entry of entries) {
+    try {
-      const name = entry.entryName;
+      const https = require('https');
-      if (name.endsWith('.class') || name.endsWith('.properties') ||
-          name.endsWith('.json') || name.endsWith('.xml') || name.endsWith('.yml')) {
       
-        const data = entry.getData();
+      // Use different URL for pre-release vs release
-
+      let url;
-        if (data.includes(oldUtf8)) {
+      if (branch === 'pre-release') {
-          const { buffer: patchedData, count } = this.findAndReplaceDomainUtf8(data, ORIGINAL_DOMAIN, newDomain);
+        url = 'https://patcher.authbp.xyz/download/patched_prerelease';
-          if (count > 0) {
+        console.log('  Using pre-release patched server from:', url);
-            zip.updateFile(entry.entryName, patchedData);
+      } else {
-            console.log(`  Patched ${count} occurrences in ${name}`);
+        url = 'https://patcher.authbp.xyz/download/patched_release';
-            totalCount += count;
+        console.log('  Using release patched server from:', url);
-          }
-        }
-      }
       }
 
-    if (totalCount === 0) {
+      await new Promise((resolve, reject) => {
-      console.log('No occurrences of hytale.com found in server JAR entries');
+        const handleResponse = (response) => {
-      return { success: true, patchCount: 0, warning: 'No domain occurrences found in JAR' };
+          if (response.statusCode === 302 || response.statusCode === 301) {
+            https.get(response.headers.location, handleResponse).on('error', reject);
+            return;
           }
 
-    if (progressCallback) {
+          if (response.statusCode !== 200) {
-      progressCallback('Writing patched JAR...', 80);
+            reject(new Error(`Failed to download: HTTP ${response.statusCode}`));
+            return;
           }
 
-    console.log('Writing patched JAR...');
+          const file = fs.createWriteStream(serverPath);
-    zip.writeZip(serverPath);
+          const totalSize = parseInt(response.headers['content-length'], 10);
+          let downloaded = 0;
 
-    this.markAsPatched(serverPath);
+          response.on('data', (chunk) => {
+            downloaded += chunk.length;
+            if (progressCallback && totalSize) {
+              const percent = 30 + Math.floor((downloaded / totalSize) * 60);
+              progressCallback(`Downloading... ${(downloaded / 1024 / 1024).toFixed(2)} MB`, percent);
+            }
+          });
 
-    if (progressCallback) {
+          response.pipe(file);
-      progressCallback('Server patching complete', 100);
+          file.on('finish', () => {
+            file.close();
+            resolve();
+          });
+        };
+
+        https.get(url, handleResponse).on('error', (err) => {
+          fs.unlink(serverPath, () => {});
+          reject(err);
+        });
+      });
+
+      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');
         }
 
-    console.log(`Successfully patched ${totalCount} occurrences in server`);
+        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
+      }));
+
+      if (progressCallback) progressCallback('Server patching complete', 100);
       console.log('=== Server Patching Complete ===');
+      return { success: true, patchCount: 1 };
 
-    return { success: true, patchCount: totalCount };
+    } 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);
+        console.log('Restored backup after download failure');
+      }
+
+      return { success: false, error: `Failed to download patched server: ${downloadError.message}` };
+    }
   }
 
   /**
-   * Find the client binary path based on platform
+   * Find client binary path based on platform
    */
   findClientPath(gameDir) {
     const candidates = [];
@@ -422,7 +740,9 @@ class ClientPatcher {
     return null;
   }
 
-
+  /**
+   * Find server JAR path
+   */
   findServerPath(gameDir) {
     const candidates = [
       path.join(gameDir, 'Server', 'HytaleServer.jar'),
@@ -439,10 +759,8 @@ class ClientPatcher {
 
   /**
    * Ensure both client and server are patched before launching
-   * @param {string} gameDir - Path to the game directory
-   * @param {function} progressCallback - Optional callback for progress updates
    */
-  async ensureClientPatched(gameDir, progressCallback) {
+  async ensureClientPatched(gameDir, progressCallback, javaPath = null, branch = 'release') {
     const results = {
       client: null,
       server: null,
@@ -451,9 +769,7 @@ class ClientPatcher {
 
     const clientPath = this.findClientPath(gameDir);
     if (clientPath) {
-      if (progressCallback) {
+      if (progressCallback) progressCallback('Patching client binary...', 10);
-        progressCallback('Patching client binary...', 10);
-      }
       results.client = await this.patchClient(clientPath, (msg, pct) => {
         if (progressCallback) {
           progressCallback(`Client: ${msg}`, pct ? pct / 2 : null);
@@ -466,14 +782,12 @@ class ClientPatcher {
 
     const serverPath = this.findServerPath(gameDir);
     if (serverPath) {
-      if (progressCallback) {
+      if (progressCallback) progressCallback('Patching server JAR...', 50);
-        progressCallback('Patching server JAR...', 50);
-      }
       results.server = await this.patchServer(serverPath, (msg, pct) => {
         if (progressCallback) {
           progressCallback(`Server: ${msg}`, pct ? 50 + pct / 2 : null);
         }
-      });
+      }, branch);
     } else {
       console.warn('Could not find HytaleServer.jar');
       results.server = { success: false, error: 'Server JAR not found' };
@@ -483,9 +797,7 @@ class ClientPatcher {
     results.alreadyPatched = (results.client && results.client.alreadyPatched) && (results.server && results.server.alreadyPatched);
     results.patchCount = (results.client ? results.client.patchCount || 0 : 0) + (results.server ? results.server.patchCount || 0 : 0);
 
-    if (progressCallback) {
+    if (progressCallback) progressCallback('Patching complete', 100);
-      progressCallback('Patching complete', 100);
-    }
 
     return results;
   }

backend/utils/fileManager.js

@@ -2,151 +2,454 @@ const fs = require('fs');
 const path = require('path');
 const axios = require('axios');
 
-async function downloadFile(url, dest, progressCallback, maxRetries = 3) {
+// Automatic stall retry constants
+const MAX_AUTOMATIC_STALL_RETRIES = 3;
+const AUTOMATIC_STALL_RETRY_DELAY = 3000; // 3 seconds in milliseconds
+
+// Network monitoring utilities using Node.js built-in methods
+function checkNetworkConnection() {
+  return new Promise((resolve) => {
+    const { lookup } = require('dns');
+    const http = require('http');
+    
+    // Try DNS lookup first (faster) - using callback version
+    lookup('8.8.8.8', (err) => {
+      if (err) {
+        resolve(false);
+        return;
+      }
+      
+      // Try HTTP request to confirm internet connectivity
+      const req = http.get('http://www.google.com', { timeout: 3000 }, (res) => {
+        resolve(true);
+        res.destroy();
+      });
+      
+      req.on('error', () => {
+        resolve(false);
+      });
+      
+      req.on('timeout', () => {
+        req.destroy();
+        resolve(false);
+      });
+    });
+  });
+}
+
+
+
+async function downloadFile(url, dest, progressCallback, maxRetries = 5) {
   let lastError = null;
+  let retryState = {
+    attempts: 0,
+    maxRetries: maxRetries,
+    canRetry: true,
+    lastError: null,
+    automaticStallRetries: 0,
+    isAutomaticRetry: false
+  };
+  let downloadStalled = false;
+  let streamCompleted = false;
 
   for (let attempt = 0; attempt < maxRetries; attempt++) {
     try {
+      retryState.attempts = attempt + 1;
       console.log(`Download attempt ${attempt + 1}/${maxRetries} for ${url}`);
 
       if (attempt > 0 && progressCallback) {
-        progressCallback(`Retry ${attempt}/${maxRetries - 1}...`, null, null, null, null);
+        // Exponential backoff with jitter - longer delays for unstable connections
-        await new Promise(resolve => setTimeout(resolve, 2000 * attempt)); // Délai progressif
+        const baseDelay = 3000;
+        const exponentialDelay = baseDelay * Math.pow(2, attempt - 1);
+        const jitter = Math.random() * 2000;
+        const delay = Math.min(exponentialDelay + jitter, 60000);
+        
+        progressCallback(`Retry ${attempt}/${maxRetries - 1}...`, null, null, null, null, retryState);
+        await new Promise(resolve => setTimeout(resolve, delay));
+      }
+
+      // Create AbortController for proper stream control
+      const controller = new AbortController();
+      let hasReceivedData = false;
+      let lastProgressTime = Date.now(); // Initialize before timeout
+      
+      // Smart overall timeout - only trigger if no progress for extended period
+      const overallTimeout = setInterval(() => {
+        const now = Date.now();
+        const timeSinceLastProgress = now - lastProgressTime;
+        
+        // Only timeout if no data received for 15 minutes (900 seconds) - for very slow connections
+        if (timeSinceLastProgress > 900000 && hasReceivedData) {
+          console.log('Download stalled for 15 minutes, aborting...');
+          console.log(`Download had progress before stall: ${(downloaded / 1024 / 1024).toFixed(2)} MB`);
+          controller.abort();
+        }
+      }, 60000); // Check every minute
+
+      // Check if we can resume existing download
+      let startByte = 0;
+      if (fs.existsSync(dest)) {
+        const existingStats = fs.statSync(dest);
+        
+        // If file size matches remote size, skip download
+        if (existingStats.size == fs.statSync(dest).size) {
+          console.log('File already exists and is complete. Skipping download.');
+          return { success: true, downloaded: existingStats.size };
+        }
+
+        // Only resume if file exists and is substantial (> 1MB)
+        if (existingStats.size > 1024 * 1024) {
+          startByte = existingStats.size;
+          console.log(`Resuming download from byte ${startByte} (${(existingStats.size / 1024 / 1024).toFixed(2)} MB already downloaded)`);
+        } else {
+          // File too small, start fresh
+          fs.unlinkSync(dest);
+          console.log('Existing file too small, starting fresh download');
+        }
+      }
+
+      const headers = {
+        'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36',
+        'Accept': '*/*'
+      };
+      
+      // Add Range header ONLY if resuming (startByte > 0)
+      if (startByte > 0) {
+        headers['Range'] = `bytes=${startByte}-`;
+        console.log(`Adding Range header: bytes=${startByte}-`);
+      } else {
+        console.log('Fresh download, no Range header');
       }
 
       const response = await axios({
         method: 'GET',
         url: url,
         responseType: 'stream',
-        timeout: 60000, // 60 secondes timeout
+        timeout: 120000, // 120 seconds for slow connections
-        headers: {
+        signal: controller.signal,
-          'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+        headers: headers,
-          'Accept': '*/*',
-          'Accept-Language': 'en-US,en;q=0.9',
-          'Referer': 'https://launcher.hytale.com/',
-          'Connection': 'keep-alive'
-        },
-        // Configuration Axios pour la robustesse réseau
         validateStatus: function (status) {
-          return status >= 200 && status < 300;
+          return (status >= 200 && status < 300) || status === 206;
         },
-        // Retry configuration
         maxRedirects: 5,
-        // Network resilience
+        family: 4
-        family: 4 // Force IPv4
       });
 
-      const totalSize = parseInt(response.headers['content-length'], 10);
+      const contentLength = response.headers['content-length'];
-      let downloaded = 0;
+      const totalSize = contentLength ? parseInt(contentLength, 10) + startByte : 0;
-      let lastProgressTime = Date.now();
+      let downloaded = startByte;
+      lastProgressTime = Date.now();
       const startTime = Date.now();
 
-      // Nettoyer le fichier de destination s'il existe
+      // Check network status before attempting download, in case of known offline state
-      if (fs.existsSync(dest)) {
+      try {
-        fs.unlinkSync(dest);
+        const isNetworkOnline = await checkNetworkConnection();
+        if (!isNetworkOnline) {
+          throw new Error('Network connection unavailable. Please check your connection and retry.');
+        }
+      } catch (networkError) {
+        console.error('[Network] Network check failed, proceeding anyway:', networkError.message);
+        // Continue with download attempt - network check failure shouldn't block
       }
 
-      const writer = fs.createWriteStream(dest);
+      const writer = fs.createWriteStream(dest, { 
-      let downloadStalled = false;
+        flags: startByte > 0 ? 'a' : 'w', // 'a' for append (resume), 'w' for write (fresh)
+        start: startByte > 0 ? startByte : 0
+      });
+      let streamError = null;
       let stalledTimeout = null;
       
+      // Reset state for this attempt
+      downloadStalled = false;
+      streamCompleted = false;
+
+      // Enhanced stream event handling
       response.data.on('data', (chunk) => {
         downloaded += chunk.length;
         const now = Date.now();
+        hasReceivedData = true; // Mark that we've received data
 
-        // Reset stalled timer on data received
+        // Reset simple stall timer on data received
         if (stalledTimeout) {
           clearTimeout(stalledTimeout);
         }
 
-        // Set new stalled timer (30 seconds without data = stalled)
+        // Set new stall timer (30 seconds without data = stalled)
-        stalledTimeout = setTimeout(() => {
+        stalledTimeout = setTimeout(async () => {
+          console.log('Download stalled - checking network connectivity...');
+          
+          // Check if network is actually available before retrying
+          try {
+            const isNetworkOnline = await checkNetworkConnection();
+            if (!isNetworkOnline) {
+              console.log('Network connection lost - stopping download and showing error');
               downloadStalled = true;
+              streamError = new Error('Network connection lost. Please check your internet connection and retry.');
+              streamError.isConnectionLost = true;
+              streamError.canRetry = false;
+              controller.abort();
               writer.destroy();
               response.data.destroy();
+              // Immediately reject the promise to prevent hanging
+              setTimeout(() => promiseReject(streamError), 100);
+              return;
+            }
+          } catch (networkError) {
+            console.error('Network check failed during stall detection:', networkError.message);
+          }
+          
+          console.log('Network available - download stalled due to slow connection, aborting for retry...');
+          downloadStalled = true;
+          streamError = new Error('Download stalled due to slow network connection. Please retry.');
+          controller.abort();
+          writer.destroy();
+          response.data.destroy();
+          // Immediately reject the promise to prevent hanging
+          setTimeout(() => promiseReject(streamError), 100);
         }, 30000);
 
         if (progressCallback && totalSize > 0 && (now - lastProgressTime > 100)) { // Update every 100ms max
           const percent = Math.min(100, Math.max(0, (downloaded / totalSize) * 100));
           const elapsed = (now - startTime) / 1000;
           const speed = elapsed > 0 ? downloaded / elapsed : 0;
-          progressCallback(null, percent, speed, downloaded, totalSize);
+          
+          progressCallback(null, percent, speed, downloaded, totalSize, retryState);
           lastProgressTime = now;
         }
       });
 
+      // Enhanced stream error handling
       response.data.on('error', (error) => {
+        // Ignore errors if it was intentionally cancelled or already handled
+        if (downloadStalled || streamCompleted || controller.signal.aborted) {
+          console.log(`Ignoring stream error after cancellation: ${error.code || error.message}`);
+          return;
+        }
+        
+        if (!streamError) {
+          streamError = new Error(`Stream error: ${error.code || error.message}. Please retry.`);
+          // Check for connection lost indicators
+          if (error.code === 'ERR_NETWORK_CHANGED' || 
+              error.code === 'ERR_INTERNET_DISCONNECTED' ||
+              error.code === 'ERR_CONNECTION_LOST') {
+            streamError.isConnectionLost = true;
+            streamError.canRetry = false;
+          }
+          console.error(`Stream error on attempt ${attempt + 1}:`, error.code || error.message);
+        }
         if (stalledTimeout) {
           clearTimeout(stalledTimeout);
         }
-        console.error(`Stream error on attempt ${attempt + 1}:`, error.code || error.message);
+        if (overallTimeout) {
+          clearInterval(overallTimeout);
+        }
         writer.destroy();
       });
 
+      response.data.on('close', () => {
+        // Only treat as error if not already handled by cancellation and writer didn't complete
+        if (!streamError && !streamCompleted && !downloadStalled && !controller.signal.aborted) {
+          // Check if writer actually completed but stream close came first
+          setTimeout(() => {
+            if (!streamCompleted) {
+              streamError = new Error('Stream closed unexpectedly. Please retry.');
+              console.log('Stream closed unexpectedly on attempt', attempt + 1);
+            }
+          }, 500); // Small delay to check if writer completes
+        }
+        if (stalledTimeout) {
+          clearTimeout(stalledTimeout);
+        }
+        if (overallTimeout) {
+          clearInterval(overallTimeout);
+        }
+      });
+
+      response.data.on('abort', () => {
+        // Only treat as error if not already handled by stall detection
+        if (!streamError && !streamCompleted && !downloadStalled) {
+          streamError = new Error('Download aborted due to network issue. Please retry.');
+          console.log('Stream aborted on attempt', attempt + 1);
+        }
+        if (stalledTimeout) {
+          clearTimeout(stalledTimeout);
+        }
+      });
+
       response.data.pipe(writer);
 
+      let promiseReject = null;
       await new Promise((resolve, reject) => {
+        // Store promise reject function for immediate use by stall timeout
+        promiseReject = reject;
         writer.on('finish', () => {
+          streamCompleted = true;
+          console.log(`Writer finished on attempt ${attempt + 1}, downloaded: ${(downloaded / 1024 / 1024).toFixed(2)} MB`);
+          
+          // Clear ALL timeouts to prevent them from firing after completion
           if (stalledTimeout) {
             clearTimeout(stalledTimeout);
+            console.log('Cleared stall timeout after writer finished');
           }
+          if (overallTimeout) {
+            clearInterval(overallTimeout);
+            console.log('Cleared overall timeout after writer finished');
+          }
+          
+          // Download is successful if writer finished - regardless of stream state
           if (!downloadStalled) {
             console.log(`Download completed successfully on attempt ${attempt + 1}`);
             resolve();
           } else {
-            reject(new Error('Download stalled'));
+            // Don't reject here if we already rejected due to network loss - prevents duplicate rejection
+            console.log('Writer finished after stall detection, ignoring...');
           }
         });
 
         writer.on('error', (error) => {
-          if (stalledTimeout) {
+          // Ignore write errors if stream was intentionally cancelled
-            clearTimeout(stalledTimeout);
+          if (downloadStalled || controller.signal.aborted) {
-          }
+            console.log(`Ignoring writer error after cancellation: ${error.code || error.message}`);
-          reject(error);
-        });
-
-        response.data.on('error', (error) => {
-          if (stalledTimeout) {
-            clearTimeout(stalledTimeout);
-          }
-          reject(error);
-        });
-      });
-
-      // Si on arrive ici, le téléchargement a réussi
             return;
+          }
+          
+          if (!streamError) {
+            streamError = new Error(`File write error: ${error.code || error.message}. Please retry.`);
+            console.error(`Writer error on attempt ${attempt + 1}:`, error.code || error.message);
+          }
+          if (stalledTimeout) {
+            clearTimeout(stalledTimeout);
+          }
+          if (overallTimeout) {
+            clearInterval(overallTimeout);
+          }
+          reject(streamError);
+        });
+
+        // Handle case where stream ends without finishing writer
+        response.data.on('end', () => {
+          if (!streamCompleted && !downloadStalled && !streamError) {
+            // Give a small delay for writer to finish - this is normal behavior
+            setTimeout(() => {
+              if (!streamCompleted) {
+                console.log('Stream ended but writer not finished - waiting longer...');
+                // Give more time for writer to finish - this might be slow disk I/O
+                setTimeout(() => {
+                  if (!streamCompleted) {
+                    streamError = new Error('Download incomplete. Please retry.');
+                    reject(streamError);
+                  }
+                }, 2000);
+              }
+            }, 1000);
+          }
+        });
+      });
+
+      return dest;
 
   } catch (error) {
     lastError = error;
+    retryState.lastError = error;
     console.error(`Download attempt ${attempt + 1} failed:`, error.code || error.message);
+    console.error(`Error details:`, { 
+      isConnectionLost: error.isConnectionLost, 
+      canRetry: error.canRetry,
+      message: error.message,
+      downloadStalled: downloadStalled,
+      streamCompleted: streamCompleted
+    });
     
-      // Nettoyer le fichier partiel en cas d'erreur
+    // Check if download actually completed successfully despite the error
+    if (fs.existsSync(dest)) {
+      const stats = fs.statSync(dest);
+      const sizeInMB = stats.size / 1024 / 1024;
+      console.log(`File size after error: ${sizeInMB.toFixed(2)} MB`);
+      
+      // If file is substantial size (> 1.5GB), treat as success and break
+      if (sizeInMB >= 1500) {
+        console.log('File appears to be complete despite error, treating as success');
+        return dest; // Exit the retry loop successfully
+      }
+    }
+
+    // Enhanced file cleanup with validation
     if (fs.existsSync(dest)) {
       try {
+        // HTTP 416 = Range Not Satisfiable, delete corrupted partial file
+        const isRangeError = error.message && error.message.includes('416');
+        
+        // Check if file is corrupted (small or invalid) or if error is non-resumable
+        const partialStats = fs.statSync(dest);
+        const isResumableError = error.message && (
+          error.message.includes('stalled') ||
+          error.message.includes('timeout') ||
+          error.message.includes('network') ||
+          error.message.includes('aborted')
+        );
+        
+        // Check if download appears to be complete (close to expected PWR size)
+        const isPossiblyComplete = partialStats.size >= 1500 * 1024 * 1024; // >= 1.5GB
+        
+        if (isRangeError || partialStats.size < 1024 * 1024 || (!isResumableError && !isPossiblyComplete)) {
+          // Delete if HTTP 416 OR file is too small OR error is non-resumable AND not possibly complete
+          const reason = isRangeError ? 'HTTP 416 range error' : (!isResumableError && !isPossiblyComplete ? 'non-resumable error' : 'too small');
+          console.log(`[Cleanup] Removing file (${reason}): ${(partialStats.size / 1024 / 1024).toFixed(2)} MB`);
           fs.unlinkSync(dest);
+        } else {
+          // Keep the file for resume on resumable errors or if possibly complete
+          console.log(`[Resume] Keeping file (${isPossiblyComplete ? 'possibly complete' : 'for resume'}): ${(partialStats.size / 1024 / 1024).toFixed(2)} MB`);
+        }
       } catch (cleanupError) {
-          console.warn('Could not cleanup partial file:', cleanupError.message);
+        console.warn('Could not handle partial file:', cleanupError.message);
       }
     }
 
-      // Vérifier si c'est une erreur réseau que l'on peut retry
+    // Expanded retryable error codes for better network detection
-      const retryableErrors = ['ECONNRESET', 'ENOTFOUND', 'ECONNREFUSED', 'ETIMEDOUT', 'ESOCKETTIMEDOUT', 'EPROTO'];
+    const retryableErrors = [
+      'ECONNRESET', 'ENOTFOUND', 'ECONNREFUSED', 'ETIMEDOUT', 
+      'ESOCKETTIMEDOUT', 'EPROTO', 'ENETDOWN', 'EHOSTUNREACH',
+      'ECONNABORTED', 'EPIPE', 'ENETRESET', 'EADDRNOTAVAIL',
+      'ERR_NETWORK', 'ERR_INTERNET_DISCONNECTED', 'ERR_CONNECTION_RESET',
+      'ERR_CONNECTION_TIMED_OUT', 'ERR_NAME_NOT_RESOLVED', 'ERR_CONNECTION_CLOSED'
+    ];
+    
     const isRetryable = retryableErrors.includes(error.code) ||
       error.message.includes('timeout') ||
       error.message.includes('stalled') ||
+      error.message.includes('aborted') ||
+      error.message.includes('network') ||
+      error.message.includes('connection') ||
+      error.message.includes('Please retry') ||
+      error.message.includes('corrupted') ||
+      error.message.includes('invalid') ||
       (error.response && error.response.status >= 500);
 
-      if (!isRetryable || attempt === maxRetries - 1) {
+    // Respect error's canRetry property if set
-        console.error(`Non-retryable error or max retries reached: ${error.code || error.message}`);
+    const canRetry = (error.canRetry === false) ? false : isRetryable;
 
+    if (!canRetry || attempt === maxRetries - 1) {
+      // Don't set retryState.canRetry to false for max retries - user should still be able to retry manually
+      retryState.canRetry = error.canRetry === false ? false : true;
+      console.error(`Non-retryable error or max retries reached: ${error.code || error.message}`);
       break;
     }
 
-      console.log(`Retryable error detected, will retry in ${2000 * (attempt + 1)}ms...`);
+    console.log(`Retryable error detected, will retry...`);
     }
   }
 
-  throw new Error(`Download failed after ${maxRetries} attempts. Last error: ${lastError?.code || lastError?.message || 'Unknown error'}`);
+  // Enhanced error with retry state and user-friendly message
+  const detailedError = lastError?.code || lastError?.message || 'Unknown error';
+  const errorMessage = `Download failed after ${maxRetries} attempts. Last error: ${detailedError}. Please retry`;
+  const enhancedError = new Error(errorMessage);
+  enhancedError.retryState = retryState;
+  enhancedError.lastError = lastError;
+  enhancedError.detailedError = detailedError;
+  
+  // Allow manual retry unless it's a connection lost error
+  enhancedError.canRetry = !lastError?.isConnectionLost && lastError?.canRetry !== false;
+  throw enhancedError;
 }
 
 function findHomePageUIPath(gameLatest) {
@@ -205,8 +508,82 @@ function findLogoPath(gameLatest) {
   return searchDirectory(gameLatest);
 }
 
+// Automatic stall retry function for network stalls
+async function retryStalledDownload(url, dest, progressCallback, previousError = null) {
+  console.log('Automatic stall retry initiated for:', url);
+  
+  // Wait before retry to allow network recovery
+  console.log(`Waiting ${AUTOMATIC_STALL_RETRY_DELAY/1000} seconds before automatic retry...`);
+  await new Promise(resolve => setTimeout(resolve, AUTOMATIC_STALL_RETRY_DELAY));
+  
+  try {
+    // Create new retryState for automatic retry
+    const automaticRetryState = {
+      attempts: 1,
+      maxRetries: 1,
+      canRetry: true,
+      lastError: null,
+      automaticStallRetries: (previousError && previousError.retryState) ? previousError.retryState.automaticStallRetries + 1 : 1,
+      isAutomaticRetry: true
+    };
+    
+    // Update progress callback with automatic retry info
+    if (progressCallback) {
+      progressCallback(
+        `Automatic stall retry ${automaticRetryState.automaticStallRetries}/${MAX_AUTOMATIC_STALL_RETRIES}...`,
+        null, null, null, null, automaticRetryState
+      );
+    }
+    
+    await downloadFile(url, dest, progressCallback, 1);
+    console.log('Automatic stall retry successful');
+  } catch (error) {
+    console.error('Automatic stall retry failed:', error.message);
+    throw error;
+  }
+}
+
+// Manual retry function for user-initiated retries
+async function retryDownload(url, dest, progressCallback, previousError = null) {
+  console.log('Manual retry initiated for:', url);
+  
+  // If we have a previous error with retry state, continue from there
+  let additionalRetries = 3; // Allow 3 additional manual retries
+  if (previousError && previousError.retryState) {
+    additionalRetries = Math.max(2, 5 - previousError.retryState.attempts);
+  }
+  
+  // Ensure cache directory exists before retrying
+  const destDir = path.dirname(dest);
+  if (!fs.existsSync(destDir)) {
+    console.log('Creating cache directory:', destDir);
+    fs.mkdirSync(destDir, { recursive: true });
+  }
+  
+  // CRITICAL: Delete partial file before manual retry to avoid HTTP 416
+  if (fs.existsSync(dest)) {
+    try {
+      const stats = fs.statSync(dest);
+      console.log(`[Retry] Deleting partial file before retry: ${(stats.size / 1024 / 1024).toFixed(2)} MB`);
+      fs.unlinkSync(dest);
+    } catch (err) {
+      console.warn('Could not delete partial file:', err.message);
+    }
+  }
+  
+  try {
+    await downloadFile(url, dest, progressCallback, additionalRetries);
+    console.log('Manual retry successful');
+  } catch (error) {
+    console.error('Manual retry failed:', error.message);
+    throw error;
+  }
+}
+
 module.exports = {
   downloadFile,
+  retryDownload,
+  retryStalledDownload,
   findHomePageUIPath,
   findLogoPath
 };

backend/utils/platformUtils.js

@@ -18,11 +18,16 @@ 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 (process.env.WAYLAND_DISPLAY) {
+  if (waylandDisplay) {
     return true;
   }
   
@@ -45,22 +50,47 @@ function setupWaylandEnvironment() {
     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, configuring environment...');
+  console.log('Detected Wayland session, checking for Gamescope/Steam Deck...');
   
-  const envVars = {
+  const envVars = {};
-    SDL_VIDEODRIVER: 'wayland',
-    GDK_BACKEND: 'wayland',
-    QT_QPA_PLATFORM: 'wayland',
-    MOZ_ENABLE_WAYLAND: '1',
-    _JAVA_AWT_WM_NONREPARENTING: '1'
-  };
 
+  // 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';
+  
+  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).');
+  }
   
   console.log('Wayland environment variables:', envVars);
   return envVars;

backend/utils/serverListSync.js

@@ -0,0 +1,120 @@
+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/userDataBackup.js

@@ -0,0 +1,131 @@
+const fs = require('fs-extra');
+const path = require('path');
+
+/**
+ * Backup and restore UserData folder during game updates
+ */
+class UserDataBackup {
+  /**
+   * Backup UserData folder to a temporary location
+   * @param {string} installPath - Base installation path (e.g., C:\Users\...\HytaleF2P)
+   * @param {string} branch - Branch name (release or pre-release)
+   * @param {boolean} hasVersionConfig - True if config.json has version_client and version_branch
+   * @returns {Promise<string|null>} - Path to backup or null if no UserData found
+   */
+  async backupUserData(installPath, branch, hasVersionConfig = true) {
+    let userDataPath;
+    
+    // Si on n'a pas de version_client/version_branch dans config.json, 
+    // c'est une ancienne installation, on cherche dans installPath/HytaleF2P/release
+    if (!hasVersionConfig) {
+      const oldPath = path.join(installPath, 'HytaleF2P', 'release', 'package', 'game', 'latest', 'Client', 'UserData');
+      console.log(`[UserDataBackup] No version_client/version_branch detected, searching old installation in: ${oldPath}`);
+      
+      if (fs.existsSync(oldPath)) {
+        userDataPath = oldPath;
+        console.log(`[UserDataBackup] ✓ Old installation found! UserData exists in old location`);
+      } else {
+        console.log(`[UserDataBackup] ✗ No old installation found in ${oldPath}`);
+        userDataPath = path.join(installPath, branch, 'package', 'game', 'latest', 'Client', 'UserData');
+      }
+    } else {
+      // Si on a version_client/version_branch, on cherche dans installPath/HytaleF2P/<branch>
+      userDataPath = path.join(installPath, branch, 'package', 'game', 'latest', 'Client', 'UserData');
+      console.log(`[UserDataBackup] Version configured, searching in: ${userDataPath}`);
+    }
+    
+    if (!fs.existsSync(userDataPath)) {
+      console.log(`[UserDataBackup] ✗ No UserData found at ${userDataPath}, backup skipped`);
+      return null;
+    }
+
+    console.log(`[UserDataBackup] ✓ UserData found at ${userDataPath}`);
+    const backupPath = path.join(installPath, `UserData_backup_${branch}_${Date.now()}`);
+    
+    try {
+      console.log(`[UserDataBackup] Copying from ${userDataPath} to ${backupPath}...`);
+      await fs.copy(userDataPath, backupPath, {
+        overwrite: true,
+        errorOnExist: false,
+        dereference: true  // Follow symlinks to avoid EPERM errors on Windows
+      });
+      console.log('[UserDataBackup] ✓ Backup completed successfully');
+      return backupPath;
+    } catch (error) {
+      console.error('[UserDataBackup] ✗ Erreur lors du backup:', error);
+      throw new Error(`Failed to backup UserData: ${error.message}`);
+    }
+  }
+
+  /**
+   * Restore UserData folder from backup
+   * @param {string} backupPath - Path to the backup folder
+   * @param {string} installPath - Base installation path
+   * @param {string} branch - Branch name (release or pre-release)
+   * @returns {Promise<boolean>} - True if restored, false otherwise
+   */
+  async restoreUserData(backupPath, installPath, branch) {
+    if (!backupPath || !fs.existsSync(backupPath)) {
+      console.log('No backup to restore or backup path does not exist');
+      return false;
+    }
+
+    const userDataPath = path.join(installPath, branch, 'package', 'game', 'latest', 'Client', 'UserData');
+    
+    try {
+      console.log(`Restoring UserData from ${backupPath} to ${userDataPath}`);
+      
+      // Ensure parent directory exists
+      const parentDir = path.dirname(userDataPath);
+      if (!fs.existsSync(parentDir)) {
+        await fs.ensureDir(parentDir);
+      }
+
+      await fs.copy(backupPath, userDataPath, {
+        overwrite: true,
+        errorOnExist: false,
+        dereference: true  // Follow symlinks to avoid EPERM errors on Windows
+      });
+      
+      console.log('UserData restore completed successfully');
+      return true;
+    } catch (error) {
+      console.error('Error restoring UserData:', error);
+      throw new Error(`Failed to restore UserData: ${error.message}`);
+    }
+  }
+
+  /**
+   * Clean up backup folder
+   * @param {string} backupPath - Path to the backup folder to delete
+   * @returns {Promise<boolean>} - True if deleted, false otherwise
+   */
+  async cleanupBackup(backupPath) {
+    if (!backupPath || !fs.existsSync(backupPath)) {
+      return false;
+    }
+
+    try {
+      console.log(`Cleaning up backup at ${backupPath}`);
+      await fs.remove(backupPath);
+      console.log('Backup cleanup completed');
+      return true;
+    } catch (error) {
+      console.error('Error cleaning up backup:', error);
+      return false;
+    }
+  }
+
+  /**
+   * Check if UserData exists for a specific branch
+   * @param {string} installPath - Base installation path
+   * @param {string} branch - Branch name (release or pre-release)
+   * @returns {boolean} - True if UserData exists
+   */
+  hasUserData(installPath, branch) {
+    const userDataPath = path.join(installPath, branch, 'package', 'game', 'latest', 'Client', 'UserData');
+    return fs.existsSync(userDataPath);
+  }
+}
+
+module.exports = new UserDataBackup();

backend/utils/userDataMigration.js

@@ -0,0 +1,172 @@
+const fs = require('fs-extra');
+const path = require('path');
+const { getHytaleSavesDir, getResolvedAppDir } = require('../core/paths');
+const { loadConfig, saveConfig } = require('../core/config');
+
+/**
+ * NEW SYSTEM (2.2.0+): UserData Migration to Centralized Location
+ * 
+ * UserData is now stored in a centralized location instead of inside game installation:
+ * - Windows: %LOCALAPPDATA%\HytaleSaves\
+ * - macOS: ~/Library/Application Support/HytaleSaves/
+ * - Linux: ~/.hytalesaves/
+ * 
+ * This eliminates the need for backup/restore during updates.
+ */
+
+/**
+ * Check if migration to centralized UserData has been completed
+ */
+function isMigrationCompleted() {
+  const config = loadConfig();
+  return config.userDataMigrated === true;
+}
+
+/**
+ * Mark migration as completed
+ */
+function markMigrationCompleted() {
+  saveConfig({ userDataMigrated: true });
+  console.log('[UserDataMigration] Migration marked as completed in config');
+}
+
+/**
+ * Find old UserData location (pre-2.2.0)
+ * Searches in: installPath/branch/package/game/latest/Client/UserData
+ */
+function findOldUserDataPath() {
+  try {
+    const config = loadConfig();
+    const installPath = getResolvedAppDir();
+    const branch = config.version_branch || 'release';
+    
+    console.log(`[UserDataMigration] Looking for old UserData...`);
+    console.log(`[UserDataMigration]   Install path: ${installPath}`);
+    console.log(`[UserDataMigration]   Branch: ${branch}`);
+    
+    // Old location
+    const oldPath = path.join(installPath, branch, 'package', 'game', 'latest', 'Client', 'UserData');
+    console.log(`[UserDataMigration]   Checking: ${oldPath}`);
+    console.log(`[UserDataMigration]   Checking: ${oldPath}`);
+    
+    if (fs.existsSync(oldPath)) {
+      console.log(`[UserDataMigration] ✓ Found old UserData at: ${oldPath}`);
+      return oldPath;
+    }
+    
+    console.log(`[UserDataMigration] ✗ Not found at current branch location`);
+    
+    // Try other branch if current doesn't exist
+    const otherBranch = branch === 'release' ? 'pre-release' : 'release';
+    const otherPath = path.join(installPath, otherBranch, 'package', 'game', 'latest', 'Client', 'UserData');
+    console.log(`[UserDataMigration]   Checking other branch: ${otherPath}`);
+    console.log(`[UserDataMigration]   Checking other branch: ${otherPath}`);
+    
+    if (fs.existsSync(otherPath)) {
+      console.log(`[UserDataMigration] ✓ Found old UserData in other branch at: ${otherPath}`);
+      return otherPath;
+    }
+    
+    console.log('[UserDataMigration] ✗ No old UserData found in any branch');
+    return null;
+  } catch (error) {
+    console.error('[UserDataMigration] Error finding old UserData:', error);
+    return null;
+  }
+}
+
+/**
+ * Migrate UserData from old location to new centralized location
+ * One-time operation when upgrading to 2.2.0
+ */
+async function migrateUserDataToCentralized() {
+  // Check if already migrated
+  if (isMigrationCompleted()) {
+    console.log('[UserDataMigration] Migration already completed, skipping');
+    return { success: true, alreadyMigrated: true };
+  }
+  
+  console.log('[UserDataMigration] === Starting UserData Migration to Centralized Location ===');
+  
+  const newUserDataPath = getHytaleSavesDir();
+  console.log(`[UserDataMigration] Target location: ${newUserDataPath}`);
+  
+  // Ensure new directory exists
+  if (!fs.existsSync(newUserDataPath)) {
+    fs.mkdirSync(newUserDataPath, { recursive: true });
+    console.log('[UserDataMigration] Created new HytaleSaves directory');
+  }
+  
+  // Find old UserData
+  const oldUserDataPath = findOldUserDataPath();
+  
+  if (!oldUserDataPath) {
+    console.log('[UserDataMigration] No old UserData found - fresh install or already migrated');
+    // Don't mark as migrated - let it check again next time in case game gets installed later
+    return { success: true, freshInstall: true };
+  }
+  
+  // Check if new location already has data (shouldn't happen, but safety check)
+  const existingFiles = fs.readdirSync(newUserDataPath);
+  if (existingFiles.length > 0) {
+    console.warn('[UserDataMigration] New location already contains files, marking as migrated to avoid re-attempts');
+    markMigrationCompleted();
+    return { success: true, skipped: true, reason: 'target_not_empty' };
+  }
+  
+  try {
+    console.log(`[UserDataMigration] Copying from ${oldUserDataPath} to ${newUserDataPath}...`);
+    
+    // Copy all UserData to new location
+    await fs.copy(oldUserDataPath, newUserDataPath, {
+      overwrite: false,
+      errorOnExist: false,
+      dereference: true  // Follow symlinks to avoid EPERM errors on Windows
+    });
+    
+    console.log('[UserDataMigration] ✓ UserData copied successfully');
+    
+    // Mark migration as completed
+    markMigrationCompleted();
+    
+    console.log('[UserDataMigration] === Migration Completed Successfully ===');
+    return { 
+      success: true, 
+      migrated: true,
+      from: oldUserDataPath,
+      to: newUserDataPath
+    };
+    
+  } catch (error) {
+    console.error('[UserDataMigration] ✗ Migration failed:', error);
+    return { 
+      success: false, 
+      error: error.message,
+      from: oldUserDataPath,
+      to: newUserDataPath
+    };
+  }
+}
+
+/**
+ * Get the centralized UserData path (always use this in 2.2.0+)
+ * Ensures directory exists
+ */
+function getUserDataPath() {
+  const userDataPath = getHytaleSavesDir();
+  
+  // Ensure directory exists
+  if (!fs.existsSync(userDataPath)) {
+    fs.mkdirSync(userDataPath, { recursive: true });
+    console.log(`[UserDataMigration] Created UserData directory: ${userDataPath}`);
+  }
+  
+  return userDataPath;
+}
+
+module.exports = {
+  migrateUserDataToCentralized,
+  getUserDataPath,
+  isMigrationCompleted,
+  findOldUserDataPath
+};

build/entitlements.mac.plist

@@ -0,0 +1,18 @@
+<?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

@@ -0,0 +1,123 @@
+# Steam Deck / Ubuntu LTS Crash Investigation
+
+## Status: SOLVED
+
+**Last updated:** 2026-01-27
+
+**Solution:** Replace bundled `libzstd.so` with system version.
+
+---
+
+## Problem Summary
+
+The Hytale F2P launcher's client patcher causes crashes on Steam Deck and Ubuntu LTS with the error:
+```
+free(): invalid pointer
+```
+or
+```
+SIGSEGV (Segmentation fault)
+```
+
+The crash occurs after successful authentication, specifically right after "Finished handling RequiredAssets".
+
+**Affected Systems:**
+- Steam Deck (glibc 2.41)
+- Ubuntu LTS
+
+**Working Systems:**
+- macOS
+- 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).
+
+---
+
+## 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
+
+| 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 |
+
+### Key Insight
+
+The crash was in `libzstd.so`, not in our patched code. The patching just changed timing enough to expose the libzstd incompatibility more frequently.
+
+---
+
+## GDB Stack Trace (Historical)
+
+```
+#0  0x00007ffff7d3f5a4 in ?? () from /usr/lib/libc.so.6
+#1  raise () from /usr/lib/libc.so.6
+#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)
+#7-#24  HytaleClient code (asset decompression)
+```
+
+---
+
+## Branch
+
+`fix/steamdeck-libzstd`

docs/STEAMDECK_DEBUG_COMMANDS.md

@@ -0,0 +1,65 @@
+# Steam Deck / Linux Crash Fix
+
+## SOLUTION: Use system libzstd
+
+The crash is caused by the bundled `libzstd.so` being incompatible with glibc 2.41's stricter heap validation.
+
+### Automatic Fix
+
+The launcher automatically replaces `libzstd.so` with the system version. No manual action needed.
+
+### Manual Fix
+
+```bash
+cd ~/.hytalef2p/release/package/game/latest/Client
+
+# Backup and replace
+mv libzstd.so libzstd.so.bundled
+ln -s /usr/lib/libzstd.so.1 libzstd.so
+```
+
+### Restore Original
+
+```bash
+cd ~/.hytalef2p/release/package/game/latest/Client
+rm libzstd.so
+mv libzstd.so.bundled libzstd.so
+```
+
+---
+
+## Debug Commands (for troubleshooting)
+
+### Check libzstd Status
+
+```bash
+# Check if symlinked
+ls -la ~/.hytalef2p/release/package/game/latest/Client/libzstd.so
+
+# Find system libzstd
+find /usr/lib -name "libzstd.so*"
+```
+
+### Binary Validation
+
+```bash
+file ~/.hytalef2p/release/package/game/latest/Client/HytaleClient
+ldd ~/.hytalef2p/release/package/game/latest/Client/HytaleClient
+```
+
+### Restore Client Binary
+
+```bash
+cd ~/.hytalef2p/release/package/game/latest/Client
+cp HytaleClient.original HytaleClient
+rm -f HytaleClient.patched_custom
+```
+
+---
+
+## Environment Variables
+
+| Variable | Description | Example |
+|----------|-------------|---------|
+| `HYTALE_AUTH_DOMAIN` | Custom auth domain | `auth.sanasol.ws` |
+| `HYTALE_NO_LIBZSTD_FIX` | Disable libzstd replacement | `1` |

main.js

@@ -1,10 +1,23 @@
 const path = require('path');
 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, saveChatUsername, loadChatUsername, saveChatColor, loadChatColor, saveJavaPath, loadJavaPath, saveInstallPath, loadInstallPath, saveDiscordRPC, loadDiscordRPC, saveLanguage, loadLanguage, saveCloseLauncherOnStart, loadCloseLauncherOnStart, isGameInstalled, uninstallGame, repairGame, getHytaleNews, handleFirstLaunchCheck, proposeGameUpdate, markAsLaunched } = require('./backend/launcher');
+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 { retryPWRDownload } = require('./backend/managers/gameManager');
+const { migrateUserDataToCentralized } = require('./backend/utils/userDataMigration');
+
+// Handle Hardware Acceleration
+try {
+  const hwEnabled = loadLauncherHardwareAcceleration();
+  if (!hwEnabled) {
+    console.log('Hardware acceleration disabled by user setting');
+    app.disableHardwareAcceleration();
+  }
+} catch (error) {
+  console.error('Failed to load hardware acceleration setting:', error);
+}
 
-const UpdateManager = require('./backend/updateManager');
 const logger = require('./backend/logger');
 const profileManager = require('./backend/managers/profileManager');
 
@@ -26,11 +39,10 @@ if (!gotTheLock) {
 }
 
 let mainWindow;
-let updateManager;
 let discordRPC = null;
 
 // Discord Rich Presence setup
-const DISCORD_CLIENT_ID = process.env.DISCORD_CLIENT_ID;
+const DISCORD_CLIENT_ID = "1462244937868513373";
 
 function initDiscordRPC() {
   try {
@@ -74,6 +86,10 @@ function setDiscordActivity() {
         {
           label: 'GitHub',
           url: 'https://github.com/amiayweb/Hytale-F2P'
+        },
+        {
+          label: 'Discord',
+          url: 'https://discord.gg/hf2pdc'
         }
       ]
     });
@@ -82,7 +98,7 @@ function setDiscordActivity() {
   }
 }
 
-function toggleDiscordRPC(enabled) {
+async function toggleDiscordRPC(enabled) {
   console.log('Toggling Discord RPC:', enabled);
 
   if (enabled && !discordRPC) {
@@ -92,11 +108,12 @@ function toggleDiscordRPC(enabled) {
     try {
       console.log('Disconnecting Discord RPC...');
       discordRPC.clearActivity();
+      await new Promise(r => setTimeout(r, 100));
       discordRPC.destroy();
-      discordRPC = null;
       console.log('Discord RPC disconnected successfully');
     } catch (error) {
       console.error('Error disconnecting Discord RPC:', error.message);
+    } finally {
       discordRPC = null;
     }
   }
@@ -162,12 +179,77 @@ function createWindow() {
   // Initialize Discord Rich Presence
   initDiscordRPC();
 
-  updateManager = new UpdateManager();
+  // Configure and initialize electron-updater
-  setTimeout(async () => {
+  // Enable auto-download so updates start immediately when available
-    const updateInfo = await updateManager.checkForUpdates();
+  autoUpdater.autoDownload = true;
-    if (updateInfo.updateAvailable) {
+  autoUpdater.autoInstallOnAppQuit = true;
-      mainWindow.webContents.send('show-update-popup', updateInfo);
+
+  autoUpdater.on('checking-for-update', () => {
+    console.log('Checking for launcher updates...');
+  });
+
+  autoUpdater.on('update-available', (info) => {
+    console.log('Update available:', info.version);
+    if (mainWindow && !mainWindow.isDestroyed()) {
+      mainWindow.webContents.send('update-available', {
+        currentVersion: app.getVersion(),
+        newVersion: info.version,
+        releaseNotes: info.releaseNotes,
+        releaseDate: info.releaseDate
+      });
     }
+  });
+
+  autoUpdater.on('update-not-available', (info) => {
+    console.log('Launcher is up to date:', info.version);
+  });
+
+  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) => {
+    if (mainWindow && !mainWindow.isDestroyed()) {
+      mainWindow.webContents.send('update-download-progress', {
+        percent: progressObj.percent,
+        transferred: progressObj.transferred,
+        total: progressObj.total,
+        bytesPerSecond: progressObj.bytesPerSecond
+      });
+    }
+  });
+
+  autoUpdater.on('update-downloaded', (info) => {
+    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'
+      });
+    }
+  });
+
+  // Check for updates after 3 seconds
+  setTimeout(() => {
+    autoUpdater.checkForUpdates().catch(err => {
+      console.log('Failed to check for updates:', err.message);
+    });
   }, 3000);
 
   mainWindow.webContents.on('devtools-opened', () => {
@@ -239,6 +321,14 @@ app.whenReady().then(async () => {
   // Initialize Profile Manager (runs migration if needed)
   profileManager.init();
 
+  // Migrate UserData to centralized location (v2.1.2+)
+  console.log('[Startup] Checking UserData migration...');
+  try {
+    await migrateUserDataToCentralized();
+  } catch (error) {
+    console.error('[Startup] UserData migration failed:', error);
+  }
+
   createSplashScreen();
 
   setTimeout(async () => {
@@ -263,9 +353,9 @@ app.whenReady().then(async () => {
         mainWindow.webContents.send('lock-play-button', true);
       }
 
-      const progressCallback = (message, percent, speed, downloaded, total) => {
+      const progressCallback = (message, percent, speed, downloaded, total, retryState) => {
         if (mainWindow && !mainWindow.isDestroyed()) {
-          mainWindow.webContents.send('first-launch-progress', { message, percent, speed, downloaded, total });
+          mainWindow.webContents.send('first-launch-progress', { message, percent, speed, downloaded, total, retryState });
         }
       };
 
@@ -320,24 +410,19 @@ app.whenReady().then(async () => {
   }, 3000);
 });
 
-function cleanupDiscordRPC() {
+async function cleanupDiscordRPC() {
-  if (discordRPC) {
+  if (!discordRPC) return;
   try {
     console.log('Cleaning up Discord RPC...');
     discordRPC.clearActivity();
-      setTimeout(() => {
+    await new Promise(r => setTimeout(r, 100));
-        try {
     discordRPC.destroy();
-        } catch (error) {
+    console.log('Discord RPC cleaned up successfully');
-          console.log('Error during final Discord RPC cleanup:', error.message);
-        }
-      }, 100);
-      discordRPC = null;
   } catch (error) {
     console.log('Error cleaning up Discord RPC:', error.message);
+  } finally {
     discordRPC = null;
   }
-  }
 }
 
 app.on('before-quit', () => {
@@ -347,23 +432,21 @@ app.on('before-quit', () => {
 
 app.on('window-all-closed', () => {
   console.log('=== LAUNCHER CLOSING ===');
-
-  cleanupDiscordRPC();
-
   app.quit();
 });
 
 
 ipcMain.handle('launch-game', async (event, playerName, javaPath, installPath, gpuPreference) => {
   try {
-    const progressCallback = (message, percent, speed, downloaded, total) => {
+    const progressCallback = (message, percent, speed, downloaded, total, retryState) => {
       if (mainWindow && !mainWindow.isDestroyed()) {
         const data = {
           message: message || null,
           percent: percent !== null && percent !== undefined ? Math.min(100, Math.max(0, percent)) : null,
           speed: speed !== null && speed !== undefined ? speed : null,
           downloaded: downloaded !== null && downloaded !== undefined ? downloaded : null,
-          total: total !== null && total !== undefined ? total : null
+          total: total !== null && total !== undefined ? total : null,
+          retryState: retryState || null
         };
         mainWindow.webContents.send('progress-update', data);
       }
@@ -397,44 +480,118 @@ ipcMain.handle('launch-game', async (event, playerName, javaPath, installPath, g
   }
 });
 
-ipcMain.handle('install-game', async (event, playerName, javaPath, installPath) => {
+ipcMain.handle('install-game', async (event, playerName, javaPath, installPath, branch) => {
   try {
+    console.log(`[IPC] install-game called with parameters:`);
+    console.log(`  - playerName: ${playerName}`);
+    console.log(`  - javaPath: ${javaPath}`);
+    console.log(`  - installPath: ${installPath}`);
+    console.log(`  - branch: ${branch}`);
+    console.log(`[IPC] branch type: ${typeof branch}, value: ${JSON.stringify(branch)}`);
+
     // Signal installation start
     if (mainWindow && !mainWindow.isDestroyed()) {
       mainWindow.webContents.send('installation-start');
     }
 
-    const progressCallback = (message, percent, speed, downloaded, total) => {
+    const progressCallback = (message, percent, speed, downloaded, total, retryState) => {
       if (mainWindow && !mainWindow.isDestroyed()) {
         const data = {
           message: message || null,
           percent: percent !== null && percent !== undefined ? Math.min(100, Math.max(0, percent)) : null,
           speed: speed !== null && speed !== undefined ? speed : null,
           downloaded: downloaded !== null && downloaded !== undefined ? downloaded : null,
-          total: total !== null && total !== undefined ? total : null
+          total: total !== null && total !== undefined ? total : null,
+          retryState: retryState || null
         };
         mainWindow.webContents.send('progress-update', data);
       }
     };
 
-    const result = await installGame(playerName, progressCallback, javaPath, installPath);
+    const result = await installGame(playerName, progressCallback, javaPath, installPath, branch);
 
     // Signal installation end
     if (mainWindow && !mainWindow.isDestroyed()) {
       mainWindow.webContents.send('installation-end');
     }
 
-    return result;
+    // Ensure we always return a result for the IPC handler
+    const successResponse = result || { success: true };
+    console.log('[Main] Returning success response for install-game:', successResponse);
+    return successResponse;
   } catch (error) {
-    console.error('Install error:', error);
+    // console.error('Install error:', error);
     const errorMessage = error.message || error.toString();
 
+    // Enhanced error data extraction for both download and Butler errors
+    let errorData = {
+      message: errorMessage,
+      error: true,
+      canRetry: true, // Default to true, will be overridden by specific error props
+      retryData: null
+    };
+
+    // Prioritize JRE errors first
+    if (error.isJREError) {
+      console.log('[Main] Processing JRE download error with retry context');
+      errorData.retryData = {
+        isJREError: true,
+        jreUrl: error.jreUrl,
+        fileName: error.fileName,
+        cacheDir: error.cacheDir,
+        osName: error.osName,
+        arch: error.arch
+      };
+      // For JRE errors, allow manual retry unless explicitly disabled
+      errorData.canRetry = error.canRetry !== false;
+      errorData.errorType = 'jre';
+    }
+    // Handle Butler-specific errors
+    else if (error.butlerError) {
+      console.log('[Main] Processing Butler error with retry context');
+      errorData.retryData = {
+        branch: error.branch || 'release',
+        fileName: error.fileName || '7.pwr',
+        cacheDir: error.cacheDir
+      };
+      errorData.canRetry = error.canRetry !== false;
+    }
+    // Handle PWR download errors
+    else if (error.branch && error.fileName) {
+      console.log('[Main] Processing PWR download error with retry context');
+      errorData.retryData = {
+        branch: error.branch,
+        fileName: error.fileName,
+        cacheDir: error.cacheDir
+      };
+      errorData.canRetry = error.canRetry !== false;
+    }
+    // Default fallback for other errors
+    else {
+      console.log('[Main] Processing generic error, creating default retry data');
+      errorData.retryData = {
+        branch: 'release',
+        fileName: '7.pwr'
+      };
+      // For generic errors, assume it's retryable unless specified
+      errorData.canRetry = error.canRetry !== false;
+    }
+
+    // Send enhanced error info for retry UI
+    if (mainWindow && !mainWindow.isDestroyed()) {
+      console.log('[Main] Sending error data to renderer:', errorData);
+      mainWindow.webContents.send('progress-update', errorData);
+    }
+
     // Signal installation end on error too
     if (mainWindow && !mainWindow.isDestroyed()) {
       mainWindow.webContents.send('installation-end');
     }
 
-    return { success: false, error: errorMessage };
+    // Always return a proper response to prevent timeout
+    const errorResponse = { success: false, error: errorMessage };
+    console.log('[Main] Returning error response for install-game:', errorResponse);
+    return errorResponse;
   }
 });
 
@@ -446,22 +603,6 @@ 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);
@@ -510,6 +651,24 @@ ipcMain.handle('load-close-launcher', () => {
   return loadCloseLauncherOnStart();
 });
 
+ipcMain.handle('save-launcher-hw-accel', (event, enabled) => {
+  saveLauncherHardwareAcceleration(enabled);
+  return { success: true };
+});
+
+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, {
@@ -525,14 +684,15 @@ ipcMain.handle('select-install-path', async () => {
 
 ipcMain.handle('accept-first-launch-update', async (event, existingGame) => {
   try {
-    const progressCallback = (message, percent, speed, downloaded, total) => {
+    const progressCallback = (message, percent, speed, downloaded, total, retryState) => {
       if (mainWindow && !mainWindow.isDestroyed()) {
         const data = {
           message: message || null,
           percent: percent !== null && percent !== undefined ? Math.min(100, Math.max(0, percent)) : null,
           speed: speed !== null && speed !== undefined ? speed : null,
           downloaded: downloaded !== null && downloaded !== undefined ? downloaded : null,
-          total: total !== null && total !== undefined ? total : null
+          total: total !== null && total !== undefined ? total : null,
+          retryState: retryState || null
         };
         mainWindow.webContents.send('first-launch-progress', data);
       }
@@ -574,21 +734,22 @@ ipcMain.handle('uninstall-game', async () => {
   try {
     await uninstallGame();
   } catch (error) {
-    console.error('Uninstall error:', error);
+    // console.error('Uninstall error:', error);
     return { success: false, error: error.message };
   }
 });
 
 ipcMain.handle('repair-game', async () => {
   try {
-    const progressCallback = (message, percent, speed, downloaded, total) => {
+    const progressCallback = (message, percent, speed, downloaded, total, retryState) => {
       if (mainWindow && !mainWindow.isDestroyed()) {
         const data = {
           message: message || null,
           percent: percent !== null && percent !== undefined ? Math.min(100, Math.max(0, percent)) : null,
           speed: speed !== null && speed !== undefined ? speed : null,
           downloaded: downloaded !== null && downloaded !== undefined ? downloaded : null,
-          total: total !== null && total !== undefined ? total : null
+          total: total !== null && total !== undefined ? total : null,
+          retryState: retryState || null
         };
         mainWindow.webContents.send('progress-update', data);
       }
@@ -598,7 +759,98 @@ ipcMain.handle('repair-game', async () => {
     return result;
   } catch (error) {
     console.error('Repair error:', error);
-    return { success: false, error: error.message };
+    const errorMessage = error.message || error.toString();
+    return { success: false, error: errorMessage };
+  }
+});
+
+ipcMain.handle('retry-download', async (event, retryData) => {
+  try {
+    console.log('[IPC] retry-download called with data:', retryData);
+
+    const progressCallback = (message, percent, speed, downloaded, total, retryState) => {
+      if (mainWindow && !mainWindow.isDestroyed()) {
+        const data = {
+          message: message || null,
+          percent: percent !== null && percent !== undefined ? Math.min(100, Math.max(0, percent)) : null,
+          speed: speed !== null && speed !== undefined ? speed : null,
+          downloaded: downloaded !== null && downloaded !== undefined ? downloaded : null,
+          total: total !== null && total !== undefined ? total : null,
+          retryState: retryState || null
+        };
+        mainWindow.webContents.send('progress-update', data);
+      }
+    };
+
+    // Handle JRE download retries
+    if (retryData && retryData.isJREError) {
+      console.log(`[IPC] Retrying JRE download: jreUrl=${retryData.jreUrl}, fileName=${retryData.fileName}`);
+      console.log('[IPC] Full JRE retry data:', JSON.stringify(retryData, null, 2));
+
+      const { retryJREDownload } = require('./backend/managers/javaManager');
+      const jreCacheFile = path.join(retryData.cacheDir, retryData.fileName);
+      await retryJREDownload(retryData.jreUrl, jreCacheFile, progressCallback);
+
+      return { success: true };
+    }
+
+    // Handle PWR download retries (default)
+    if (!retryData || !retryData.branch || !retryData.fileName) {
+      console.log('[IPC] Invalid retry data, using PWR defaults');
+      retryData = {
+        branch: 'release',
+        fileName: '7.pwr'
+      };
+    }
+
+    // Extract PWR download info from retryData
+    const branch = retryData.branch;
+    const fileName = retryData.fileName;
+    const cacheDir = retryData.cacheDir;
+
+    console.log(`[IPC] Retrying PWR download: branch=${branch}, fileName=${fileName}`);
+    console.log('[IPC] Full PWR retry data:', JSON.stringify(retryData, null, 2));
+
+    // Perform retry with enhanced context
+    await retryPWRDownload(branch, fileName, progressCallback, cacheDir);
+
+    return { success: true };
+  } catch (error) {
+    console.error('Retry download error:', error);
+    const errorMessage = error.message || error.toString();
+
+    // Send error update to frontend with context
+    if (mainWindow && !mainWindow.isDestroyed()) {
+      const isJreError = retryData?.isJREError;
+      const errorRetryData = isJreError ?
+        {
+          isJREError: true,
+          jreUrl: retryData?.jreUrl,
+          fileName: retryData?.fileName,
+          cacheDir: retryData?.cacheDir,
+          osName: retryData?.osName,
+          arch: retryData?.arch
+        } :
+        {
+          branch: retryData?.branch || 'release',
+          fileName: retryData?.fileName || '7.pwr',
+          cacheDir: retryData?.cacheDir
+        };
+
+      const data = {
+        message: errorMessage,
+        error: true,
+        canRetry: error.canRetry !== false, // Respect canRetry from the thrown error
+        retryData: errorRetryData,
+        errorType: isJreError ? 'jre' : 'general' // Add errorType for the UI
+      };
+      mainWindow.webContents.send('progress-update', data);
+    }
+
+    // Always return a proper response to prevent timeout
+    const errorResponse = { success: false, error: errorMessage };
+    console.log('[Main] Returning error response for retry-download:', errorResponse);
+    return errorResponse;
   }
 });
 
@@ -622,10 +874,22 @@ 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 } = require('./backend/launcher');
+    const { getResolvedAppDir, loadVersionBranch } = require('./backend/launcher');
-    const gameDir = path.join(getResolvedAppDir(), 'release', 'package', 'game');
+    const branch = loadVersionBranch();
+    const gameDir = path.join(getResolvedAppDir(), branch, 'package', 'game');
 
     if (fs.existsSync(gameDir)) {
       await shell.openPath(gameDir);
@@ -823,33 +1087,66 @@ ipcMain.handle('copy-mod-file', async (event, sourcePath, modsPath) => {
   }
 });
 
+// Electron-updater IPC handlers
 ipcMain.handle('check-for-updates', async () => {
   try {
-    return await updateManager.checkForUpdates();
+    const result = await autoUpdater.checkForUpdates();
+    return {
+      updateAvailable: result && result.updateInfo,
+      currentVersion: app.getVersion(),
+      updateInfo: result ? result.updateInfo : null
+    };
   } catch (error) {
     console.error('Error checking for updates:', error);
     return { updateAvailable: false, error: error.message };
   }
 });
 
-ipcMain.handle('open-download-page', async () => {
+ipcMain.handle('download-update', async () => {
   try {
-    await shell.openExternal(updateManager.getDownloadUrl());
+    await autoUpdater.downloadUpdate();
-
-    setTimeout(() => {
-      app.quit();
-    }, 1000);
-
-
     return { success: true };
   } catch (error) {
-    console.error('Error opening download page:', error);
+    console.error('Error downloading update:', error);
     return { success: false, error: error.message };
   }
 });
 
-ipcMain.handle('get-update-info', async () => {
+ipcMain.handle('install-update', async () => {
-  return updateManager.getUpdateInfo();
+  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('get-launcher-version', () => {
+  return app.getVersion();
 });
 
 ipcMain.handle('get-gpu-info', () => {
@@ -881,6 +1178,22 @@ ipcMain.handle('get-detected-gpu', () => {
   return global.detectedGpu;
 });
 
+ipcMain.handle('save-version-branch', (event, branch) => {
+  const { saveVersionBranch } = require('./backend/launcher');
+  saveVersionBranch(branch);
+  return { success: true };
+});
+
+ipcMain.handle('load-version-branch', () => {
+  const { loadVersionBranch } = require('./backend/launcher');
+  return loadVersionBranch();
+});
+
+ipcMain.handle('load-version-client', () => {
+  const { loadVersionClient } = require('./backend/launcher');
+  return loadVersionClient();
+});
+
 ipcMain.handle('window-close', () => {
   app.quit();
 });
@@ -1063,3 +1376,4 @@ 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.0.11",
+  "version": "2.1.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "hytale-f2p-launcher",
-      "version": "2.0.11",
+      "version": "2.1.2",
       "license": "MIT",
       "dependencies": {
         "adm-zip": "^0.5.10",
@@ -14,10 +14,12 @@
         "discord-rpc": "^4.0.1",
         "dotenv": "^17.2.3",
         "electron-updater": "^6.7.3",
+        "fs-extra": "^11.3.3",
         "tar": "^6.2.1",
         "uuid": "^9.0.1"
       },
       "devDependencies": {
+        "@electron/notarize": "^2.5.0",
         "electron": "^40.0.0",
         "electron-builder": "^26.4.0"
       }
@@ -147,6 +149,21 @@
         "global-agent": "^3.0.0"
       }
     },
+    "node_modules/@electron/get/node_modules/fs-extra": {
+      "version": "8.1.0",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-8.1.0.tgz",
+      "integrity": "sha512-yhlQgA6mnOJUKOsRUFsgJdQCvkKhcz8tlZG5HBQfReYZy46OwLcY+Zia0mtdHsOo9y/hP+CxMN0TU9QxoOtG4g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "graceful-fs": "^4.2.0",
+        "jsonfile": "^4.0.0",
+        "universalify": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=6 <7 || >=8"
+      }
+    },
     "node_modules/@electron/notarize": {
       "version": "2.5.0",
       "resolved": "https://registry.npmjs.org/@electron/notarize/-/notarize-2.5.0.tgz",
@@ -345,34 +362,6 @@
         "balanced-match": "^1.0.0"
       }
     },
-    "node_modules/@electron/universal/node_modules/fs-extra": {
-      "version": "11.3.3",
-      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-11.3.3.tgz",
-      "integrity": "sha512-VWSRii4t0AFm6ixFFmLLx1t7wS1gh+ckoa84aOeapGum0h+EZd1EhEumSB+ZdDLnEPuucsVB9oB7cxJHap6Afg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "graceful-fs": "^4.2.0",
-        "jsonfile": "^6.0.1",
-        "universalify": "^2.0.0"
-      },
-      "engines": {
-        "node": ">=14.14"
-      }
-    },
-    "node_modules/@electron/universal/node_modules/jsonfile": {
-      "version": "6.2.0",
-      "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-6.2.0.tgz",
-      "integrity": "sha512-FGuPw30AdOIUTRMC2OMRtQV+jkVj2cfPqSeWXv1NEAJ1qZ5zb1X6z1mFhbfOB/iy3ssJCD+3KuZ8r8C3uVFlAg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "universalify": "^2.0.0"
-      },
-      "optionalDependencies": {
-        "graceful-fs": "^4.1.6"
-      }
-    },
     "node_modules/@electron/universal/node_modules/minimatch": {
       "version": "9.0.5",
       "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.5.tgz",
@@ -389,16 +378,6 @@
         "url": "https://github.com/sponsors/isaacs"
       }
     },
-    "node_modules/@electron/universal/node_modules/universalify": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.1.tgz",
-      "integrity": "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">= 10.0.0"
-      }
-    },
     "node_modules/@electron/windows-sign": {
       "version": "1.2.2",
       "resolved": "https://registry.npmjs.org/@electron/windows-sign/-/windows-sign-1.2.2.tgz",
@@ -421,50 +400,6 @@
         "node": ">=14.14"
       }
     },
-    "node_modules/@electron/windows-sign/node_modules/fs-extra": {
-      "version": "11.3.3",
-      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-11.3.3.tgz",
-      "integrity": "sha512-VWSRii4t0AFm6ixFFmLLx1t7wS1gh+ckoa84aOeapGum0h+EZd1EhEumSB+ZdDLnEPuucsVB9oB7cxJHap6Afg==",
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "peer": true,
-      "dependencies": {
-        "graceful-fs": "^4.2.0",
-        "jsonfile": "^6.0.1",
-        "universalify": "^2.0.0"
-      },
-      "engines": {
-        "node": ">=14.14"
-      }
-    },
-    "node_modules/@electron/windows-sign/node_modules/jsonfile": {
-      "version": "6.2.0",
-      "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-6.2.0.tgz",
-      "integrity": "sha512-FGuPw30AdOIUTRMC2OMRtQV+jkVj2cfPqSeWXv1NEAJ1qZ5zb1X6z1mFhbfOB/iy3ssJCD+3KuZ8r8C3uVFlAg==",
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "peer": true,
-      "dependencies": {
-        "universalify": "^2.0.0"
-      },
-      "optionalDependencies": {
-        "graceful-fs": "^4.1.6"
-      }
-    },
-    "node_modules/@electron/windows-sign/node_modules/universalify": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.1.tgz",
-      "integrity": "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==",
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "peer": true,
-      "engines": {
-        "node": ">= 10.0.0"
-      }
-    },
     "node_modules/@isaacs/balanced-match": {
       "version": "4.0.1",
       "resolved": "https://registry.npmjs.org/@isaacs/balanced-match/-/balanced-match-4.0.1.tgz",
@@ -2612,18 +2547,38 @@
       }
     },
     "node_modules/fs-extra": {
-      "version": "8.1.0",
+      "version": "11.3.3",
-      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-8.1.0.tgz",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-11.3.3.tgz",
-      "integrity": "sha512-yhlQgA6mnOJUKOsRUFsgJdQCvkKhcz8tlZG5HBQfReYZy46OwLcY+Zia0mtdHsOo9y/hP+CxMN0TU9QxoOtG4g==",
+      "integrity": "sha512-VWSRii4t0AFm6ixFFmLLx1t7wS1gh+ckoa84aOeapGum0h+EZd1EhEumSB+ZdDLnEPuucsVB9oB7cxJHap6Afg==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "graceful-fs": "^4.2.0",
-        "jsonfile": "^4.0.0",
+        "jsonfile": "^6.0.1",
-        "universalify": "^0.1.0"
+        "universalify": "^2.0.0"
       },
       "engines": {
-        "node": ">=6 <7 || >=8"
+        "node": ">=14.14"
+      }
+    },
+    "node_modules/fs-extra/node_modules/jsonfile": {
+      "version": "6.2.0",
+      "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-6.2.0.tgz",
+      "integrity": "sha512-FGuPw30AdOIUTRMC2OMRtQV+jkVj2cfPqSeWXv1NEAJ1qZ5zb1X6z1mFhbfOB/iy3ssJCD+3KuZ8r8C3uVFlAg==",
+      "license": "MIT",
+      "dependencies": {
+        "universalify": "^2.0.0"
+      },
+      "optionalDependencies": {
+        "graceful-fs": "^4.1.6"
+      }
+    },
+    "node_modules/fs-extra/node_modules/universalify": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.1.tgz",
+      "integrity": "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 10.0.0"
       }
     },
     "node_modules/fs-minipass": {
@@ -3238,9 +3193,9 @@
       "license": "MIT"
     },
     "node_modules/lodash": {
-      "version": "4.17.21",
+      "version": "4.17.23",
-      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz",
+      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.23.tgz",
-      "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==",
+      "integrity": "sha512-LgVTMpQtIopCi79SJeDiP0TfWi5CNEc/L/aRdTh3yIvmZXTnheWpKjSZhnvMl8iXbC1tFg9gdHHDMLoV7CnG+w==",
       "dev": true,
       "license": "MIT"
     },
@@ -4530,6 +4485,7 @@
       "version": "6.2.1",
       "resolved": "https://registry.npmjs.org/tar/-/tar-6.2.1.tgz",
       "integrity": "sha512-DZ4yORTwrbTj/7MZYq2w+/ZFdI6OZ/f9SFHR+71gIVUZhOQPHzVCLpvRnPgyaMpfWxxk/4ONva3GQSyNIKRv6A==",
+      "deprecated": "Old versions of tar are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exhorbitant rates) by contacting i@izs.me",
       "license": "ISC",
       "dependencies": {
         "chownr": "^2.0.0",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "hytale-f2p-launcher",
-  "version": "2.0.11",
+  "version": "2.1.2",
   "description": "A modern, cross-platform launcher for Hytale with automatic updates and multi-client support",
   "homepage": "https://github.com/amiayweb/Hytale-F2P",
   "main": "main.js",
@@ -11,7 +11,11 @@
     "build:win": "electron-builder --win",
     "build:linux": "electron-builder --linux",
     "build:mac": "electron-builder --mac",
-    "build:all": "electron-builder --win --linux --mac"
+    "build:all": "electron-builder --win --linux --mac",
+    "build:arch": "electron-builder --linux dir",
+    "build:appimage": "electron-builder --linux AppImage --publish never",
+    "build:deb": "electron-builder --linux deb --publish never",
+    "build:rpm": "electron-builder --linux rpm --publish never"
   },
   "keywords": [
     "hytale",
@@ -41,6 +45,7 @@
   },
   "license": "MIT",
   "devDependencies": {
+    "@electron/notarize": "^2.5.0",
     "electron": "^40.0.0",
     "electron-builder": "^26.4.0"
   },
@@ -50,6 +55,7 @@
     "discord-rpc": "^4.0.1",
     "dotenv": "^17.2.3",
     "electron-updater": "^6.7.3",
+    "fs-extra": "^11.3.3",
     "tar": "^6.2.1",
     "uuid": "^9.0.1"
   },
@@ -81,7 +87,7 @@
           ]
         }
       ],
-      "icon": "icon.ico"
+      "icon": "build/icon.ico"
     },
     "linux": {
       "target": [
@@ -105,13 +111,6 @@
             "x64",
             "arm64"
           ]
-        },
-        {
-          "target": "pacman",
-          "arch": [
-            "x64",
-            "arm64"
-          ]
         }
       ],
       "icon": "build/icon.png",
@@ -122,19 +121,30 @@
         {
           "target": "dmg",
           "arch": [
-            "universal"
+            "arm64",
+            "x64"
           ]
         },
         {
           "target": "zip",
           "arch": [
-            "universal"
+            "arm64",
+            "x64"
           ]
         }
       ],
       "icon": "build/icon.icns",
-      "category": "public.app-category.games"
+      "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
     },
+    "afterSign": "scripts/notarize.js",
     "nsis": {
       "oneClick": false,
       "allowToChangeInstallationDirectory": true,

preload.js

@@ -2,17 +2,13 @@ const { contextBridge, ipcRenderer } = require('electron');
 
 contextBridge.exposeInMainWorld('electronAPI', {
   launchGame: (playerName, javaPath, installPath, gpuPreference) => ipcRenderer.invoke('launch-game', playerName, javaPath, installPath, gpuPreference),
-  installGame: (playerName, javaPath, installPath) => ipcRenderer.invoke('install-game', playerName, javaPath, installPath),
+  installGame: (playerName, javaPath, installPath, branch) => ipcRenderer.invoke('install-game', playerName, javaPath, installPath, branch),
   closeWindow: () => ipcRenderer.invoke('window-close'),
   minimizeWindow: () => ipcRenderer.invoke('window-minimize'),
   maximizeWindow: () => ipcRenderer.invoke('window-maximize'),
   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),
@@ -23,11 +19,19 @@ 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
+  saveLauncherHardwareAcceleration: (enabled) => ipcRenderer.invoke('save-launcher-hw-accel', enabled),
+  loadLauncherHardwareAcceleration: () => ipcRenderer.invoke('load-launcher-hw-accel'),
+
   selectInstallPath: () => ipcRenderer.invoke('select-install-path'),
   browseJavaPath: () => ipcRenderer.invoke('browse-java-path'),
   isGameInstalled: () => ipcRenderer.invoke('is-game-installed'),
   uninstallGame: () => ipcRenderer.invoke('uninstall-game'),
   repairGame: () => ipcRenderer.invoke('repair-game'),
+  retryDownload: (retryData) => ipcRenderer.invoke('retry-download', retryData),
   getHytaleNews: () => ipcRenderer.invoke('get-hytale-news'),
   openExternal: (url) => ipcRenderer.invoke('open-external', url),
   openExternalLink: (url) => ipcRenderer.invoke('openExternalLink', url),
@@ -56,7 +60,6 @@ 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) => {
@@ -68,6 +71,10 @@ contextBridge.exposeInMainWorld('electronAPI', {
   loadGpuPreference: () => ipcRenderer.invoke('load-gpu-preference'),
   getDetectedGpu: () => ipcRenderer.invoke('get-detected-gpu'),
 
+  saveVersionBranch: (branch) => ipcRenderer.invoke('save-version-branch', branch),
+  loadVersionBranch: () => ipcRenderer.invoke('load-version-branch'),
+  loadVersionClient: () => ipcRenderer.invoke('load-version-client'),
+
   acceptFirstLaunchUpdate: (existingGame) => ipcRenderer.invoke('accept-first-launch-update', existingGame),
   markAsLaunched: () => ipcRenderer.invoke('mark-as-launched'),
   onFirstLaunchUpdate: (callback) => {
@@ -103,5 +110,24 @@ contextBridge.exposeInMainWorld('electronAPI', {
     activate: (id) => ipcRenderer.invoke('profile-activate', id),
     delete: (id) => ipcRenderer.invoke('profile-delete', id),
     update: (id, updates) => ipcRenderer.invoke('profile-update', id, updates)
+  },
+
+  // Launcher Update API
+  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));
+  },
+  onUpdateDownloadProgress: (callback) => {
+    ipcRenderer.on('update-download-progress', (event, data) => callback(data));
+  },
+  onUpdateDownloaded: (callback) => {
+    ipcRenderer.on('update-downloaded', (event, data) => callback(data));
+  },
+  onUpdateError: (callback) => {
+    ipcRenderer.on('update-error', (event, data) => callback(data));
   }
 });

scripts/notarize.js

@@ -0,0 +1,92 @@
+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;
+  }
+};