RustRaptor/docs/github-releases.md

Downloadable releases

Current release: v1.0.0 — Linux and Windows.

Artwork note: 5,743 of 5,753 original pictures have approved HD remasters. Ten retain original-art fallback; v1.0.0 does not claim complete HD coverage.

The GitHub release provides playable Linux x86_64 and Windows x86_64 packages. Cargo, Python, the old engine and a Git checkout are unnecessary for play.

The approved HD artwork makes the shared data larger than GitHub's 2 GiB limit per release asset. Each platform ZIP therefore contains the executable, platform libraries, all 45 mods with SD/HD artwork and audio, and the source/docs. Shared data ZIPs contain the complete unchanged original catalog, approved HD pack, briefings and the runtime manifest's other data files. Extracting them together produces one self-contained RustRaptor folder. A single ZIP is only part of the download.

Install

Download Install-Windows.ps1 or Install-Linux.sh from the release. Review it, then run it in a directory without an existing RustRaptor folder. It downloads your platform ZIP and every shared data ZIP, checks each archive and every extracted payload against the versioned release-manifest.json (and publishes SHA256SUMS for manual verification), and extracts them into the same destination. Downloads are processed one at a time. Linux needs Bash and Python 3.8 or later for this optional installer; Windows uses built-in Windows PowerShell 5.1 and .NET. The Windows helper uses explicit extended paths to retain long accepted proof filenames without an admin policy change. A failed install preserves its partial folder for inspection; move or remove that folder before retrying. All archives reject unexpected paths, links and file collisions.

powershell -NoProfile -ExecutionPolicy Bypass -File .\Install-Windows.ps1

bash ./Install-Linux.sh

For manual installation:

1. Download one platform ZIP: RustRaptor-windows-x86_64.zip or RustRaptor-linux-x86_64.zip.
2. Download every RustRaptor-data-NN-of-TT.zip and SHA256SUMS from the same release. Do not mix snapshots.
3. Verify the downloaded hashes. On Windows use Get-FileHash -Algorithm SHA256; on Linux use sha256sum. Compare them with SHA256SUMS.
4. Extract every downloaded ZIP into the same parent directory. Every ZIP starts with RustRaptor/; do not make a different subfolder for each ZIP.
5. Start RustRaptor/run.cmd on Windows or RustRaptor/run.sh on Linux.

Keep enough storage for the installed folder plus one data ZIP during install. The release notes state the exact installed/download sizes. Your pilots and settings stay in the separate RaptorReplica user profile directories.

Maintainer export

Export only a clean, fully committed final tested commit with current Linux and Windows manifests. The exporter does not build, refresh the runtime, change manifests or upload.

python3 tools/export_release.py plan --package . \
  --expected-commit FULL_TESTED_COMMIT --output /tmp/release-plan.json
python3 tools/export_release.py archive --plan /tmp/release-plan.json \
  --asset RustRaptor-data-01-of-07.zip \
  --output /tmp/RustRaptor-data-01-of-07.zip \
  --receipt /path/to/receipts/RustRaptor-data-01-of-07.zip.json

Use the actual volume count in the plan. Each asset is under 1.5 GB before ZIP overhead, is checked against every planned source SHA-256 while writing, and passes whole-archive CRC validation before a receipt is produced. The exporter retains Linux execute permissions. The exporter inventories selected source files without following symlinks and rejects non-regular members. It preserves every physical runtime-data file, including directories named derived; proof/lineage files already present in the runtime manifest remain included.

Create a draft release at the exact tested tag. Write, verify and upload one archive at a time, record its remote size/digest, then remove only that disposable export copy before producing the next. Keep receipts. After all assets exist:

python3 tools/export_release.py checksums --plan /tmp/release-plan.json \
  --receipts /path/to/receipts --output /tmp/SHA256SUMS \
  --manifest-output /tmp/release-manifest.json --tag v1.0.0

Upload the versioned release manifest, checksum list and installers, check complete remote membership, and publish the draft only after all checks pass. Native Windows CI and local representative rendering/audio evidence retain their actual commit and scope; archive integrity checks do not imply a fresh full playthrough.

Hosted export

The manually dispatched Upload frozen release to existing draft workflow accepts the exact tested 40-character commit, existing version tag, empty draft release ID and expected prerelease flag. For v1.0.0 select false for prerelease. The publishing controller is checked out separately from the immutable game checkpoint. Every source and remote release identity is checked, all archives are verified, and the frozen plan and receipts are retained as an Actions artifact. The job leaves the draft unpublished for final review.

The older preview workflow retains its fixed 20 October checkpoint and cannot modify its already-published release. Neither workflow publishes automatically.