Preview 1.84.1 (#862) - Part 1

![UpdateIsAvailable-Campaign-Columbina](https://github.com/user-attachments/assets/e7043018-4d49-48f2-adf1-3c846fd3c3e4)
# Preview 1.84.1 (Codename: Columbina)

### Hewwo, it's neon-nyan here~

It's beeeeeen a while since the last 1.83.x update. For now, this
release is focusing on more quality improvements, bug fixes and internal
code reworks rather than new features as we are preparing on reworking
Collapse for new codebase.

That being said, this 1.84 update will be the marked as the last V1
release after roughly 4 years since the start of this project as we are
going to move into V2 codebase starting this year (at Q3 or Q4 2026).
Thank you so much for your continous support and interest in this
project💖

Without further ado, let's dig into what's new in this release so far.

# What's new?
## Reworked Background System
Since months, HoYoverse has updated HoYoPlay to support multiple
background to display, including static image and dynamic background
ones. This has been our backlog since this release as due to
"spaghetti-code" nature of our entire codebase, this made us harder to
adapt the changes and thus making Collapse still only support one static
background image.

Thanks to [this massive
rework](#862), we are
now able to pull-off this feature by splitting the parts of the code
into its own element, making it more easier and more manageable for the
change and for incoming improvements.

We are also moving to [**FFmpeg**](https://www.ffmpeg.org/) as our
secondary library for background video decoder if no built-in codec is
present. You will be prompted to install the FFmpeg library if none of
the required built-in Windows Media Foundation codec for VP9 or any
codec is present.

> [**FFmpeg**](https://www.ffmpeg.org/legal.html) is licensed and
distributed under [GNU Lesser General Public License, version 2.1
**(LGPLv2.1)**](https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html)

[2026-03-22
20-02-46.webm](https://github.com/user-attachments/assets/954c4c77-4ae9-4222-afa7-4b396c7cc2f9)

The experience might still be sluggish due to rushed implementation. But
this will be improved in future updates🤞

### Update: 2026/03/27
Due to corrupted video background situation in any regions for Zenless
Zone Zero game, FFmpeg has been set as a default decoder for Collapse
Launcher now (You can opt-in for using built-in Windows Media Foundation
decoder, though). You might be asked to install a new one if you don't
have any defined in your system's Environment Variable.

[2026-03-27
11-55-13.webm](https://github.com/user-attachments/assets/670dd6d4-a3d3-44ba-9ee5-48866a0362da)

## Reworked Localization System #861 
This is more like development-experience improvement rather than user
focused ones. Previously in order to implement the localization for new
elements, we have to manually map each class properties to represented
JSON entries. Thanks to newly source-generated class mapper, every JSON
entries will be mapped automatically. Each class properties can now be
bind into UI element directly, making the UI able to update the visual
itself rather than being told manually, one-by-one (which is expensive).

## Reworked Download Speed Limiter #859 
The feature has been long broken since last 1.83.x release due to
inconsistency and changes to other download-related libraries. Even
though if you're enabling this feature, you might experience that the
download speed "isn't actually being limited" and noticing that your
bandwidth is still being fully utilized. This feature should now be
fully fixed by decentralizing the code of the feature into its own
library and making it easier to maintain.

This feature could also be applied for any game plugins whose have
v1-update4 API standard fully implemented.

## Minor UI Adjustments
Not so noticeable UI changes at all. But it's worth to mention here.
#### 1. News Carousel Design
<img width="1282" height="457" alt="image"
src="https://github.com/user-attachments/assets/3f3df571-63b5-42d5-9d54-6b6e005a8b83"
/>

#### 2. About Card
<img width="810" height="535" alt="image"
src="https://github.com/user-attachments/assets/66b826b0-219d-4733-ba49-8a600705ede1"
/>

## Other New Changes
- **[New]** Adding Files Clean-up Button to the Menu Bar, by @bagusnl 
<img width="334" height="139" alt="image"
src="https://github.com/user-attachments/assets/50869299-c0dc-4888-9a5b-1819f05bed99"
/>

- **[Imp]** Switching Static Libraries Compiler from MSVC 19 to Clang
20.1, by @neon-nyan
- **[Imp]** Caching Page Loading, by @neon-nyan 
- **[Imp]** Detach SDK Loading (for Sentry, Libsql.Client), by
@neon-nyan
- **[Imp]** Add Plugin Details (Breadcrumbs) to Sentry Reports, by
@bagusnl
- **[Imp]** Update overlay mask according to UI changes, by @shatyuka 
- **[Fix]** Remove ZZZ Game Settings Resolution Limit, by @shatyuka 
- **[Fix]** Invalid Encoding while saving ZZZ Game Settings Profile
(GENERAL_DATA.bin), by @shatyuka
- **[Imp]** Localization updates, by localizers 🥳
  - de-DE - German (Progress: 73%)
  - es-419 - Spanish (Latin America)(Progress: 99%)
  - fr-FR - French (Progress: 99%)
  - id-ID - Bahasa Indonesia (Progress: 100%)
  - it-IT - Italian (Progress: 45%)
  - ja-JP - Japanese (Progress: 100%)
  - ko-KR - Korean (Progress: 87%)
  - nl-NL - Dutch (Progress: 99%)
  - pl-PL - Polish (Progress: 56%)
  - pt-BR - Portuguese (Brazil)(Progress: 73%)
  - pt-PT - Portuguese (Portugal)(Progress: 66%)
  - ru-RU - Russian (Progress: 76%)
  - th-TH - Thai (Progress: 95%)
  - uk-UA - Ukranian (Progress: 85%)
  - zh-CN - Chinese Simplified (Progress: 100%)
  - zh-TW - Chinese Traditional (Progress: 61%)

## PR Status :
- Overall Status : Done
- Commits : Done
- Synced to base (Collapse:main) : Yes
- Build status : OK
- Crashing : No
- Bug found caused by PR : -
- ~**[Regression][High Priority]** Game Config's API is not changed
while changing the games (Assignee: @neon-nyan)~ Fixed as per
052cb94

### Templates

<details>
  <summary>Changelog Prefixes</summary>
  
  ```
    **[New]**
    **[Imp]**
    **[Fix]**
    **[Loc]**
    **[Doc]**
  ```

</details>

Author: neon-nyan

.all-contributorsrc

@@ -14,7 +14,7 @@
       "login": "neon-nyan",
       "name": "Kemal Setya Adhi",
       "avatar_url": "https://avatars.githubusercontent.com/u/30566970?v=4",
-      "profile": "https://prophost.ironmaid.xyz",
+      "profile": "https://github.com/neon-nyan",
       "contributions": [
         "code",
         "design",
@@ -208,10 +208,10 @@
       ]
     },
     {
-      "login": "kujou-kju",
-      "name": "kujou",
+      "login": "puyomi2k",
+      "name": "puyomi",
       "avatar_url": "https://avatars.githubusercontent.com/u/23724383?v=4",
-      "profile": "https://github.com/kujou-kju",
+      "profile": "https://github.com/puyomi2k",
       "contributions": [
         "translation"
       ]

.github/workflows/build.yml

@@ -7,7 +7,6 @@ on:
   push:
     branches:
         - 'main'
-        - '1.83.x-staging'
     paths-ignore:
         - '**.md'
         - 'Hi3Helper.Core/Lang/**.json'
@@ -29,12 +28,12 @@ env:
 
 jobs:
   build:
-    runs-on: windows-latest
+    runs-on: windows-2025-vs2026
     strategy:
       matrix:
         configuration: [Debug] # No need to distribute Debug builds
         platform: [x64]
-        framework: [net9.0-windows10.0.26100.0]
+        framework: [net10.0-windows10.0.26100.0]
 
     env:
       Configuration: ${{ matrix.configuration }}
@@ -85,12 +84,12 @@ jobs:
         dotnet build CollapseLauncher -c Publish --verbosity quiet --no-restore
 
   build-nativeaot:
-    runs-on: windows-latest
+    runs-on: windows-2025-vs2026
     strategy:
       matrix:
         configuration: [Debug]
         platform: [x64]
-        framework: [net9.0-windows10.0.26100.0]
+        framework: [net10.0-windows10.0.26100.0]
 
     env:
       Configuration: ${{ matrix.configuration }}

.github/workflows/release-winget.yml

@@ -1,36 +1,63 @@
 name: Publish Stable & Preview builds to WinGet
 on:
   release:
-    types: [released]
+    types: [released, prereleased]
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to publish (e.g. 1.2.3)'
+        required: true
+        type: string
+      channel:
+        description: 'Release channel'
+        required: true
+        type: choice
+        options:
+          - Stable
+          - Preview
+      release-tag:
+        description: 'Release tag to fetch installers from (e.g. CL-1.2.3)'
+        required: true
+        type: string
 jobs:
   determine_channel:
     runs-on: ubuntu-latest
     outputs:
       channel: ${{ steps.check.outputs.channel }}
       version: ${{ steps.check.outputs.version }}
+      release-tag: ${{ steps.check.outputs.release-tag }}
     steps:
       - name: Check Release Name and Extract Version
         id: check
         # Find X.Y.Z version, then check for "Preview" after it for regex
         run: |
-          RELEASE_NAME="${{ github.event.release.name }}"
-          if [[ "$RELEASE_NAME" =~ (\d+\.\d+\.\d+) ]]; then
-            VERSION="${BASH_REMATCH[1]}"
+          if [[ "${{ github.event_name }}" == "workflow_dispatch" ]]; then
+            VERSION="${{ inputs.version }}"
+            CHANNEL="${{ inputs.channel }}"
+            RELEASE_TAG="${{ inputs.release-tag }}"
           else
-            echo "Error: Could not find X.Y.Z version in release name."
-            exit 1
-          fi
+            RELEASE_NAME="${{ github.event.release.name }}"
+            RELEASE_TAG="${{ github.event.release.tag_name }}"
+            if [[ "$RELEASE_NAME" =~ (\d+\.\d+\.\d+) ]]; then
+              VERSION="${BASH_REMATCH[1]}"
+            else
+              echo "Error: Could not find X.Y.Z version in release name."
+              exit 1
+            fi
 
-          if [[ "$RELEASE_NAME" == *"Preview"* ]]; then
-            CHANNEL="Preview"
-          else
-            CHANNEL="Stable"
+            if [[ "$RELEASE_NAME" == *"Preview"* ]]; then
+              CHANNEL="Preview"
+            else
+              CHANNEL="Stable"
+            fi
           fi
 
           echo "Detected Channel: $CHANNEL"
           echo "Detected Version: $VERSION"
+          echo "Detected Release Tag: $RELEASE_TAG"
           echo "channel=$CHANNEL" >> $GITHUB_OUTPUT
           echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "release-tag=$RELEASE_TAG" >> $GITHUB_OUTPUT
   
   publish_stable:
     needs: determine_channel
@@ -42,6 +69,7 @@ jobs:
         with:
           identifier: CollapseLauncher.Collapse
           version: ${{ needs.determine_channel.outputs.version }}
+          release-tag: ${{ needs.determine_channel.outputs.release-tag }}
           installers-regex: '\.exe$'
           token: ${{ secrets.WINGET_TOKEN }}
 
@@ -55,5 +83,6 @@ jobs:
         with:
           identifier: CollapseLauncher.Collapse.Preview
           version: ${{ needs.determine_channel.outputs.version }}
+          release-tag: ${{ needs.determine_channel.outputs.release-tag }}
           installers-regex: '\.exe$'
           token: ${{ secrets.WINGET_TOKEN }}

.gitignore

@@ -4,8 +4,15 @@
 .vs/*
 *.user
 packages/*
+msbuild.binlog
 
 CollapseLauncher/Deps/*
+CollapseLauncher/StaticLib/buildScript/waifu2x-ncnn-vulkan
+CollapseLauncher/StaticLib/buildScript/zlib
+CollapseLauncher/StaticLib/buildScript/zstd
+CollapseLauncher/StaticLib/buildScript/dav1d
+CollapseLauncher/StaticLib/buildScript/llvm-project
+CollapseLauncher/StaticLib/buildScript/lib*
 CollapseLauncher/StaticLib/*.lib
 CollapseLauncher/StaticLib/**/*.lib
 CollapseLauncher/StaticLib/*.pdb

ClearCache.bat

@@ -1,33 +1,31 @@
 @echo off
-echo 	Clearing Collapse cache
+echo     Clearing Collapse cache
 rmdir /S /Q CollapseLauncher\bin && rmdir /S /Q CollapseLauncher\obj
-echo 	Clearing ColorThief cache
+echo     Clearing ColorThief cache
 rmdir /S /Q ColorThief\ColorThief\bin && rmdir /S /Q ColorThief\ColorThief\obj
-echo 	Clearing CommunityToolkit.ImageCropper cache
+echo     Clearing CommunityToolkit.ImageCropper cache
 rmdir /S /Q Hi3Helper.CommunityToolkit\ImageCropper\bin && rmdir /S /Q Hi3Helper.CommunityToolkit\ImageCropper\obj
-echo 	Clearing CommunityToolkit.SettingsControls cache
+echo     Clearing CommunityToolkit.SettingsControls cache
 rmdir /S /Q Hi3Helper.CommunityToolkit\SettingsControls\bin && rmdir /S /Q Hi3Helper.CommunityToolkit\SettingsControls\obj
-echo 	Clearing Core cache
+echo     Clearing Core cache
 rmdir /S /Q Hi3Helper.Core\bin && rmdir /S /Q Hi3Helper.Core\obj
-echo 	Clearing EncTool cache
+echo     Clearing EncTool cache
 rmdir /S /Q Hi3Helper.EncTool\bin && rmdir /S /Q Hi3Helper.EncTool\obj
-echo 	Clearing EncTool tester cache
-rmdir /S /Q Hi3Helper.EncTool.Test\bin && rmdir /S /Q Hi3Helper.EncTool.Test\obj
-echo 	Clearing Http cache
+echo     Clearing Http cache
 rmdir /S /Q Hi3Helper.Http\bin && rmdir /S /Q Hi3Helper.Http\obj
-echo 	Clearing Http tester cache
-rmdir /S /Q Hi3Helper.Http\Test\bin && rmdir /S /Q Hi3Helper.Http\Test\obj
-echo 	Clearing TaskScheduler cache
+echo     Clearing TaskScheduler cache
 rmdir /S /Q Hi3Helper.TaskScheduler\bin && rmdir /S /Q Hi3Helper.TaskScheduler\obj
-echo 	Clearing HDiff cache
-rmdir /S /Q Hi3Helper.SharpHDiffPatch\Hi3Helper.SharpHDiffPatch\bin && rmdir /S /Q Hi3Helper.SharpHDiffPatch\Hi3Helper.SharpHDiffPatch\obj
-echo 	Clearing 2nd HDiff cache
-rmdir /S /Q Hi3Helper.SharpHDiffPatch\SharpHDiffPatch\bin && rmdir /S /Q Hi3Helper.SharpHDiffPatch\SharpHDiffPatch\obj
-echo 	Clearing InnoSetupHelper cache
+echo     Clearing InnoSetupHelper cache
 rmdir /S /Q InnoSetupHelper\bin && rmdir /S /Q InnoSetupHelper\obj
-echo 	Clearing ImageEx cache
+echo     Clearing ImageEx cache
 rmdir /S /Q ImageEx\ImageEx\bin && rmdir /S /Q ImageEx\ImageEx\obj
-echo 	Clearing 7z cache
-rmdir /S /Q Hi3Helper.Core\Classes\Data\Tools\SevenZipTool\SevenZipExtractor\SevenZipExtractor\bin && rmdir /S /Q Hi3Helper.Core\Classes\Data\Tools\SevenZipTool\SevenZipExtractor\SevenZipExtractor\obj
-echo 	Clearing SharpDiscordRPC cache
-rmdir /S /Q Hi3Helper.SharpDiscordRPC\DiscordRPC\bin && rmdir /S /Q Hi3Helper.SharpDiscordRPC\DiscordRPC\obj
+echo     Clearing 7z cache
+rmdir /S /Q SevenZipExtractor\SevenZipExtractor\bin && rmdir /S /Q SevenZipExtractor\SevenZipExtractor\obj
+echo     Clearing SharpDiscordRPC cache
+rmdir /S /Q Hi3Helper.SharpDiscordRPC\DiscordRPC\bin && rmdir /S /Q Hi3Helper.SharpDiscordRPC\DiscordRPC\obj
+echo     Clearing Hi3Helper.SourceGen cache
+rmdir /S /Q Hi3Helper.SourceGen\bin && rmdir /S /Q Hi3Helper.SourceGen\obj
+echo     Clearing Hi3Helper.LocaleSourceGen cache
+rmdir /S /Q Hi3Helper.LocaleSourceGen\bin && rmdir /S /Q Hi3Helper.LocaleSourceGen\obj
+echo     Clearing Hi3Helper.Plugin.Core cache
+rmdir /S /Q Hi3Helper.Plugin.Core\bin && rmdir /S /Q Hi3Helper.Plugin.Core\obj

CollapseLauncher.slnx

@@ -50,6 +50,9 @@
     <BuildType Solution="Publish|*" Project="Release" />
     <Platform Project="x64" />
   </Project>
+  <Project Path="Hi3Helper.LocaleSourceGen/Hi3Helper.LocaleSourceGen.csproj">
+    <Platform Project="x64" />
+  </Project>
   <Project Path="Hi3Helper.Plugin.Core/Hi3Helper.Plugin.Core.csproj">
     <BuildType Solution="Publish|*" Project="Release" />
     <Platform Project="x64" />
@@ -66,6 +69,9 @@
     <BuildType Solution="Publish|*" Project="Release" />
     <Platform Project="x64" />
   </Project>
+  <Project Path="Hi3Helper.SourceGen/Hi3Helper.SourceGen.csproj">
+    <BuildType Solution="Publish|*" Project="Release" />
+  </Project>
   <Project Path="Hi3Helper.TaskScheduler/Hi3Helper.TaskScheduler.csproj">
     <BuildType Solution="Publish|*" Project="Release" />
     <Platform Project="x64" />
@@ -90,4 +96,10 @@
     <BuildType Solution="Publish|*" Project="Release" />
     <Platform Project="x64" />
   </Project>
+  <Project Path="TLFixer/TLFixer.csproj" Id="5b59dd8f-24ee-4bec-91db-1e95b51f46a7">
+    <BuildType Solution="Publish|*" Project="Release" />
+    <Platform Project="x64" />
+    <Build Solution="Publish|*" Project="false" />
+    <Build Solution="Release|*" Project="false" />
+  </Project>
 </Solution>