Compare commits
46 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| cb71852068 | |||
| 26031c0381 | |||
| 9c73be1cb7 | |||
| a8e94c19fb | |||
| 6b968172ea | |||
| b3bc91522f | |||
| a7936c90bd | |||
| 4d1af7e4a0 | |||
| 0eff8afe6b | |||
| 3593e32a7b | |||
| 797739ea7a | |||
| df006a7430 | |||
| 344e4348d4 | |||
| 719217d00b | |||
| b1930811f9 | |||
| d1ca18b563 | |||
| 5d91190dbf | |||
| 28122ee332 | |||
| 56bb73784e | |||
| 0d8f22a2d0 | |||
| 3c6238f8d2 | |||
| a031230117 | |||
| 77ae53ffa7 | |||
| c23c57e16c | |||
| 898400e526 | |||
| c45f5860d8 | |||
| 838c834cc2 | |||
| 7b8b2fda8f | |||
| 0485b56df5 | |||
| d18a9cdccf | |||
| c74f4a8a00 | |||
| 9f592e7ce2 | |||
| 21b1822006 | |||
| dbcc7d1e96 | |||
| 09c40aa25f | |||
| 1a01034816 | |||
| 83e2161456 | |||
| a2b904caa2 | |||
| 9f622ca130 | |||
| 0ab273977e | |||
| 388afe69b7 | |||
| 3f0305c741 | |||
| 1a6a13a621 | |||
| 23cb0646bf | |||
| 6768cab391 | |||
| 35902f1f8f |
@@ -0,0 +1,6 @@
|
||||
[*]
|
||||
indent_style = tab
|
||||
indent_size = 4
|
||||
end_of_line = lf
|
||||
insert_final_newline = true
|
||||
trim_trailing_whitespace = true
|
||||
@@ -3,3 +3,4 @@
|
||||
!install.sh
|
||||
!README.md
|
||||
!version
|
||||
!.editorconfig
|
||||
|
||||
@@ -4,9 +4,9 @@ Helldivers 2 Mod Manager CLI is a command line interface for managing Helldivers
|
||||
|
||||
This script is complete, the version will always [remain at 0.x.x](https://0ver.org/)
|
||||
|
||||
## Installation and updating
|
||||
## Installation
|
||||
|
||||
To install/update Helldivers 2 Mod Manager CLI run the following command in your terminal:
|
||||
To install Helldivers 2 Mod Manager CLI run the following command in your terminal:
|
||||
|
||||
```bash
|
||||
bash -c "$(curl -fsSL https://raw.githubusercontent.com/v4n00/h2mm-cli/refs/heads/master/install.sh)"
|
||||
@@ -16,7 +16,8 @@ bash -c "$(curl -fsSL https://raw.githubusercontent.com/v4n00/h2mm-cli/refs/head
|
||||
> 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.
|
||||
|
||||
If for some reason, the installation command doesn't work you can:
|
||||
1. Go to https://raw.githubusercontent.com/v4n00/h2mm-cli/refs/heads/master/install.sh
|
||||
|
||||
1. Go to <https://raw.githubusercontent.com/v4n00/h2mm-cli/refs/heads/master/install.sh>
|
||||
1. Right click -> Save page as...
|
||||
1. Go to your downloads folders `cd ~/Downloads`
|
||||
1. Give the script execution permissions `chmod +x install.sh`
|
||||
@@ -33,23 +34,27 @@ h2mm
|
||||
### Available commands
|
||||
|
||||
- `install` - Install a mod by the file provided (directory, zip, patch).
|
||||
- `uninstall` - Uninstall a mod by name (or index).
|
||||
- `uninstall` - Uninstall a mod.
|
||||
- `list` - List all installed mods.
|
||||
- `enable` - Enable a mod by name (or index).
|
||||
- `disable` - Disable a mod by name (or index).
|
||||
- `enable` - Enable a mod.
|
||||
- `disable` - Disable a mod.
|
||||
- `export` - Export installed mods to a zip file.
|
||||
- `import` - Import mods from a zip file.
|
||||
- `order` - Change load order for a mod.
|
||||
- `modpack-create` - Create a modpack from the currently installed mods.
|
||||
- `modpack-switch` - Switch to a modpack by name (or index).
|
||||
- `modpack-switch` - Switch to a modpack.
|
||||
- `modpack-list` - List all installed modpacks.
|
||||
- `modpack-delete` - Delete a modpack by name (or index).
|
||||
- `modpack-overwrite` - Overwrite a modpack by name (or index).
|
||||
- `modpack-delete` - Delete a modpack.
|
||||
- `modpack-overwrite` - Overwrite a modpack.
|
||||
- `modpack-reset` - Reset all installed modpacks.
|
||||
- `update` - Update h2mm to latest version.
|
||||
- `reset` - Reset all installed mods.
|
||||
- `help` - Display this help message.
|
||||
|
||||
### Basic usage
|
||||
|
||||
To find out how to use a command, you can run `h2mm <COMMAND> --help`.
|
||||
|
||||
#### Install mod(s)
|
||||
|
||||
```bash
|
||||
@@ -60,23 +65,20 @@ h2mm install -n "Example mod" mod.patch_0 mod.patch_0.stream # -n is mandatory w
|
||||
h2mm install -n "Example mod" mod* # using a wildcard to include all files
|
||||
```
|
||||
|
||||
> [!NOTE]
|
||||
> If the mod has more than 1 variant, you need to install the one you want by unarchiving it separately and providing the directory.
|
||||
|
||||
#### Uninstall a mod
|
||||
|
||||
```bash
|
||||
h2mm uninstall "Example mod"
|
||||
h2mm uninstall -i 1 # uninstall mod with index 1
|
||||
h2mm uninstall -n "Example mod"
|
||||
h2mm uninstall -i 3
|
||||
```
|
||||
|
||||
#### Enable/disable mods
|
||||
|
||||
```bash
|
||||
h2mm enable "Example mod"
|
||||
h2mm enable -i 1 # enable mod with index 1
|
||||
h2mm disable "Example mod"
|
||||
h2mm disable -i 1 # disable mod with index 1
|
||||
h2mm enable -n "Example mod"
|
||||
h2mm enable -i 3
|
||||
h2mm disable -n "Example mod"
|
||||
h2mm disable -i 3
|
||||
```
|
||||
|
||||
#### List installed mods
|
||||
@@ -85,6 +87,12 @@ h2mm disable -i 1 # disable mod with index 1
|
||||
h2mm list
|
||||
```
|
||||
|
||||
#### Updating the script
|
||||
|
||||
```bash
|
||||
h2mm update
|
||||
```
|
||||
|
||||
## Compatibility
|
||||
|
||||
The script is developed and tested on Arch Linux, but it should work on other Linux distributions as well. If you encounter any issues, please open an issue on the repository.
|
||||
@@ -92,7 +100,7 @@ The script is developed and tested on Arch Linux, but it should work on other Li
|
||||
Status of platforms:
|
||||
|
||||
- Linux :white_check_mark:
|
||||
- Steam Deck - untested (should work) :grey_question:
|
||||
- Steam Deck :white_check_mark:
|
||||
- Windows - WSL :white_check_mark:
|
||||
|
||||
> The script works on WSL, but you need to specify the path to the Helldivers 2 mods directory manually, to find your Windows partition head to `/mnt/` and from there go to your Helldivers 2 data directory, on a typical install it should be on `/mnt/c/Program\ Files\ \(x86\)/Steam/steamapps/common/Helldivers\ 2/data`. You also need to have `unzip` installed, which can be done by running `sudo apt install unzip`.
|
||||
@@ -110,12 +118,14 @@ You can use the short form of commands to save some time. The shortcuts are:
|
||||
- `l` for `list`
|
||||
- `ex` for `export`
|
||||
- `im` for `import`
|
||||
- `o` for `order`
|
||||
- `mc` for `modpack-create`
|
||||
- `ms` for `modpack-switch`
|
||||
- `ml` for `modpack-list`
|
||||
- `md` for `modpack-delete`
|
||||
- `mo` for `modpack-overwrite`
|
||||
- `mr` for `modpack-reset`
|
||||
- `up` for `update`
|
||||
- `r` for `reset`
|
||||
|
||||
### Modpacks support
|
||||
@@ -123,10 +133,10 @@ You can use the short form of commands to save some time. The shortcuts are:
|
||||
You can set up modpacks by using the `modpack-*` commands. This allows you to quickly change between a set of mods. For more information, check the help message.
|
||||
|
||||
```bash
|
||||
h2mm modpack-create "Modpack 1"
|
||||
h2mm modpack-create -n "Modpack 1"
|
||||
# install, enable, disable other mods...
|
||||
h2mm modpack-create "Modpack 2"
|
||||
h2mm modpack-switch "Modpack 1"
|
||||
h2mm modpack-create -n "Modpack 2"
|
||||
h2mm modpack-switch -n "Modpack 1"
|
||||
```
|
||||
|
||||
### Exporting and importing
|
||||
@@ -134,8 +144,8 @@ h2mm modpack-switch "Modpack 1"
|
||||
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 archive file (`.tar.gz`) will be saved in the current directory.
|
||||
|
||||
```bash
|
||||
h2mm export modpack1.zip
|
||||
h2mm import modpack2.zip
|
||||
h2mm export
|
||||
h2mm import /path/to/mods.tar.gz
|
||||
```
|
||||
|
||||
### Resetting all installed mods
|
||||
|
||||
+115
-68
@@ -1,4 +1,4 @@
|
||||
#!/bin/bash
|
||||
#!/usr/bin/env bash
|
||||
set -e
|
||||
|
||||
RED='\033[0;31m'
|
||||
@@ -10,120 +10,167 @@ DESTINATION_PATH="/usr/local/bin"
|
||||
SCRIPT_NAME="h2mm"
|
||||
REPO_URL="https://raw.githubusercontent.com/v4n00/h2mm-cli/refs/heads/master"
|
||||
|
||||
if [ "$(id -u)" -eq 0 ]; then
|
||||
echo "Run me as normal user, not as root."
|
||||
exit 1
|
||||
fi
|
||||
function log() {
|
||||
local type="$1"
|
||||
shift
|
||||
case "$type" in
|
||||
INFO)
|
||||
echo -e "$*" >&2
|
||||
;;
|
||||
ERROR)
|
||||
echo -e "${RED}[ERROR]${NC} $*" >&2
|
||||
;;
|
||||
PROMPT)
|
||||
echo -ne "$*" >&2
|
||||
;;
|
||||
esac
|
||||
}
|
||||
|
||||
# --- Main ---
|
||||
|
||||
# Warning
|
||||
# warning
|
||||
|
||||
echo -e "!!! ${RED}WARNING${NC} !!!"
|
||||
echo -e "This script will install Helldivers 2 Mod Manager CLI for Linux to $DESTINATION_PATH/$SCRIPT_NAME."
|
||||
echo -e "Running this script will require sudo permissions. ${RED}DO NOT TRUST${NC} random scripts from the internet."
|
||||
echo -e "If you want to review the script before running it, check out the mod repository for yourself:"
|
||||
echo -e "https://github.com/v4n00/h2mm-cli"
|
||||
echo -e "!!! ${RED}WARNING${NC} !!!"
|
||||
echo
|
||||
cat << EOF
|
||||
!!! WARNING !!!
|
||||
This script will install Helldivers 2 Mod Manager CLI for Linux to $DESTINATION_PATH/$SCRIPT_NAME.
|
||||
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:
|
||||
https://github.com/v4n00/h2mm-cli
|
||||
!!! WARNING !!!
|
||||
|
||||
# Check if update
|
||||
|
||||
# Breaking changes hash table
|
||||
EOF
|
||||
|
||||
# breaking changes hash table
|
||||
breaking_changes_patches=(
|
||||
["2"]='sed -i "s/^\([0-9]\+\),/\1,ENABLED,/" "$1/mods.csv"'
|
||||
["3"]='sed -i "1 i\\3" "$1/mods.csv"'
|
||||
["4"]='awk '\''BEGIN {FS=OFS=","} NR==1 {print 4; next} {print NR-1, $2, $3, $4, $5}'\'' "$1/mods.csv" | tee "$1/mods.csv" > /dev/null'
|
||||
)
|
||||
|
||||
# Handle breaking changes
|
||||
|
||||
# notify if update is happening
|
||||
installed_version=""
|
||||
latest_version=""
|
||||
if [[ -x "$(command -v $SCRIPT_NAME)" ]]; then
|
||||
installed_version=$($SCRIPT_NAME --version)
|
||||
# version 1 show the help message, if the first character is not a 0, store installed version as 0.1.6
|
||||
[[ ${installed_version:0:1} != "0" ]] && { installed_version="0.1.6"; }
|
||||
|
||||
# if installed version isn't x.x.x crash
|
||||
if [[ ! "$installed_version" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
|
||||
log ERROR "Installed version is not in the correct format."
|
||||
log ERROR "h2mm is installed here -> $(which h2mm)"
|
||||
log ERROR "Delete the script file and retry the install script, any mods installed will not be lost."
|
||||
exit 1
|
||||
fi
|
||||
|
||||
latest_version=$(curl -sS "$REPO_URL"/version)
|
||||
if [[ "$latest_version" == "$installed_version" ]]; then
|
||||
echo -e "You are reinstalling version $installed_version."
|
||||
log INFO "You are reinstalling version ${GREEN}$installed_version${NC}."
|
||||
else
|
||||
echo -e "You are upgrading from ${ORANGE}$installed_version${NC} -> ${GREEN}$latest_version${NC}."
|
||||
log INFO "You are upgrading from ${ORANGE}$installed_version${NC} -> ${GREEN}$latest_version${NC}."
|
||||
fi
|
||||
fi
|
||||
|
||||
# split version numbers
|
||||
installed_major=""
|
||||
latest_major=""
|
||||
IFS='.' read -r _1 installed_major _2 <<< "$installed_version"
|
||||
IFS='.' read -r _1 latest_major _2 <<< "$latest_version"
|
||||
# if steam deck, set destination path to ~/.local/bin
|
||||
log PROMPT "Are you installing on a Steam Deck? (y/N): "
|
||||
IFS= read -e response_sd
|
||||
|
||||
if [[ "$response_sd" == "y" || "$response_sd" == "Y" ]]; then
|
||||
# steam deck
|
||||
DESTINATION_PATH="$HOME/.local/bin"
|
||||
mkdir -p "$DESTINATION_PATH"
|
||||
|
||||
# check if ~/.local/bin is in PATH
|
||||
if [[ ":$PATH:" != *":$HOME/.local/bin:"* ]]; then
|
||||
# add ~/.local/bin to PATH
|
||||
log INFO "Installing the script on a Steam Deck means adding $DESTINATION_PATH to your \$PATH."
|
||||
log INFO "If you're using a different shell than bash, you may need to add it manually."
|
||||
|
||||
log PROMPT "Do you want to add $DESTINATION_PATH to your \$PATH in ~/.bashrc? (Y/n): "
|
||||
IFS= read -e response
|
||||
if [[ "$response" == "y" || "$response" = "Y" || -z "$response" ]]; then
|
||||
echo "export PATH=\"\$HOME/.local/bin:\$PATH\"" >> "$HOME/.bashrc"
|
||||
|
||||
[[ $? -ne 0 ]] && { log ERROR "Failed to add $DESTINATION_PATH to \$PATH in ~/.bashrc." ; exit 1; }
|
||||
log INFO "Added $DESTINATION_PATH to your \$PATH in ~/.bashrc."
|
||||
fi
|
||||
fi
|
||||
else
|
||||
# not steam deck
|
||||
# set another path if needed
|
||||
log PROMPT "Install the script to $DESTINATION_PATH or specify another path (must be included in \$PATH)? (Y/path): "
|
||||
IFS= read -e response
|
||||
|
||||
if [[ "$response" != "y" && "$response" != "Y" && -n "$response" ]]; then
|
||||
DESTINATION_PATH="$response"
|
||||
[[ ! -d "$DESTINATION_PATH" ]] && { log ERROR "Path $DESTINATION_PATH does not exist." ; exit 1; }
|
||||
fi
|
||||
fi
|
||||
|
||||
# handle breaking changes
|
||||
installed_major=$(echo "$installed_version" | awk -F. '{print $2}')
|
||||
latest_major=$(echo "$latest_version" | awk -F. '{print $2}')
|
||||
|
||||
if [[ $latest_major -gt $installed_major ]]; then
|
||||
echo -e "${ORANGE}Warning:${NC} Major version upgrade detected."
|
||||
echo "Check out the changelogs here:"
|
||||
echo "https://github.com/v4n00/h2mm-cli/releases"
|
||||
echo "The script will proceed to upgrade ${SCRIPT_NAME} to avoid breaking changes."
|
||||
log INFO ""
|
||||
log INFO "Major version upgrade detected."
|
||||
log INFO "Check out the changelogs here -> https://github.com/v4n00/h2mm-cli/releases"
|
||||
log INFO "The script will proceed to upgrade the database file to avoid breaking changes."
|
||||
|
||||
# find hd2 path
|
||||
search_dir="${HOME}"
|
||||
target_dir="Steam/steamapps/common/Helldivers\ 2/data"
|
||||
echo "Searching for the Helldivers 2 data directory... (20 seconds timeout)" >&2
|
||||
|
||||
# check if game directory is in ~/.config/h2mm/h2path
|
||||
if [[ -f "$HOME/.config/h2mm/h2path" ]]; then
|
||||
game_dir=$(cat "$HOME/.config/h2mm/h2path")
|
||||
[[ ! -d "$game_dir" ]] && { log ERROR "Helldivers 2 data directory in ~/.config/h2mm/h2path is not a valid directory." ; exit 1; }
|
||||
|
||||
log INFO "Helldivers 2 data directory found: $game_dir."
|
||||
else
|
||||
log INFO "Searching for the Helldivers 2 data directory... (20 seconds timeout)"
|
||||
game_dir=$(timeout 20 find "$search_dir" -type d -path "*/$target_dir" 2>/dev/null | head -n 1)
|
||||
fi
|
||||
|
||||
# if not found, prompt user
|
||||
if [[ -z "$game_dir" ]]; then
|
||||
echo "Could not find the Helldivers 2 data directory automatically." >&2
|
||||
IFS= read -ep "Please enter the path to the Helldivers 2 data directory: " game_dir
|
||||
log INFO "Could not find the Helldivers 2 data directory automatically."
|
||||
log PROMPT "Please enter the path to the Helldivers 2 data directory: "
|
||||
IFS= read -e game_dir
|
||||
if [[ ! -d "$game_dir" ]]; then
|
||||
echo -e "${RED}Error${NC}: Provided path is not a valid directory." >&2
|
||||
log ERROR "Provided path is not a valid directory."
|
||||
exit 1
|
||||
fi
|
||||
fi
|
||||
|
||||
[[ ! -f "$game_dir/mods.csv" ]] && { echo -e "${RED}Error:${NC} mods.csv not found in $game_dir."; exit 1; }
|
||||
|
||||
# make backup of mods in case something goes wrong
|
||||
echo "Creating a backup of mods.csv."
|
||||
h2mm export
|
||||
[[ ! -f "$game_dir/mods.csv" ]] && { log ERROR "mods.csv not found in $game_dir." ; exit 1; }
|
||||
|
||||
# iterate from installed major number to latest major number
|
||||
for ((i = installed_major + 1; i <= latest_major; i++)); do
|
||||
echo -e "Applying breaking changes patch for version $i."
|
||||
|
||||
if [[ -n "${breaking_changes_patches[$i]}" ]]; then
|
||||
eval $(echo "${breaking_changes_patches[$i]}" | sed "s:\$1:$game_dir:")
|
||||
# apply breaking changes patch
|
||||
eval $(echo "${breaking_changes_patches[$i]}" | sed "s:\$1:$game_dir:g")
|
||||
else
|
||||
echo "No breaking changes for version $i."
|
||||
log INFO "No breaking changes for version $i."
|
||||
continue
|
||||
fi
|
||||
|
||||
if [[ $? -ne 0 ]]; then
|
||||
echo -ne "${RED}Error:${NC} Failed to apply breaking changes patch for version $i. Do you want to continue? (Y/n): "
|
||||
log ERROR "Failed to apply breaking changes patch for version $i. Do you want to continue? (Y/n): "
|
||||
read -er response
|
||||
|
||||
[[ "$response" != "y" && "$response" != "Y" && -n "$response" ]] && { echo "Exiting. Uninstall the script first the retry the install script."; exit 1; }
|
||||
[[ "$response" != "y" && "$response" != "Y" && -n "$response" ]] && { log INFO "Exiting." ; exit 1; }
|
||||
else
|
||||
echo -e "Breaking changes patch for version ${ORANGE}$i${NC} applied ${GREEN}successfully${NC}."
|
||||
log INFO "Version upgrade fix ${GREEN}successfully${NC} applied for version $i."
|
||||
fi
|
||||
done
|
||||
fi
|
||||
echo
|
||||
log INFO ""
|
||||
fi
|
||||
|
||||
# Install
|
||||
|
||||
IFS= read -ep "Install the script to $DESTINATION_PATH or specify another path (must be included in \$PATH)? (Y/path): " response
|
||||
|
||||
if [[ "$response" != "y" && "$response" != "Y" && -n "$response" ]]; then
|
||||
DESTINATION_PATH="$response"
|
||||
if [[ ! -d "$DESTINATION_PATH" ]]; then
|
||||
echo -e "${RED}Error:${NC} Path $DESTINATION_PATH does not exist."
|
||||
exit 1
|
||||
fi
|
||||
fi
|
||||
|
||||
echo "Installing $SCRIPT_NAME to $DESTINATION_PATH."
|
||||
# install
|
||||
log INFO "Installing $SCRIPT_NAME to $DESTINATION_PATH."
|
||||
sudo curl "$REPO_URL"/h2mm --output "$DESTINATION_PATH/$SCRIPT_NAME"
|
||||
sudo chmod +x "$DESTINATION_PATH/$SCRIPT_NAME"
|
||||
log INFO ""
|
||||
|
||||
if [[ ! -x "$(command -v $SCRIPT_NAME)" ]]; then
|
||||
echo -e "${RED}Error:${NC} Installation failed."
|
||||
exit 1
|
||||
fi
|
||||
|
||||
echo "Helldivers 2 Mod Manager CLI installed successfully to $DESTINATION_PATH/$SCRIPT_NAME. Use it by running '$SCRIPT_NAME'."
|
||||
[[ ! -x "$(command -v $SCRIPT_NAME)" ]] && { log ERROR "Installation failed. Mod manager was not found in \$PATH." ; exit 1; }
|
||||
log INFO "Helldivers 2 Mod Manager CLI ${GREEN}successfully${NC} installed: $DESTINATION_PATH/$SCRIPT_NAME."
|
||||
log INFO "Use it by running '$SCRIPT_NAME'. Made with love <3 by v4n and contributors."
|
||||
|
||||
Reference in New Issue
Block a user