#!/bin/bash VERSION="0.2.1" # --- Globals --- RED='\033[0;31m' GREEN='\033[0;32m' ORANGE='\033[0;33m' NC='\033[0m' H2PATH="${HOME}/.config/h2mm/h2path" MODS_DIR="" DB_FILE="" LAST_CHECKED_UPDATE_FILE="${HOME}/.config/h2mm/last_update" VERSION_URL="https://raw.githubusercontent.com/v4n00/h2mm-cli/refs/heads/master/version" REPO_URL="https://github.com/v4n00/h2mm-cli" # --- Utility Functions --- function get_filename_without_path() { echo $(echo "$1" | awk -F/ '{print $NF}') } function get_basename() { echo $(get_filename_without_path "$1" | sed -E 's/\.+.*//') } function get_extension() { echo $(get_filename_without_path "$1" | sed -E 's/.*patch_[0-9]+//') } function get_files_by_entry_from_db() { echo $(echo "$1" | cut -d',' -f4- | tr ',' ' ' | head -1) } function get_mod_name_and_index() { if [[ -n "$mod_index" ]]; then # if mod index exists entry=$(grep "^${mod_index}," "$DB_FILE") mod_name=$(echo "$entry" | awk -F, '{print $3}') elif [[ -n "$mod_name" ]]; then # if mod name exists entry=$(grep -i ",$mod_name," "$DB_FILE") mod_index=$(echo "$entry" | awk -F, '{print $1}' | head -1) fi if [[ -z "$entry" || -z "$mod_index" || -z "$mod_name" ]]; then echo -e "${RED}Error${NC}: Mod not found." >&2 exit 1 fi status=$(echo "$entry" | awk -F, '{print $2}') } function find_game_directory() { local search_dir="${HOME}" local target_dir="Steam/steamapps/common/Helldivers\ 2/data" # check if path is saved if [[ -f "$H2PATH" ]]; then saved_dir=$(cat "$H2PATH") if [[ -d "$saved_dir" ]]; then echo "$saved_dir" return else echo "Saved game directory is invalid." fi fi # first time setup, or directory is not valid anymore echo "Searching for the Helldivers 2 data directory..." >&2 game_dir=$(find "$search_dir" -type d -path "*/$target_dir" 2>/dev/null | head -n 1) if [[ -z "$game_dir" ]]; then echo "Could not find the Helldivers 2 data directory automatically." >&2 read -p "Please enter the path to the Helldivers 2 data directory: " game_dir game_dir=$(eval echo "$game_dir") if [[ ! -d "$game_dir" ]]; then echo -e "${RED}Error${NC}: Provided path is not a valid directory." >&2 exit 1 fi fi mkdir -p "$(dirname "$H2PATH")" echo "$game_dir" > "$H2PATH" if [[ $? -eq 0 ]]; then echo -e "Game directory ${GREEN}saved${NC}: $game_dir" >&2 else echo -e "${RED}Error${NC}: Could not save game directory." >&2 exit 1 fi echo "$game_dir" } function initialize_directories() { MODS_DIR=$(find_game_directory) DB_FILE="$MODS_DIR/mods.csv" if [[ ! -f "$DB_FILE" ]]; then touch "$DB_FILE" if [[ $? -eq 0 ]]; then echo -e "Database file ${GREEN}created${NC}: $DB_FILE" else echo -e "${RED}Error${NC}: Could not create database file." >&2 exit 1 fi fi } # --- Help Functions --- function display_help() { echo "Helldivers 2 Mod Manager v${VERSION}" echo "Usage: h2mm [command] [options]" echo "Commands:" echo " install Install a mod with files." echo " uninstall Uninstall a mod by name." echo " list List all installed mods." echo " enable Enable a mod by name." echo " disable Disable a mod by name." echo " export Export installed mods to a zip file." echo " import Import mods from a zip file." echo " reset Reset all installed mods." echo " help Display this help message." echo "For more information on usage, use h2mm [command] --help, available for install and uninstall." echo "Basic Usage:" echo " h2mm install /path/to/mod.zip" echo " h2mm install /path/to/mod/files" echo " h2mm uninstall \"Example mod\"" } function display_install_help() { echo "Usage: h2mm install [options] " echo "Short form: h2mm i" echo "Options:" echo " -n \"\" Name the mod yourself, inside double quotes." echo " Multiple mod files, accepts wildcards." echo " Directory containing mod files." echo " Zip file containing mod files." echo "Usage:" echo " h2mm install /path/to/mod.zip" echo " h2mm install /path/to/mod/files" echo " h2mm install -n \"Example mod\" mod.patch_0 mod.patch_0.stream # -n is mandatory when using files" echo " h2mm install -n \"Example mod\" mod* # using a wildcard to include all files" echo "If the mod has more than 1 variant, you need to install the one you want by unarchiving it separately." } function display_uninstall_help() { echo "Usage: h2mm uninstall [options] \"\"" echo "Short form: h2mm u" echo "Options:" echo " -i Index of the mod to uninstall." echo "Usage:" echo " h2mm uninstall \"Example mod\"" echo " h2mm uninstall -i 1 # uninstall mod with index 1" } function display_enable_help() { echo "Usage: h2mm enable [options] \"\"" echo "Short form: h2mm e" echo "Options:" echo " -i Index of the mod to enable." echo "Usage:" echo " h2mm enable \"Example mod\"" echo " h2mm enable -i 1 # enable mod with index 1" } function display_disable_help() { echo "Usage: h2mm disable [options] \"\"" echo "Short form: h2mm d" echo "Options:" echo " -i Index of the mod to disable." echo "Usage:" echo " h2mm disable \"Example mod\"" echo " h2mm disable -i 1 # disable mod with index 1" } function display_list_help() { echo "Usage: h2mm list" echo "Short form: h2mm l" echo "List all installed mods." echo "Database of mods is stored in Steam/steamapps/common/Helldivers\ 2/data/mods.csv" echo "You can rename, delete, or edit this file to manage mods manually." } function display_reset_help() { echo "Usage: h2mm reset" echo "Short form: h2mm r" echo "Reset all installed mods." echo "Deletes all installed mods and the database file." echo "Database of mods is stored in Steam/steamapps/common/Helldivers\ 2/data/mods.csv, along with the mods." } function display_export_help() { echo "Usage: h2mm export" echo "Short form: h2mm ex" echo "Export installed mods and database to a zip file." } function display_import_help() { echo "Usage: h2mm import" echo "Short form: h2mm im" echo "Import mods and database from a zip file (coming from h2mm)." } # --- Main Functions --- # Check for updates function check_for_updates() { if [[ -f "$LAST_CHECKED_UPDATE_FILE" ]]; then last_update=$(cat "$LAST_CHECKED_UPDATE_FILE") if [[ $(date +%Y-%m-%d) -gt $(date +%Y-%m-%d -d "$last_update + 7 days") ]]; then return fi else echo $(date +%Y-%m-%d) > "$LAST_CHECKED_UPDATE_FILE" exit 0 fi latest_version=$(curl -sS "$VERSION_URL") if [[ $? -ne 0 ]]; then echo "${RED}Error:${NC} Could not check for updates." >&2 return fi if [[ "$latest_version" != "$VERSION" ]]; then echo -e "${RED}!${NC} A new version of h2mm is available: ${ORANGE}$VERSION${NC} -> ${GREEN}$latest_version${NC}" >&2 echo -e "${RED}!${NC} You can download it from: $REPO_URL" >&2 fi echo $(date +%Y-%m-%d) > "$LAST_CHECKED_UPDATE_FILE" } # Mod management function mod_disable() { local mod_name="" local mod_index="" [[ $# -eq 0 ]] && { display_disable_help; exit 0; } # parse arguments while [[ $# -gt 0 ]]; do case "$1" in -i) mod_index="$2"; shift 2 ;; --help|-h) display_disable_help; exit 0 ;; *) mod_name="$1"; shift 1 ;; esac done if [[ -z "$mod_name" && -z "$mod_index" ]]; then echo -e "${RED}Error${NC}: Mod name or index is required to disable." >&2 exit 1 fi # find mod files get_mod_name_and_index "$mod_name" "$mod_index" if [[ "$status" == "DISABLED" ]]; then echo -e "${RED}Error${NC}: Mod $mod_name is already disabled." >&2 exit 1 fi # disable each mod file by adding disabled_ to the start of the filename files=$(get_files_by_entry_from_db "$entry") for file in $files; do if [[ ! -f "$MODS_DIR/$file" ]]; then echo -e "${RED}Error${NC}: Mod file $file does not exist." >&2 exit 1 else disabled_file="disabled_$file" mv "$MODS_DIR/$file" "$MODS_DIR/$disabled_file" echo -e "Disabled ${ORANGE}$file${NC} (changed to ${GREEN}\$MODS_DIR/$disabled_file${NC})." >&2 fi done # update the database sed -i "/^$mod_index,/s/ENABLED/DISABLED/" "$DB_FILE" if [[ $? -eq 0 ]]; then echo -e "Mod $mod_name ${ORANGE}disabled${NC} successfully." >&2 else echo -e "${RED}Error${NC}: Failed to disable mod." >&2 exit 1 fi } function mod_enable() { local mod_name="" local mod_index="" [[ $# -eq 0 ]] && { display_enable_help; exit 0; } # parse arguments while [[ $# -gt 0 ]]; do case "$1" in -i) mod_index="$2"; shift 2 ;; --help|-h) display_enable_help; exit 0 ;; *) mod_name="$1"; shift 1 ;; esac done [[ -z "$mod_name" && -z "$mod_index" ]] && { echo -e "${RED}Error${NC}: Mod name or index is required to enable." >&2; exit 1; } # find mod files get_mod_name_and_index "$mod_name" "$mod_index" [[ "$status" == "ENABLED" ]] && { echo -e "${RED}Error${NC}: Mod $mod_name is already enabled." >&2; exit 1; } files=$(get_files_by_entry_from_db "$entry") # enable each mod file by removing disabled_ from the start of the filename for file in $files; do disabled_file="disabled_$file" # check if the files exists [[ -f "$MODS_DIR/$disabled_file" ]] || { echo -e "${RED}Error${NC}: Mod file $file does not exist." >&2; exit 1; } mv "$MODS_DIR/$disabled_file" "$MODS_DIR/$file" # check if the file was moved successfully [[ $? -ne 0 ]] && { echo -e "${RED}Error${NC}: Could not enable mod file $disabled_file." >&2; exit 1; } echo -e "Enabled ${ORANGE}$disabled_file${NC} (changed to ${GREEN}\$MODS_DIR/$file${NC})." >&2 done # update the database sed -i "/^$mod_index,/s/DISABLED/ENABLED/" "$DB_FILE" if [[ $? -eq 0 ]]; then echo -e "Mod $mod_name ${GREEN}enabled${NC} successfully." >&2 else echo -e "${RED}Error${NC}: Failed to enable mod." >&2 exit 1 fi } function mod_reset() { if [[ "$1" == "--help" || "$1" == "-h" ]]; then display_reset_help exit 0 fi read -p "Are you sure you want to reset all installed mods? (Y/n): " confirm if [[ "$confirm" == "y" || "$confirm" == "Y" || "$confirm" = "" ]]; then rm -f "$MODS_DIR"/*.patch_* rm -f "$DB_FILE" rm -f "$H2PATH" echo "Mods and database file deleted." else echo "Reset cancelled." >&2 exit 1 fi } function mod_install() { local mod_name="" local mod_dir="" local mod_files=() [[ $# -eq 0 ]] && { display_install_help; exit 0; } # parse arguments while [[ $# -gt 0 ]]; do case "$1" in -n) mod_name="$2"; shift 2 ;; --help|-h) display_install_help; exit 0 ;; *) if [[ -f "$1" && "$1" == *.zip ]]; then mod_zip="$1" elif [[ -d "$1" ]]; then mod_dir="$1" else mod_files+=("$1") fi shift ;; esac done # zip file containing mod files if [[ -n "$mod_zip" ]]; then command -v unzip &> /dev/null || { echo -e "${RED}Error${NC}: unzip package is not installed." >&2; exit 1; } [[ ! -f "$mod_zip" ]] && { echo -e "${RED}Error${NC}: Zip file $mod_zip does not exist." >&2; exit 1; } # check if mod name was provided, otherwise use the zip file name, get rid of .zip and version numbers if [[ -z "$mod_name" ]]; then mod_name=$(basename "$mod_zip" | sed -E 's/\.zip//' | awk -F/ '{print $NF}' | sed -E 's/-[0-9]+-.*//') fi mod_dir=$(mktemp -d) unzip -qq "$mod_zip" -d "$mod_dir" fi # directory containing mod files if [[ -n "$mod_dir" ]]; then # verify directory exists [[ ! -d "$mod_dir" ]] && { echo -e "${RED}Error${NC}: Directory $mod_dir does not exist." >&2; exit 1; } readarray -d '' mod_files < <(find "$mod_dir" -type f -name "*.patch_*" -print0) if [[ -z "$mod_name" ]]; then mod_name=$(echo "$mod_dir" | sed 's:/*$::' | awk -F/ '{print $NF}' | sed -E 's/-[0-9]+-.*//') fi fi # verify minimum information required [[ -z "$mod_name" || ${#mod_files[@]} -eq 0 ]] && { echo -e "${RED}Error${NC}: Mod name and files are required." >&2; exit 1; } # verify mod files exist and is not directory for file in "${mod_files[@]}"; do if [[ ! -f "$file" ]]; then # if it isn't a file, check if it's a directory [[ ! -d "$file" ]] && { echo -e "${RED}Error${NC}: File $file does not exist." >&2; exit 1; } mod_files=(${mod_files[@]/$file}) fi done # hash table - in case multiple named files are needed for 1 mod install, store the patch count declare -A patch_count # store the target files so we can put them in the database later target_files=() # sort the mod files because with the below logic, the .stream and .gpu_resources files need to come after their respective patch files IFS=$'\n' mod_files=($(printf "%s\n" "${mod_files[@]}" | sort -t. -k1,1 -k2,2n)); unset IFS for file in "${mod_files[@]}"; do base_name=$(get_basename "$file") patch_prefix="$MODS_DIR/${base_name}.patch_" count=$(ls "${patch_prefix}"* 2>/dev/null | grep -E '([0-9]+$)' 2>/dev/null | wc -l) # count installed patches # set patch count for file name if [[ -z "${patch_count[$file]+unset}" ]]; then patch_count["$file"]=$count fi patch_count["$base_name"]=$count # if the file has an extension, look for the last patch number and use that extension=$(get_extension "$file") if [[ -n "$extension" ]]; then target_file="${base_name}.patch_$((patch_count[$base_name] - 1))${extension}" else target_file="${base_name}.patch_${patch_count[$file]}" fi target_files+=($target_file) cp "$file" "$MODS_DIR/$target_file" # verify installation worked [[ $? -ne 0 ]] && { echo -e "${RED}Error${NC}: Could not install mod file $file." >&2; exit 1; } echo -e "Mod file ${ORANGE}$file${NC} installed at ${GREEN}\$MODS_DIR/$target_file${NC}." >&2 done # add entry to database next_id=$(awk -F, 'END {print $1 + 1}' "$DB_FILE") echo "$next_id,ENABLED,$mod_name,${target_files[*]}" >> "$DB_FILE" echo -e "Mod $mod_name ($base_name) ${GREEN}installed${NC} successfully." >&2 } function mod_uninstall() { local mod_name="" local mod_index="" [[ $# -eq 0 ]] && { display_uninstall_help; exit 0; } # parse arguments while [[ $# -gt 0 ]]; do case "$1" in -i) mod_index="$2"; shift 2 ;; --help|-h) display_uninstall_help; exit 0 ;; *) mod_name="$1"; shift 1 ;; esac done if [[ -z "$mod_name" && -z "$mod_index" ]]; then echo -e "${RED}Error${NC}: Mod name or index is required to uninstall." >&2 exit 1 fi # find mod files get_mod_name_and_index "$mod_name" "$mod_index" # delete mod files files=$(get_files_by_entry_from_db "$entry") echo "$files" declare -A downgrades for file in $files; do if [[ ! -f "$MODS_DIR/$file" ]]; then echo -e "${RED}Error${NC}: Mod file $file does not exist." >&2 exit 1 else echo -e "Removing ${ORANGE}\$MODS_DIR/$file${NC}." >&2 rm "$MODS_DIR/$file" if [[ $? -ne 0 ]]; then echo -e "${RED}Error${NC}: Could not remove mod file $file." >&2 exit 1 fi base_name=$(get_basename "$file") current_version=$(echo $file | grep -oP '(?<=patch_)\d+') downgrades["$base_name"]=$current_version fi done # downgrade any necessary mods for file in "${!downgrades[@]}"; do # find all files that have the same base name, and are greater than the current version, and downgrade them base_name=$(get_basename "$file") same_patches=$(ls "$MODS_DIR/${base_name}.patch_"* 2>/dev/null) for patch in $same_patches; do patch=$(get_filename_without_path "$patch") patch_version=$(echo $patch | grep -oP '(?<=patch_)\d+') if [[ $patch_version -gt ${downgrades[$file]} ]]; then new_version=$((patch_version - downgrades[$base_name] - 1)) extension=$(get_extension "$path") new_patch="${base_name}.patch_${new_version}${extension}" mv "$MODS_DIR/$patch" "$MODS_DIR/$new_patch" echo -e "Downgraded ${ORANGE}$patch${NC} to ${GREEN}\$MODS_DIR/$new_patch${NC}." >&2 # save changes in database as well sed -i "s/$patch/$new_patch/" "$DB_FILE" fi done done # remove entry from database sed -i "/^$mod_index/d" "$DB_FILE" echo -e "Mod $mod_name ${ORANGE}uninstalled${NC} successfully." >&2 } function mod_list() { if [[ "$1" == "--help" || "$1" == "-h" ]]; then display_list_help exit 0 fi if [[ ! -s "$DB_FILE" ]]; then echo "No mods installed." return fi echo "Installed mods:" >&2 awk -v GREEN="$GREEN" -v RED="$RED" -v NC="$NC" -F, '{ color = ($2 == "DISABLED") ? RED : GREEN; if (length($4) > 150) $4 = substr($4, 1, 147) "..."; printf "%2s. [%s%s%s] %s (%s)\n", $1, color, $2, NC, $3, $4}' "$DB_FILE" } function mod_export() { if [[ "$1" == "--help" || "$1" == "-h" ]]; then display_export_help exit 0 fi echo -ne "Archive file will be saved in the current directory ($(pwd)). Continue? (Y/n): " read -r confirm if [[ "$confirm" == "y" || "$confirm" == "Y" || "$confirm" = "" ]]; then OUT_DIR=$(mktemp -d) MODS_EXPORT_DIR="$OUT_DIR/Helldivers 2 Mods" mkdir -p "$MODS_EXPORT_DIR" cp "$DB_FILE" "$MODS_EXPORT_DIR" for file in $(ls "$MODS_DIR/" 2>/dev/null | grep -E 'patch_.*'); do cp "$MODS_DIR/$file" "$MODS_EXPORT_DIR" done if [[ $? -ne 0 ]]; then echo -e "${RED}Error${NC}: Could not export mods. Possibly because no mods are present." >&2 exit 1 fi current_path=$(pwd) archive_name="Helldivers_2_Mods_$(date +%Y-%m-%d_%H-%M-%S).tar.gz" tar -czf "$current_path/$archive_name" -C "$OUT_DIR" "Helldivers 2 Mods" if [[ $? -eq 0 ]]; then echo -e "Mods exported to ${GREEN}$current_path/$archive_name${NC}." >&2 else echo -e "${RED}Error${NC}: Failed to export mods." >&2 fi fi } function mod_import() { if [[ "$1" == "--help" || "$1" == "-h" ]]; then display_import_help exit 0 fi if [[ ! -f "$1" ]]; then echo -e "${RED}Error${NC}: File $1 does not exist." >&2 exit 1 fi echo -e "Importing mods will ${RED}reset${NC} your mods." >&2 mod_reset if [[ $? -eq 1 ]]; then exit 1 fi OUT_DIR=$(mktemp -d) tar -xzf "$1" -C "$OUT_DIR" if [[ $? -ne 0 ]]; then echo -e "${RED}Error${NC}: Could not import mods. Possibly because the zip file is invalid." >&2 exit 1 fi MODS_EXPORT_DIR="$OUT_DIR/Helldivers 2 Mods" if [[ ! -d "$MODS_EXPORT_DIR" ]]; then echo -e "${RED}Error${NC}: Could not import mods. Possibly because the zip file is invalid." >&2 exit 1 fi # copy mods verbosely cp -v "$MODS_EXPORT_DIR"/* "$MODS_DIR" if [[ $? -eq 0 ]]; then echo -e "Mods imported ${GREEN}successfully${NC}." >&2 else echo -e "${RED}Error${NC}: Failed to import mods." >&2 fi } # --- Main --- function main() { if [[ $# -lt 1 ]]; then display_help exit 1 fi command="$1" shift initialize_directories check_for_updates case "$command" in install|i) mod_install "$@" ;; list|l) mod_list "$@" ;; uninstall|u) mod_uninstall "$@" ;; enable|e) mod_enable "$@" ;; disable|d) mod_disable "$@" ;; export|ex) mod_export "$@" ;; import|im) mod_import "$@" ;; reset|r) mod_reset "$@" ;; version|v|-v|--version) echo "${VERSION}" ;; help|--help|-h|h) display_help ;; *) display_help ;; esac } main "$@"