alterware-launcher/README.md

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
  • 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 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
)