We recommend using the Thunderstore Mod Manager or an alternative for installing mods
Last updated | 4 months ago |
Total downloads | 1482 |
Total rating | 5 |
Categories | Tools |
Dependency string | Foldex-r2mod_cli-1.3.2 |
Dependants | 0 other mods depend on this mod |
Features | Installation | Usage | Changelog |
---|
A simple mod manager written in Bash for Linux users.
r2mod is available in the Arch AUR as r2mod_cli
yay -S r2mod_cli
r2mod is available from flathub as io.github.Foldex.r2mod
flatpak install flathub io.github.Foldex.r2mod
Flatpak bin exports should allow you to run r2mod using io.github.Foldex.r2mod
.
But you may wish to set up an alias for easier use.
alias r2mod="io.github.Foldex.r2mod"
Flatpak does not allow shell completions to be installed in the usual root owned locations.
The flatpak will install them under user owned directories at runtime instead.
For ZSH, you may need to add $HOME/.local/share/zsh/site-functions
to your $fpath
The prior methods are preferred, but if you wish to manually install:
Extract the zip and run sudo make install
inside its directory.
sudo pacman -S curl findutils gawk jq p7zip sed
sudo dnf install curl findutils gawk jq p7zip sed
sudo apt-get install curl findutils gawk jq p7zip-full sed
Make sure you have run Risk of Rain 2 beforehand to create the needed directories.
It is heavily recommended to run r2mod setup
to create a new install.
Some empty folders will be placed in the BepInEx/plugins
dir, do not remove them.
They are used to track updates for certain mods.
The default install directories for Steam/Flatpak should automatically be handled.
If you've installed Risk of Rain 2 to a different location, please export the environment variable
$R2MOD_INSTALL_DIR
in your bash profile and point it to your install directory:
export R2MOD_INSTALL_DIR="$HOME/custom/dir/Risk of Rain 2"
$R2MOD_COMPAT_DIR
also exists for custom locations of Steam's compatdata directory.
export R2MOD_COMPAT_DIR="$HOME/custom/dir/steamapps/compatdata/632360"
If you wish to use a custom install location with the flatpak, you may use overrides or Flatseal to edit the permissions and environment variables.
The env vars must be an absolute path, they are literal strings and do not have ~
expansion.
Do NOT include Risk of Rain 2
in the R2MOD_INSTALL_DIR
env path, an issue with flatpak does not allow for spaces in environment variables. Just point up to steamapps/common
.
Use flatpak override --user
if it is a user installed flatpak
flatpak override \
--env='R2MOD_INSTALL_DIR=/home/foldex/Games/Steam/SteamLibrary/steamapps/common' \
--env='R2MOD_COMPAT_DIR=/home/foldex/Games/Steam/SteamLibrary/steamapps/compatdata/632360' \
--filesystem='~/Games/Steam/SteamLibrary/steamapps/common/Risk of Rain 2' \
--filesystem='~/Games/Steam/SteamLibrary/steamapps/compatdata/632360' \
io.github.Foldex.r2mod
Accepts shorthand for command names.
r2mod ch(eck): Check for Script Updates
r2mod del(ete) ProfileName: Delete Local Profile
r2mod dis(able) (Mod-Dependency-String): Disable Mods
r2mod ed(it) ConfigName: Edit Mod Configs
r2mod en(able) (Mod-Dependency-String): Enable Mods
r2mod exp(ort) ProfileName: Export r2modman mod profile
r2mod hol(d): Toggle Mod Updates
r2mod imp(ort) ProfileCode: Install r2modman mod profile
r2mod ins(tall) Mod-Dependency-String: Install New Mod
r2mod li(st) (count|all) : List or Count Installed Mods
r2mod loa(d) ProfileName: Import Local Profile
r2mod ref(resh): Force Refresh Package Cache
r2mod run: Launch Risk of Rain
r2mod sav(e) ProfileName: Export Local Profile
r2mod sea(rch): Search for Mods
r2mod set(up): Install a Fresh BepInEx Setup
r2mod un(install) Mod-Dependency-String: Uninstall Mod
r2mod upd(ate): Update All Exisiting Mods
r2mod ver(sion): Print Version
r2mod install ontrigger-ItemStatsMod-2.0.0
to install a mod.
If the version number is left out, the most recent version will be installed.
r2mod install ontrigger-ItemStatsMod
Multiple mods can also be installed
r2mod install ontrigger-ItemStatsMod MagnusMagnuson-BiggerBazaar
Use r2mod uninstall ontrigger-ItemStatsMod-2.0.0
to install a mod.
If the version number is left out, any version of that mod will be uninstalled.
r2mod uninstall ontrigger-ItemStatsMod
Multiple mods can also be uninstalled
r2mod uninstall ontrigger-ItemStatsMod MagnusMagnuson-BiggerBazaar
r2mod disable
to disable BepInEx entirely.
r2mod enable
to re-enable.
r2mod disable ontrigger-ItemStatsMod-2.0.0
to disable a specific mod.
r2mod enable ontrigger-ItemStatsMod-2.0.0
to re-enable.
r2mod list
to display installed mods.
r2mod list all
to display installed mods and disabled mods.
r2mod list count
to display a count of installed mods.
r2mod list count all
to display a count of installed mods and disabled mods.
$EDITOR
environment variable is used to determine which editor to use.
r2mod edit
will open all BepInEx config files in your editor
r2mod edit name
will open all matching configs (case insensitive, incomplete names are fine)
Mods can be prevented from being auto updated by running r2mod hold ModName
.
Run again to remove the hold.
Updates for r2mod will be automatically checked, but not installed.
If you manually installed r2mod, updates can be done like any other mod:
r2mod install Foldex-r2mod_cli
All Files, Old Versions, and Backups can be found in /tmp/r2mod
$XDG_DATA_HOME
run
command for flatpak versionlist
and import preview
$XDG_DATA_HOME
ror2mm://
linksimport preview
list
now uses color=autolist count
commandls
aliasremove
for uninstallPlease note that the install buttons only work if you have compatible client software installed, such as the Thunderstore Mod Manager. Otherwise use the zip download links instead.
Upload date | Version number | Downloads | Download link | |
---|---|---|---|---|
2022-3-26 | 1.3.2 | 53 | Version 1.3.2 | Install |
2022-3-12 | 1.2.2 | 67 | Version 1.2.2 | Install |
2022-1-17 | 1.2.1 | 43 | Version 1.2.1 | Install |
2021-5-19 | 1.2.0 | 97 | Version 1.2.0 | Install |
2021-4-12 | 1.1.0 | 103 | Version 1.1.0 | Install |
2021-4-6 | 1.0.7 | 102 | Version 1.0.7 | Install |
2021-2-28 | 1.0.6 | 112 | Version 1.0.6 | Install |
2020-11-21 | 1.0.5 | 179 | Version 1.0.5 | Install |
2020-10-5 | 1.0.4 | 173 | Version 1.0.4 | Install |
2020-10-2 | 1.0.3 | 130 | Version 1.0.3 | Install |
2020-9-29 | 1.0.2 | 147 | Version 1.0.2 | Install |
2020-9-26 | 1.0.1 | 143 | Version 1.0.1 | Install |
2020-9-26 | 1.0.0 | 133 | Version 1.0.0 | Install |