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.

Collapse Launcher stores its application configuration in an INI file at: 
%USERPROFILE%\AppData\LocalLow\CollapseLauncher\config.ini
Most settings are managed through the Settings page in the launcher UI, which writes back to this file automatically. You do not need to edit the file directly under normal circumstances.

​
Appearance

Controls the color scheme of the launcher UI. Stored as the ThemeMode key.
ValueDescription
DefaultFollows the Windows system theme (dark or light).
DarkForces dark mode regardless of system setting.
LightForces light mode regardless of system setting.
A launcher restart is required after changing the theme.
Stored as EnableAcrylicEffect (boolean, default: true). Enables the translucent acrylic blur backdrop on the launcher window. Disabling this can improve performance on low-end GPUs.
When UseCustomBG is true, the launcher uses the file path stored in CustomBGPath as its background instead of the game-provided image.Supported formats are shown in the background customizer note in Settings. Video backgrounds are also supported; enable IsUseVideoBGDynamicColorUpdate to let the UI accent color update dynamically from video frames.
Stored as GlobalIsBackgroundParallaxEffectEnabled (boolean, default: false). When enabled, the background shifts slightly as you move the window. The pixel shift amount is controlled by GlobalBackgroundParallaxPixelShift (default: 8).
Stored as WindowSizeProfile (default: Normal). Available profiles are listed in the Settings page. Changing this resizes the launcher window and adjusts internal layout widths.

​
Language

Stored as AppLanguage (default: en-us). The value is the locale ID of the selected language (for example, ja-jp or zh-cn). See the Localization page for the full list of supported languages and locale IDs.
A launcher restart is required after changing the language.

​
Behavior on game launch

Stored as GameLaunchedBehavior. Controls what Collapse does when you start a game.
ValueDescription
Minimize (default)Minimizes the launcher window.
ToTrayHides the launcher to the system tray.
NothingLeaves the launcher window as-is.
MinimizeToTray (boolean, default: false) — when enabled, minimizing the window sends it to the system tray instead of the taskbar. LowerCollapsePrioOnGameLaunch (boolean, default: false) — lowers Collapse’s process priority while a game is running so the game can use more CPU resources.

​
Startup behavior

IsIntroEnabled (boolean, default: true) — shows the animated intro sequence when the launcher starts. EnableMultipleInstance (boolean, default: false) — allows more than one instance of Collapse to run at the same time. To launch Collapse automatically with Windows, enable Launch on Startup in Settings. This registers a scheduled task via the Windows Task Scheduler. You can also enable Start to Tray alongside it so the window starts hidden.

​
Download settings

Stored as DownloadThread (integer, default: 4). Sets how many parallel HTTP connections are used when downloading game files using the legacy downloader.
Stored as ExtractionThread (integer, default: 0). Sets how many threads are used during archive extraction. A value of 0 uses all available logical processors.
Sophon is Collapse’s modern download engine used for game installation and updates on supported titles.
KeyDefaultDescription
IsEnableSophontrueEnables the Sophon download engine where supported.
SophonCpuThread0CPU threads for Sophon operations. 0 uses all available cores.
SophonHttpConnInt0Number of HTTP connections for Sophon. 0 uses the engine default.
SophonPreloadApplyPerfModefalseUses performance mode when applying a preloaded update.
IsUsePreallocatedDownloader (boolean, default: true) — preallocates disk space for the full download before writing begins, which can improve throughput on HDDs and reduce fragmentation.IsBurstDownloadModeEnabled (boolean, default: true) — allows short bursts above the configured speed limit. Only active when the preallocated downloader is enabled.
Speed limiting and burst mode controls are disabled when the preallocated downloader is turned off.
Stored as DownloadChunkSize (bytes, default: 64 MiB). Controls the size of each file chunk split during download. Clamped between 32 MiB and 512 MiB.
Stored as UseDownloadChunksMerging (boolean, default: false). When the preallocated downloader is disabled, this merges downloaded chunks into the final file after completion. Only applicable with the legacy downloader.
Stored as EnforceToUse7zipOnExtract (boolean, default: false). Forces the launcher to use 7-Zip for all archive extraction instead of the built-in extractor.

​
Speed limiter

The speed limiter throttles the total download throughput across all active download operations (game downloads, updates, repairs, and cache updates). It is implemented in SpeedLimiterService via a native throttle library (Hi3Helper.Throttle.dll). The service uses a token-bucket algorithm, with a burst allowance of 2× the configured limit. To configure it in Settings:
1

Open Settings

Click the gear icon in the bottom-left corner of the launcher.
2

Go to Network settings

Scroll to the Network Settings section.
3

Enable the speed limiter

Toggle Limit Download Speed on. This sets IsUseDownloadSpeedLimiter to true.
4

Set the limit

Enter the desired speed in MiB/s. This value is stored as DownloadSpeedLimit in bytes (e.g., 10 MiB/s is stored as 10485760).
The speed limiter requires the preallocated downloader to be enabled. Disabling the preallocated downloader will also disable the speed limiter and burst mode.

​
CDN selection

Collapse distributes launcher metadata and update packages through multiple CDN providers. The selected CDN is stored as CurrentCDN (integer index, default: 0).
IndexProviderNotes
0CloudflarePartial download (range requests) supported.
1DigitalOceanPartial download supported. Mirror of the main repo.
2GitHubPartial download supported. Official main repository.
3GitLabMirror of the official repository.
4CNBMirror of the official repository.
During the first-time setup (OOBE), the launcher automatically measures latency to each CDN and recommends the fastest one. If your selected CDN fails, the launcher automatically falls back to the next available CDN and updates CurrentCDN to the one that succeeded.
If you are in mainland China, CNB may provide lower latency than GitHub or Cloudflare.

​
Network settings

KeyDefaultDescription
IsUseProxyfalseEnables the HTTP proxy for all launcher network requests.
HttpProxyUrl(empty)Proxy URL. Supports http, https, socks4, socks4a, and socks5 schemes.
HttpProxyUsername(empty)Optional proxy authentication username.
HttpProxyPassword(empty)Optional proxy password. Stored encrypted using Windows DPAPI.
IsAllowHttpRedirectionstrueAllows HTTP redirects when making requests.
IsAllowHttpCookiesfalseAllows cookies in HTTP requests.
IsAllowUntrustedCertfalseBypasses TLS certificate validation. Not recommended.
HttpClientTimeout90Timeout in seconds for HTTP requests.
KeyDefaultDescription
IsUseExternalDnsfalseEnables a custom DNS resolver for all launcher requests.
ExternalDnsAddresses(empty)DNS server addresses and connection type, separated by a pipe character (|).
DNS connection types include plain UDP/TCP, DNS-over-HTTPS (DoH), and DNS-over-TLS (DoT). Enter the addresses and connection type in the Custom DNS panel in Settings and click Apply and Test to validate.
KeyDefaultDescription
IsCDNCacheEnabledfalseEnables local caching of CDN responses.
IsCDNCacheAggressiveModeEnabledfalseEnables aggressive caching, retaining more responses locally.
CDNCacheDir(empty)Cache directory path. Defaults to <GameFolder>/_cdnCache.
CDNCacheExpireTimeMinutes10How long cached responses are considered valid, in minutes.

​
Discord Rich Presence

KeyDefaultDescription
EnableDiscordRPCfalseEnables Discord Rich Presence integration.
EnableDiscordGameStatustrueShows current game and region in the Discord status.
EnableDiscordIdleStatustrueShows an idle status when no game is running.

​
Per-game preset configuration

Each game and region has a PresetConfig stored in the launcher’s metadata. This is read-only from the user’s perspective — it defines game-specific properties such as:
  • Game type — Honkai, Genshin, StarRail, Zenless (or Plugin)
  • Vendor — miHoYo or Cognosphere
  • Launcher type — HoYoPlay (modern) or Legacy/Sophon
  • Server region — one of os_usa, os_euro, os_asia, os_cht, cn_gf01, cn_qd01
  • Game channel — Stable, Beta, or DevRelease
These values are loaded from the metadata CDN and determine which features (repair, cache update, game settings, etc.) are available for a given game region. You do not configure these directly; they are updated automatically when the launcher fetches fresh metadata.

​
Plugin folder

Plugins are loaded from <GameFolder>/_plugins. The path is derived from GameFolder in the config and is not separately configurable. Plugin auto-update can be controlled with IsEnablePluginAutoUpdate (boolean, default: true).

Build docs developers (and LLMs) love

Get started for freeTalk to us