Foldex-r2mod_cli icon

r2mod cli

A simple CLI Mod Manager for Linux

Last updated 2 days ago
Total downloads 522
Total rating 4 
Categories Tools
Dependency string Foldex-r2mod_cli-1.1.0
Dependants 0 other mods depend on this mod



Features Requirements Usage Changelog

A simple mod manager written in Bash for Linux users.



  • Simple No-Nonsense Usage
  • Setup BepInEx and R2API
  • Install and Update Mods
  • Resolve Dependencies
  • Hold Specific Mods Back from Updating
  • Enable/Disable Mods
  • Edit Mod Configs
  • Check for Updates for itself
  • Supports Importing/Exporting r2modman profile codes
  • Supports Flatpak Steam Installs
  • Tab Completion


The following programs should be installed:


sudo pacman -S curl gawk jq p7zip sed


sudo dnf install curl gawk jq p7zip sed


sudo apt-get install curl gawk jq p7zip-full sed




r2mod is available in the Arch AUR as r2mod_cli

yay -S r2mod_cli


Extract the zip and run sudo make install inside its directory.

First Setup

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.

Custom Install Location

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"

Command List

Accepts shorthand for command names.

r2mod ch(eck): Check for Script Updates
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 ref(resh): Force Refresh Package Cache
r2mod run: Launch Risk of Rain
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"

Installing a Mod

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

Uninstalling a Mod

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

Disabling Mods

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.

Listing Installed Mods

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.

Editing Configs

$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.

Updating r2mod

Updates for r2mod will be automatically checked, but not installed.

Installing 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



  • Dependency Support
  • Disable/Enable Individual Mods
  • Install r2mod updates through r2mod
  • Add HookGenPatcher to default installs
  • Add r2mod to AUR


  • Support R2API v3
  • Allow Custom Steam Compat Dir
  • Add Completion for import preview
  • Fix mod installs with patchers
  • Avoid running update check twice


  • Fix some mods zips extracting without folders
  • Improved setup logic
  • list now uses color=auto
  • Added list count command
  • Added ls alias


  • Add Search Command
  • Alias remove for uninstall
  • Automatically override winhttp on setup (bgkillas)


  • Allow Custom Install Locations
  • Improved ZSH Tab Completion
  • Added run Command to Launch Game


  • Added Hold Command
  • Auto Check for R2Mod Updates
  • Added profile_import preview option
  • Fallback to previous cache if package cache update fails


  • Added Tab Completion


  • Fixed Update Check


  • Initial Release

Available versions

Please 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  
2021-4-12 1.1.0 12 Version 1.1.0 Install
2021-4-6 1.0.7 23 Version 1.0.7 Install
2021-2-28 1.0.6 39 Version 1.0.6 Install
2020-11-21 1.0.5 105 Version 1.0.5 Install
2020-10-5 1.0.4 94 Version 1.0.4 Install
2020-10-2 1.0.3 61 Version 1.0.3 Install
2020-9-29 1.0.2 67 Version 1.0.2 Install
2020-9-26 1.0.1 64 Version 1.0.1 Install
2020-9-26 1.0.0 57 Version 1.0.0 Install