ResoniteModLoader

A mod loader for Resonite. Consider joining our community on Discord for support, updates, and more.

Installation

If you are using the Steam version of Resonite you are in the right place. If you are on Linux, read the Linux Notes.

1. Download ResoniteModLoader.dll to Resonite's Libraries folder (C:\Program Files (x86)\Steam\steamapps\common\Resonite\Libraries). You may need to create this folder if it's missing.
2. Place 0Harmony.dll into a rml_libs folder under your Resonite install directory (C:\Program Files (x86)\Steam\steamapps\common\Resonite\rml_libs). You will need to create this folder.
3. Add the following to Resonite's launch options: -LoadAssembly Libraries/ResoniteModLoader.dll. If you put ResoniteModLoader.dll somewhere else you will need to change the path.
4. Optionally add mod DLL files to a rml_mods folder under your Resonite install directory (C:\Program Files (x86)\Steam\steamapps\common\Resonite\rml_mods). You can create the folder if it's missing, or launch Resonite once with ResoniteModLoader installed and it will be created automatically.
5. Start the game. If you want to verify that ResoniteModLoader is working you can check the Resonite logs. (C:\Program Files (x86)\Steam\steamapps\common\Resonite\Logs). The modloader adds some very obvious logs on startup, and if they're missing something has gone wrong. Here is an example log file where everything worked correctly.

If ResoniteModLoader isn't working after following those steps, take a look at our troubleshooting page.

Example Directory Structure

Your Resonite directory should now look similar to the following. Files not related to modding are not shown.

<Resonite Install Directory>
│   Resonite.exe
│
├───Logs
│       <Log files will generate here>
│
├───rml_mods
│       <Mods go here>
│
├───rml_libs
│       0Harmony.dll
│       <More libs go here>
│
├───rml_config
│       <Mod config files here>
│
└───Libraries
        ResoniteModLoader.dll

Note that additional libraries (rml_libs) can also be in the root of the Resonite install directory if you prefer, but the loading of those happens outside of RML itself.

Finding Mods

A list of known mods will be made available on the Resonite Mod List. New mods and updates will also announced in our Discord.

Frequently Asked Questions

Many questions about what RML is and how it works are answered on our frequently asked questions page.

Making a Mod

Check out the Mod Creation Guide.

Configuration

ResoniteModLoader aims to have a reasonable default configuration, but certain things can be adjusted via an optional config file.

Contributing

Issues and PRs are welcome. Please read our Contributing Guidelines!

Licensing and Credits

ResoniteModLoader is licensed under the GNU Lesser General Public License (LGPL). See LICENSE.txt for the full license.

Third-party libraries distributed alongside ResoniteModLoader:

• LibHarmony (MIT License)

Third-party libraries used in source:

• .NET (Various licenses)
• Resonite (EULA)
• Json.NET (MIT License)