https://github.com/viktorholk/arma3-mod-manager-console
⚙️ An Arma 3 Mod Manager Console for Linux & MacOS. Easily enable, disable, and manage Steam Workshop mods and CDLCs without the official launcher.
https://github.com/viktorholk/arma3-mod-manager-console
apple-silicon arma arma3 console dlc expansion expansions linux mac mod mod-manager terminal tool
Last synced: 4 months ago
JSON representation
⚙️ An Arma 3 Mod Manager Console for Linux & MacOS. Easily enable, disable, and manage Steam Workshop mods and CDLCs without the official launcher.
- Host: GitHub
- URL: https://github.com/viktorholk/arma3-mod-manager-console
- Owner: viktorholk
- License: mit
- Created: 2024-08-18T12:28:02.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-03-05T21:13:28.000Z (over 1 year ago)
- Last Synced: 2025-04-02T12:23:52.556Z (about 1 year ago)
- Topics: apple-silicon, arma, arma3, console, dlc, expansion, expansions, linux, mac, mod, mod-manager, terminal, tool
- Language: Rust
- Homepage:
- Size: 72.3 KB
- Stars: 6
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Arma 3 Mod Manager Console
A lightweight terminal-based mod manager for Arma 3 on **Linux** and **macOS**.
Enable, disable, and launch mods without the official launcher.
[](LICENSE)
[](https://github.com/viktorholk/arma3-mod-manager-console/releases/latest)
[Website](https://viktorholk.github.io/arma3-mod-manager-console) · [Download](https://github.com/viktorholk/arma3-mod-manager-console/releases/latest) · [Issues](https://github.com/viktorholk/arma3-mod-manager-console/issues)
## Features
- **Mod toggling** — enable/disable mods with a keypress
- **Mod presets** — save and switch named mod loadouts
- **Dependency checking** — detect missing mod dependencies
- **Direct launch** — start Arma 3 from the manager
- **Setup wizard** — guided first-run configuration
- **CDLC support** — manage Creator DLC alongside mods
- **Custom mods** — load offline mods from a local folder
## Requirements
- Arma 3 installed via Steam
- Rust & Cargo (if building from source)
## Installation
### Pre-built binary
Download the latest release for your platform from [releases](https://github.com/viktorholk/arma3-mod-manager-console/releases/latest):
| Platform | File |
|---|---|
| macOS Apple Silicon (M1+) | `arma3-mod-manager-console-*-aarch64-apple-darwin-release.zip` |
| macOS Intel | `arma3-mod-manager-console-*-x86_64-apple-darwin-release.zip` |
| Linux x86_64 | `arma3-mod-manager-console-*-x86_64-unknown-linux-gnu-release.zip` |
| Linux ARM | `arma3-mod-manager-console-*-aarch64-unknown-linux-gnu-release.zip` |
Unzip, make executable (`chmod +x arma3-mod-manager-console`), and run.
macOS security warning
On macOS, you may be greeted with a security warning.
Go to **Settings > Privacy & Security > Security** and press **Open Anyway**.
### Build from source
```sh
git clone https://github.com/viktorholk/arma3-mod-manager-console.git
cd arma3-mod-manager-console
cargo run --release
```
## Usage
### Controls
| Action | Keys |
|---|---|
| Navigate | `W` `S` / `K` `J` / `↑` `↓` |
| Toggle mod | `Space` |
| Cycle presets | `Tab` / `Shift+Tab` |
| Preset manager | `T` |
| Launch Arma 3 | `P` |
| Search | `/` |
| Check dependencies | `D` |
| Quit | `Q` |
### Presets
Presets let you save named mod selections and switch between them without manually toggling mods each time. Useful for different game modes (milsim, antistasi, casual, etc.).
Existing configs are automatically migrated — your current mod selection becomes the "Default" preset.
## Configuration
The config file is located at:
```
~/.config/arma3-mod-launcher-console/config.json
```
```json
{
"game_path": "/path/to/Steam/steamapps/common/Arma 3",
"workshop_path": "/path/to/Steam/steamapps/workshop/content/107410",
"custom_mods_path": "/path/to/custom-mods",
"executable_name": "arma3",
"enabled_mods": [],
"default_args": "-noSplash -skipIntro -world=empty",
"presets": {
"Default": []
},
"active_preset": "Default"
}
```
If the application cannot resolve the correct paths, you can edit them here. The `executable_name` field allows you to specify a different Arma 3 executable name:
- On macOS: without the `.app` extension (e.g., `arma3`)
- On Linux: the actual executable name (e.g., `arma3_x64`)
### Custom mods
Place your mods in the custom mods folder. The folder is created alongside the config file.
## Troubleshooting
### InvalidPath error
If you see `Error: InvalidPath(...)` on startup, the Steam paths in your config are incorrect.
1. Open the config file (see above)
2. Set `game_path` and `workshop_path` to the correct Steam directories:
- macOS: `~/Library/Application Support/Steam/steamapps/...`
- Linux: `~/.local/share/Steam/steamapps/...`
3. Save and rerun
### Mod compatibility
Not all Arma 3 mods work on macOS or Linux. Mods that require Windows .DLL files (ACE, TFAR/ACRE, Blastcore, etc.) are not compatible. Most content mods (maps, units, vehicles) work fine.
## License
[MIT](LICENSE)