alterware-launcher's Introduction

AlterWare Launcher

AlterWare.dev

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

Installation

Download the latest alterware-launcher.exe
Place alterware-launcher.exe in the game directory
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
- Pass additional arguments to the game
  - See client-args.md
--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 on Windows it will restart by spawning a new console. If you are automating this process, you should probably use --skip-launcher-update and download the latest launcher yourself from here.

The linux build does not update itself.

Recommend Projects