Skip to content

mxve/plutonium-updater.rs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

87 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Plutonium Updater CLI alt text alt text

Features

  • Multi-platform
  • Option to automatically create backups
  • Install older versions from plutonium-archive.getserve.rs

Usage

  • Download the latest release
    • Linux
      • https://github.com/mxve/plutonium-updater.rs/releases/latest/download/plutonium-updater-x86_64-unknown-linux-gnu.tar.gz
    • Windows
      • https://github.com/mxve/plutonium-updater.rs/releases/latest/download/plutonium-updater-x86_64-pc-windows-msvc.zip
    • MacOS (untested)
      • https://github.com/mxve/plutonium-updater.rs/releases/latest/download/plutonium-updater-x86_64-apple-darwin.tar.gz
  • Unpack archive
  • Run it
    • Preferably from a terminal so you can see the output and append the arguments listed below, if needed.
    • Linux
      • Unpack
        • tar xfv plutonium-updater-x86_64-unknown-linux-gnu.tar.gz
      • Make binary executable
        • chmod +x plutonium-updater
      • Run it
        • ./plutonium-updater
    • Windows
      • Unpack
      • Run it

Examples

Windows update .bat
@echo off
set installDir=C:\your_pluto_directory
plutonium-updater.exe -d "%installDir%"
Linux update .sh
#!/bin/bash
INSTALLDIR=/home/pluto/pluto_dir
./plutonium-updater -d "$INSTALLDIR"
Repair files
./plutonium-updater.exe -f

or

./plutonium-updater.exe -fd "pluto directory"

Arguments

  • -h, --help
    • Show available arguments
  • -V, --version
    • Print plutonium-updater version
  • -d, --directory <path>
    • Install directory, supports relative and absolute paths
    • Default: "plutonium"
  • -f, --force
    • Force file hash re-check even if version matches
  • -l, --launcher
    • Download launcher assets.
  • -q, --quiet
    • Hide file actions (Checked, Skipped, Downloaded)
  • -s, --silent
    • Hide all non-error output
  • -c, --check
    • Compares local version to remote
      • Exit code 0 for up to date
      • Exit code 1 for outdated
  • --version-local
    • Returns local version number, not found/broken = 0
  • --version-cdn
    • Returns latest version number
  • --no-color
    • Disable colors
  • --archive-list | --plutools-list
    • List revisions archived on plutonium-archive.getserve.rs
  • --archive <revision> | --plutools
    • Install revision archived on plutonium-archive.getserve.rs
    • Downgrading is not recommended, use an empty directory instead. If downgrading use -f.
  • --backup
    • Create backup of current version while updating
  • --manual-backup
    • Create/update backup of current version
  • --backup-list
    • List available backups
  • --backup-restore <backup>
    • Restore backed up version
  • --cdn-url
    • Override cdn url
  • -e, --exclude "file|folder
    • Exclude file or folder from update
    • Can be used multiple times
    • Example: -e "games/t6mp.exe" -e "storage"

Exit codes

  • 0 success
  • 101 error (rust panic) (Just fail on everything that differs from 0 if you are scripting it)

Building

  1. Install the rust toolchain
  2. Clone the repo
  3. Build
    • cargo build --release
  4. (Linux/Optional) Strip binary
    • strip target/release/plutonium-updater
  5. Grab binary from target/release/plutonium-updater(.exe)