A cross-platform mod manager for Ravenswatch. Swap textures, edit stats, override translations, and author Lua-scripted mods — all from a desktop app or CLI. Works on Windows, macOS, and Linux.
No terminal required. Grab the desktop app for your OS:
| Platform | Installer |
|---|---|
| Windows 10/11 | RSMM-x64.msi |
| macOS 12+ (Intel & Apple Silicon) | RSMM-universal.dmg |
| Linux (AppImage) | RSMM-x86_64.AppImage |
| Linux (Debian/Ubuntu) | rsmm_amd64.deb |
| Arch Linux | yay -S rsmm |
| Capability | Desktop app | CLI |
|---|---|---|
| Browse & install mods from the Registry | ✅ Click to install | rsmm apply |
| Swap textures, audio, meshes | ✅ Built-in | rsmm apply |
| Edit balance numbers | ✅ Coming soon | rsmm stat |
| Override translations | ✅ Coming soon | rsmm text |
| Manage multiple profiles | ✅ Dropdown menu | — |
| Health check | ✅ Doctor button | rsmm doctor |
| Launch the game | ✅ Play button | rsmm run |
| Author mods in Lua | — | rsmm new, rsmm pack |
| Live re-apply on file changes | — | rsmm watch |
Lua scripting is Windows-only (requires a native DLL loaded into the game process). Texture swaps, stat edits, and text overrides work on all platforms.
- Download and install RSMM for your OS
- Launch the app — it auto-detects your Ravenswatch installation
- Browse the Registry tab and install mods
- Click Apply to copy mods into the game
- Click Play to launch Ravenswatch
See Installation Guide for full setup including the CLI.
git clone https://github.com/Ovilli/RavenswatchModManager.git
cd RavenswatchModManager
python3 -m venv .venv && source .venv/bin/activate && pip install -e .
./rsmm doctor
./rsmm new MyMod
./rsmm apply| For you | Start here |
|---|---|
| Installing the mod manager | docs/INSTALLATION.md |
| Using the desktop app | RSMM Docs |
| Creating mods | docs/MODDING.md |
| CLI reference | docs/CLI_USAGE.md |
| Contributing | docs/SETUP.md |
rsmm CLI entry point — every workflow starts here
apps/ TypeScript monorepo (Tauri desktop, Next.js site, Hono API, Astro docs)
desktop/ Tauri 2 desktop app (Windows, macOS, Linux)
www/ Next.js website + registry browser
api/ Hono API server
docs/ Astro Starlight documentation site
packages/ Shared packages (db, ui, api-client, schemas, tsconfig)
src/rsmm/ Python CLI + SDK
src/loader/ Native DLL (winhttp proxy + Lua VM, Windows only)
docs/ User + developer documentation
mods/ Installed mods (one folder per id)
data/ Asset maps + pattern signatures (gitignored)
dist/ Built loader DLL + packed mod zips
MIT — see LICENSE. The loader DLL bundles third-party code (MinHook, Dear ImGui, Lua 5.4); their licenses are in THIRD_PARTY_NOTICES.md.
RSMM is a single-player modding tool. It does not bypass anti-cheat, does not modify Ravenswatch.exe, and requires a legitimate copy of the game. It ships no game content — data/asset_map.json is a reconstructed path index, not game assets. Mods authored with RSMM are the modder's own work.