95 lines
3.2 KiB
Markdown
95 lines
3.2 KiB
Markdown
# AlterWare Launcher
|
|
|
|
### [AlterWare.dev](https://alterware.dev)
|
|
|
|
##### IW4x | IW4-SP | IW5-Mod | IW6-Mod | S1-Mod
|
|
|
|
  
|
|
|
|
---
|
|
|
|
## Installation
|
|
|
|
1. Download the game from [Steam](https://store.steampowered.com/)
|
|
2. Download the [latest alterware-launcher.exe](https://github.com/mxve/alterware-launcher/releases/latest/download/alterware-launcher.exe)
|
|
3. Place alterware-launcher.exe in the game directory
|
|
4. 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](client-args.md)
|
|
- ```--version```, ```-v```
|
|
- Print the launcher version
|
|
- ```--ignore-required-files```
|
|
- Install client even if required files are missing
|
|
|
|
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: ""
|
|
- ```use_https```
|
|
- Use HTTPS for downloads
|
|
- Default: false
|
|
|
|
---
|
|
|
|
#### Support
|
|
|
|
Visit the [AlterWare Forum](https://forum.alterware.dev/) or [Discord](https://discord.gg/2ETE8engZM) for support.
|
|
|
|
---
|
|
|
|
#### Building from Source
|
|
|
|
- [Install Rust](https://rustup.rs/)
|
|
- 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](https://github.com/mxve/alterware-launcher/releases/latest/download/alterware-launcher.exe).
|
|
|
|
The linux build does __not__ update itself. |