Skip to content

Simplify your Arma 3 mod management. B.I.M.M lets you extract mod lists and combine presets quickly and easily.

License

Notifications You must be signed in to change notification settings

MBarkerUK/B.I.M.M

Repository files navigation

Bohemia Interactive Mod Manager (B.I.M.M)

Shell Script Security Last Commit Codacy Security Scan

This repository is regularly scanned for security vulnerabilities using GitHub Actions, ensuring code quality and safety. The build status indicates the current state of the automated tests, and the last update badge shows recent development activity.

B.I.M.M (Bohemia Interactive Mod Manager) is a command-line utility designed to streamline the management of Arma 3 mod presets. It provides functionality to extract mod lists from preset files and merge multiple presets into a single, unified file

Features

  • Mod List Extraction: Quickly generate a list of mods from an Arma 3 preset HTML file, facilitating easy inspection and configuration.
  • Preset Merging: Combine multiple Arma 3 preset files into a consolidated file, simplifying the management of complex mod configurations.

Usage

Mod List Extraction

Linux/macOS

./BIMM-Extract.sh

Windows

.\BIMM-Extract.ps1
Detailed Explanation

This command extracts mod names from a given Arma 3 preset HTML file.

  1. File Selection: A file selection dialog will appear, prompting you to choose the desired preset HTML file.

  2. Mod Name Extraction: The script parses the HTML file, identifying and extracting the mod names.

  3. Output: The extracted mod list is saved to ModList.txt in the current working directory. The file contains a single line with mod names delimited by ;@, suitable for direct use in configuration files.

Preset Merging

Linux/macOS

./BIMM-Merge.sh

Windows

.\BIMM-Merge.ps1
Detailed Explanation

This command merges two Arma 3 preset HTML files.

  1. File Selection: You will be prompted to select two preset HTML files.

  2. Template Utilization: The script uses a template file (Arma 3 Preset Default.html) to ensure proper formatting of the merged output.

  3. Mod List Extraction & Combination: The script extracts the mod lists from the selected files and combines them.

  4. Template Population: The combined mod list is inserted into the designated section of the template.

  5. Output: The merged preset is saved as Arma 3 Preset Merged.html in the current working directory.

Installation

Download: Download the B.I.M.M scripts from here. Make Executable (Linux/macOS): For the Bash scripts, execute the following command:

chmod +x BIMM-Extract.sh BIMM-Merge.sh

Dependencies

  • Linux/macOS: zenity, grep, cut, sed, tr, cat (Typically pre-installed on most distributions.)
  • Windows: PowerShell (Pre-installed on Windows).

Releases

Contributing

Contributions are welcome! Please submit pull requests or open issues.

License

This project is licensed under the GNU General Public License v3.0.