alterware-launcher/README.md

2.3 KiB

AlterWare Launcher

AlterWare.dev

IW4x | IW4-SP | IW5-Mod | IW6-Mod | S1-Mod

Installation

  1. Download the latest alterware-launcher.exe
  2. Place alterware-launcher.exe in the game directory
  3. Run alterware-launcher.exe, after updating the game will launch automatically

Command line arguments

  • iw4-sp, iw4x, iw5-mod, iw6-mod, s1-mod
    • Skip automatic detection and launch the specified game
      • This should always be the first argument if used
  • --update, -u
    • Only update the game, don't launch it
  • --skip-launcher-update
    • Don't update the launcher
  • --bonus
    • Download bonus content
  • --force, -f
    • Force file hash recheck
  • --path, -p
    • Set the game path
      • Do not include a trailing backslash in the path
  • --pass
  • --version, -v
    • Print the launcher version

Example: alterware-launcher.exe iw4x --bonus -u --path "C:\Games\IW4x" --pass "-console"

Some arguments can be set in alterware-launcher.json, args generally override the values of the config.


Config file

alterware-launcher.json

  • update_only
    • See --update
    • Default: false
  • skip_self_update
    • See --skip-launcher-update
    • Default: false
  • download_bonus_content
    • See --bonus
    • Default: false
  • ask_bonus_content
    • Ask the user if they want to download bonus content
    • Default: true; false after asking
  • force_update
    • See --force
    • Default: false
  • args
    • See --pass
    • Default: ""

Support

Visit the AlterWare Forum or Discord for support.


Building from Source

  • Install Rust
  • Clone the repository
  • Run cargo build --release
  • The executable will be located in target/release

Note for server owners:

When the launcher updates itself it needs to be restarted. It will return exit code 201 in this case.

@echo off
:loop
start /wait alterware-launcher.exe --update
if %errorlevel% equ 201 (
    goto loop
)