h2mm-cli/README.md

Helldivers 2 Mod Manager CLI

• Helldivers 2 Mod Manager CLI
  • Installation
  • Usage
    • Available commands
    • Basic usage
      • Install a mod
      • Uninstall a mod
      • List installed mods
  • Advanced usage
    • Shortcuts
    • Exporting and importing
    • Resetting all installed mods
    • Database location and details
  • Contributing
  • Planned features

Helldivers 2 Mod Manager CLI is a command line interface for managing Helldivers 2 mods. Since there is no mod manager GUI for Helldivers 2 on Linux yet, this small script aims to provide a simple way to manage mods on Linux.

Installation

To install/update Helldivers 2 Mod Manager CLI run the following command in your terminal:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/v4n00/h2mm-cli/refs/heads/master/install.sh)"

Running this script will require sudo permissions. DO NOT TRUST random scripts from the internet. If you want to review the script before running it, check out the mod repository for yourself.

Usage

The script gets added to /usr/local/bin/h2mm and can be used by running h2mm in your shell, which will show the help message explaining how to use the script.

h2mm

Available commands

• install - Install a mod with files
• uninstall - Uninstall a mod by name
• list - List all installed mods
• export <zip_name> - Export installed mods to a zip file
• import <zip_name> - Import mods from a zip file
• reset - Reset all installed mods
• help - Display the help message

Basic usage

Install a mod

h2mm install /path/to/mod.zip
h2mm install /path/to/mod/files
h2mm install -n "Example mod" mod.patch_0 mod.patch_0.stream # -n is mandatory when using files
h2mm install -n "Example mod" mod* # using a wildcard to include all files

Important: If the mod has more than 1 variant, you need to install the one you want by unarchiving it separately.

Uninstall a mod

h2mm uninstall "Example mod"
h2mm uninstall -i 1 # uninstall mod with index 1

List installed mods

h2mm list

Advanced usage

Shortcuts

You can use the short form of the commands to save some time. The shortcuts are:

• i for install
• u for uninstall
• l for list
• ex for export
• im for import
• r for reset

Exporting and importing

You can export all installed mods to a zip file and import mods from the same file. This can be useful for sharing mods with others or for backing up your mods. The zip file will be saved in the current directory.

h2mm export modpack1.zip
h2mm import modpack2.zip

Resetting all installed mods

You can reset all installed mods by running the following command. This will remove all installed mods and the database, in case things go wild.

h2mm reset

Database location and details

The database is stored in the Helldivers 2 install directory, under the data folder with the name mods.csv, where the mods are also installed. The database is a simple CSV file which you can use to manually manage mods if needed, you can mostly use it to rename or reorder mods.

Contributing

Feel free to contribute to this project by creating a pull request or opening an issue.

Planned features

• ! Enable/disable mods
• ! Provide fixes for breaking updates
• ! Auto update mods
• !! Easier way to change mod presets
• !! Change to .tar.xz for exporting and importing
• !!! Find a way to make use of manifest.json and simplify installing variants