Installation
RSMM runs on Windows and Linux. Most people only need the desktop app — no terminal required.
Desktop app (recommended)
The desktop app gives you a graphical interface to browse, install, and manage mods.
- Download
RSMM-x64.msifrom the latest release. - Double-click the
.msiand follow the installer. - Launch Ravenswatch Mod Manager from the Start Menu.
| Distro | Package |
|---|---|
| Any (AppImage) | RSMM-x86_64.AppImage — chmod +x then run |
| Debian / Ubuntu | rsmm_amd64.deb |
| Arch Linux | AUR: yay -S rsmm |
| Other | Use the CLI or pipx below |
First run
- Set your game path — RSMM auto-detects Steam installs. If it can’t, browse to the folder containing
Ravenswatch.exe. - Run the Doctor — click the Doctor button to verify the setup.
- Browse mods — open the Registry tab to discover community mods.
- Apply — click Apply to install your selected mods into the game.
- Play — launch Ravenswatch from the app.
CLI (advanced)
Install from source if you want to author mods, script installs, or run on a platform without a pre-built package.
Prerequisites: Python 3.11+, Git, and Ravenswatch installed.
git clone https://github.com/Ovilli/RavenswatchModManager.gitcd RavenswatchModManagerpython -m venv venvvenv\Scripts\activatepip install -e .rsmm doctorsudo apt install build-essential cmake pkg-config # build depsgit clone https://github.com/Ovilli/RavenswatchModManager.gitcd RavenswatchModManagerpython3 -m venv .venvsource .venv/bin/activatepip install -e ../rsmm doctorpipx install git+https://github.com/Ovilli/RavenswatchModManager.gitrsmm doctorVerify your setup
rsmm doctor # health check — should pass with no errorsrsmm new TestMod # scaffold a test modrsmm apply # apply all enabled modsrsmm run # launch the gameLua scripting (Windows only; experimental on Steam Proton)
Lua mods run inside the game process and need the loader DLL (winhttp.dll) next to Ravenswatch.exe. Texture and asset overrides work without it.
cd src/loader./build.sh # Linux cross-compile (MinGW)# or build.bat # Windowsrsmm install-loader # install into the gameNext steps
Your first mod Install and create a mod in minutes.
CLI reference Every command explained.
Authoring mods Build and share your own mods.
Troubleshooting Fixes for common issues.