chore: bump version to 0.8.0

refactor: extract asar from electron-builder output instead of custom script
chore: bump version to 0.7.9
2026-04-16 10:30:56 -07:00 · 2026-04-16 10:30:44 -07:00 · 2026-04-16 10:21:26 -07:00 · 2026-04-16 10:21:14 -07:00 · 2026-04-16 09:38:00 -07:00 · 2026-04-16 09:38:00 -07:00
11 changed files with 1158 additions and 627 deletions
@@ -4,6 +4,17 @@ on:
  push:
    branches:
      - main
+  workflow_dispatch:
+    inputs:
+      release_type:
+        description: 'Override release type (auto-detected by default)'
+        required: false
+        default: 'auto'
+        type: choice
+        options:
+          - auto
+          - patch
+          - full

 permissions:
  contents: write
@@ -14,18 +25,24 @@ jobs:
    steps:
      - name: Checkout
        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0

      - name: Check if version already released
        id: version-check
        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITEA_TOKEN: ${{ secrets.DEST_GITEA_TOKEN }}
        run: |
          VERSION=$(grep '"version"' package.json | head -1 | sed 's/.*"version": *"\([^"]*\)".*/\1/')
          TAG="v$VERSION"
          echo "VERSION=$VERSION" >> "$GITHUB_OUTPUT"
          echo "TAG=$TAG" >> "$GITHUB_OUTPUT"

-          if gh release view "$TAG" --repo "$GITHUB_REPOSITORY" >/dev/null 2>&1; then
+          STATUS=$(curl -s -o /dev/null -w "%{http_code}" \
+            "https://gitea.crjlab.net/api/v1/repos/bigjakk/Krunker-Civilian-Client-Test/releases/tags/$TAG" \
+            -H "Authorization: token $GITEA_TOKEN")
+
+          if [ "$STATUS" = "200" ]; then
            echo "Release $TAG already exists, skipping build"
            echo "SKIP=true" >> "$GITHUB_OUTPUT"
          else
@@ -33,6 +50,55 @@ jobs:
            echo "SKIP=false" >> "$GITHUB_OUTPUT"
          fi

+      - name: Detect release type
+        if: steps.version-check.outputs.SKIP == 'false'
+        id: release-type
+        run: |
+          OVERRIDE="${{ github.event.inputs.release_type || 'auto' }}"
+
+          if [ "$OVERRIDE" != "auto" ]; then
+            echo "Release type overridden to: $OVERRIDE"
+            echo "TYPE=$OVERRIDE" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          # Auto-detect: find what changed since the last release tag
+          PREV_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || true)
+
+          if [ -z "$PREV_TAG" ]; then
+            echo "No previous tag found — defaulting to full build"
+            echo "TYPE=full" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          echo "Comparing changes since $PREV_TAG"
+          CHANGED=$(git diff --name-only "$PREV_TAG"..HEAD)
+          echo "$CHANGED"
+
+          # Files that require a full (installer-only) release
+          FULL_TRIGGERS="electron-builder.yml|scripts/download-electron.js"
+
+          if echo "$CHANGED" | grep -qE "^($FULL_TRIGGERS)$"; then
+            echo "Full build trigger detected in changed files"
+            echo "TYPE=full" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          # Check if package.json deps changed (not just version field)
+          if echo "$CHANGED" | grep -q "^package.json$"; then
+            DEP_DIFF=$(git diff "$PREV_TAG"..HEAD -- package.json \
+              | grep -E '^\+' | grep -vE '^\+\+\+' \
+              | grep -E '"(dependencies|devDependencies|electron|electron-nightly)"' || true)
+            if [ -n "$DEP_DIFF" ]; then
+              echo "Dependency changes detected in package.json"
+              echo "TYPE=full" >> "$GITHUB_OUTPUT"
+              exit 0
+            fi
+          fi
+
+          echo "Only source changes detected — patch release"
+          echo "TYPE=patch" >> "$GITHUB_OUTPUT"
+
      - name: Setup Node.js
        if: steps.version-check.outputs.SKIP == 'false'
        uses: actions/setup-node@v4
@@ -42,9 +108,9 @@ jobs:
      - name: Install system dependencies
        if: steps.version-check.outputs.SKIP == 'false'
        run: |
-          sudo dpkg --add-architecture i386
-          sudo apt-get update -qq
-          sudo apt-get install -y --no-install-recommends \
+          dpkg --add-architecture i386
+          apt-get update -qq
+          apt-get install -y --no-install-recommends \
            wine wine32 wine64 \
            libnss3 libatk1.0-0 libatk-bridge2.0-0 libcups2t64 \
            libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 \
@@ -70,46 +136,133 @@ jobs:
        if: steps.version-check.outputs.SKIP == 'false'
        run: npx electron-builder --linux -c.electronDist=node_modules/electron/dist-linux --publish never

+      - name: Extract asar for patch updates
+        if: steps.version-check.outputs.SKIP == 'false' && steps.release-type.outputs.TYPE == 'patch'
+        run: |
+          # The asar is a byproduct of the Linux build — platform-independent (just JS)
+          ASAR_SRC="out/linux-unpacked/resources/app.asar"
+          ASAR_DIR="out/asar"
+          mkdir -p "$ASAR_DIR"
+          cp "$ASAR_SRC" "$ASAR_DIR/app.asar"
+          sha256sum "$ASAR_DIR/app.asar" | awk '{print $1 "  app.asar"}' > "$ASAR_DIR/checksums.sha256"
+          echo "Extracted asar: $(du -h "$ASAR_DIR/app.asar" | cut -f1)"
+          cat "$ASAR_DIR/checksums.sha256"
+
      - name: Report build sizes
        if: steps.version-check.outputs.SKIP == 'false'
        run: |
-          echo "=== Build output sizes ==="
+          echo "=== Release type: ${{ steps.release-type.outputs.TYPE }} ==="
          ls -lh out/*.exe out/*.AppImage out/*.deb 2>/dev/null || true
+          ls -lh out/asar/* 2>/dev/null || true

      - name: Generate release notes
        if: steps.version-check.outputs.SKIP == 'false'
+        env:
+          GITEA_TOKEN: ${{ secrets.DEST_GITEA_TOKEN }}
        run: |
-          git fetch --unshallow 2>/dev/null || true
          chmod +x scripts/generate-release-notes.sh
-          scripts/generate-release-notes.sh "${{ steps.version-check.outputs.TAG }}" > /tmp/release-notes.md
+
+          PREV_SHA=$(curl -s "https://gitea.crjlab.net/api/v1/repos/bigjakk/Krunker-Civilian-Client-Test/releases?limit=1" \
+            -H "Authorization: token $GITEA_TOKEN" \
+            | jq -r '.[0].target_commitish // empty' 2>/dev/null || true)
+
+          echo "Previous release SHA: ${PREV_SHA:-none}"
+          scripts/generate-release-notes.sh "${{ steps.version-check.outputs.TAG }}" "$PREV_SHA" > /tmp/release-notes.md
          echo "--- Generated release notes ---"
          cat /tmp/release-notes.md

-      - name: Create GitHub release and upload assets
+      - name: Create release and upload assets
        if: steps.version-check.outputs.SKIP == 'false'
        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITEA_TOKEN: ${{ secrets.DEST_GITEA_TOKEN }}
+          TAG: ${{ steps.version-check.outputs.TAG }}
+          RELEASE_TYPE: ${{ steps.release-type.outputs.TYPE }}
        run: |
-          # Collect built artifacts
-          ASSETS=()
-          for file in out/*.exe out/*.AppImage out/*.deb; do
-            [ -f "$file" ] || continue
-            ASSETS+=("$file")
-          done
+          GITEA_BASE="https://gitea.crjlab.net"
+          REPO="bigjakk/Krunker-Civilian-Client-Test"

-          if [ ${#ASSETS[@]} -eq 0 ]; then
-            echo "ERROR: No build artifacts found in out/"
-            ls -la out/ 2>/dev/null || echo "out/ directory does not exist"
+          # Create tag
+          curl -s -X POST "$GITEA_BASE/api/v1/repos/$REPO/tags" \
+            -H "Authorization: token $GITEA_TOKEN" \
+            -H "Content-Type: application/json" \
+            -d "{\"tag_name\": \"$TAG\", \"message\": \"$TAG\", \"target\": \"$GITHUB_SHA\"}"
+
+          # Read release notes
+          NOTES=$(cat /tmp/release-notes.md)
+          BODY=$(echo "$NOTES" | python3 -c 'import sys,json; print(json.dumps(sys.stdin.read()))')
+
+          # Create release
+          RESPONSE=$(curl -s -X POST "$GITEA_BASE/api/v1/repos/$REPO/releases" \
+            -H "Authorization: token $GITEA_TOKEN" \
+            -H "Content-Type: application/json" \
+            -d "{
+              \"tag_name\": \"$TAG\",
+              \"name\": \"$TAG\",
+              \"body\": $BODY,
+              \"draft\": false,
+              \"prerelease\": false
+            }")
+
+          RELEASE_ID=$(echo "$RESPONSE" | jq -r '.id')
+          echo "Created release ID: $RELEASE_ID"
+
+          if [ "$RELEASE_ID" = "null" ] || [ -z "$RELEASE_ID" ]; then
+            echo "Failed to create release:"
+            echo "$RESPONSE"
            exit 1
          fi

-          echo "Uploading ${#ASSETS[@]} assets:"
-          printf '  %s\n' "${ASSETS[@]}"
+          # Upload asar + checksums (patch releases only — signals client to use fast path)
+          if [ "$RELEASE_TYPE" = "patch" ]; then
+            for file in out/asar/app.asar out/asar/checksums.sha256; do
+              [ -f "$file" ] || continue
+              FILENAME=$(basename "$file")
+              echo "Uploading: $FILENAME ($(du -h "$file" | cut -f1))"
+              curl -s -X POST \
+                "$GITEA_BASE/api/v1/repos/$REPO/releases/$RELEASE_ID/assets?name=$FILENAME" \
+                -H "Authorization: token $GITEA_TOKEN" \
+                -F "attachment=@$file" \
+                | jq -r '"  -> \(.name) (\(.size) bytes)"'
+            done
+          else
+            echo "Full release — skipping asar upload (forces installer update)"
+          fi

-          gh release create "${{ steps.version-check.outputs.TAG }}" \
-            --repo "$GITHUB_REPOSITORY" \
-            --title "${{ steps.version-check.outputs.TAG }}" \
-            --notes-file /tmp/release-notes.md \
-            --draft=false \
-            --latest \
-            "${ASSETS[@]}"
+          # Upload installers (always — for new users and major updates)
+          for file in out/*.exe out/*.AppImage out/*.deb; do
+            [ -f "$file" ] || continue
+            FILENAME=$(basename "$file")
+            SAFE_NAME=$(echo "$FILENAME" | tr ' ' '_')
+            echo "Uploading: $SAFE_NAME ($(du -h "$file" | cut -f1))"
+            curl -s -X POST \
+              "$GITEA_BASE/api/v1/repos/$REPO/releases/$RELEASE_ID/assets?name=$SAFE_NAME" \
+              -H "Authorization: token $GITEA_TOKEN" \
+              -F "attachment=@$file" \
+              | jq -r '"  -> \(.name) (\(.size) bytes)"'
+          done
+
+          echo "All assets uploaded"
+
+      - name: Prune old releases
+        if: steps.version-check.outputs.SKIP == 'false'
+        env:
+          GITEA_TOKEN: ${{ secrets.DEST_GITEA_TOKEN }}
+          KEEP: 5
+        run: |
+          GITEA_BASE="https://gitea.crjlab.net"
+          REPO="bigjakk/Krunker-Civilian-Client-Test"
+          echo "=== Pruning $REPO (keeping last $KEEP) ==="
+          RELEASES=$(curl -s "$GITEA_BASE/api/v1/repos/$REPO/releases?limit=50" \
+            -H "Authorization: token $GITEA_TOKEN")
+
+          DELETE_IDS=$(echo "$RELEASES" | jq -r "sort_by(.created_at) | reverse | .[$KEEP:][] | .id")
+
+          for ID in $DELETE_IDS; do
+            TAG_NAME=$(echo "$RELEASES" | jq -r ".[] | select(.id == $ID) | .tag_name")
+            echo "Deleting release $TAG_NAME (id=$ID)"
+            curl -s -X DELETE "$GITEA_BASE/api/v1/repos/$REPO/releases/$ID" \
+              -H "Authorization: token $GITEA_TOKEN"
+            curl -s -X DELETE "$GITEA_BASE/api/v1/repos/$REPO/tags/$TAG_NAME" \
+              -H "Authorization: token $GITEA_TOKEN"
+          done
+          echo "Prune complete"
@@ -1,12 +1,12 @@
 {
  "name": "krunker-civilian-client",
-  "version": "0.7.1",
+  "version": "0.7.9",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "krunker-civilian-client",
-      "version": "0.7.1",
+      "version": "0.7.9",
      "hasInstallScript": true,
      "license": "GPL-3.0",
      "dependencies": {
@@ -44,37 +44,6 @@
        "url": "https://opencollective.com/webpack"
      }
    },
-    "node_modules/@electron/asar": {
-      "version": "3.4.1",
-      "resolved": "https://registry.npmjs.org/@electron/asar/-/asar-3.4.1.tgz",
-      "integrity": "sha512-i4/rNPRS84t0vSRa2HorerGRXWyF4vThfHesw0dmcWHp+cspK743UanA0suA5Q5y8kzY2y6YKrvbIUn69BCAiA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "commander": "^5.0.0",
-        "glob": "^7.1.6",
-        "minimatch": "^3.0.4"
-      },
-      "bin": {
-        "asar": "bin/asar.js"
-      },
-      "engines": {
-        "node": ">=10.12.0"
-      }
-    },
-    "node_modules/@electron/asar/node_modules/minimatch": {
-      "version": "3.1.5",
-      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz",
-      "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==",
-      "dev": true,
-      "license": "ISC",
-      "dependencies": {
-        "brace-expansion": "^1.1.7"
-      },
-      "engines": {
-        "node": "*"
-      }
-    },
    "node_modules/@electron/fuses": {
      "version": "1.8.0",
      "resolved": "https://registry.npmjs.org/@electron/fuses/-/fuses-1.8.0.tgz",
@@ -338,6 +307,48 @@
        "node": ">=16.4"
      }
    },
+    "node_modules/@electron/universal/node_modules/@electron/asar": {
+      "version": "3.4.1",
+      "resolved": "https://registry.npmjs.org/@electron/asar/-/asar-3.4.1.tgz",
+      "integrity": "sha512-i4/rNPRS84t0vSRa2HorerGRXWyF4vThfHesw0dmcWHp+cspK743UanA0suA5Q5y8kzY2y6YKrvbIUn69BCAiA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "commander": "^5.0.0",
+        "glob": "^7.1.6",
+        "minimatch": "^3.0.4"
+      },
+      "bin": {
+        "asar": "bin/asar.js"
+      },
+      "engines": {
+        "node": ">=10.12.0"
+      }
+    },
+    "node_modules/@electron/universal/node_modules/@electron/asar/node_modules/brace-expansion": {
+      "version": "1.1.14",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.14.tgz",
+      "integrity": "sha512-MWPGfDxnyzKU7rNOW9SP/c50vi3xrmrua/+6hfPbCS2ABNWfx24vPidzvC7krjU/RTo235sV776ymlsMtGKj8g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "node_modules/@electron/universal/node_modules/@electron/asar/node_modules/minimatch": {
+      "version": "3.1.5",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz",
+      "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
    "node_modules/@electron/universal/node_modules/brace-expansion": {
      "version": "2.0.3",
      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.3.tgz",
@@ -348,6 +359,16 @@
        "balanced-match": "^1.0.0"
      }
    },
+    "node_modules/@electron/universal/node_modules/commander": {
+      "version": "5.1.0",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-5.1.0.tgz",
+      "integrity": "sha512-P0CysNDQ7rtVw4QIQtm+MRxV66vKFSvlsQvGYXZWR3qFU0jlMKHZZZgw8e+8DSah4UDKMqnknRDQz+xuQXQ/Zg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 6"
+      }
+    },
    "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",
@@ -2359,6 +2380,37 @@
        "electron-builder-squirrel-windows": "26.8.1"
      }
    },
+    "node_modules/app-builder-lib/node_modules/@electron/asar": {
+      "version": "3.4.1",
+      "resolved": "https://registry.npmjs.org/@electron/asar/-/asar-3.4.1.tgz",
+      "integrity": "sha512-i4/rNPRS84t0vSRa2HorerGRXWyF4vThfHesw0dmcWHp+cspK743UanA0suA5Q5y8kzY2y6YKrvbIUn69BCAiA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "commander": "^5.0.0",
+        "glob": "^7.1.6",
+        "minimatch": "^3.0.4"
+      },
+      "bin": {
+        "asar": "bin/asar.js"
+      },
+      "engines": {
+        "node": ">=10.12.0"
+      }
+    },
+    "node_modules/app-builder-lib/node_modules/@electron/asar/node_modules/minimatch": {
+      "version": "3.1.5",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz",
+      "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
    "node_modules/app-builder-lib/node_modules/@electron/get": {
      "version": "3.1.0",
      "resolved": "https://registry.npmjs.org/@electron/get/-/get-3.1.0.tgz",
@@ -2422,6 +2474,16 @@
        "node": ">=8"
      }
    },
+    "node_modules/app-builder-lib/node_modules/commander": {
+      "version": "5.1.0",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-5.1.0.tgz",
+      "integrity": "sha512-P0CysNDQ7rtVw4QIQtm+MRxV66vKFSvlsQvGYXZWR3qFU0jlMKHZZZgw8e+8DSah4UDKMqnknRDQz+xuQXQ/Zg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 6"
+      }
+    },
    "node_modules/app-builder-lib/node_modules/fs-extra": {
      "version": "10.1.0",
      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-10.1.0.tgz",
@@ -3031,16 +3093,6 @@
        "node": ">= 0.8"
      }
    },
-    "node_modules/commander": {
-      "version": "5.1.0",
-      "resolved": "https://registry.npmjs.org/commander/-/commander-5.1.0.tgz",
-      "integrity": "sha512-P0CysNDQ7rtVw4QIQtm+MRxV66vKFSvlsQvGYXZWR3qFU0jlMKHZZZgw8e+8DSah4UDKMqnknRDQz+xuQXQ/Zg==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">= 6"
-      }
-    },
    "node_modules/compare-version": {
      "version": "0.1.2",
      "resolved": "https://registry.npmjs.org/compare-version/-/compare-version-0.1.2.tgz",
@@ -3715,6 +3767,36 @@
        "@electron/windows-sign": "^1.1.2"
      }
    },
+    "node_modules/electron-winstaller/node_modules/@electron/asar": {
+      "version": "3.4.1",
+      "resolved": "https://registry.npmjs.org/@electron/asar/-/asar-3.4.1.tgz",
+      "integrity": "sha512-i4/rNPRS84t0vSRa2HorerGRXWyF4vThfHesw0dmcWHp+cspK743UanA0suA5Q5y8kzY2y6YKrvbIUn69BCAiA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "commander": "^5.0.0",
+        "glob": "^7.1.6",
+        "minimatch": "^3.0.4"
+      },
+      "bin": {
+        "asar": "bin/asar.js"
+      },
+      "engines": {
+        "node": ">=10.12.0"
+      }
+    },
+    "node_modules/electron-winstaller/node_modules/commander": {
+      "version": "5.1.0",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-5.1.0.tgz",
+      "integrity": "sha512-P0CysNDQ7rtVw4QIQtm+MRxV66vKFSvlsQvGYXZWR3qFU0jlMKHZZZgw8e+8DSah4UDKMqnknRDQz+xuQXQ/Zg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 6"
+      }
+    },
    "node_modules/electron-winstaller/node_modules/fs-extra": {
      "version": "7.0.1",
      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-7.0.1.tgz",
@@ -3731,6 +3813,20 @@
        "node": ">=6 <7 || >=8"
      }
    },
+    "node_modules/electron-winstaller/node_modules/minimatch": {
+      "version": "3.1.5",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz",
+      "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
    "node_modules/electron/node_modules/@types/node": {
      "version": "24.11.0",
      "resolved": "https://registry.npmjs.org/@types/node/-/node-24.11.0.tgz",
@@ -1,6 +1,6 @@
 {
  "name": "krunker-civilian-client",
-  "version": "0.7.4",
+  "version": "0.8.0",
  "description": "Cross-platform Krunker game client",
  "main": "dist/main/index.js",
  "homepage": "https://github.com/bigjakk/Krunker-Civilian-Client",
@@ -54,7 +54,7 @@ export interface AppConfig {
    maxPlayers: number;
    minRemainingTime: number;
    openServerBrowser: boolean;
-    autoJoin: boolean;
+    sortByPlayers: boolean;
  };
  keybinds: {
    reload: Keybind;
@@ -63,7 +63,6 @@ export interface AppConfig {
    joinFromClipboard: Keybind;
    devTools: Keybind;
    matchmaker: Keybind;
-    matchmakerAccept: Keybind;
    matchmakerCancel: Keybind;
    fullscreenToggle: Keybind;
  };
@@ -119,7 +118,6 @@ export const DEFAULT_KEYBINDS: AppConfig['keybinds'] = {
  joinFromClipboard: { key: 'j',      ctrl: true,  shift: false, alt: false },
  devTools:          { key: 'F12',    ctrl: false, shift: false, alt: false },
  matchmaker:        { key: 'F6',     ctrl: false, shift: false, alt: false },
-  matchmakerAccept:  { key: 'Enter',  ctrl: false, shift: false, alt: false },
  matchmakerCancel:  { key: 'Escape', ctrl: false, shift: false, alt: false },
  fullscreenToggle:  { key: 'F11',    ctrl: false, shift: false, alt: false },
 };
@@ -156,7 +154,7 @@ export const config = new Store<AppConfig>({
      hpEnemyCounter: true,
    },
    swapper: {
-      enabled: true,
+      enabled: false,
      path: '',
    },
    matchmaker: {
@@ -168,11 +166,11 @@ export const config = new Store<AppConfig>({
      maxPlayers: 6,
      minRemainingTime: 120,
      openServerBrowser: true,
-      autoJoin: false,
+      sortByPlayers: false,
    },
    keybinds: DEFAULT_KEYBINDS,
    userscripts: {
-      enabled: true,
+      enabled: false,
      path: '',
    },
    ui: {
@@ -188,7 +186,7 @@ export const config = new Store<AppConfig>({
      lastSeenVersion: '',
    },
    discord: {
-      enabled: false,
+      enabled: true,
    },
    translator: {
      enabled: true,
@@ -1,6 +1,7 @@
 import { app, BrowserWindow, Menu, clipboard, ipcMain, safeStorage, session, shell } from 'electron';
-import { join } from 'path';
+import { join, dirname } from 'path';
 import { existsSync, mkdirSync, promises as fsp } from 'fs';
+import { existsSync as origExistsSync, unlinkSync as origUnlinkSync } from 'original-fs';
 import { get as httpsGet } from 'https';
 import { execFile } from 'child_process';
 import * as os from 'os';
@@ -10,7 +11,7 @@ import { initSwapperProtocol, registerSwapperFileProtocol, ResourceSwapper } fro
 import { UserscriptManager } from './userscripts';
 import { ALL_CLIENT_CSS } from './client-ui';
 import { electronLog, getLogPath, closeLogStreams } from './logger';
-import { checkForUpdate, downloadUpdate, installUpdate } from './updater';
+import { checkForUpdate, downloadUpdate, installUpdate, applyMinorUpdate } from './updater';
 import { showUpdateWindow } from './update-window';
 import { DiscordRPC } from './discord-rpc';
 import { listThemes, getThemeCSS, listLoadingThemes, getLoadingScreenCSS } from './css-themes';
@@ -164,51 +165,93 @@ function saveWindowState(win: BrowserWindow): void {

 app.whenReady().then(async () => {
  electronLog.log('[KCC] App ready');
+  electronLog.log('[KCC] Minor update test — asar swap successful');

-  // ── Auto-update check (mandatory, Windows NSIS install only) ──
+  // ── Auto-update check (2-stage: minor asar swap or major installer) ──
  const isPortable = !!process.env.PORTABLE_EXECUTABLE_DIR;
  const isAppImage = !!process.env.APPIMAGE;
  const isDev = !app.isPackaged;
-  if (isDev || process.platform !== 'win32' || isPortable || isAppImage) {
-    electronLog.log('[KCC] Skipping auto-update (portable or non-Windows)');
+  const canMajorUpdate = process.platform === 'win32' && !isPortable;
+  const canMinorUpdate = !isPortable && !isAppImage;
+
+  if (isDev || (!canMajorUpdate && !canMinorUpdate)) {
+    electronLog.log('[KCC] Skipping auto-update');
  } else {
+    // Clean up stale pending asar from a previous failed swap
+    const resourcesDir = join(dirname(app.getPath('exe')), 'resources');
+    const stalePending = join(resourcesDir, 'app-pending.asar');
+    if (origExistsSync(stalePending)) {
+      try { origUnlinkSync(stalePending); } catch { /* ignore */ }
+    }
+
    try {
      electronLog.log('[KCC] Checking for updates...');
      const update = await checkForUpdate(appVersion);
      if (update) {
-        electronLog.log(`[KCC] Update available: v${update.version}`);
+        electronLog.log(`[KCC] Update available: v${update.version} (${update.updateType})`);
        const { window: updateWin, sendProgress } = showUpdateWindow();
-        sendProgress(`Update available (v${update.version})`, 0);

-      const tempDir = join(app.getPath('temp'), 'kcc-update');
-      if (!existsSync(tempDir)) mkdirSync(tempDir, { recursive: true });
-      const installerPath = join(tempDir, `KCC-${update.version}-Setup.exe`);
+        let cancelled = false;
+        updateWin.on('closed', () => { cancelled = true; });

-      let cancelled = false;
-      updateWin.on('closed', () => { cancelled = true; });
+        if (update.updateType === 'minor' && canMinorUpdate) {
+          // Minor update: download app.asar, swap via external script, restart
+          sendProgress(`Patch available (v${update.version})`, 0);
+          const pendingPath = join(resourcesDir, 'app-pending.asar');

-      try {
-        await downloadUpdate(update.downloadUrl, installerPath, (pct) => {
-          if (!cancelled && !updateWin.isDestroyed()) {
-            sendProgress(`Downloading update... ${pct}%`, pct);
+          try {
+            await downloadUpdate(update.downloadUrl, pendingPath, (pct) => {
+              if (!cancelled && !updateWin.isDestroyed()) {
+                sendProgress(`Downloading patch... ${pct}%`, pct);
+              }
+            }, update.sha256 || undefined);
+
+            if (!cancelled) {
+              sendProgress('Applying patch...', 100);
+              applyMinorUpdate(pendingPath);
+              return;
+            }
+          } catch (err) {
+            electronLog.error('[KCC] Patch download failed:', err);
+            // Clean up failed download
+            if (origExistsSync(pendingPath)) {
+              try { origUnlinkSync(pendingPath); } catch { /* ignore */ }
+            }
+            if (!updateWin.isDestroyed()) updateWin.close();
          }
-        }, update.sha256);
+        } else if (update.updateType === 'major' && canMajorUpdate) {
+          // Major update: download Setup.exe, run installer
+          sendProgress(`Update available (v${update.version})`, 0);
+          const tempDir = join(app.getPath('temp'), 'kcc-update');
+          if (!existsSync(tempDir)) mkdirSync(tempDir, { recursive: true });
+          const installerPath = join(tempDir, `KCC-${update.version}-Setup.exe`);

-        if (!cancelled) {
-          sendProgress('Installing update...', 100);
-          installUpdate(installerPath);
-          return; // app.quit() called by installUpdate
+          try {
+            await downloadUpdate(update.downloadUrl, installerPath, (pct) => {
+              if (!cancelled && !updateWin.isDestroyed()) {
+                sendProgress(`Downloading update... ${pct}%`, pct);
+              }
+            }, update.sha256 || undefined);
+
+            if (!cancelled) {
+              sendProgress('Installing update...', 100);
+              installUpdate(installerPath);
+              return;
+            }
+          } catch (err) {
+            electronLog.error('[KCC] Update download failed:', err);
+            if (!updateWin.isDestroyed()) updateWin.close();
+          }
+        } else {
+          electronLog.log('[KCC] Update available but cannot auto-install on this platform');
+          if (!updateWin.isDestroyed()) updateWin.close();
        }
-      } catch (err) {
-        electronLog.error('[KCC] Update download failed:', err);
-        if (!updateWin.isDestroyed()) updateWin.close();
+      } else {
+        electronLog.log('[KCC] No updates available');
      }
-    } else {
-      electronLog.log('[KCC] No updates available');
+    } catch (err) {
+      electronLog.error('[KCC] Update check failed:', err);
    }
-  } catch (err) {
-    electronLog.error('[KCC] Update check failed:', err);
-  }
  }

  await launchApp();
@@ -389,7 +432,6 @@ async function launchApp(): Promise<void> {
      if (mm.enabled) {
        win.webContents.send('matchmaker-find', {
          ...mm,
-          acceptKey: binds.matchmakerAccept,
          cancelKey: binds.matchmakerCancel,
        });
      } else {
@@ -411,7 +453,6 @@ async function launchApp(): Promise<void> {
      if (mm.enabled) {
        win.webContents.send('matchmaker-find', {
          ...mm,
-          acceptKey: binds.matchmakerAccept,
          cancelKey: binds.matchmakerCancel,
        });
      } else {
@@ -459,12 +500,13 @@ async function launchApp(): Promise<void> {
  // ── Tab Manager ──
  const preloadPath = join(__dirname, '..', 'preload', 'index.js');
  let tabMode: 'same' | 'new' = getGameConf().socialTabBehaviour === 'Same Window' ? 'same' : 'new';
+  let sessionTabs: string[] = [];
  let tabManager = new TabManager(
    win, ses, preloadPath, tabMode, isGameURL,
    () => config.get('tabWindow'),
    (state) => config.set('tabWindow', state),
-    () => config.get('savedTabs'),
-    (urls) => config.set('savedTabs', urls),
+    () => sessionTabs,
+    (urls) => { sessionTabs = urls; },
    () => config.get('game.rememberTabs') ?? false,
  );

@@ -339,19 +339,39 @@ export class TabManager {
        const tab = this.tabs.find(t => t.id === id);
        if (!tab) return;

-        if (this.activeTabId !== null) {
+        if (this.activeTabId !== null && this.activeTabId !== id) {
            const prev = this.tabs.find(t => t.id === this.activeTabId);
            if (prev) {
                this.containerView.removeChildView(prev.view);
+                this.freezeTab(prev);
            }
        }

        this.activeTabId = id;
+        this.unfreezeTab(tab);
        this.containerView.addChildView(tab.view);
        this.updateLayout();
        this.broadcastTabState();
    }

+    // ── Freeze/unfreeze background tabs via CDP Page Lifecycle ──
+    private freezeTab(tab: TabInfo): void {
+        const wc = tab.view.webContents;
+        if (wc.isDestroyed()) return;
+        this.stopTitleWatcher(tab.id);
+        try { wc.debugger.attach('1.3'); } catch { /* already attached (DevTools open) */ }
+        wc.debugger.sendCommand('Page.setWebLifecycleState', { state: 'frozen' }).catch(() => {});
+    }
+
+    private unfreezeTab(tab: TabInfo): void {
+        const wc = tab.view.webContents;
+        if (wc.isDestroyed()) return;
+        wc.debugger.sendCommand('Page.setWebLifecycleState', { state: 'active' }).catch(() => {}).finally(() => {
+            try { wc.debugger.detach(); } catch { /* not attached */ }
+            if (!wc.isDestroyed()) this.startTitleWatcher(tab.id, wc);
+        });
+    }
+
    // ── Close a tab ──
    closeTab(id: number): void {
        const idx = this.tabs.findIndex(t => t.id === id);
@@ -1,279 +1,489 @@
-import { get as httpsGet } from 'https';
-import { createReadStream, createWriteStream, renameSync, unlinkSync, existsSync } from 'fs';
-import { createHash } from 'crypto';
-import { spawn } from 'child_process';
-import { app } from 'electron';
-import { electronLog } from './logger';
-
-export interface UpdateInfo {
-  version: string;
-  downloadUrl: string;
-  fileSize: number;
-  sha256: string;
-}
-
-export type ProgressCallback = (percent: number) => void;
-
-const UPDATE_CONFIG = {
-  checkUrl: 'https://api.github.com/repos/bigjakk/Krunker-Civilian-Client/releases/latest',
-  assetPattern: /Setup\.exe$/i,
-  allowedHosts: ['github.com', 'githubusercontent.com'],
-};
-
-const CHECK_TIMEOUT_MS = 10000;
-const DOWNLOAD_TIMEOUT_MS = 300000; // 5 minutes
-
-/**
- * Validate that a redirect URL stays on an allowed host.
- */
-function isAllowedRedirect(url: string): boolean {
-  try {
-    const parsed = new URL(url);
-    return UPDATE_CONFIG.allowedHosts.some(h => parsed.hostname === h || parsed.hostname.endsWith('.' + h));
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Simple semver comparison: returns true if a < b.
- * Handles versions like "0.1.0", "1.2.3".
- */
-function versionLessThan(a: string, b: string): boolean {
-  const pa = a.split('.').map(Number);
-  const pb = b.split('.').map(Number);
-  const len = Math.max(pa.length, pb.length);
-  for (let i = 0; i < len; i++) {
-    const na = pa[i] || 0;
-    const nb = pb[i] || 0;
-    if (na < nb) return true;
-    if (na > nb) return false;
-  }
-  return false;
-}
-
-export function checkForUpdate(currentVersion: string): Promise<UpdateInfo | null> {
-  return new Promise((resolve) => {
-    electronLog.log('[KCC-Update] Checking for updates at:', UPDATE_CONFIG.checkUrl);
-    electronLog.log('[KCC-Update] Current version:', currentVersion);
-
-    const req = httpsGet(UPDATE_CONFIG.checkUrl, {
-      headers: { 'User-Agent': 'KrunkerCivilianClient/' + currentVersion },
-    }, (res) => {
-      electronLog.log('[KCC-Update] Check response status:', res.statusCode);
-      // Follow redirects (with domain validation)
-      if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
-        const redirectUrl = res.headers.location;
-        electronLog.log('[KCC-Update] Redirected to:', redirectUrl);
-        if (!isAllowedRedirect(redirectUrl)) {
-          electronLog.error('[KCC-Update] Redirect to untrusted host blocked:', redirectUrl);
-          resolve(null);
-          return;
-        }
-        httpsGet(redirectUrl, {
-          headers: { 'User-Agent': 'KrunkerCivilianClient/' + currentVersion },
-        }, (redirectRes) => {
-          electronLog.log('[KCC-Update] Redirect response status:', redirectRes.statusCode);
-          handleResponse(redirectRes);
-        }).on('error', (err) => {
-          electronLog.error('[KCC-Update] Redirect error:', err);
-          resolve(null);
-        });
-        return;
-      }
-      handleResponse(res);
-    });
-
-    function handleResponse(res: import('http').IncomingMessage): void {
-      if (res.statusCode !== 200) {
-        electronLog.error('[KCC-Update] Check returned status', res.statusCode);
-        resolve(null);
-        return;
-      }
-
-      let data = '';
-      res.on('data', (chunk: string) => { data += chunk; });
-      res.on('end', () => {
-        try {
-          const release = JSON.parse(data);
-          const tagName: string = release.tag_name || '';
-          const remoteVersion = tagName.replace(/^v/i, '');
-          electronLog.log('[KCC-Update] Latest release:', remoteVersion, '| Current:', currentVersion);
-
-          if (!remoteVersion || !versionLessThan(currentVersion, remoteVersion)) {
-            electronLog.log('[KCC-Update] Already up to date');
-            resolve(null);
-            return;
-          }
-
-          const assets: Array<{ name: string; browser_download_url: string; size: number; digest: string }> = release.assets || [];
-          const setupAsset = assets.find((a) => UPDATE_CONFIG.assetPattern.test(a.name));
-          if (!setupAsset) {
-            electronLog.error('[KCC-Update] No Setup.exe asset found in release', remoteVersion);
-            resolve(null);
-            return;
-          }
-
-          // Validate the download URL points to an allowed host
-          if (!isAllowedRedirect(setupAsset.browser_download_url)) {
-            electronLog.error('[KCC-Update] Download URL points to untrusted host:', setupAsset.browser_download_url);
-            resolve(null);
-            return;
-          }
-
-          // Extract SHA-256 digest from GitHub API (format: "sha256:<hex>")
-          const sha256 = (setupAsset.digest || '').replace(/^sha256:/i, '');
-          if (!sha256) {
-            electronLog.error('[KCC-Update] No SHA-256 digest found for asset');
-            resolve(null);
-            return;
-          }
-
-          electronLog.log('[KCC-Update] Update available:', remoteVersion, '| SHA-256:', sha256.substring(0, 16) + '...');
-          resolve({
-            version: remoteVersion,
-            downloadUrl: setupAsset.browser_download_url,
-            fileSize: setupAsset.size,
-            sha256,
-          });
-        } catch (err) {
-          electronLog.error('[KCC-Update] Failed to parse release data:', err);
-          resolve(null);
-        }
-      });
-      res.on('error', (err) => {
-        electronLog.error('[KCC-Update] Response error:', err);
-        resolve(null);
-      });
-    }
-
-    req.setTimeout(CHECK_TIMEOUT_MS, () => {
-      electronLog.error('[KCC-Update] Check timed out after', CHECK_TIMEOUT_MS, 'ms');
-      req.destroy();
-      resolve(null);
-    });
-
-    req.on('error', (err) => {
-      electronLog.error('[KCC-Update] Check error:', err);
-      resolve(null);
-    });
-  });
-}
-
-function verifyChecksum(filePath: string, expectedSha256: string): Promise<boolean> {
-  return new Promise((resolve, reject) => {
-    const hash = createHash('sha256');
-    const stream = createReadStream(filePath);
-    stream.on('data', (chunk) => hash.update(chunk));
-    stream.on('end', () => {
-      const actual = hash.digest('hex');
-      electronLog.log('[KCC-Update] SHA-256 expected:', expectedSha256);
-      electronLog.log('[KCC-Update] SHA-256 actual:  ', actual);
-      resolve(actual === expectedSha256);
-    });
-    stream.on('error', reject);
-  });
-}
-
-export function downloadUpdate(url: string, destPath: string, onProgress: ProgressCallback, expectedSha256?: string): Promise<void> {
-  return new Promise((resolve, reject) => {
-    const tmpPath = destPath + '.tmp';
-
-    function doDownload(downloadUrl: string, redirectCount = 0): void {
-      if (redirectCount > 5) {
-        reject(new Error('Too many redirects'));
-        return;
-      }
-      electronLog.log('[KCC-Update] Downloading from:', downloadUrl);
-      const req = httpsGet(downloadUrl, {
-        headers: { 'User-Agent': 'KrunkerCivilianClient' },
-      }, (res) => {
-        // Follow redirects (with domain validation)
-        if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
-          const redirectUrl = res.headers.location;
-          electronLog.log('[KCC-Update] Download redirected to:', redirectUrl);
-          if (!isAllowedRedirect(redirectUrl)) {
-            electronLog.error('[KCC-Update] Download redirect to untrusted host blocked:', redirectUrl);
-            reject(new Error('Download redirect to untrusted host: ' + redirectUrl));
-            return;
-          }
-          doDownload(redirectUrl, redirectCount + 1);
-          return;
-        }
-
-        if (res.statusCode !== 200) {
-          electronLog.error('[KCC-Update] Download returned status', res.statusCode, 'from:', downloadUrl);
-          reject(new Error('Download returned status ' + res.statusCode));
-          return;
-        }
-
-        const total = parseInt(res.headers['content-length'] || '0', 10);
-        let received = 0;
-
-        const file = createWriteStream(tmpPath);
-        res.on('data', (chunk: Buffer) => {
-          received += chunk.length;
-          if (total > 0) {
-            onProgress(Math.round(100 * received / total));
-          }
-        });
-        res.pipe(file);
-
-        file.on('finish', () => {
-          file.close(async () => {
-            try {
-              if (expectedSha256) {
-                const valid = await verifyChecksum(tmpPath, expectedSha256);
-                if (!valid) {
-                  electronLog.error('[KCC-Update] Checksum mismatch — file may be corrupted or tampered');
-                  try { unlinkSync(tmpPath); } catch { /* ignore */ }
-                  reject(new Error('SHA-256 checksum mismatch'));
-                  return;
-                }
-                electronLog.log('[KCC-Update] Checksum verified');
-              }
-              if (existsSync(destPath)) unlinkSync(destPath);
-              renameSync(tmpPath, destPath);
-              resolve();
-            } catch (err) {
-              reject(err);
-            }
-          });
-        });
-
-        file.on('error', (err) => {
-          try { unlinkSync(tmpPath); } catch { /* ignore */ }
-          reject(err);
-        });
-
-        res.on('error', (err) => {
-          try { unlinkSync(tmpPath); } catch { /* ignore */ }
-          reject(err);
-        });
-      });
-
-      req.setTimeout(DOWNLOAD_TIMEOUT_MS, () => {
-        req.destroy();
-        try { unlinkSync(tmpPath); } catch { /* ignore */ }
-        reject(new Error('Download timed out'));
-      });
-
-      req.on('error', (err) => {
-        try { unlinkSync(tmpPath); } catch { /* ignore */ }
-        reject(err);
-      });
-    }
-
-    doDownload(url);
-  });
-}
-
-export function installUpdate(installerPath: string): void {
-  electronLog.log('[KCC-Update] Launching installer:', installerPath);
-  const child = spawn(installerPath, [], {
-    detached: true,
-    stdio: 'ignore',
-  });
-  child.unref();
-  app.quit();
-}
+import { get as httpsGet } from 'https';
+// Use original-fs to bypass Electron's asar interception — required for
+// writing/renaming .asar files in the resources directory.
+import { createReadStream, createWriteStream, writeFileSync, renameSync, unlinkSync, existsSync, mkdirSync } from 'original-fs';
+import { join, dirname } from 'path';
+import { createHash } from 'crypto';
+import { spawn } from 'child_process';
+import { app } from 'electron';
+import { electronLog } from './logger';
+
+// ── Types ──
+
+export type UpdateType = 'minor' | 'major';
+
+export interface UpdateInfo {
+    version: string;
+    updateType: UpdateType;
+    downloadUrl: string;
+    fileSize: number;
+    sha256: string;
+}
+
+export type ProgressCallback = (percent: number) => void;
+
+// ── Build-time update source (injected by Vite define) ──
+
+declare const __UPDATE_SOURCE__: 'github' | 'gitea';
+
+interface UpdateSourceConfig {
+    checkUrl: string;
+    allowedHosts: string[];
+    checksumSource: 'digest' | 'file';
+}
+
+const UPDATE_SOURCES: Record<string, UpdateSourceConfig> = {
+    github: {
+        checkUrl: 'https://api.github.com/repos/bigjakk/Krunker-Civilian-Client/releases/latest',
+        allowedHosts: ['github.com', 'githubusercontent.com'],
+        checksumSource: 'digest',
+    },
+    gitea: {
+        checkUrl: 'https://gitea.crjlab.net/api/v1/repos/bigjakk/Krunker-Civilian-Client-Test/releases/latest',
+        allowedHosts: ['gitea.crjlab.net'],
+        checksumSource: 'file',
+    },
+};
+
+const sourceKey = typeof __UPDATE_SOURCE__ !== 'undefined' ? __UPDATE_SOURCE__ : 'github';
+const UPDATE_CONFIG = UPDATE_SOURCES[sourceKey] || UPDATE_SOURCES.github;
+
+const ASSET_PATTERNS = {
+    asar: /^app\.asar$/i,
+    setup: /Setup\.exe$/i,
+    checksums: /^checksums\.sha256$/i,
+};
+
+const CHECK_TIMEOUT_MS = 10000;
+const DOWNLOAD_TIMEOUT_MS = 300000; // 5 minutes
+
+// ── Swap scripts (embedded, written to temp at runtime) ──
+
+const SWAP_SCRIPT_PS1 = `param(
+    [int]$ProcessId,
+    [string]$ResourcesDir,
+    [string]$ExePath
+)
+
+try {
+    $proc = Get-Process -Id $ProcessId -ErrorAction SilentlyContinue
+    if ($proc) { $proc.WaitForExit(30000) | Out-Null }
+} catch {}
+
+Start-Sleep -Milliseconds 500
+
+$asar = Join-Path $ResourcesDir "app.asar"
+$pending = Join-Path $ResourcesDir "app-pending.asar"
+$backup = Join-Path $ResourcesDir "app-backup.asar"
+
+if (-not (Test-Path $pending)) { exit 1 }
+
+try {
+    if (Test-Path $backup) { Remove-Item $backup -Force }
+    Move-Item $asar $backup -Force
+    Move-Item $pending $asar -Force
+    if (Test-Path $backup) { Remove-Item $backup -Force }
+} catch {
+    if ((Test-Path $backup) -and -not (Test-Path $asar)) {
+        Move-Item $backup $asar -Force
+    }
+    exit 1
+}
+
+Start-Process $ExePath
+`;
+
+const SWAP_SCRIPT_BASH = `#!/bin/bash
+PID="$1"
+RESOURCES_DIR="$2"
+EXE_PATH="$3"
+
+while kill -0 "$PID" 2>/dev/null; do sleep 0.2; done
+sleep 0.5
+
+ASAR="$RESOURCES_DIR/app.asar"
+PENDING="$RESOURCES_DIR/app-pending.asar"
+BACKUP="$RESOURCES_DIR/app-backup.asar"
+
+[ -f "$PENDING" ] || exit 1
+
+rm -f "$BACKUP"
+mv "$ASAR" "$BACKUP" && mv "$PENDING" "$ASAR" && rm -f "$BACKUP" || {
+    [ -f "$BACKUP" ] && [ ! -f "$ASAR" ] && mv "$BACKUP" "$ASAR"
+    exit 1
+}
+
+"$EXE_PATH" &
+`;
+
+// ── Helpers ──
+
+function isAllowedRedirect(url: string): boolean {
+    try {
+        const parsed = new URL(url);
+        return UPDATE_CONFIG.allowedHosts.some(h => parsed.hostname === h || parsed.hostname.endsWith('.' + h));
+    } catch {
+        return false;
+    }
+}
+
+function versionLessThan(a: string, b: string): boolean {
+    const pa = a.split('.').map(Number);
+    const pb = b.split('.').map(Number);
+    const len = Math.max(pa.length, pb.length);
+    for (let i = 0; i < len; i++) {
+        const na = pa[i] || 0;
+        const nb = pb[i] || 0;
+        if (na < nb) return true;
+        if (na > nb) return false;
+    }
+    return false;
+}
+
+function simpleGet(url: string): Promise<string> {
+    return new Promise((resolve, reject) => {
+        function doGet(getUrl: string, redirectCount = 0): void {
+            if (redirectCount > 5) {
+                reject(new Error('Too many redirects'));
+                return;
+            }
+            const req = httpsGet(getUrl, {
+                headers: { 'User-Agent': 'KrunkerCivilianClient' },
+            }, (res) => {
+                if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+                    if (!isAllowedRedirect(res.headers.location)) {
+                        reject(new Error('Redirect to untrusted host: ' + res.headers.location));
+                        return;
+                    }
+                    doGet(res.headers.location, redirectCount + 1);
+                    return;
+                }
+                if (res.statusCode !== 200) {
+                    reject(new Error('HTTP ' + res.statusCode));
+                    return;
+                }
+                let data = '';
+                res.on('data', (chunk: string) => { data += chunk; });
+                res.on('end', () => resolve(data));
+                res.on('error', reject);
+            });
+            req.setTimeout(CHECK_TIMEOUT_MS, () => {
+                req.destroy();
+                reject(new Error('Request timed out'));
+            });
+            req.on('error', reject);
+        }
+        doGet(url);
+    });
+}
+
+/**
+ * Fetch and parse a checksums.sha256 file from a release asset URL.
+ * Format: "<sha256>  <filename>" per line.
+ */
+async function fetchChecksums(url: string): Promise<Map<string, string>> {
+    const text = await simpleGet(url);
+    const map = new Map<string, string>();
+    for (const line of text.split('\n')) {
+        const match = line.trim().match(/^([a-f0-9]{64})\s+(.+)$/i);
+        if (match) map.set(match[2].trim(), match[1].toLowerCase());
+    }
+    return map;
+}
+
+// ── Update check ──
+
+interface ReleaseAsset {
+    name: string;
+    browser_download_url: string;
+    size: number;
+    digest?: string;
+}
+
+export function checkForUpdate(currentVersion: string): Promise<UpdateInfo | null> {
+    return new Promise((resolve) => {
+        electronLog.log('[KCC-Update] Checking for updates at:', UPDATE_CONFIG.checkUrl);
+        electronLog.log('[KCC-Update] Current version:', currentVersion);
+
+        const req = httpsGet(UPDATE_CONFIG.checkUrl, {
+            headers: { 'User-Agent': 'KrunkerCivilianClient/' + currentVersion },
+        }, (res) => {
+            electronLog.log('[KCC-Update] Check response status:', res.statusCode);
+            if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+                const redirectUrl = res.headers.location;
+                electronLog.log('[KCC-Update] Redirected to:', redirectUrl);
+                if (!isAllowedRedirect(redirectUrl)) {
+                    electronLog.error('[KCC-Update] Redirect to untrusted host blocked:', redirectUrl);
+                    resolve(null);
+                    return;
+                }
+                httpsGet(redirectUrl, {
+                    headers: { 'User-Agent': 'KrunkerCivilianClient/' + currentVersion },
+                }, (redirectRes) => {
+                    electronLog.log('[KCC-Update] Redirect response status:', redirectRes.statusCode);
+                    handleResponse(redirectRes);
+                }).on('error', (err) => {
+                    electronLog.error('[KCC-Update] Redirect error:', err);
+                    resolve(null);
+                });
+                return;
+            }
+            handleResponse(res);
+        });
+
+        async function handleResponse(res: import('http').IncomingMessage): Promise<void> {
+            if (res.statusCode !== 200) {
+                electronLog.error('[KCC-Update] Check returned status', res.statusCode);
+                resolve(null);
+                return;
+            }
+
+            let data = '';
+            res.on('data', (chunk: string) => { data += chunk; });
+            res.on('end', async () => {
+                try {
+                    const release = JSON.parse(data);
+                    const tagName: string = release.tag_name || '';
+                    const remoteVersion = tagName.replace(/^v/i, '');
+                    electronLog.log('[KCC-Update] Latest release:', remoteVersion, '| Current:', currentVersion);
+
+                    if (!remoteVersion || !versionLessThan(currentVersion, remoteVersion)) {
+                        electronLog.log('[KCC-Update] Already up to date');
+                        resolve(null);
+                        return;
+                    }
+
+                    const assets: ReleaseAsset[] = release.assets || [];
+
+                    // Determine update type: prefer minor (asar) over major (setup)
+                    const asarAsset = assets.find((a) => ASSET_PATTERNS.asar.test(a.name));
+                    const setupAsset = assets.find((a) => ASSET_PATTERNS.setup.test(a.name));
+                    const chosenAsset = asarAsset || setupAsset;
+                    const updateType: UpdateType = asarAsset ? 'minor' : 'major';
+
+                    if (!chosenAsset) {
+                        electronLog.error('[KCC-Update] No app.asar or Setup.exe asset found in release', remoteVersion);
+                        resolve(null);
+                        return;
+                    }
+
+                    if (!isAllowedRedirect(chosenAsset.browser_download_url)) {
+                        electronLog.error('[KCC-Update] Download URL points to untrusted host:', chosenAsset.browser_download_url);
+                        resolve(null);
+                        return;
+                    }
+
+                    // Resolve SHA-256 checksum
+                    let sha256 = '';
+                    if (UPDATE_CONFIG.checksumSource === 'digest') {
+                        sha256 = (chosenAsset.digest || '').replace(/^sha256:/i, '');
+                        if (!sha256) {
+                            electronLog.error('[KCC-Update] No SHA-256 digest found for asset');
+                            resolve(null);
+                            return;
+                        }
+                    } else {
+                        // Fetch checksums.sha256 companion file
+                        const checksumAsset = assets.find((a) => ASSET_PATTERNS.checksums.test(a.name));
+                        if (checksumAsset) {
+                            try {
+                                const checksums = await fetchChecksums(checksumAsset.browser_download_url);
+                                sha256 = checksums.get(chosenAsset.name) || '';
+                            } catch (err) {
+                                electronLog.error('[KCC-Update] Failed to fetch checksums:', err);
+                            }
+                        }
+                        if (!sha256) {
+                            electronLog.warn('[KCC-Update] No checksum available — proceeding without verification');
+                        }
+                    }
+
+                    electronLog.log('[KCC-Update] Update available:', remoteVersion,
+                        '| Type:', updateType,
+                        '| SHA-256:', sha256 ? sha256.substring(0, 16) + '...' : 'none');
+
+                    resolve({
+                        version: remoteVersion,
+                        updateType,
+                        downloadUrl: chosenAsset.browser_download_url,
+                        fileSize: chosenAsset.size,
+                        sha256,
+                    });
+                } catch (err) {
+                    electronLog.error('[KCC-Update] Failed to parse release data:', err);
+                    resolve(null);
+                }
+            });
+            res.on('error', (err) => {
+                electronLog.error('[KCC-Update] Response error:', err);
+                resolve(null);
+            });
+        }
+
+        req.setTimeout(CHECK_TIMEOUT_MS, () => {
+            electronLog.error('[KCC-Update] Check timed out after', CHECK_TIMEOUT_MS, 'ms');
+            req.destroy();
+            resolve(null);
+        });
+
+        req.on('error', (err) => {
+            electronLog.error('[KCC-Update] Check error:', err);
+            resolve(null);
+        });
+    });
+}
+
+// ── Download ──
+
+function verifyChecksum(filePath: string, expectedSha256: string): Promise<boolean> {
+    return new Promise((resolve, reject) => {
+        const hash = createHash('sha256');
+        const stream = createReadStream(filePath);
+        stream.on('data', (chunk) => hash.update(chunk));
+        stream.on('end', () => {
+            const actual = hash.digest('hex');
+            electronLog.log('[KCC-Update] SHA-256 expected:', expectedSha256);
+            electronLog.log('[KCC-Update] SHA-256 actual:  ', actual);
+            resolve(actual === expectedSha256);
+        });
+        stream.on('error', reject);
+    });
+}
+
+export function downloadUpdate(url: string, destPath: string, onProgress: ProgressCallback, expectedSha256?: string): Promise<void> {
+    return new Promise((resolve, reject) => {
+        const tmpPath = destPath + '.tmp';
+
+        function doDownload(downloadUrl: string, redirectCount = 0): void {
+            if (redirectCount > 5) {
+                reject(new Error('Too many redirects'));
+                return;
+            }
+            electronLog.log('[KCC-Update] Downloading from:', downloadUrl);
+            const req = httpsGet(downloadUrl, {
+                headers: { 'User-Agent': 'KrunkerCivilianClient' },
+            }, (res) => {
+                if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+                    const redirectUrl = res.headers.location;
+                    electronLog.log('[KCC-Update] Download redirected to:', redirectUrl);
+                    if (!isAllowedRedirect(redirectUrl)) {
+                        electronLog.error('[KCC-Update] Download redirect to untrusted host blocked:', redirectUrl);
+                        reject(new Error('Download redirect to untrusted host: ' + redirectUrl));
+                        return;
+                    }
+                    doDownload(redirectUrl, redirectCount + 1);
+                    return;
+                }
+
+                if (res.statusCode !== 200) {
+                    electronLog.error('[KCC-Update] Download returned status', res.statusCode, 'from:', downloadUrl);
+                    reject(new Error('Download returned status ' + res.statusCode));
+                    return;
+                }
+
+                const total = parseInt(res.headers['content-length'] || '0', 10);
+                let received = 0;
+
+                const file = createWriteStream(tmpPath);
+                res.on('data', (chunk: Buffer) => {
+                    received += chunk.length;
+                    if (total > 0) {
+                        onProgress(Math.round(100 * received / total));
+                    }
+                });
+                res.pipe(file);
+
+                file.on('finish', () => {
+                    file.close(async () => {
+                        try {
+                            if (expectedSha256) {
+                                const valid = await verifyChecksum(tmpPath, expectedSha256);
+                                if (!valid) {
+                                    electronLog.error('[KCC-Update] Checksum mismatch — file may be corrupted or tampered');
+                                    try { unlinkSync(tmpPath); } catch { /* ignore */ }
+                                    reject(new Error('SHA-256 checksum mismatch'));
+                                    return;
+                                }
+                                electronLog.log('[KCC-Update] Checksum verified');
+                            }
+                            if (existsSync(destPath)) unlinkSync(destPath);
+                            renameSync(tmpPath, destPath);
+                            resolve();
+                        } catch (err) {
+                            reject(err);
+                        }
+                    });
+                });
+
+                file.on('error', (err) => {
+                    try { unlinkSync(tmpPath); } catch { /* ignore */ }
+                    reject(err);
+                });
+
+                res.on('error', (err) => {
+                    try { unlinkSync(tmpPath); } catch { /* ignore */ }
+                    reject(err);
+                });
+            });
+
+            req.setTimeout(DOWNLOAD_TIMEOUT_MS, () => {
+                req.destroy();
+                try { unlinkSync(tmpPath); } catch { /* ignore */ }
+                reject(new Error('Download timed out'));
+            });
+
+            req.on('error', (err) => {
+                try { unlinkSync(tmpPath); } catch { /* ignore */ }
+                reject(err);
+            });
+        }
+
+        doDownload(url);
+    });
+}
+
+// ── Install / Apply ──
+
+export function installUpdate(installerPath: string): void {
+    electronLog.log('[KCC-Update] Launching installer:', installerPath);
+    const child = spawn(installerPath, [], {
+        detached: true,
+        stdio: 'ignore',
+    });
+    child.unref();
+    app.quit();
+}
+
+export function applyMinorUpdate(pendingAsarPath: string): void {
+    const resourcesDir = dirname(pendingAsarPath);
+    const exePath = app.getPath('exe');
+    const tempDir = join(app.getPath('temp'), 'kcc-update');
+    if (!existsSync(tempDir)) mkdirSync(tempDir, { recursive: true });
+
+    electronLog.log('[KCC-Update] Applying minor update via swap script');
+    electronLog.log('[KCC-Update] Resources dir:', resourcesDir);
+    electronLog.log('[KCC-Update] Exe path:', exePath);
+    electronLog.log('[KCC-Update] PID:', process.pid);
+
+    if (process.platform === 'win32') {
+        const scriptPath = join(tempDir, 'swap-asar.ps1');
+        writeFileSync(scriptPath, SWAP_SCRIPT_PS1);
+        const child = spawn('powershell.exe', [
+            '-ExecutionPolicy', 'Bypass',
+            '-File', scriptPath,
+            '-ProcessId', String(process.pid),
+            '-ResourcesDir', resourcesDir,
+            '-ExePath', exePath,
+        ], { detached: true, stdio: 'ignore' });
+        child.unref();
+    } else {
+        const scriptPath = join(tempDir, 'swap-asar.sh');
+        writeFileSync(scriptPath, SWAP_SCRIPT_BASH, { mode: 0o755 });
+        const child = spawn('bash', [
+            scriptPath, String(process.pid), resourcesDir, exePath,
+        ], { detached: true, stdio: 'ignore' });
+        child.unref();
+    }
+
+    app.quit();
+}
@@ -321,20 +321,23 @@ function createNumberRow(opts: {
  max: number;
  value: number;
  onChange: (value: number) => void;
+  step?: number;
  safety?: number;
  restart?: boolean;
  instant?: boolean;
  refreshOnly?: boolean;
 }): HTMLElement {
  const s = opts.safety || 0;
+  const step = opts.step || 1;
+  const parse = step < 1 ? parseFloat : parseInt;
  const row = document.createElement('div');
  row.className = 'setting settName safety-' + s + ' num';
  row.innerHTML =
    settingIcon(s, opts.instant, opts.refreshOnly, opts.restart) +
    '<span class="setting-title">' + escapeHtml(opts.label) + '</span>' +
    '<span class="setting-input-wrapper">' +
-      '<div class="slidecontainer"><input type="range" class="sliderM s-update-secondary" min="' + opts.min + '" max="' + opts.max + '" value="' + opts.value + '"></div>' +
-      '<input type="number" class="rb-input s-update sliderVal" min="' + opts.min + '" max="' + opts.max + '" value="' + opts.value + '">' +
+      '<div class="slidecontainer"><input type="range" class="sliderM s-update-secondary" min="' + opts.min + '" max="' + opts.max + '" step="' + step + '" value="' + opts.value + '"></div>' +
+      '<input type="number" class="rb-input s-update sliderVal" min="' + opts.min + '" max="' + opts.max + '" step="' + step + '" value="' + opts.value + '">' +
    '</span>' +
    '<div class="setting-desc-new">' + escapeHtml(opts.desc) + '</div>';
  const rangeInput = row.querySelector('input[type="range"]') as HTMLInputElement;
@@ -343,7 +346,7 @@ function createNumberRow(opts: {
    numInput.value = rangeInput.value;
  });
  rangeInput.addEventListener('change', () => {
-    const v = Math.max(opts.min, Math.min(opts.max, parseInt(rangeInput.value) || 0));
+    const v = Math.max(opts.min, Math.min(opts.max, parse(rangeInput.value) || 0));
    rangeInput.value = String(v);
    numInput.value = String(v);
    opts.onChange(v);
@@ -351,7 +354,7 @@ function createNumberRow(opts: {
    else if (opts.refreshOnly) onSettingChanged('refresh');
  });
  numInput.addEventListener('change', () => {
-    const v = Math.max(opts.min, Math.min(opts.max, parseInt(numInput.value) || 0));
+    const v = Math.max(opts.min, Math.min(opts.max, parse(numInput.value) || 0));
    numInput.value = String(v);
    rangeInput.value = String(v);
    opts.onChange(v);
@@ -543,18 +546,8 @@ interface SettingsBag {
 }

 function buildGeneralSection(
-  body: HTMLElement, gameConf: any, uiConfRaw: any, perfConf: any, bag: SettingsBag,
+  body: HTMLElement, gameConf: any, uiConfRaw: any, bag: SettingsBag,
 ): void {
-  const perfDefaults = { fpsUnlocked: true };
-  const perf = { ...perfDefaults, ...perfConf };
-
-  body.appendChild(createToggleRow({
-    label: 'Unlimited FPS',
-    desc: 'Uncap the frame rate (requires restart)',
-    checked: perf.fpsUnlocked, restart: true,
-    onChange: (v) => { perf.fpsUnlocked = v; ipcRenderer.invoke('set-config', 'performance', perf); },
-  }));
-
  const gameDefaults = { lastServer: '', socialTabBehaviour: 'New Window', rememberTabs: false };
  const game = { ...gameDefaults, ...gameConf };

@@ -591,6 +584,72 @@ function buildGeneralSection(
    },
  }));

+  body.appendChild(createToggleRow({
+    label: 'Join as Spectator',
+    desc: 'Automatically enable spectate mode when joining a game',
+    checked: game.joinAsSpectator, instant: true,
+    onChange: (v) => { game.joinAsSpectator = v; ipcRenderer.invoke('set-config', 'game', game); },
+  }));
+
+  body.appendChild(createToggleRow({
+    label: 'Show Changelog',
+    desc: 'Show release notes popup when the client updates',
+    checked: ui.showChangelog ?? true, instant: true,
+    onChange: (v) => { ui.showChangelog = v; saveUI(); },
+  }));
+
+  body.appendChild(createKeybindRow('Toggle Fullscreen', 'Fullscreen the game window (default F11)', bag.binds.fullscreenToggle, (b) => {
+    bag.binds.fullscreenToggle = b;
+    bag.saveBinds();
+  }, undefined, true));
+}
+
+function buildGameSection(
+  body: HTMLElement, gameConf: any, uiConfRaw: any, bag: SettingsBag,
+): void {
+  const game = { rawInput: true, showPing: true, hpEnemyCounter: true, ...gameConf };
+  const ui = { deathscreenAnimation: false, hideMenuPopups: false, menuTimer: true, doublePing: true, ...uiConfRaw };
+
+  function saveGame(): void {
+    ipcRenderer.invoke('set-config', 'game', game);
+  }
+  function saveUI(): void {
+    ipcRenderer.invoke('set-config', 'ui', ui);
+  }
+
+  if (bag.isWindows) {
+    body.appendChild(createToggleRow({
+      label: 'Raw Input',
+      desc: 'Bypass OS mouse acceleration for direct 1:1 sensor input (Windows only)',
+      checked: game.rawInput ?? true, refreshOnly: true,
+      onChange: (v) => { game.rawInput = v; saveGame(); },
+    }));
+  }
+
+  body.appendChild(createToggleRow({
+    label: 'Show Ping in Player List',
+    desc: 'Replace the ping icon with numeric millisecond values in the player list',
+    checked: game.showPing ?? true, refreshOnly: true,
+    onChange: (v) => { game.showPing = v; saveGame(); },
+  }));
+
+  body.appendChild(createToggleRow({
+    label: 'Double Ping Display',
+    desc: 'Show the real ping value (Krunker displays half the actual latency)',
+    checked: ui.doublePing ?? true, refreshOnly: true,
+    onChange: (v) => { ui.doublePing = v; saveUI(); },
+  }));
+
+  body.appendChild(createToggleRow({
+    label: 'Hardpoint Enemy Counter',
+    desc: 'Show enemy capture points in Hardpoint mode',
+    checked: game.hpEnemyCounter ?? true, refreshOnly: true,
+    onChange: (v) => {
+      game.hpEnemyCounter = v; saveGame();
+      if (v) initHPCounter(); else destroyHPCounter();
+    },
+  }));
+
  body.appendChild(createToggleRow({
    label: 'Block Death Screen Animation',
    desc: 'Disable the slide-in animation on the death screen',
@@ -608,13 +667,6 @@ function buildGeneralSection(
    },
  }));

-  body.appendChild(createToggleRow({
-    label: 'Join as Spectator',
-    desc: 'Automatically enable spectate mode when joining a game',
-    checked: game.joinAsSpectator, instant: true,
-    onChange: (v) => { game.joinAsSpectator = v; ipcRenderer.invoke('set-config', 'game', game); },
-  }));
-
  body.appendChild(createToggleRow({
    label: 'Menu Timer',
    desc: 'Show the game/spectate timer on the menu screen',
@@ -622,64 +674,59 @@ function buildGeneralSection(
    onChange: (v) => { ui.menuTimer = v; saveUI(); setMenuTimer(v); },
  }));

-  body.appendChild(createToggleRow({
-    label: 'Double Ping Display',
-    desc: 'Show the real ping value (Krunker displays half the actual latency)',
-    checked: ui.doublePing ?? true, refreshOnly: true,
-    onChange: (v) => { ui.doublePing = v; saveUI(); },
-  }));
-
-  body.appendChild(createToggleRow({
-    label: 'Show Ping in Player List',
-    desc: 'Replace the ping icon with numeric millisecond values in the player list',
-    checked: game.showPing ?? true, refreshOnly: true,
-    onChange: (v) => { game.showPing = v; ipcRenderer.invoke('set-config', 'game', game); },
-  }));
-
-  if (bag.isWindows) {
-    body.appendChild(createToggleRow({
-      label: 'Raw Input',
-      desc: 'Bypass OS mouse acceleration for direct 1:1 sensor input (Windows only)',
-      checked: game.rawInput ?? true, refreshOnly: true,
-      onChange: (v) => { game.rawInput = v; ipcRenderer.invoke('set-config', 'game', game); },
-    }));
-  }
-
-  body.appendChild(createToggleRow({
-    label: 'Hardpoint Enemy Counter',
-    desc: 'Show enemy capture points in Hardpoint mode',
-    checked: game.hpEnemyCounter ?? true, refreshOnly: true,
-    onChange: (v) => {
-      game.hpEnemyCounter = v; ipcRenderer.invoke('set-config', 'game', game);
-      if (v) initHPCounter(); else destroyHPCounter();
-    },
-  }));
-
-  body.appendChild(createToggleRow({
-    label: 'Show Changelog',
-    desc: 'Show release notes popup when the client updates',
-    checked: ui.showChangelog ?? true, instant: true,
-    onChange: (v) => { ui.showChangelog = v; saveUI(); },
-  }));
-
  if (ui.deathscreenAnimation) setDeathAnimBlock(true);
  if (ui.menuTimer ?? true) setMenuTimer(true);
  if (ui.hideMenuPopups) startHidePopups();
-
-  body.appendChild(createKeybindRow('Toggle Fullscreen', 'Fullscreen the game window (default F11)', bag.binds.fullscreenToggle, (b) => {
-    bag.binds.fullscreenToggle = b;
-    bag.saveBinds();
-  }, undefined, true));
 }

-function buildSwapperSection(body: HTMLElement, swapperConf: any, uiConfRaw: any): void {
-  const swapEnabled = swapperConf ? swapperConf.enabled : true;
-  const ui = { cssTheme: 'disabled', loadingTheme: 'disabled', backgroundUrl: '', ...uiConfRaw };
+function buildPerformanceSection(
+  body: HTMLElement, perfConf: any, isWindows: boolean,
+): void {
+  const perf = { fpsUnlocked: true, cpuThrottleGame: 1, cpuThrottleMenu: 1.5, processPriority: 'Normal', ...perfConf };

-  function saveUI(): void {
-    ipcRenderer.invoke('set-config', 'ui', ui);
+  function savePerf(): void {
+    ipcRenderer.invoke('set-config', 'performance', perf);
  }

+  body.appendChild(createToggleRow({
+    label: 'Unlimited FPS',
+    desc: 'Uncap the frame rate (requires restart)',
+    checked: perf.fpsUnlocked, restart: true,
+    onChange: (v) => { perf.fpsUnlocked = v; savePerf(); },
+  }));
+
+  body.appendChild(createNumberRow({
+    label: 'CPU Throttle (Game)', desc: 'CPU throttle rate during gameplay (1 = no throttle, 3 = heavy throttle)',
+    min: 1, max: 3, step: 0.01, value: perf.cpuThrottleGame, instant: true, safety: 2,
+    onChange: (v) => { perf.cpuThrottleGame = v; savePerf(); },
+  }));
+
+  body.appendChild(createNumberRow({
+    label: 'CPU Throttle (Menu)', desc: 'CPU throttle rate on menu screens (1 = no throttle, 3 = heavy throttle)',
+    min: 1, max: 3, step: 0.01, value: perf.cpuThrottleMenu, instant: true, safety: 1,
+    onChange: (v) => { perf.cpuThrottleMenu = v; savePerf(); },
+  }));
+
+  if (isWindows) {
+    body.appendChild(createSelectRow({
+      label: 'Process Priority',
+      desc: 'OS-level process priority for the client (Windows only)',
+      options: [
+        { value: 'Normal', label: 'Normal' },
+        { value: 'Above Normal', label: 'Above Normal' },
+        { value: 'High', label: 'High' },
+        { value: 'Below Normal', label: 'Below Normal' },
+        { value: 'Low', label: 'Low' },
+      ],
+      value: perf.processPriority, restart: true, safety: 2,
+      onChange: (v) => { perf.processPriority = v; savePerf(); },
+    }));
+  }
+}
+
+function buildSwapperSection(body: HTMLElement, swapperConf: any): void {
+  const swapEnabled = swapperConf ? swapperConf.enabled : true;
+
  body.appendChild(createToggleRow({
    label: 'Resource Swapper',
    desc: 'Replace game textures, sounds, and models with local files',
@@ -704,6 +751,14 @@ function buildSwapperSection(body: HTMLElement, swapperConf: any, uiConfRaw: any
  swapFolderBtn.addEventListener('click', () => ipcRenderer.invoke('open-swap-folder'));
  folderRow.appendChild(swapFolderBtn);
  body.appendChild(folderRow);
+}
+
+function buildAppearanceSection(body: HTMLElement, uiConfRaw: any): void {
+  const ui = { cssTheme: 'disabled', loadingTheme: 'disabled', backgroundUrl: '', ...uiConfRaw };
+
+  function saveUI(): void {
+    ipcRenderer.invoke('set-config', 'ui', ui);
+  }

  // ── CSS Theme selector (populated from swap/themes/) ──
  const themeRow = document.createElement('div');
@@ -774,10 +829,31 @@ function buildSwapperSection(body: HTMLElement, swapperConf: any, uiConfRaw: any
    saveUI();
    onSettingChanged('refresh');
  });
+
+  // ── Background URL (overrides loading theme selection) ──
+  const urlRow = document.createElement('div');
+  urlRow.className = 'setting settName safety-0';
+  urlRow.innerHTML =
+    refreshIcon('refresh-icon') +
+    '<span class="setting-title">Background URL</span>' +
+    '<div class="setting-desc-new">Direct image URL for loading screen (overrides dropdown above)</div>';
+  const urlInput = document.createElement('input');
+  urlInput.type = 'text';
+  urlInput.className = 'inputGrey2';
+  urlInput.placeholder = 'https://example.com/image.png';
+  urlInput.value = ui.backgroundUrl || '';
+  urlInput.style.width = '300px';
+  urlInput.addEventListener('change', () => {
+    ui.backgroundUrl = urlInput.value.trim();
+    saveUI();
+    onSettingChanged('refresh');
+  });
+  urlRow.appendChild(urlInput);
+  body.appendChild(urlRow);
 }

 function buildMatchmakerSection(body: HTMLElement, mmConf: any, bag: SettingsBag): void {
-  const mm = mmConf || { enabled: true, regions: [], gamemodes: [], minPlayers: 1, maxPlayers: 6, minRemainingTime: 120, openServerBrowser: true, autoJoin: false };
+  const mm = mmConf || { enabled: true, regions: [], gamemodes: [], minPlayers: 1, maxPlayers: 6, minRemainingTime: 120, openServerBrowser: true, sortByPlayers: false };

  function saveMM(): void {
    ipcRenderer.invoke('set-config', 'matchmaker', mm);
@@ -798,20 +874,16 @@ function buildMatchmakerSection(body: HTMLElement, mmConf: any, bag: SettingsBag
  }));

  body.appendChild(createToggleRow({
-    label: 'Auto-Join',
-    desc: 'Automatically join the best match without showing the popup',
-    checked: mm.autoJoin ?? false, instant: true,
-    onChange: (v) => { mm.autoJoin = v; saveMM(); },
+    label: 'Prioritize Player Count',
+    desc: 'Sort results by most players first, then by ping (default is ping first)',
+    checked: mm.sortByPlayers ?? false, instant: true,
+    onChange: (v) => { mm.sortByPlayers = v; saveMM(); },
  }));

  body.appendChild(createKeybindRow('Matchmaker Hotkey', 'Key to trigger the custom matchmaker', bag.binds.matchmaker, (b) => {
    bag.binds.matchmaker = b;
    bag.saveBinds();
  }, undefined, true));
-  body.appendChild(createKeybindRow('Matchmaker Accept', 'Key to accept a found game', bag.binds.matchmakerAccept, (b) => {
-    bag.binds.matchmakerAccept = b;
-    bag.saveBinds();
-  }, undefined, true));
  body.appendChild(createKeybindRow('Matchmaker Cancel', 'Key to dismiss the matchmaker popup', bag.binds.matchmakerCancel, (b) => {
    bag.binds.matchmakerCancel = b;
    bag.saveBinds();
@@ -1078,7 +1150,7 @@ function buildChatSection(body: HTMLElement, gameConf: any, translatorConf: any)
 }

 function buildAdvancedSection(
-  body: HTMLElement, advConf: any, perfConf: any, isWindows: boolean,
+  body: HTMLElement, advConf: any, isWindows: boolean,
 ): void {
  const advDefaults = {
    removeUselessFeatures: true,
@@ -1091,11 +1163,6 @@ function buildAdvancedSection(
    verboseLogging: false,
  };
  const adv = { ...advDefaults, ...advConf };
-  const perf = { cpuThrottleGame: 1, cpuThrottleMenu: 1.5, processPriority: 'Normal', ...perfConf };
-
-  function savePerf(): void {
-    ipcRenderer.invoke('set-config', 'performance', perf);
-  }

  function saveAdv(): void {
    ipcRenderer.invoke('set-config', 'advanced', adv);
@@ -1142,34 +1209,6 @@ function buildAdvancedSection(
    }));
  }

-  body.appendChild(createNumberRow({
-    label: 'CPU Throttle (Game)', desc: 'CPU throttle rate during gameplay (1 = no throttle, 3 = heavy throttle)',
-    min: 1, max: 3, value: perf.cpuThrottleGame, instant: true, safety: 2,
-    onChange: (v) => { perf.cpuThrottleGame = v; savePerf(); },
-  }));
-
-  body.appendChild(createNumberRow({
-    label: 'CPU Throttle (Menu)', desc: 'CPU throttle rate on menu screens (1 = no throttle, 3 = heavy throttle)',
-    min: 1, max: 3, value: perf.cpuThrottleMenu, instant: true, safety: 1,
-    onChange: (v) => { perf.cpuThrottleMenu = v; savePerf(); },
-  }));
-
-  if (isWindows) {
-    body.appendChild(createSelectRow({
-      label: 'Process Priority',
-      desc: 'OS-level process priority for the client (Windows only)',
-      options: [
-        { value: 'Normal', label: 'Normal' },
-        { value: 'Above Normal', label: 'Above Normal' },
-        { value: 'High', label: 'High' },
-        { value: 'Below Normal', label: 'Below Normal' },
-        { value: 'Low', label: 'Low' },
-      ],
-      value: perf.processPriority, restart: true, safety: 2,
-      onChange: (v) => { perf.processPriority = v; savePerf(); },
-    }));
-  }
-
  body.appendChild(createToggleRow({
    label: 'Verbose Logging',
    desc: 'Forward all preload console output to the Electron log file',
@@ -1277,8 +1316,14 @@ function renderSettings(searchQuery?: string): void {
  // ── Create section shells ──
  const genSec = createSection('General');
  container.appendChild(genSec.section);
+  const gameSec = createSection('Game');
+  container.appendChild(gameSec.section);
+  const perfSec = createSection('Performance');
+  container.appendChild(perfSec.section);
  const swapSec = createSection('Swapper');
  container.appendChild(swapSec.section);
+  const appearSec = createSection('Appearance');
+  container.appendChild(appearSec.section);
  const mmSec = createSection('Matchmaker');
  container.appendChild(mmSec.section);
  const chatSec = createSection('Chat');
@@ -1307,7 +1352,6 @@ function renderSettings(searchQuery?: string): void {
    const translatorConf = allConf.translator;
    const defaultBinds = {
      matchmaker:       { key: 'F6',     ctrl: false, shift: false, alt: false },
-      matchmakerAccept: { key: 'Enter',  ctrl: false, shift: false, alt: false },
      matchmakerCancel: { key: 'Escape', ctrl: false, shift: false, alt: false },
      fullscreenToggle: { key: 'F11',    ctrl: false, shift: false, alt: false },
    };
@@ -1321,13 +1365,16 @@ function renderSettings(searchQuery?: string): void {
    };

    // Populate each section
-    buildGeneralSection(genSec.body, gameConf, uiConfRaw, allConf.performance, bag);
-    buildSwapperSection(swapSec.body, swapperConf, uiConfRaw);
+    buildGeneralSection(genSec.body, gameConf, uiConfRaw, bag);
+    buildGameSection(gameSec.body, gameConf, uiConfRaw, bag);
+    buildPerformanceSection(perfSec.body, allConf.performance, isWindows);
+    buildSwapperSection(swapSec.body, swapperConf);
+    buildAppearanceSection(appearSec.body, uiConfRaw);
    buildMatchmakerSection(mmSec.body, mmConf, bag);
    buildChatSection(chatSec.body, gameConf, translatorConf);
    buildDiscordSection(discordSec.body, discordConf);
    buildAccountsSection(accSec.body, allConf.accounts);
-    buildAdvancedSection(advSec.body, advConf, allConf.performance, isWindows);
+    buildAdvancedSection(advSec.body, advConf, isWindows);
    renderUserscriptsSection(usSec.body);

    if (searchQuery) applySearchFilter(container, holder, searchQuery);
@@ -17,8 +17,8 @@ export const MATCHMAKER_GAMEMODE_FILTER = [
    'Domination', 'Kranked FFA', 'Team Defender', 'Deposit FFA', 'Chaos Snipers',
    'Bighead FFA',
 ];
-export const MATCHMAKER_REGIONS = ['MBI', 'NY', 'FRA', 'SIN', 'DAL', 'SYD', 'MIA', 'BHN', 'TOK', 'BRZ', 'AFR', 'LON', 'CHI', 'SV', 'STL', 'MX'];
-export const MATCHMAKER_REGION_NAMES: Record<string, string> = { MBI: 'Mumbai', NY: 'New York', FRA: 'Frankfurt', SIN: 'Singapore', DAL: 'Dallas', SYD: 'Sydney', MIA: 'Miami', BHN: 'Middle East', TOK: 'Tokyo', BRZ: 'Brazil', AFR: 'South Africa', LON: 'London', CHI: 'China', SV: 'Silicon Valley', STL: 'Seattle', MX: 'Mexico' };
+export const MATCHMAKER_REGIONS = ['SV', 'TOK', 'FRA', 'MBI', 'SYD', 'SIN', 'DAL', 'BHN', 'BRZ', 'NY'];
+export const MATCHMAKER_REGION_NAMES: Record<string, string> = { SV: 'Silicon Valley', TOK: 'Tokyo', FRA: 'Frankfurt', MBI: 'Mumbai', SYD: 'Sydney', SIN: 'Singapore', DAL: 'Dallas', BHN: 'Bahrain', BRZ: 'Brazil', NY: 'New York' };
 export const MAP_ICON_INDICES = ['Burg', 'Littletown', 'Sandstorm', 'Subzero', 'Undergrowth', 'Shipment', 'Freight', 'Lostworld', 'Citadel', 'Oasis', 'Kanji', 'Industry', 'Lumber', 'Evacuation', 'Site', 'SkyTemple', 'Lagoon', 'Bureau', 'Tortuga', 'Tropicano', 'Krunk_Plaza', 'Arena', 'Habitat', 'Atomic', 'Old_Burg', 'Throwback', 'Stockade', 'Facility', 'Clockwork', 'Laboratory', 'Shipyard', 'Soul Sanctum', 'Bazaar', 'Erupt', 'HQ', 'Khepri', 'Lush', 'Vivo', 'Slide Moonlight', 'Eterno Sim'];
 export const MATCHMAKER_MAP_NAMES: Record<string, string> = {
    SkyTemple: 'Sky Temple', Krunk_Plaza: 'Krunk Plaza', Old_Burg: 'Old Burg',
@@ -65,18 +65,10 @@ export interface MatchmakerConfig {
    maxPlayers: number;
    minRemainingTime: number;
    openServerBrowser: boolean;
-    autoJoin: boolean;
-    acceptKey: Keybind;
+    sortByPlayers: boolean;
    cancelKey: Keybind;
 }

-function secondsToTimestring(num: number): string {
-    const minutes = Math.floor(num / 60);
-    const seconds = num % 60;
-    if (minutes < 1) return `${num}s`;
-    return `${minutes}m ${seconds}s`;
-}
-
 function matchesKey(bind: Keybind, event: KeyboardEvent): boolean {
    if ((document.activeElement as HTMLElement)?.tagName === 'INPUT') return false;
    return event.key === bind.key
@@ -102,21 +94,17 @@ popupElement.appendChild(popupDescription);
 const popupOptions = document.createElement('div');
 popupOptions.id = 'matchmakerPopupOptions';

-const popupConfirmBtn = document.createElement('div');
-popupConfirmBtn.id = 'matchmakerConfirmButton';
-popupConfirmBtn.className = 'matchmakerPopupButton bigShadowT';
-popupConfirmBtn.textContent = 'Join';
-popupConfirmBtn.setAttribute('onmouseenter', 'playTick()');
-popupConfirmBtn.addEventListener('click', () => decideMatchmakerDecision(true));
-
 const popupCancelBtn = document.createElement('div');
 popupCancelBtn.id = 'matchmakerCancelButton';
 popupCancelBtn.className = 'matchmakerPopupButton bigShadowT';
 popupCancelBtn.textContent = 'Cancel';
 popupCancelBtn.setAttribute('onmouseenter', 'playTick()');
-popupCancelBtn.addEventListener('click', () => decideMatchmakerDecision(false));
+popupCancelBtn.addEventListener('click', () => {
+    const w = window as any;
+    if (typeof w.playSelect === 'function') w.playSelect();
+    dismissPopup();
+});

-popupOptions.appendChild(popupConfirmBtn);
 popupOptions.appendChild(popupCancelBtn);
 popupElement.appendChild(popupOptions);

@@ -146,10 +134,8 @@ searchContainer.appendChild(searchCancelBtn);
 popupElement.appendChild(searchContainer);

 // ── State ──
-let popupGameID = '';
 let popupCandidates: MatchmakerGame[] = [];
 let openServerBrowser = true;
-let confirmKey: Keybind = { key: 'Enter', ctrl: false, shift: false, alt: false };
 let cancelKey: Keybind = { key: 'Escape', ctrl: false, shift: false, alt: false };
 let searchAborted = false;

@@ -191,25 +177,11 @@ async function verifyAndJoin(gameID: string): Promise<void> {

 function dismissPopup(): void {
    document.removeEventListener('keydown', handleSearchBind, true);
-    document.removeEventListener('keydown', handleMatchmakerBind, true);
+
    if (popupElement.parentNode) popupElement.remove();
    popupElement.classList.remove('searching');
 }

-function decideMatchmakerDecision(accept: boolean): void {
-    const w = window as any;
-    if (typeof w.playSelect === 'function') w.playSelect();
-
-    if (accept && popupGameID !== 'none') {
-        verifyAndJoin(popupGameID);
-    } else {
-        dismissPopup();
-        if (popupGameID === 'none' && openServerBrowser && typeof w.openServerWindow === 'function') {
-            w.openServerWindow(0);
-        }
-    }
-}
-
 function handleSearchBind(event: KeyboardEvent): void {
    if (document.pointerLockElement) return;
    if (matchesKey(cancelKey, event)) {
@@ -219,42 +191,6 @@ function handleSearchBind(event: KeyboardEvent): void {
    }
 }

-function handleMatchmakerBind(event: KeyboardEvent): void {
-    if (document.pointerLockElement) return;
-    const isAccept = matchesKey(confirmKey, event);
-    const isCancel = matchesKey(cancelKey, event);
-    if (isAccept || isCancel) {
-        document.removeEventListener('keydown', handleMatchmakerBind, true);
-        decideMatchmakerDecision(isAccept);
-    }
-}
-
-function showResultPopup(game: MatchmakerGame): void {
-    popupElement.classList.remove('searching');
-    const mapIdx = MAP_ICON_INDICES.indexOf(game.map);
-    popupElement.style.backgroundImage = `url(https://assets.krunker.io/img/maps/map_${mapIdx >= 0 ? mapIdx : 0}.png)`;
-
-    popupGameID = game.gameID;
-    if (game.gameID === 'none') {
-        popupTitle.innerText = 'No Games Found...';
-        popupDescription.innerHTML = 'Check the server browser to see other lobbies.';
-        popupConfirmBtn.style.display = 'none';
-    } else {
-        popupTitle.innerText = 'Game Found!';
-        const regionName = MATCHMAKER_REGION_NAMES[game.region] ?? 'Unknown Region';
-        popupDescription.innerHTML = `${escapeHtml(game.gamemode)} on ${escapeHtml(game.map)} (${escapeHtml(regionName)})<br/>${game.playerCount}/${game.playerLimit} Players, ${secondsToTimestring(game.remainingTime)} Left`;
-        popupConfirmBtn.style.display = 'block';
-    }
-
-    // Re-trigger slide animation
-    popupElement.style.animation = 'none';
-    void popupElement.offsetWidth;
-    popupElement.style.animation = '';
-
-    document.removeEventListener('keydown', handleSearchBind, true);
-    document.addEventListener('keydown', handleMatchmakerBind, true);
-}
-
 function showSearchPopup(): void {
    searchAborted = false;
    popupElement.classList.add('searching');
@@ -263,7 +199,7 @@ function showSearchPopup(): void {
    searchFeed.innerHTML = '';
    searchCounter.textContent = '';

-    document.removeEventListener('keydown', handleMatchmakerBind, true);
+
    document.addEventListener('keydown', handleSearchBind, true);

    const uiBase = document.getElementById('uiBase');
@@ -358,8 +294,12 @@ async function fetchAllGames(mmConfig: MatchmakerConfig): Promise<{ all: RawLobb
    return { all, filtered };
 }

-function sortByPingThenPlayers(games: MatchmakerGame[], pings: Record<string, number>): MatchmakerGame[] {
+function sortGames(games: MatchmakerGame[], pings: Record<string, number>, sortByPlayers: boolean): MatchmakerGame[] {
    return games.sort((a, b) => {
+        if (sortByPlayers) {
+            if (a.playerCount !== b.playerCount) return b.playerCount - a.playerCount;
+            return (pings[a.region] ?? 999) - (pings[b.region] ?? 999);
+        }
        const pingA = pings[a.region] ?? 999;
        const pingB = pings[b.region] ?? 999;
        if (pingA !== pingB) return pingA - pingB;
@@ -369,7 +309,6 @@ function sortByPingThenPlayers(games: MatchmakerGame[], pings: Record<string, nu

 export async function fetchGame(mmConfig: MatchmakerConfig, _con?: SavedConsole): Promise<void> {
    openServerBrowser = mmConfig.openServerBrowser;
-    confirmKey = mmConfig.acceptKey;
    cancelKey = mmConfig.cancelKey;

    // Dismiss existing popup if active (also aborts in-flight search)
@@ -406,7 +345,7 @@ export async function fetchGame(mmConfig: MatchmakerConfig, _con?: SavedConsole)
    _con?.log('[KCC-MM]', filtered.length, '/', allLobbies.length, 'games passed filters');

    // Sort immediately — result is ready
-    if (filtered.length > 0) sortByPingThenPlayers(filtered, pings);
+    if (filtered.length > 0) sortGames(filtered, pings, mmConfig.sortByPlayers);
    popupCandidates = filtered;

    // Fire animation in background (non-blocking eye candy)
@@ -429,45 +368,27 @@ export async function fetchGame(mmConfig: MatchmakerConfig, _con?: SavedConsole)
        const best = pool[Math.floor(Math.random() * pool.length)];
        _con?.log('[KCC-MM] Best match:', best.gameID, best.region, best.map, `(${pings[best.region] ?? '?'}ms, pool: ${pool.length})`);

-        if (mmConfig.autoJoin) {
-            // Brief "Lobby Found!" flash before joining
-            const regionName = MATCHMAKER_REGION_NAMES[best.region] ?? best.region;
-            searchStatus.textContent = 'Lobby Found!';
-            searchFeed.innerHTML = '';
-            const found = document.createElement('div');
-            found.className = 'mm-feed-entry mm-pass';
-            found.style.cssText = 'font-size:1.1em;justify-content:center;';
-            found.innerHTML =
-                `<span class="mm-feed-region">${escapeHtml(best.region)}</span>` +
-                `<span class="mm-feed-map">${escapeHtml(best.map)}</span>` +
-                `<span class="mm-feed-players">${best.playerCount}/${best.playerLimit}</span>`;
-            searchFeed.appendChild(found);
-            searchCounter.textContent = `${best.gamemode} \u00B7 ${regionName} \u00B7 ${pings[best.region] ?? '?'}ms`;
-            await new Promise(r => setTimeout(r, 1200));
-            await verifyAndJoin(best.gameID);
-            return;
-        }
-
-        showResultPopup(best);
+        // Brief "Lobby Found!" flash before auto-joining
+        const regionName = MATCHMAKER_REGION_NAMES[best.region] ?? best.region;
+        searchStatus.textContent = 'Lobby Found!';
+        searchFeed.innerHTML = '';
+        const found = document.createElement('div');
+        found.className = 'mm-feed-entry mm-pass';
+        found.style.cssText = 'font-size:1.1em;justify-content:center;';
+        found.innerHTML =
+            `<span class="mm-feed-region">${escapeHtml(best.region)}</span>` +
+            `<span class="mm-feed-map">${escapeHtml(best.map)}</span>` +
+            `<span class="mm-feed-players">${best.playerCount}/${best.playerLimit}</span>`;
+        searchFeed.appendChild(found);
+        searchCounter.textContent = `${best.gamemode} \u00B7 ${regionName} \u00B7 ${pings[best.region] ?? '?'}ms`;
+        await new Promise(r => setTimeout(r, 1200));
+        await verifyAndJoin(best.gameID);
    } else {
        _con?.log('[KCC-MM] No matching games found');

-        if (mmConfig.autoJoin) {
-            dismissPopup();
-            if (openServerBrowser && typeof (window as any).openServerWindow === 'function') {
-                (window as any).openServerWindow(0);
-            }
-            return;
+        dismissPopup();
+        if (openServerBrowser && typeof (window as any).openServerWindow === 'function') {
+            (window as any).openServerWindow(0);
        }
-
-        showResultPopup({
-            gameID: 'none',
-            region: 'none',
-            playerCount: 0,
-            playerLimit: 0,
-            map: MAP_ICON_INDICES[0],
-            gamemode: MATCHMAKER_GAMEMODES[0],
-            remainingTime: 0,
-        });
    }
 }
@@ -104,7 +104,7 @@ const FALSE_POSITIVE_LANGS = new Set([

 // ── Auto-suppression (repeated short phrases) ──

-const suppressionCounts = new Map<string, number>();
+let suppressionCounts = new Map<string, number>();
 const SUPPRESS_THRESHOLD = 3;
 const MIN_LATIN_WORDS = 3;
 const SHORT_TEXT_THRESHOLD = 15;
@@ -113,6 +113,7 @@ const SHORT_TEXT_THRESHOLD = 15;

 let activeRequests = 0;
 const MAX_CONCURRENT = 3;
+const MAX_QUEUE = 15;
 const pendingQueue: Array<() => void> = [];

 function enqueue(fn: () => Promise<void>): void {
@@ -123,10 +124,45 @@ function enqueue(fn: () => Promise<void>): void {
      if (pendingQueue.length > 0) pendingQueue.shift()!();
    });
  } else {
+    // Drop oldest if queue is full — old messages have already scrolled off-screen
+    if (pendingQueue.length >= MAX_QUEUE) pendingQueue.shift();
    pendingQueue.push(() => enqueue(fn));
  }
 }

+// ── Periodic cleanup (prevents unbounded memory growth in long sessions) ──
+
+const CLEANUP_INTERVAL_MS = 5 * 60 * 1000;
+let cleanupTimer: ReturnType<typeof setInterval> | null = null;
+
+function startCleanup(): void {
+  if (cleanupTimer) return;
+  cleanupTimer = setInterval(() => {
+    // Reset suppression counts (re-learned naturally from fresh messages)
+    suppressionCounts = new Map();
+
+    // Prune expired sessionStorage cache entries
+    const now = Date.now();
+    const keysToRemove: string[] = [];
+    for (let i = 0; i < sessionStorage.length; i++) {
+      const key = sessionStorage.key(i);
+      if (!key?.startsWith(CACHE_KEY_PREFIX)) continue;
+      try {
+        const entry: CacheEntry = JSON.parse(sessionStorage.getItem(key) || '');
+        if (now - entry.ts > CACHE_EXPIRY_MS) keysToRemove.push(key);
+      } catch { keysToRemove.push(key); }
+    }
+    for (const key of keysToRemove) sessionStorage.removeItem(key);
+  }, CLEANUP_INTERVAL_MS);
+}
+
+function stopCleanup(): void {
+  if (cleanupTimer) {
+    clearInterval(cleanupTimer);
+    cleanupTimer = null;
+  }
+}
+
 // ── System message patterns to skip ──

 const SYSTEM_PATTERNS = [
@@ -281,8 +317,10 @@ function processMessage(node: HTMLElement): void {

  const { message, username } = extracted;
  enqueue(async () => {
+    // Node may have been removed by chat history trimming while queued
+    if (!node.isConnected) return;
    const result = await translateText(message);
-    if (result) appendTranslation(node, username, result.translation, result.srcLang);
+    if (result && node.isConnected) appendTranslation(node, username, result.translation, result.srcLang);
  });
 }

@@ -316,6 +354,7 @@ function startObserver(): void {
    });

    chatObserver.observe(chatList, { childList: true });
+    startCleanup();
    _con.log('[KCC-TL] Chat observer active');
  }, 500);
 }
@@ -329,6 +368,8 @@ function stopObserver(): void {
    chatObserver.disconnect();
    chatObserver = null;
  }
+  stopCleanup();
+  pendingQueue.length = 0;
 }

 // ── Public API ──
@@ -8,6 +8,9 @@ const nodeBuiltins = builtinModules.flatMap((m) => [m, `node:${m}`]);
 const isProd = process.env.NODE_ENV === 'production' || !process.argv.includes('--mode');

 export default defineConfig({
+  define: {
+    __UPDATE_SOURCE__: JSON.stringify(process.env.UPDATE_SOURCE || 'gitea'),
+  },
  build: {
    lib: {
      entry: resolve(__dirname, 'src/main/index.ts'),
@@ -17,7 +20,7 @@ export default defineConfig({
    outDir: 'dist/main',
    emptyDirBefore: true,
    rollupOptions: {
-      external: ['electron', 'electron-store', ...nodeBuiltins],
+      external: ['electron', 'electron-store', 'original-fs', ...nodeBuiltins],
    },
    target: 'node20',
    minify: isProd,
Author	SHA1	Message	Date
bigjakk	d17c1bc0a2	chore: bump version to 0.8.0 Build and Release / build-and-release (push) Successful in 17m21s Details	2026-04-16 10:30:56 -07:00
bigjakk	b968ace8fa	refactor: extract asar from electron-builder output instead of custom script	2026-04-16 10:30:44 -07:00
bigjakk	2cf5623186	chore: bump version to 0.7.9 Build and Release / build-and-release (push) Failing after 7m37s Details	2026-04-16 10:21:26 -07:00
bigjakk	5e7786d66e	fix: resolve transitive deps in build-asar, use Move-Item in swap script	2026-04-16 10:21:14 -07:00
bigjakk	9a52d6b8fc	chore: bump version to 0.7.8 Build and Release / build-and-release (push) Successful in 12m59s Details	2026-04-16 09:38:00 -07:00
bigjakk	255befd1b8	fix: use original-fs to bypass Electron asar interception	2026-04-16 09:38:00 -07:00
bigjakk	691b363f88	ci: remove sudo from workflow (Gitea runner is root) Build and Release / build-and-release (push) Successful in 9m20s Details	2026-04-16 08:56:19 -07:00
bigjakk	8972c3e363	chore: bump version to 0.7.7 Build and Release / build-and-release (push) Has been cancelled Details	2026-04-16 08:31:27 -07:00
bigjakk	5a8d77c494	ci: auto-detect patch vs full, control asar upload accordingly Build and Release / build-and-release (push) Successful in 8s Details	2026-04-16 08:26:26 -07:00
bigjakk	2240ca38bd	ci: auto-detect patch vs full release in workflow Build and Release / build-and-release (push) Successful in 37s Details	2026-04-16 08:10:14 -07:00
bigjakk	d2696a510f	feat: add 2-stage update system (asar swap + full installer)	2026-04-16 08:10:06 -07:00
bigjakk	4aecb402d6	perf: freeze background tabs via CDP Page Lifecycle API Build and Release / build-and-release (push) Failing after 32m2s Details	2026-04-16 06:52:44 -07:00
bigjakk	088db29377	chore: bump version to 0.7.5	2026-04-15 09:36:44 -07:00
bigjakk	d9512a9040	fix: update default settings for deathscreen, discord, swapper, userscripts	2026-04-15 08:59:47 -07:00
bigjakk	5a18242f72	fix: store remembered tabs in memory instead of persisting to disk	2026-04-15 08:50:17 -07:00
bigjakk	ae359497be	refactor: remove matchmaker accept hotkey and always auto-join	2026-04-15 08:44:20 -07:00
bigjakk	db89352ed8	refactor: reorganize settings into General, Game, Performance, Swapper, Appearance sections	2026-04-15 08:37:26 -07:00
bigjakk	c1d1f6bce3	feat: add sort by players option to matchmaker	2026-04-15 08:28:43 -07:00
bigjakk	6582ddf93a	fix: add translator queue limit, periodic cleanup, and node checks	2026-04-15 07:27:01 -07:00
bigjakk	fba25a9081	fix: default deathscreen animation to disabled	2026-04-15 07:25:29 -07:00
bigjakk	ca5c0491b7	feat: add background URL text input to swapper settings	2026-04-15 07:23:00 -07:00
bigjakk	2b2ff703c2	fix: update matchmaker regions to match current server list	2026-04-15 07:14:52 -07:00
bigjakk	13e42e4374	feat: add step support to number settings for fractional values	2026-04-15 07:12:04 -07:00