Add HYTALE_NOOP_TEST to test read/write without patching

Tests if our file read/write process itself causes corruption. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Fix: Don't fallback to legacy mode when using skip list
2026-02-26 14:51:48 -03:00 · 2026-01-27 04:05:08 +01:00 · 2026-01-27 03:51:32 +01:00 · 2026-01-27 03:38:09 +01:00 · 2026-01-27 03:34:36 +01:00 · 2026-01-27 03:31:51 +01:00
19 changed files with 959 additions and 288 deletions
--- a/.github/ISSUE_TEMPLATE/bug_report.yml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -55,6 +55,15 @@ body:
    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 | VRAM: 24 GB | RAM: 32 GB"
+    validations:
+      required: true
+
  - type: dropdown
    id: os
    attributes:
@@ -71,8 +80,17 @@ body:
    validations:
      required: true

+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs or Error Messages
+      description: If applicable, paste any error messages or logs here.
+      render: shell
+    validations:
+      required: true
+
  - type: textarea
    id: additional
    attributes:
      label: Additional context
-      description: Add any other context about the problem here.
+      description: Add any other context about the problem here.
--- a/.github/ISSUE_TEMPLATE/feature_request.yml
+++ b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -39,7 +39,7 @@ body:
    validations:
      required: true

-  - type: screenshots
+  - type: textarea
    id: screenshots
    attributes:
      label: Screenshots (Optional)
@@ -49,4 +49,4 @@ body:
    id: additional
    attributes:
      label: Additional context
-      description: Add any other context or screenshots about the feature request here.
+      description: Add any other context or screenshots about the feature request here.
--- a/.github/ISSUE_TEMPLATE/support_request.yml
+++ b/.github/ISSUE_TEMPLATE/support_request.yml
@@ -28,6 +28,15 @@ body:
    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 | VRAM: 24 GB | RAM: 32 GB"
+    validations:
+      required: true
+
  - type: input
    id: version
    attributes:
@@ -66,4 +75,4 @@ body:
    id: additional
    attributes:
      label: Additional Information
-      description: Any other information that might help us assist you.
+      description: Any other information that might help us assist you.
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -9,35 +9,6 @@ on:
  workflow_dispatch:

 jobs:
-  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 --x64 --arm64 --publish never
-      - uses: actions/upload-artifact@v4
-        with:
-          name: linux-builds
-          path: |
-            dist/*.AppImage
-            dist/*.AppImage.blockmap
-            dist/*.deb
-            dist/*.rpm
-            dist/*.pkg.tar.zst
-            dist/latest-linux.yml
-
  build-windows:
    runs-on: windows-latest
    steps:
@@ -78,8 +49,82 @@ jobs:
            dist/*.zip
            dist/latest-mac.yml

+  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 --x64 --arm64 --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: Upload Arch Package
+        uses: actions/upload-artifact@v4
+        with:
+          name: arch-package
+          path: |
+            *.pkg.tar.zst
+            *.src.tar.zst
+            .SRCINFO
+
  release:
-    needs: [build-linux, build-windows, build-macos]
+    needs: [build-windows, build-macos, build-linux, build-arch]
    runs-on: ubuntu-latest
    if: |
      startsWith(github.ref, 'refs/tags/v') || 
@@ -109,11 +154,15 @@ jobs:
      - name: Create Release
        uses: softprops/action-gh-release@v2
        with:
+          tag_name: ${{ github.ref_name }}
          # If it's a tag, use the tag. 
-          tag_name: ${{ github.ref_type == 'tag' && github.ref_name || format('v{0}.r{1}', steps.pkg_version.outputs.VERSION, github.run_number) }}
+          # tag_name: ${{ github.ref_type == 'tag' && github.ref_name || format('v{0}.r{1}', steps.pkg_version.outputs.VERSION, github.run_number) }}
          # If it's the 'release' branch, use 'v2.0.2-beta.r42'
          # name: ${{ github.ref_type == 'tag' && github.ref_name || format('v{0}-beta.r{1}', steps.pkg_version.outputs.VERSION, github.run_number) }}
          files: |
+            artifacts/arch-package/*.pkg.tar.zst
+            artifacts/arch-package/*.src.tar.zst
+            artifacts/arch-package/.SRCINFO
            artifacts/linux-builds/**/*
            artifacts/windows-builds/**/*
            artifacts/macos-builds/**/*
--- a/GUI/js/i18n.js
+++ b/GUI/js/i18n.js
@@ -6,7 +6,8 @@ const i18n = (() => {
    { code: 'en', name: 'English' },
    { code: 'es-ES', name: 'Español (España)' },
    { code: 'pt-BR', name: 'Portuguese (Brazil)' },
-    { code: 'tr-TR', name: 'Turkish (Turkey)' }
+    { code: 'tr-TR', name: 'Turkish (Turkey)' },
+    { code: 'pl-PL', name: 'Polish (Poland)' }
  ];

  // Load single language file
--- a/GUI/locales/pl-PL.json
+++ b/GUI/locales/pl-PL.json
@@ -0,0 +1,234 @@
+{
+  "nav": {
+    "play": "Graj",
+    "mods": "Mody",
+    "news": "Wiadomości",
+    "chat": "Chat z graczami",
+    "settings": "Ustawienia",
+    "skins": "Skiny"
+  },
+  "header": {
+    "playersLabel": "Graczy:",
+    "manageProfiles": "Zarządzaj Profilami",
+    "defaultProfile": "Domyślny",
+    "f2p": "FREE TO PLAY"
+  },
+  "install": {
+    "title": "FREE TO PLAY LAUNCHER",
+    "playerName": "Nazwa Gracza",
+    "playerNamePlaceholder": "Wprowadź Nazwę",
+    "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ź"
+  },
+  "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": "Wybierz preferowany procesor graficzny (Linux: wpływa na DRI_PRIME)",
+    "gpuAuto": "Auto",
+    "gpuIntegrated": "Zintegrowana",
+    "gpuDedicated": "Dedykowana",
+    "logs": "SYSTEM LOGS",
+    "logsCopy": "Kopiuj",
+    "logsRefresh": "Odśwież",
+    "logsFolder": "Otwórz Folder",
+    "logsLoading": "Ładowanie logów..."
+  },
+  "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"
+  },
+  "skins": {
+    "title": "Skiny",
+    "comingSoon": "Personalizacja skórek już wkrótce..."
+  },
+  "common": {
+    "confirm": "Potwierdź",
+    "cancel": "Anuluj",
+    "save": "Zapisz",
+    "close": "Zamknij",
+    "delete": "Usuń",
+    "edit": "Edytuj",
+    "loading": "Ładowanie...",
+    "apply": "Zastosuj"
+  },
+  "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"
+  },
+  "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!"
+  }
+}
--- a/33
+++ b/33
@@ -1,33 +1,28 @@
 # Maintainer: Terromur <terromuroz@proton.me>
-pkgname=Hytale-F2P-git
-_pkgname=Hytale-F2P
-pkgver=2.0.12.r150.gb62ffc1
+# Maintainer: Fazri Gading <fazrigading@gmail.com>
+# This PKGBUILD is for Github Releases
+pkgname=Hytale-F2P
+pkgver=2.1.1
 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')
-source=("git+$url.git" "Hytale-F2P.desktop")
+depends=('gtk3' 'nss' 'libxcrypt-compat')
+makedepends=('npm')
+source=("$url/archive/v$pkgver.tar.gz" "Hytale-F2P.desktop")
 sha256sums=('SKIP' '46488fada4775d9976d7b7b62f8d1f1f8d9a9a9d8f8aa9af4f2e2153019f6a30')

-pkgver() {
-  cd "$_pkgname"
-  version=$(git describe --abbrev=0 --tags --match "v[0-9]*")
-  commits=$(git rev-list --count HEAD)
-  hash=$(git rev-parse --short HEAD)
-  printf "%s.r%s.g%s" "${version#v}" "$commits" "$hash"
-}
-
 build() {
-   cd "$_pkgname"
+   cd "$pkgname-$pkgver"
   npm ci
-   npm run build:linux
+   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"
+  cd "$pkgname-$pkgver"
+  install -d "$pkgdir/opt/$pkgname"
+  cp -r dist/linux-unpacked/* "$pkgdir/opt/$pkgname"
+  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"
 }
--- a/34
+++ b/34
@@ -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')
+source=("git+$url.git" "$_pkgname.desktop")
+sha256sums=('SKIP' '46488fada4775d9976d7b7b62f8d1f1f8d9a9a9d8f8aa9af4f2e2153019f6a30')
+
+pkgver() {
+  cd "$srcdir/$_pkgname"
+  git describe --tags --long | sed 's/^v//;s/-/.r/;s/-/./'
+}
+
+build() {
+   cd "$srcdir/$_pkgname"
+   npm ci
+   npm run build:arch
+}
+
+package() {
+  cd "$srcdir/$_pkgname"
+  install -d "$pkgdir/opt/$_pkgname"
+  cp -r "$_pkgname/dist/linux-unpacked/"* "$pkgdir/opt/$_pkgname"
+
+  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"
+}
--- a/README.md
+++ b/README.md
@@ -1,12 +1,13 @@
 <div align="center">

 <header>
-  <h1>🎮 Hytale F2P Launcher | Cross-Platform Multiplayer 🖥️</h1>
+  <h1>🎮 Hytale F2P Launcher 🚀</h1>
+  <h2>💻 Cross-Platform Multiplayer 🖥️</h2>
  <h3>Available for Windows 🪟, macOS 🍎, and Linux 🐧</h3>
  <p><small>An unofficial cross-platform launcher for Hytale with automatic updates and multiplayer support (all OS supported)</small></p>
 </header>

-![Version](https://img.shields.io/badge/Version-2.1.0-green?style=for-the-badge)
+![Version](https://img.shields.io/badge/Version-2.1.1-green?style=for-the-badge)
 ![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-orange?style=for-the-badge)
 ![License](https://img.shields.io/badge/License-Educational-blue?style=for-the-badge)

@@ -17,10 +18,10 @@

 ### ⚠️ **READ [QUICK START](https://github.com/amiayweb/Hytale-F2P/tree/main?tab=readme-ov-file#-quick-start) before Downloading & Installing the Launcher!** ⚠️

-🛑 **Found a problem? Join the Discord and Select #Open-A-Ticket!: https://discord.gg/gME8rUy3MB** 🛑
+#### 🛑 **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>
+  👍 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>

@@ -119,7 +120,7 @@
      <td colspan="3" align="center">
        Windows 10/11 (64-bit; X64/ARM64) | Linux (x64/ARM64) | macOS (Apple Silicon only)
        <br />
-        <small><i>⚠️ Note: macOS Intel (x86) is not yet supported <a href="#fn1" id="ref1">1</a></sup></i></small>
+        <small><i>⚠️ Note: macOS Intel (x86) is not yet supported <sup><a href="#fn1" id="ref1">1</a></sup></i></small>
      </td>
    </tr>
    <tr>
@@ -130,7 +131,7 @@
    </tr>
    <tr>
      <td><b>🧠 RAM</b></td>
-      <td>8GB (Dedicated) / 12GB (iGPU)</td>
+      <td>8GB (dGPU)<sup><a href="#fn1" id="ref2">2</a></sup> /<br>12GB (iGPU)<sup><a href="#fn1" id="ref3">3</a></sup></td>
      <td>16 GB</td>
      <td>32 GB</td>
    </tr>
@@ -155,14 +156,22 @@
  </tbody>
 </table>
 </div>
-<p id="fn1"><sup>1</sup> Hytale did not provide game files for macOS Intel, yet.</p>
+<p id="fn1"><sup>Note 1</sup> Hytale did not provide game files for macOS Intel, yet.</p>
+<p id="fn2"><sup>Note 2</sup> Using Discrete/Dedicated GPU (dGPU) must have 8 GB RAM minimum.</p>
+<p id="fn3"><sup>Note 3</sup> Using Integrated GPU (dGPU) must have 12 GB RAM minimum.</p>



 ### 🪟 Windows Prequisites
-* **Java JDK 25:** Download via [Adoptium](https://adoptium.net/temurin/releases/?version=25) or [Oracle](https://www.oracle.com/java/technologies/downloads/#jdk25-windows)
-* **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/)
-* **ENABLE MULTIPLAYER:** // TODO MULTIPLAYER GUIDE; FIREWALL GUIDE AND SUCH
+* **
+* **Java JDK 25:**
+  * [Oracle](https://www.oracle.com/java/technologies/downloads/#jdk25-windows), **no** support for Windows ARM64 in both version 25 and 21.
+  * [Adoptium](https://adoptium.net/temurin/releases/?version=25), has Windows ARM64 support in version 21 only.
+  * [Microsoft](https://learn.microsoft.com/en-us/java/openjdk/download), has Windows ARM64 support in version 25.
+  * Download from any vendor if your OS is not Windows with ARM64 architecture.
+* **Latest Visual Studio Redist:** 
+  * Download via [Microsoft Visual C++ Redistributable](https://aka.ms/vc14/vc_redist.x64.exe)
+  * Or [All-in-One by Techpowerup](https://www.techpowerup.com/download/visual-c-redistributable-runtime-package-all-in-one/)

 ### 🐧 Linux Prequisites

@@ -202,24 +211,37 @@
 3. **Permissions & Execution:**
   * **AppImage:** Make the file executable and run it:
     ```bash
-     chmod +x Hytale-F2P-Launcher.AppImage
-     ./Hytale-F2P-Launcher.AppImage
+     chmod +x hytale-f2p-launcher.AppImage
+     ./hytale-f2p-launcher.AppImage
     ```
-   * **Fedora (dnf):** Install the RPM:
+   * **Ubuntu/Debian-based or Fedora/RHEL-based:** Install the DEB/RPM:
     ```bash
-     sudo dnf install ./Hytale-F2P-Launcher.rpm
-     ```
-   * **Debian/Ubuntu (apt):** Install the DEB:
-     ```bash
-     sudo apt install ./Hytale-F2P-Launcher.deb
+     # Fedora/RHEL-based
+     sudo dnf install hytale-f2p-launcher.rpm
+     # Debian/Ubuntu
+     sudo apt install -y libasound2 libpng16-16 libpng-dev libicu76
+     sudo dpkg -i hytale-f2p-launcher.deb
     ```
   * **Arch Linux (pacman):** Install the package using:
     ```bash
-     sudo pacman -U /path/to/Hytale-F2P-Launcher.pkg.tar.zst
+     # 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
     ```
+
+> [!NOTE]
+> Make sure to adjust the filename correctly with the version and the architecture type. TIP: Use `cd` command to the package location.
+
 4. **Troubleshooting:**
   * **FUSE:** If the AppImage fails to launch on newer distributions, ensure `libfuse2` (or `fuse2` on Arch/Fedora) is installed.
   * **Desktop Entry:** After installing via `.rpm`, `.deb`, or `.pkg.tar.zst`, the launcher should automatically appear in your App Library/Grid.
+   * Missing libxcrypt.so.1: Install `libxcrypt-compat` using your package manager

 ---

@@ -279,27 +301,28 @@ The `.zip` version is useful for users who prefer a portable installation or nee

 ## 🛠️ Building from Source

-See [BUILD.md](BUILD.md) for comprehensive build instructions.
+See [BUILD.md](docs/BUILD.md) for comprehensive build instructions.

 ---

 ## 📋 Changelog

-### 🆕 v2.1.0
-
- 🚨 **Auto-Retry Downloads and Auto-Patch Files** —  
- ⚡ **Hardware Acceleration** — 
- 👨‍💻 **In-App Logging** — 
- 🛠️ **Repair Button** — Y
- 🔎 **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.1.1
+- 🛠️ **Fix Bug EPERM**: EPERM or Error Permission in creating/removing process in reinstalling is now fixed.
+- 🅰️ **Adds .pkg.tar.zst Build for Arch Users**: This Arch-package has been needed since the first release.  
+- ❎ **Removes .pacman Build for Arch**: Based on the established conventions within the Arch Linux community, the file extension .pacman should not be used for package files.
+- 🌎 **New Translation**: New Polish 🇵🇱 Translation added to the Launcher. 

 <details>
 <summary>Click here to see older Changelogs</summary>

-### 🆕 v2.0.2b *(Minor Update: Performance & Utilities)*  
+### 🔄 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.
--- a/backend/core/paths.js
+++ b/backend/core/paths.js
@@ -14,6 +14,21 @@ function getAppDir() {
  }
 }

+/**
+ * Get centralized UserData saves directory (NEW in 2.1.2)
+ * 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) {
@@ -179,8 +194,28 @@ async function getModsPath(customInstallPath = null) {
    const profilesPath = path.join(userDataPath, 'Profiles');

    if (!fs.existsSync(modsPath)) {
-      // Ensure the Mods directory exists
-      fs.mkdirSync(modsPath, { recursive: true });
+      // 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 });
@@ -198,20 +233,8 @@ async function getModsPath(customInstallPath = null) {

 function getProfilesDir(customInstallPath = null) {
  try {
-    // get UserData path
-    let installPath = customInstallPath;
-    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 branch = loadVersionBranch();
-    const gameLatest = path.join(installPath, branch, 'package', 'game', 'latest');
-    const userDataPath = findUserDataPath(gameLatest);
+    // NEW 2.1.2: Use centralized UserData location
+    const userDataPath = getHytaleSavesDir();
    const profilesDir = path.join(userDataPath, 'Profiles');
    
    if (!fs.existsSync(profilesDir)) {
@@ -227,6 +250,7 @@ function getProfilesDir(customInstallPath = null) {

 module.exports = {
  getAppDir,
+  getHytaleSavesDir,
  getResolvedAppDir,
  expandHome,
  APP_DIR,
--- a/backend/managers/gameLauncher.js
+++ b/backend/managers/gameLauncher.js
@@ -12,6 +12,7 @@ const { resolveJavaPath, getJavaExec, getBundledJavaPath, detectSystemJava, JAVA
 const { getLatestClientVersion } = require('../services/versionManager');
 const { updateGameFiles } = require('./gameManager');
 const { syncModsForCurrentProfile } = require('./modManager');
+const { getUserDataPath } = require('../utils/userDataMigration');

 // Client patcher for custom auth server (sanasol.ws)
 let clientPatcher = null;
@@ -106,7 +107,9 @@ async function launchGame(playerName = 'Player', progressCallback, javaPathOverr
  const customAppDir = getResolvedAppDir(installPathOverride);
  const customGameDir = path.join(customAppDir, branch, 'package', 'game', 'latest');
  const customJreDir = path.join(customAppDir, branch, 'package', 'jre', 'latest');
-  const userDataDir = path.join(customGameDir, 'Client', 'UserData');
+  
+  // NEW 2.1.2: Use centralized UserData location
+  const userDataDir = getUserDataPath();

  const gameLatest = customGameDir;
  let clientPath = findClientPath(gameLatest);
@@ -282,6 +285,32 @@ exec "$REAL_JAVA" "\${ARGS[@]}"
   const gpuEnv = setupGpuEnvironment(gpuPreference);
   Object.assign(env, gpuEnv);

+   // Linux memory allocator fixes for "free(): invalid pointer" crashes
+   // on Steam Deck (glibc 2.41) and Ubuntu LTS
+   if (process.platform === 'linux') {
+     // Option 1: Disable glibc heap validation
+     env.MALLOC_CHECK_ = '0';
+
+     // Option 2: Try to use jemalloc if available (more robust allocator)
+     // User can set HYTALE_USE_JEMALLOC=1 to enable
+     if (process.env.HYTALE_USE_JEMALLOC === '1') {
+       const jemalloc = require('fs').existsSync('/usr/lib/libjemalloc.so.2')
+         ? '/usr/lib/libjemalloc.so.2'
+         : require('fs').existsSync('/usr/lib/x86_64-linux-gnu/libjemalloc.so.2')
+           ? '/usr/lib/x86_64-linux-gnu/libjemalloc.so.2'
+           : null;
+
+       if (jemalloc) {
+         env.LD_PRELOAD = jemalloc + (env.LD_PRELOAD ? ':' + env.LD_PRELOAD : '');
+         console.log(`Linux: Using jemalloc allocator (${jemalloc})`);
+       } else {
+         console.log('Linux: jemalloc not found, using glibc with MALLOC_CHECK_=0');
+       }
+     } else {
+       console.log('Linux: Using glibc with MALLOC_CHECK_=0 (set HYTALE_USE_JEMALLOC=1 to try jemalloc)');
+     }
+   }
+
  try {
    let spawnOptions = {
      stdio: ['ignore', 'pipe', 'pipe'],
--- a/backend/managers/gameManager.js
+++ b/backend/managers/gameManager.js
@@ -9,7 +9,7 @@ const { installButler } = require('./butlerManager');
 const { downloadAndReplaceHomePageUI, downloadAndReplaceLogo } = require('./uiFileManager');
 const { saveUsername, saveInstallPath, loadJavaPath, CONFIG_FILE, loadConfig, loadVersionBranch, saveVersionClient, loadVersionClient } = require('../core/config');
 const { resolveJavaPath, detectSystemJava, downloadJRE, getJavaExec, getBundledJavaPath } = require('./javaManager');
-const userDataBackup = require('../utils/userDataBackup');
+const { getUserDataPath, migrateUserDataToCentralized } = require('../utils/userDataMigration');

 async function downloadPWR(branch = 'release', fileName = '4.pwr', progressCallback, cacheDir = CACHE_DIR, manualRetry = false) {
  const osName = getOS();
@@ -308,31 +308,25 @@ async function applyPWR(pwrFile, progressCallback, gameDir = GAME_DIR, toolsDir

 async function updateGameFiles(newVersion, progressCallback, gameDir = GAME_DIR, toolsDir = TOOLS_DIR, cacheDir = CACHE_DIR, branchOverride = null) {
  let tempUpdateDir;
-  let backupPath = null;
  const branch = branchOverride || loadVersionBranch();
  const installPath = path.dirname(path.dirname(path.dirname(path.dirname(gameDir))));
  
-  // Vérifier si on a version_client et version_branch dans config.json
  const config = loadConfig();
-  const hasVersionConfig = !!(config.version_client && config.version_branch);
-  const oldBranch = config.version_branch || 'release'; // L'ancienne branche pour le backup
-  console.log(`[UpdateGameFiles] hasVersionConfig: ${hasVersionConfig}`);
+  const oldBranch = config.version_branch || 'release';
  console.log(`[UpdateGameFiles] Switching from ${oldBranch} to ${branch}`);
  
  try {
-    if (progressCallback) {
-      progressCallback('Backing up user data...', 5, null, null, null);
-    }
-
-    // Backup UserData AVANT de télécharger/installer (critical for same-branch updates)
+    // NEW 2.1.2: Ensure UserData migration to centralized location
    try {
-      console.log(`[UpdateGameFiles] Attempting to backup UserData from old branch: ${oldBranch}`);
-      backupPath = await userDataBackup.backupUserData(installPath, oldBranch, hasVersionConfig);
-      if (backupPath) {
-        console.log(`[UpdateGameFiles] ✓ UserData backed up from ${oldBranch}: ${backupPath}`);
+      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');
      }
-    } catch (backupError) {
-      console.warn('[UpdateGameFiles] ✗ UserData backup failed:', backupError.message);
+    } catch (migrationError) {
+      console.warn('[UpdateGameFiles] UserData migration warning:', migrationError.message);
    }

    if (progressCallback) {
@@ -365,7 +359,21 @@ async function updateGameFiles(newVersion, progressCallback, gameDir = GAME_DIR,

    if (fs.existsSync(gameDir)) {
      console.log('Removing old game files...');
-      fs.rmSync(gameDir, { recursive: true, force: true });
+      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);
@@ -376,31 +384,9 @@ async function updateGameFiles(newVersion, progressCallback, gameDir = GAME_DIR,
    const logoResult = await downloadAndReplaceLogo(gameDir, progressCallback);
    console.log('Logo@2x.png update result after update:', logoResult);

-    // Ensure UserData directory exists
-    const userDataDir = path.join(gameDir, 'Client', 'UserData');
-    if (!fs.existsSync(userDataDir)) {
-      console.log(`[UpdateGameFiles] Creating UserData directory at: ${userDataDir}`);
-      fs.mkdirSync(userDataDir, { recursive: true });
-    }
-
-    if (progressCallback) {
-      progressCallback('Restoring user data...', 90, null, null, null);
-    }
-
-    // Restore UserData using new system
-    if (backupPath) {
-      try {
-        console.log(`[UpdateGameFiles] Restoring UserData from ${oldBranch} to ${branch}`);
-        console.log(`[UpdateGameFiles] Source backup: ${backupPath}`);
-        await userDataBackup.restoreUserData(backupPath, installPath, branch);
-        await userDataBackup.cleanupBackup(backupPath);
-        console.log(`[UpdateGameFiles] ✓ UserData migrated successfully from ${oldBranch} to ${branch}`);
-      } catch (restoreError) {
-        console.warn('[UpdateGameFiles] ✗ UserData restore failed:', restoreError.message);
-      }
-    } else {
-      console.log('[UpdateGameFiles] No backup to restore, empty UserData folder created');
-    }
+    // NEW 2.1.2: No longer create UserData in game installation
+    // UserData is now in centralized location (getUserDataPath())
+    console.log('[UpdateGameFiles] UserData is managed in centralized location');

    console.log(`Game files updated successfully to version: ${newVersion}`);
    
@@ -420,15 +406,6 @@ async function updateGameFiles(newVersion, progressCallback, gameDir = GAME_DIR,
  } catch (error) {
    console.error('Error updating game files:', error);

-    if (backupPath) {
-      try {
-        await userDataBackup.cleanupBackup(backupPath);
-        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 });
    }
@@ -456,28 +433,18 @@ async function installGame(playerName = 'Player', progressCallback, javaPathOver
  const customToolsDir = path.join(customAppDir, 'butler');
  const customGameDir = path.join(customAppDir, branch, 'package', 'game', 'latest');
  const customJreDir = path.join(customAppDir, branch, 'package', 'jre', 'latest');
-  const userDataDir = path.join(customGameDir, 'Client', 'UserData');
-
-  // 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(`[InstallGame] Configuration detected - version_client: ${config.version_client}, version_branch: ${config.version_branch}`);
-  console.log(`[InstallGame] hasVersionConfig: ${hasVersionConfig}`);
-
-  // Backup UserData AVANT l'installation si nécessaire
-  let backupPath = null;
-  if (progressCallback) {
-    progressCallback('Checking for existing UserData...', 5, null, null, null);
-  }

+  // NEW 2.1.2: Ensure UserData migration to centralized location
  try {
-    console.log(`[InstallGame] Attempting UserData backup (hasVersionConfig: ${hasVersionConfig})...`);
-    backupPath = await userDataBackup.backupUserData(customAppDir, branch, hasVersionConfig);
-    if (backupPath) {
-      console.log(`[InstallGame] ✓ UserData backed up to: ${backupPath}`);
+    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 (backupError) {
-    console.warn('[InstallGame] ✗ UserData backup failed:', backupError.message);
+  } catch (migrationError) {
+    console.warn('[InstallGame] UserData migration warning:', migrationError.message);
  }

  [customAppDir, customCacheDir, customToolsDir].forEach(dir => {
@@ -486,10 +453,6 @@ async function installGame(playerName = 'Player', progressCallback, javaPathOver
    }
  });

-  if (!fs.existsSync(userDataDir)) {
-    fs.mkdirSync(userDataDir, { recursive: true });
-  }
-
  saveUsername(playerName);
  if (installPathOverride) {
    saveInstallPath(installPathOverride);
@@ -581,29 +544,9 @@ async function installGame(playerName = 'Player', progressCallback, javaPathOver
  const logoResult = await downloadAndReplaceLogo(customGameDir, progressCallback);
  console.log('Logo@2x.png update result after installation:', logoResult);

-  // Ensure UserData directory exists
-  if (!fs.existsSync(userDataDir)) {
-    console.log(`[InstallGame] Creating UserData directory at: ${userDataDir}`);
-    fs.mkdirSync(userDataDir, { recursive: true });
-  }
-
-  // Restore UserData from backup if exists
-  if (backupPath) {
-    if (progressCallback) {
-      progressCallback('Restoring UserData...', 95, null, null, null);
-    }
-
-    try {
-      console.log(`[InstallGame] Restoring UserData from: ${backupPath}`);
-      await userDataBackup.restoreUserData(backupPath, customAppDir, branch);
-      await userDataBackup.cleanupBackup(backupPath);
-      console.log('[InstallGame] ✓ UserData restored successfully');
-    } catch (restoreError) {
-      console.warn('[InstallGame] ✗ UserData restore failed:', restoreError.message);
-    }
-  } else {
-    console.log('[InstallGame] No backup to restore, empty UserData folder created');
-  }
+  // NEW 2.1.2: No longer create UserData in game installation
+  // UserData is managed in centralized location (getUserDataPath())
+  console.log('[InstallGame] UserData is managed in centralized location');

  if (progressCallback) {
    progressCallback('Installation complete', 100, null, null, null);
--- a/backend/managers/modManager.js
+++ b/backend/managers/modManager.js
@@ -2,6 +2,7 @@ const fs = require('fs');
 const path = require('path');
 const crypto = require('crypto');
 const axios = require('axios');
+const { getOS } = require('../utils/platformUtils');
 const { getModsPath, getProfilesDir } = require('../core/paths');
 const { saveModsToConfig, loadModsFromConfig } = require('../core/config');
 const profileManager = require('./profileManager');
@@ -307,11 +308,16 @@ async function syncModsForCurrentProfile() {

    // 2. Symlink / Migration Logic
    let needsLink = false;
+    let globalStats = null;
+    
+    try {
+      globalStats = fs.lstatSync(globalModsPath);
+    } catch (e) {
+      // Path doesn't exist
+    }

-    if (fs.existsSync(globalModsPath)) {
-      const stats = fs.lstatSync(globalModsPath);
-      
-      if (stats.isSymbolicLink()) {
+    if (globalStats) {
+      if (globalStats.isSymbolicLink()) {
        const linkTarget = fs.readlinkSync(globalModsPath);
        // Normalize paths for comparison
        if (path.resolve(linkTarget) !== path.resolve(profileModsPath)) {
@@ -319,7 +325,7 @@ async function syncModsForCurrentProfile() {
          fs.unlinkSync(globalModsPath);
          needsLink = true;
        }
-      } else if (stats.isDirectory()) {
+      } else if (globalStats.isDirectory()) {
        // MIGRATION: It's a real directory. Move contents to profile.
        console.log('[ModManager] Migrating global mods folder to profile folder...');
        const files = fs.readdirSync(globalModsPath);
@@ -349,7 +355,20 @@ async function syncModsForCurrentProfile() {

        // Remove the directory so we can link it
        try {
-            fs.rmSync(globalModsPath, { recursive: true, force: true });
+            let retries = 3;
+            while (retries > 0) {
+                try {
+                    fs.rmSync(globalModsPath, { recursive: true, force: true });
+                    break;
+                } catch (err) {
+                    if ((err.code === 'EPERM' || err.code === 'EBUSY') && retries > 0) {
+                        retries--;
+                        await new Promise(resolve => setTimeout(resolve, 500));
+                    } else {
+                        throw err;
+                    }
+                }
+            }
            needsLink = true;
        } catch (e) {
            console.error('Failed to remove global mods dir:', e);
@@ -364,8 +383,8 @@ async function syncModsForCurrentProfile() {
    if (needsLink) {
      console.log(`[ModManager] Creating symlink: ${globalModsPath} -> ${profileModsPath}`);
      try {
-         // 'junction' is key for Windows without admin
-         fs.symlinkSync(profileModsPath, globalModsPath, 'junction'); 
+         const symlinkType = getOS() === 'windows' ? 'junction' : 'dir';
+         fs.symlinkSync(profileModsPath, globalModsPath, symlinkType); 
      } catch (err) {
        // If we can't create the symlink, try creating the directory first
        console.error('[ModManager] Failed to create symlink. Falling back to direct folder mode.');
--- a/backend/utils/clientPatcher.js
+++ b/backend/utils/clientPatcher.js
@@ -147,8 +147,9 @@ class ClientPatcher {
  }

  /**
-   * Replace bytes in buffer - only overwrites the length of new bytes
-   * Prevents offset corruption by not expanding the replacement
+   * Replace bytes in buffer with null-padding for shorter replacements
+   * When new pattern is shorter than old, pads with 0x00 to prevent leftover bytes
+   * that can cause memory corruption (free(): invalid pointer) on some systems
   */
  replaceBytes(buffer, oldBytes, newBytes) {
    let count = 0;
@@ -162,7 +163,20 @@ class ClientPatcher {
    const positions = this.findAllOccurrences(result, oldBytes);

    for (const pos of positions) {
-      // Only overwrite the length of the new bytes
+      // Log offset and surrounding bytes for debugging
+      const before = result.slice(Math.max(0, pos - 8), pos);
+      const after = result.slice(pos + oldBytes.length, Math.min(result.length, pos + oldBytes.length + 8));
+      console.log(`    Patching at offset 0x${pos.toString(16)} (${pos})`);
+      console.log(`      Before: ${before.toString('hex')}`);
+      console.log(`      Old pattern: ${oldBytes.slice(0, 20).toString('hex')}${oldBytes.length > 20 ? '...' : ''}`);
+      console.log(`      After: ${after.toString('hex')}`);
+
+      // First fill the entire old pattern region with zeros
+      // This prevents leftover bytes from causing memory corruption
+      if (newBytes.length < oldBytes.length) {
+        result.fill(0x00, pos, pos + oldBytes.length);
+      }
+      // Then write the new bytes
      newBytes.copy(result, pos);
      count++;
    }
@@ -170,6 +184,65 @@ class ClientPatcher {
    return { buffer: result, count };
  }

+  /**
+   * Replace bytes with skip/limit control (for debugging)
+   * HYTALE_PATCH_SKIP: comma-separated indices to skip (e.g., "0,2" skips 1st and 3rd)
+   * HYTALE_PATCH_LIMIT: max number of patches to apply
+   */
+  replaceBytesLimited(buffer, oldBytes, newBytes, limit) {
+    let count = 0;
+    const result = Buffer.from(buffer);
+
+    if (newBytes.length > oldBytes.length) {
+      console.warn(`  Warning: New pattern (${newBytes.length}) longer than old (${oldBytes.length}), skipping`);
+      return { buffer: result, count: 0 };
+    }
+
+    // Parse skip list from env
+    const skipIndices = (process.env.HYTALE_PATCH_SKIP || '')
+      .split(',')
+      .filter(s => s.trim())
+      .map(s => parseInt(s.trim(), 10));
+    if (skipIndices.length > 0) {
+      console.log(`    Skip indices: ${skipIndices.join(', ')}`);
+    }
+
+    const positions = this.findAllOccurrences(result, oldBytes);
+
+    let patchedCount = 0;
+    for (let i = 0; i < positions.length; i++) {
+      const pos = positions[i];
+
+      // Log offset and surrounding bytes for debugging
+      const before = result.slice(Math.max(0, pos - 8), pos);
+      const after = result.slice(pos + oldBytes.length, Math.min(result.length, pos + oldBytes.length + 8));
+
+      if (skipIndices.includes(i)) {
+        console.log(`    [${i}] Skipping offset 0x${pos.toString(16)} (in skip list)`);
+        continue;
+      }
+
+      if (patchedCount >= limit) {
+        console.log(`    [${i}] Skipping offset 0x${pos.toString(16)} (limit reached)`);
+        continue;
+      }
+
+      console.log(`    [${i}] Patching at offset 0x${pos.toString(16)} (${pos})`);
+      console.log(`      Before: ${before.toString('hex')}`);
+      console.log(`      Old pattern: ${oldBytes.slice(0, 20).toString('hex')}${oldBytes.length > 20 ? '...' : ''}`);
+      console.log(`      After: ${after.toString('hex')}`);
+
+      if (newBytes.length < oldBytes.length) {
+        result.fill(0x00, pos, pos + oldBytes.length);
+      }
+      newBytes.copy(result, pos);
+      patchedCount++;
+      count++;
+    }
+
+    return { buffer: result, count };
+  }
+
  /**
   * UTF-8 domain replacement for Java JAR files.
   * Java stores strings in UTF-8 format in the constant pool.
@@ -197,11 +270,19 @@ class ClientPatcher {
   * .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
+   *
+   * IMPORTANT: newDomain must be same length or shorter than oldDomain to avoid buffer overflow
   */
  findAndReplaceDomainSmart(data, oldDomain, newDomain) {
    let count = 0;
    const result = Buffer.from(data);

+    // Safety check: new domain must not be longer than old
+    if (newDomain.length > oldDomain.length) {
+      console.warn(`  Warning: New domain (${newDomain.length} chars) longer than old (${oldDomain.length} chars), skipping smart replacement`);
+      return { buffer: result, count: 0 };
+    }
+
    const oldUtf16NoLast = this.stringToUtf16LE(oldDomain.slice(0, -1));
    const newUtf16NoLast = this.stringToUtf16LE(newDomain.slice(0, -1));

@@ -217,6 +298,11 @@ class ClientPatcher {
      const lastCharFirstByte = result[lastCharPos];

      if (lastCharFirstByte === oldLastCharByte) {
+        // Zero-fill the old region first if new is shorter
+        if (newUtf16NoLast.length < oldUtf16NoLast.length) {
+          result.fill(0x00, pos, pos + oldUtf16NoLast.length);
+        }
+
        newUtf16NoLast.copy(result, pos);

        result[lastCharPos] = newLastCharByte;
@@ -239,6 +325,10 @@ class ClientPatcher {
  /**
   * Apply all domain patches using length-prefixed format
   * This is the main patching method for variable-length domains
+   *
+   * Debug env vars:
+   *   HYTALE_SKIP_SENTRY_PATCH=1 - Skip sentry URL patch (biggest size change)
+   *   HYTALE_SKIP_SUBDOMAIN_PATCH=1 - Skip subdomain prefix patches
   */
  applyDomainPatches(data, domain, protocol = 'https://') {
    let result = Buffer.from(data);
@@ -247,50 +337,79 @@ class ClientPatcher {

    console.log(`  Patching strategy: ${strategy.description}`);

-    // 1. Patch telemetry/sentry URL
-    const oldSentry = 'https://ca900df42fcf57d4dd8401a86ddd7da2@sentry.hytale.com/2';
-    const newSentry = `${protocol}t@${domain}/2`;
+    // 1. Patch telemetry/sentry URL (skip if debugging)
+    if (process.env.HYTALE_SKIP_SENTRY_PATCH === '1') {
+      console.log(`  Skipping sentry patch (HYTALE_SKIP_SENTRY_PATCH=1)`);
+    } else {
+      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;
+      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 (hytale.com -> mainDomain)
+    // Try length-prefixed format first, then fall back to pure UTF-16LE
    console.log(`  Patching domain: ${ORIGINAL_DOMAIN} -> ${strategy.mainDomain}`);
-    const domainResult = this.replaceBytes(
-        result,
-        this.stringToLengthPrefixed(ORIGINAL_DOMAIN),
-        this.stringToLengthPrefixed(strategy.mainDomain)
-    );
+
+    // Check for HYTALE_PATCH_MODE env var to test different formats
+    const patchMode = process.env.HYTALE_PATCH_MODE || 'length-prefixed';
+    console.log(`  Patch mode: ${patchMode}`);
+
+    let domainResult;
+    if (patchMode === 'utf16le') {
+      // Pure UTF-16LE replacement (no length prefix)
+      const oldUtf16 = this.stringToUtf16LE(ORIGINAL_DOMAIN);
+      const newUtf16 = this.stringToUtf16LE(strategy.mainDomain);
+      console.log(`    UTF-16LE: old=${oldUtf16.length} bytes, new=${newUtf16.length} bytes`);
+
+      // HYTALE_PATCH_LIMIT: only patch first N occurrences (for debugging)
+      const patchLimit = parseInt(process.env.HYTALE_PATCH_LIMIT || '999', 10);
+      console.log(`    Patch limit: ${patchLimit}`);
+      domainResult = this.replaceBytesLimited(result, oldUtf16, newUtf16, patchLimit);
+    } else {
+      // Length-prefixed format (default)
+      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;
+    // 3. Patch subdomain prefixes (skip if debugging)
+    if (process.env.HYTALE_SKIP_SUBDOMAIN_PATCH === '1') {
+      console.log(`  Skipping subdomain patches (HYTALE_SKIP_SUBDOMAIN_PATCH=1)`);
+    } else {
+      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;
+      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;
+        }
      }
    }

@@ -298,38 +417,13 @@ class ClientPatcher {
  }

  /**
-   * Patch Discord invite URLs from .gg/hytale to .gg/MHkEjepMQ7
+   * Patch Discord invite URLs - DISABLED
+   * Was causing buffer overflow crashes on Steam Deck/Ubuntu LTS
+   * The Discord URL in the game doesn't affect F2P functionality anyway
   */
  patchDiscordUrl(data) {
-    let count = 0;
-    const result = Buffer.from(data);
-
-    const oldUrl = '.gg/hytale';
-    const newUrl = '.gg/MHkEjepMQ7';
-
-    // Try length-prefixed format first
-    const lpResult = this.replaceBytes(
-        result,
-        this.stringToLengthPrefixed(oldUrl),
-        this.stringToLengthPrefixed(newUrl)
-    );
-
-    if (lpResult.count > 0) {
-      return { buffer: lpResult.buffer, count: lpResult.count };
-    }
-
-    // Fallback to UTF-16LE
-    const oldUtf16 = this.stringToUtf16LE(oldUrl);
-    const newUtf16 = this.stringToUtf16LE(newUrl);
-
-    const positions = this.findAllOccurrences(result, oldUtf16);
-
-    for (const pos of positions) {
-      newUtf16.copy(result, pos);
-      count++;
-    }
-
-    return { buffer: result, count };
+    // Disabled - no practical effect and was causing memory corruption
+    return { buffer: Buffer.from(data), count: 0 };
  }

  /**
@@ -483,6 +577,14 @@ class ClientPatcher {
      progressCallback('Patching domain references...', 50);
    }

+    // HYTALE_NOOP_TEST: Just read and write binary without any changes
+    if (process.env.HYTALE_NOOP_TEST === '1') {
+      console.log('NOOP TEST: Writing binary without modifications...');
+      fs.writeFileSync(clientPath, data);
+      this.markAsPatched(clientPath);
+      return { success: true, patchCount: 0, noop: true };
+    }
+
    console.log('Applying domain patches (length-prefixed format)...');
    const { buffer: patchedData, count } = this.applyDomainPatches(data, newDomain);

@@ -490,6 +592,17 @@ class ClientPatcher {
    const { buffer: finalData, count: discordCount } = this.patchDiscordUrl(patchedData);

    if (count === 0 && discordCount === 0) {
+      // Check if we're in debug mode with skip - don't fallback if intentionally skipping
+      const hasSkipList = (process.env.HYTALE_PATCH_SKIP || '').trim().length > 0;
+      const noLegacyFallback = process.env.HYTALE_NO_LEGACY_FALLBACK === '1';
+
+      if (hasSkipList || noLegacyFallback) {
+        console.log('No occurrences patched (skip list active or legacy fallback disabled)');
+        fs.writeFileSync(clientPath, patchedData);
+        this.markAsPatched(clientPath);
+        return { success: true, patchCount: 0, skipped: true };
+      }
+
      console.log('No occurrences found - trying legacy UTF-16LE format...');

      // Fallback to legacy patching for older binary formats
--- a/backend/utils/userDataBackup.js
+++ b/backend/utils/userDataBackup.js
@@ -46,7 +46,8 @@ class UserDataBackup {
      console.log(`[UserDataBackup] Copying from ${userDataPath} to ${backupPath}...`);
      await fs.copy(userDataPath, backupPath, {
        overwrite: true,
-        errorOnExist: false
+        errorOnExist: false,
+        dereference: true  // Follow symlinks to avoid EPERM errors on Windows
      });
      console.log('[UserDataBackup] ✓ Backup completed successfully');
      return backupPath;
@@ -82,7 +83,8 @@ class UserDataBackup {

      await fs.copy(backupPath, userDataPath, {
        overwrite: true,
-        errorOnExist: false
+        errorOnExist: false,
+        dereference: true  // Follow symlinks to avoid EPERM errors on Windows
      });
      
      console.log('UserData restore completed successfully');
--- a/backend/utils/userDataMigration.js
+++ b/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.1.2+): 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.1.2)
+ * 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.1.2
+ */
+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.1.2+)
+ * 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
+};
--- a/main.js
+++ b/main.js
@@ -5,6 +5,7 @@ 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, saveLauncherHardwareAcceleration, loadLauncherHardwareAcceleration, isGameInstalled, uninstallGame, repairGame, getHytaleNews, handleFirstLaunchCheck, proposeGameUpdate, markAsLaunched } = require('./backend/launcher');
 const { retryPWRDownload } = require('./backend/managers/gameManager');
+const { migrateUserDataToCentralized } = require('./backend/utils/userDataMigration');

 // Handle Hardware Acceleration
 try {
@@ -298,6 +299,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 () => {
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
  "name": "hytale-f2p-launcher",
-  "version": "2.1.0",
+  "version": "2.1.1",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "hytale-f2p-launcher",
-      "version": "2.1.0",
+      "version": "2.1.1",
      "license": "MIT",
      "dependencies": {
        "adm-zip": "^0.5.10",
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
  "name": "hytale-f2p-launcher",
-  "version": "2.1.0",
+  "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",
@@ -82,7 +86,7 @@
          ]
        }
      ],
-      "icon": "icon.ico"
+      "icon": "build/icon.ico"
    },
    "linux": {
      "target": [
@@ -106,13 +110,6 @@
            "x64",
            "arm64"
          ]
-        },
-        {
-          "target": "pacman",
-          "arch": [
-            "x64",
-            "arm64"
-          ]
        }
      ],
      "icon": "build/icon.png",
Author	SHA1	Message	Date
sanasol	ab6f932245	Add HYTALE_NOOP_TEST to test read/write without patching Tests if our file read/write process itself causes corruption. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-01-27 04:05:08 +01:00
sanasol	6333263ef9	Fix: Don't fallback to legacy mode when using skip list When HYTALE_PATCH_SKIP is set, the legacy fallback was ignoring the skip list and patching all occurrences anyway. Now if skip list is active or HYTALE_NO_LEGACY_FALLBACK=1, the legacy fallback is disabled. Also found 4th occurrence at 0x1bc5d67 with metadata byte 0x89 that legacy mode was patching - this may be the crash culprit. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-01-27 03:51:32 +01:00
sanasol	654deca933	Add HYTALE_PATCH_SKIP to skip specific occurrences by index HYTALE_PATCH_SKIP=0 - skip first occurrence only HYTALE_PATCH_SKIP=0,2 - skip first and third HYTALE_PATCH_SKIP=0 HYTALE_PATCH_LIMIT=1 - patch only second occurrence Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-01-27 03:38:09 +01:00
sanasol	aab67e8e28	Add HYTALE_PATCH_LIMIT to patch only first N occurrences Use HYTALE_PATCH_LIMIT=1 to patch only first occurrence, HYTALE_PATCH_LIMIT=2 for first two, etc. Helps isolate which specific occurrence causes the crash. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-01-27 03:34:36 +01:00
sanasol	3953827f4a	Add offset logging to debug which locations are being patched Shows hex offset, bytes before/after each patch location to help identify if we're patching false positives. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-01-27 03:31:51 +01:00
sanasol	81d1e7c113	Add HYTALE_PATCH_MODE env var to test different string formats HYTALE_PATCH_MODE=utf16le - Use pure UTF-16LE (no length prefix) HYTALE_PATCH_MODE=length-prefixed - Use length-prefixed format (default) This helps debug if the length-prefixed format is causing crashes. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-01-27 03:00:29 +01:00
sanasol	d8f90bd1ff	Disable Discord URL patching entirely The Discord URL patch was causing buffer overflow crashes and has no practical effect on F2P functionality anyway. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-01-27 02:44:13 +01:00
sanasol	50491abc69	Fix buffer overflow in Discord URL patch - likely cause of crashes The Discord URL patch was writing 28 bytes (.gg/MHkEjepMQ7, 14 chars) where only 20 bytes existed (.gg/hytale, 10 chars), corrupting 8 bytes of adjacent data in the binary. Changes: - Use same-length Discord URL: .gg/santop (10 chars) - Add length check to UTF-16LE fallback path - Add length check and zero-fill to findAndReplaceDomainSmart This buffer overflow explains why the crash happened on some systems (Steam Deck, Ubuntu LTS) but not others - depending on what data was adjacent to the patched string. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-01-27 02:41:38 +01:00
sanasol	c92c5bec3c	Add debug options and jemalloc support for Linux memory issues Debug env vars for clientPatcher: - HYTALE_SKIP_SENTRY_PATCH=1 - Skip sentry URL patch (60->26 chars) - HYTALE_SKIP_SUBDOMAIN_PATCH=1 - Skip subdomain prefix patches Game launcher Linux options: - HYTALE_USE_JEMALLOC=1 - Use jemalloc allocator instead of glibc This helps isolate which patch causes "free(): invalid pointer" on Steam Deck and Ubuntu LTS. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-01-27 02:31:38 +01:00
sanasol	73f67f2fec	Add MALLOC_CHECK_=0 for Linux to bypass glibc heap validation Attempts to fix "free(): invalid pointer" crashes on Steam Deck and Ubuntu LTS. The same patched binary works on macOS, Windows, and Arch Linux, suggesting the issue is glibc's strict heap validation rather than actual memory corruption. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-01-27 02:27:04 +01:00
sanasol	2582d9b6d1	Fix memory corruption by null-padding shorter replacement patterns When replacing domain strings with shorter ones, the replaceBytes function was only copying the new bytes without clearing the leftover bytes from the old pattern. This caused "free(): invalid pointer" crashes on Steam Deck and Ubuntu due to corrupted string metadata in the .NET AOT binary. Fix: Fill the entire old pattern region with 0x00 before writing the new bytes. This ensures no leftover data remains that could corrupt the binary structure. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-01-27 02:10:31 +01:00
AMIAY	e56b12cd72	userdata migration [need review from other OS]	2026-01-27 01:44:58 +01:00
Fazri Gading	3edee4b4eb	fix: PKGBUILD pkgname variable fix	2026-01-27 03:55:01 +08:00
Fazri Gading	e5fec7c326	Merge branch 'main' into develop	2026-01-27 03:42:40 +08:00
Fazri Gading	7d2672b684	add hardware spec input in bug_report.yml	2026-01-27 03:41:26 +08:00
Fazri Gading	01823729ec	fix screenshot input in feature_request.yml	2026-01-27 03:40:22 +08:00
Fazri Gading	639a2ab1b5	chore: add changelog in README.md	2026-01-27 03:38:20 +08:00
Fazri Gading	6b76eb365e	Update bug_report.yml Add logs textfield to bug report	2026-01-27 03:21:47 +08:00
Fazri Gading	6fa933fece	Update support_request.yml Added hardware specification	2026-01-27 03:19:06 +08:00
walti0	e7023dcf95	Polish language support (#195 )	2026-01-27 03:06:16 +08:00
Fazri Gading	faf21b830b	Merge pull request #196 from amiayweb/develop Release v2.1.1: fix EPERM error and add ArchLinux package (.pkg.tar.zst)	2026-01-27 02:29:35 +08:00
Fazri Gading	f4d966ee65	chore: fix ubuntu/debian part in README.md	2026-01-27 02:16:01 +08:00
Fazri Gading	ca835a868b	Merge pull request #188 from TalesAmaral/patch-1 Update README.md	2026-01-27 00:19:05 +08:00
Fazri Gading	3a1b6039d0	Merge branch 'develop' into patch-1	2026-01-27 00:18:33 +08:00
Fazri Gading	7828454631	Update PKGBUILD-git	2026-01-27 00:15:25 +08:00
Fazri Gading	cc1c6c334c	Update PKGBUILD	2026-01-27 00:14:53 +08:00
TalesAmaral	081ac926e3	Update README.md BUILD.md location was changed and now this link is poiting to nothing	2026-01-26 11:49:39 -03:00
Fazri Gading	75a450c9ec	Update README.md adds information for Arch build	2026-01-26 18:54:53 +08:00
Fazri Gading	e426690632	ci: add fixed-version PKGBUILD for Arch Linux releases this PKGBUILD intended for CI and GitHub release artifacts. targets tagged releases only and uses a fixed pkgver that matches the corresponding git tag. all of the VCS logic has been removed to PKGBUILD-git to ensure reproducible builds and stable versioning suitable for binary distribution. the build process relies on electron-builder directory output (--dir) and packages only the unpacked application into a standard Arch Linux package (.pkg.tar.zst). other distro format are excluded from this path and handled separately. this change establishes a clear separation between: - rolling AUR development builds (-git) - CI-generated, versioned Arch Linux release packages the result is predictable artifact naming, correct version alignment, and Arch-compliant packaging for downstream users.	2026-01-26 18:33:07 +08:00
Fazri Gading	78f76afe0a	aur: add proper VCS (-git) PKGBUILD created clean VCS-based PKGBUILD following arch packaging conventions. this explicitly marked as a rolling (-git) build and derives its version dynamically from git tags and commit history via pkgver(). previous hybrid approach has been changed. key changes: - use -git suffix to clearly indicate rolling source builds - set pkgver=0 and compute the actual version via pkgver() - build only a directory layout using electron-builder (--dir) - avoid generating AppImage, deb, rpm, or pacman installers - align build and package steps with Arch packaging guidelines note: this PKGBUILD is intended for development and AUR use only and is not suitable for binary redistribution or release artifacts.	2026-01-26 18:20:37 +08:00
Fazri Gading	131de1dcd7	fix: removes pacman build as it replaced by tar.zst and adds build:arch shortcut for pkgbuild	2026-01-26 17:56:44 +08:00
Fazri Gading	b39877f561	fix: release workflow for build-arch and build-linux * build-arch job now only build arch .pkg.tar.zst package instead of the whole generic linux. * build-linux job now exclude .pacman package since its deprecated and should not be used.	2026-01-26 17:46:40 +08:00
Fazri Gading	6f10b1390d	Release v2.1.1: fix EPERM error and add ArchLinux package (.tar.zst) (#185 ) * fix: resolve cross-platform EPERM permissions errors modManager.js: - Switch from hardcoded 'junction' to dynamic symlink type based on OS (fixing Linux EPERM). - Add retry logic for directory removal to handle file locking race conditions. - Improve broken symlink detection during profile sync. gameManager.js: - Implement retry loop (3 attempts) for game directory removal in updateGameFiles to prevent EBUSY/EPERM errors on Windows. paths.js: - Prevent fs.mkdirSync failure in getModsPath by pre-checking for broken symbolic links. * fix: missing pacman builds * prepare release for 2.1.1 minor fix for EPERM error permission * prepare release 2.1.1 minor fix EPERM permission error * prepare release 2.1.1 * Update README.md Windows Prequisites for ARM64 builds * fix: remove broken symlink after detected * fix: add pathexists for paths.js to check symlink * fix: isbrokenlink should be true to remove the symlink * add arch package .pkg.tar.zst for release	2026-01-26 14:14:26 +08:00
Fazri Gading	0b1b448cce	Merge branch 'main' into develop	2026-01-26 13:56:33 +08:00
Fazri Gading	aed00cd067	add arch package .pkg.tar.zst for release	2026-01-26 13:52:18 +08:00
Fazri Gading	c4a32ce1e0	Release v2.1.1: Fix EPERM cross-platform error (#183 ) * fix: resolve cross-platform EPERM permissions errors modManager.js: - Switch from hardcoded 'junction' to dynamic symlink type based on OS (fixing Linux EPERM). - Add retry logic for directory removal to handle file locking race conditions. - Improve broken symlink detection during profile sync. gameManager.js: - Implement retry loop (3 attempts) for game directory removal in updateGameFiles to prevent EBUSY/EPERM errors on Windows. paths.js: - Prevent fs.mkdirSync failure in getModsPath by pre-checking for broken symbolic links. * fix: missing pacman builds * prepare release for 2.1.1 minor fix for EPERM error permission * Update README.md Windows Prequisites for ARM64 builds * fix: remove broken symlink after detected * fix: add pathexists for paths.js to check symlink * fix: isbrokenlink should be true to remove the symlink	2026-01-26 12:29:14 +08:00
Fazri Gading	eff6fcd520	fix: isbrokenlink should be true to remove the symlink	2026-01-26 12:24:24 +08:00
Fazri Gading	94d4586b97	fix: add pathexists for paths.js to check symlink	2026-01-26 12:09:48 +08:00
Fazri Gading	20faf36b37	fix: remove broken symlink after detected	2026-01-26 12:01:46 +08:00
Fazri Gading	375b422c73	Update README.md Windows Prequisites for ARM64 builds	2026-01-26 11:33:00 +08:00
Fazri Gading	b668bdb45a	prepare release 2.1.1	2026-01-26 09:48:26 +08:00
Fazri Gading	653d4429ed	prepare release 2.1.1 minor fix EPERM permission error	2026-01-26 09:36:03 +08:00
Fazri Gading	17e15c17f0	prepare release for 2.1.1 minor fix for EPERM error permission	2026-01-26 09:34:16 +08:00
Fazri Gading	b99b22e8bf	fix: missing pacman builds	2026-01-26 09:23:15 +08:00
Fazri Gading	9303c17e57	Merge branch 'develop' of https://github.com/amiayweb/Hytale-F2P into develop	2026-01-26 08:20:55 +08:00
Fazri Gading	615ee5cadc	fix: resolve cross-platform EPERM permissions errors modManager.js: - Switch from hardcoded 'junction' to dynamic symlink type based on OS (fixing Linux EPERM). - Add retry logic for directory removal to handle file locking race conditions. - Improve broken symlink detection during profile sync. gameManager.js: - Implement retry loop (3 attempts) for game directory removal in updateGameFiles to prevent EBUSY/EPERM errors on Windows. paths.js: - Prevent fs.mkdirSync failure in getModsPath by pre-checking for broken symbolic links.	2026-01-26 08:19:13 +08:00