Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/CollapseLauncher/Collapse/llms.txt

Use this file to discover all available pages before exploring further.

​
Prerequisites

Before building, install the following tools:
ToolVersionNotes
Visual Studio 2022 or JetBrains RiderLatestAny edition. Include .NET desktop development workload in VS.
Windows SDK10.0.26100.0 onlyInstall via Visual Studio Installer
.NET SDK10.0.2xx (GA)Configured in global.json — use rollForward: latestPatch
You must use exactly Windows SDK 10.0.26100.0. Other SDK versions will cause build failures. Install it through the Visual Studio Installer’s “Individual components” tab.

​
Clone the repository

Collapse uses Git submodules extensively. Always clone with --recurse: 
git clone https://github.com/CollapseLauncher/Collapse --recurse
If you already cloned without --recurse, initialize submodules manually: 
git submodule update --init --recursive

​
Build configurations

There are three build configurations, each using a different publish profile:
Used for local development and CI canary builds. Produces a JIT-compiled binary — faster to build, easier to debug.
dotnet publish CollapseLauncher -c Debug -p:PublishProfile=Publish-DebugCIRelease
The target framework is net10.0-windows10.0.26100.0 (x64 only). Release builds use NativeAOT for smaller, faster executables — but NativeAOT compilation takes significantly longer than a standard JIT build.

​
Opening in your IDE

Open CollapseLauncher.sln (or CollapseLauncher.slnx for the new solution format) in Visual Studio 2022 or JetBrains Rider. Set the startup project to CollapseLauncher.

​
Project structure

The solution contains the main app and several helper library projects: 
CollapseLauncher.sln
├── CollapseLauncher/          # Main WinUI 3 application (your primary working directory)
├── Hi3Helper.Core/            # Shared core: logger, locale JSON, preset classes
├── Hi3Helper.Http/            # Multi-session HTTP download library
├── Hi3Helper.Sophon/          # Sophon chunked differential download engine
├── Hi3Helper.EncTool/         # Encryption and hashing utilities
├── Hi3Helper.Win32/           # Win32 P/Invoke wrappers
├── Hi3Helper.Plugin.Core/     # Plugin SDK and COM interface definitions
├── Hi3Helper.SharpDiscordRPC/ # Discord Rich Presence (forked)
└── ...                        # Additional helpers and submodules

​
Troubleshooting builds

Open Visual Studio Installer → Modify your VS 2022 installation → Individual components → search for Windows SDK 10.0.26100.0 and install it.
Run git submodule update --init --recursive from the repository root.
NativeAOT requires the Desktop development with C++ workload in Visual Studio (for the MSVC linker). Install it via Visual Studio Installer.
Check the global.json at the repo root — it pins the SDK to 10.0.200 with latestPatch rollForward. Run dotnet --version to confirm your installed SDK matches.

Build docs developers (and LLMs) love

Get started for freeTalk to us