Download  ·  Browse mods  ·  New to modding?  ·  Documentation  ·  Make a mod ·  Editor

For players A desktop app that finds your game, installs mods from rsmm.me in a click and applies them for you. Every file it changes is backed up, so the unmodded game is always one click away. Get the app →

For mod authors A command-line tool and SDK for changing textures, models, stats, text and items, scripting gameplay in Lua, and publishing to the site with one command. Make your first mod →

Getting started

Windows 10/11	Linux (any distro)	Debian / Ubuntu
Installer (.exe)	.AppImage	.deb package

On Windows, download the file ending in x64-setup.exe. The app keeps itself up to date after the first install. Steam Deck works through the Linux AppImage.

1. Open RSMM. It finds Ravenswatch in your Steam library by itself. If it can't, it asks you for the folder that contains Ravenswatch.exe.
2. Get some mods. Open Browse and press install on any mod you like. It lands in your Library, switched on.
3. Press Launch Modded. The game starts with your mods.

When you quit the game, RSMM puts the original files back by itself. Launch Vanilla starts the plain game. Starting Ravenswatch from Steam also gives you the plain game, so use Launch Modded whenever you want mods.

New to all this? The step-by-step install guide and app tour explain every screen, and the FAQ covers safety, co-op and game updates.

List view. Every mod in the active profile at a glance, in load order.

Mod settings. Change a mod's options without editing any files.

Profiles. Keep separate mod setups and share them as a code.

What mods can change

Area	What you can change
Look and sound	Textures, 3D models and audio
Balance	Hero and enemy stats, talent values, magical-object values
Text	Any in-game string, including full translations
New content	Custom magical objects. Enemies, maps, shops and rewards are supported but still experimental, and mods that use them say so
Scripted gameplay	Lua scripts running in the game through the loader

Many mods have their own settings: press the settings button on a mod in your Library to change them before you play.

Note

Mods only change files on your own machine. Cosmetic mods are fine in co-op. Mods that change balance or content can behave differently for other players, so check a mod's description before bringing it into someone else's lobby.

Making mods

No install needed to start: the web editor changes items, talents and abilities right in your browser, using your own game files. Make your first mod walks you through it.

For everything else there's the rsmm command-line tool, which needs Python 3.11 or newer and Git. Never used a terminal? Set up the modding tools goes through it one step at a time.

git clone https://github.com/Ovilli/RavenswatchModManager
cd RavenswatchModManager
python3 -m venv .venv && source .venv/bin/activate    # Windows: .venv\Scripts\activate
pip install -e .

rsmm new my-first-mod --kind item    # start from a copy of an existing magical object
rsmm lint my-first-mod               # check it
rsmm apply                           # try it in the game
rsmm publish my-first-mod            # upload it to rsmm.me

A mod is a manifest.toml describing what it changes, plus any assets it needs. rsmm watch re-applies it every time you save. Publishing needs an API token from your rsmm.me account. Every upload is malware-scanned before it appears on the site.

Your first mod A step-by-step walkthrough

Modding guide Every manifest field

Lua SDK Scripting gameplay

Example mods Working mods to copy

For the game itself (heroes, talents, items, enemies), the unofficial Ravenswatch Wiki, maintained by Skigim, is the reference.

Lua mods

Most mods are plain file changes and work wherever the game runs. Lua mods also need the loader, a small DLL that runs next to the game:

rsmm install-loader    # install the loader and the Lua SDK into the game folder
rsmm log -f            # follow the loader log

On Linux under Proton, add WINEDLLOVERRIDES="winhttp=n,b" %command% to the game's Steam launch options.

If something goes wrong

Common problems and fixes

Problem	Fix
Mods don't show up in the game	Start the game with Launch Modded, not from Steam, and check you're not in the Default profile
The game crashes	Press Launch Vanilla to check the game itself works, then switch mods off half at a time to find the culprit
A game update broke things	Press Repair on the "Ravenswatch updated" banner, then Launch Modded
Gray window on Debian/Ubuntu	Start the app with WEBKIT_DISABLE_DMABUF_RENDERER=1 WEBKIT_DISABLE_COMPOSITING_MODE=1
The app won't open on Windows	Install WebView2

Commands → Doctor in the app (or rsmm doctor) checks your setup and reports what it finds. More fixes are in the troubleshooting guide. If you're still stuck, open an issue with your OS, RSMM version and the rsmm doctor output.

Contributing

Bug reports, mods, documentation fixes and reverse-engineering findings are all welcome. Development setup explains how to build the app, the website and the loader. Architecture explains how mods are applied, and CLAUDE.md is a detailed technical brief of the repo.

Repository layout

src/rsmm/     CLI and modding SDK (Python)
src/loader/   Lua loader DLL (C++)
apps/         desktop app (Tauri), website (Next.js), API (Hono), docs (Starlight)
packages/     shared TypeScript packages
examples/     example mods
docs/         generated API reference and raw reverse-engineering notes
data/         engine symbol map and generated asset data

For the Ravenswatch developers

RSMM is a fan project and we want it to be a good neighbour to the game. Here is exactly what it touches:

• Data files. Mods replace cooked asset files in the game folder. Each original is backed up first, and Launch Modded puts every original back when the game closes. rsmm restore --all or Steam's Verify integrity of game files returns a clean install at any time.
• The optional Lua loader. A winhttp.dll placed next to the game that hooks game functions in memory so Lua mods can react to gameplay. It never writes to Ravenswatch.exe on disk, and it is only installed when a player asks for it.
• Nothing that is paid for. Paid content stays behind its ownership check: RSMM does not unlock DLC heroes or outfits, and won't accept mods that do.
• Online. Our docs ask players to use gameplay-changing mods only with people who have agreed to them, and rsmm modpack tells a group which of their mods everyone needs and which only change what one player sees.

If anything here causes you a problem, or you'd rather we did something differently, email contact@rsmm.me or open an issue. We will follow any modding guidelines you publish, and takedown requests are handled as described on rsmm.me/dmca.

Support

RSMM is free and open source. If you'd like to support it:

---

_{MIT licensed, see LICENSE. The loader includes MinHook, Lua 5.4, nlohmann/json and toml++, and the app bundles open-source fonts and frameworks; their licenses are in THIRD_PARTY_NOTICES.md. RSMM never writes to Ravenswatch.exe, contains no game assets, and requires a legitimate copy of the game. The optional Lua loader hooks game functions in memory while the game runs. Not affiliated with Passtech Games or Nacon. Logo by Arch.}

Contributors