Skip to content
Version 2.32.0
↓ Get the launcher

DownloadRequest record

A download a plugin asks for: one https file or zip, verified, placed under the plugin’s own data folder (IPluginDownloads.DataFolder — the same folder IPluginDataStore uses).

public record DownloadRequest
name description
DownloadRequest(…) A download a plugin asks for: one https file or zip, verified, placed under the plugin’s own data folder (IPluginDownloads.DataFolder — the same folder IPluginDataStore uses).
ExtractZip { get; set; } True: the download is a zip, extracted into TargetPath. False: the bytes are written as one file at TargetPath.
IncludePrefixes { get; set; } Zip only: extract only entries whose path starts with one of these prefixes (null = every entry). The prefix is KEPT in the output path: with ["Shaders/"] and target "packs/std", the entry Shaders/Bloom.fx lands at packs/std/Shaders/Bloom.fx; Textures/x.png is skipped.
MaxBytes { get; set; } Upper bound on the downloaded (for a zip: compressed) bytes. The whole download is held in memory until it is verified, so keep this to what you actually need.
Sha256 { get; set; } The expected SHA-256 of the downloaded bytes: 64 hex characters, compared case-insensitively. Checked before anything is written; a mismatch writes nothing.
TargetPath { get; set; } Relative to the plugin’s data folder, “/”-separated, and never escaping it. For a plain download it is the destination FILE path (e.g. "reshade/ReShade64.dll"); for a zip it is the destination FOLDER. A zip download REPLACES that whole folder (atomically), so keep any other files of yours elsewhere.
Url { get; set; } Absolute https URL. Anything else is refused.