hazre.ResoniteDownloader 1.1.1

ResoniteDownloader

A .NET tool to download and manage Resonite game files via Steam.

Features

• Download and update Resonite game files via Steam's depot system
• Target specific versions or manifest IDs for precise build control
• Automatic version detection from the resonite-version-monitor versions file
• Support for public and protected branches
• Outputs version metadata for CI/CD workflows

Prerequisites

• .NET 10 SDK
• DepotDownloader must be available in your PATH.

Installation

Install as a global .NET tool:

dotnet tool install --global hazre.ResoniteDownloader

Usage

Download Game Files

Download Resonite files to a specific directory.

resonitedownloader download --game-dir "/path/to/resonite" --steam-user "username" --steam-pass "password"

Download with Manifest ID (bypasses version lookup):

resonitedownloader download --game-dir "/path/to/resonite" --steam-user "username" --steam-pass "password" --manifest-id 1234567890

Options:

Note: When using --manifest-id, the actual version will be determined from Build.version after download. You can optionally provide both --version and --manifest-id if you already know them.

Resolve Version

Check what the latest version is for a specific branch without downloading.

resonitedownloader resolve-version --branch headless

Resolve Version from Manifest ID (downloads only Build.version):

resonitedownloader resolve-version --manifest-id 1234567890 --steam-user "username" --steam-pass "password"

For protected branches:

resonitedownloader resolve-version --manifest-id 1234567890 --steam-user "username" --steam-pass "password" --beta-pass "headlesspass" --branch headless

Options:

Note: When using --manifest-id, the tool downloads only Build.version using a filelist to efficiently resolve the version number.

GitHub Actions Integration

This tool outputs version, build-id, and manifest-id to the GitHub Actions output environment if available.

- name: Download Resonite
  id: resonite
  run: resonitedownloader download -d ./game -u ${{ secrets.STEAM_USER }} -p ${{ secrets.STEAM_PASS }}

- name: Use Version
  run: |
    echo "Installed version: ${{ steps.resonite.outputs.version }}"
    echo "Build ID: ${{ steps.resonite.outputs.build-id }}"
    echo "Manifest ID: ${{ steps.resonite.outputs.manifest-id }}"

- name: Resolve Version from Manifest
  id: resolve
  run: resonitedownloader resolve-version -m 1234567890 -u ${{ secrets.STEAM_USER }} -p ${{ secrets.STEAM_PASS }}

- name: Use Resolved Version
  run: echo "Version for manifest: ${{ steps.resolve.outputs.version }}"

Examples

Download latest public version

resonitedownloader download -d ./game -u myuser -p mypass

Download latest headless version

resonitedownloader download -d ./game -u myuser -p mypass -b headlesspass --branch headless

Download specific version

resonitedownloader download -d ./game -u myuser -p mypass -v 2024.1.28.1342

Download specific manifest

resonitedownloader download -d ./game -u myuser -p mypass -m 1234567890

Download specific version and manifest together

resonitedownloader download -d ./game -u myuser -p mypass -v 2024.1.28.1342 -m 1234567890

Check latest version without downloading

resonitedownloader resolve-version

Resolve version from manifest ID

resonitedownloader resolve-version -m 1234567890 -u myuser -p mypass

License

This project is licensed under the MIT License - see the LICENSE file for details.