A modding framework for Roblox Studio, enabling native, C#, and internal Luau script mods.
Note
This project is still in development and may contain bugs or incomplete features.
Warning
Roblox changed (shuffled) the internal layout of Luau’s structs a few months ago, so the in-memory structures we relied on no longer line up. Because of that I’m building a static-analysis dumper to reconstruct the correct structs and offsets so scripting support can work again. Luau/internal scripting is temporarily disabled while I finish that—native C++/C# mods keep working normally. I’ll re-enable scripting once the dumper produces a stable, reliable mapping.
- Windows
- Linux Vinegar
- macOS (planned)
RML targets your local Roblox Studio installation (typically under
%LOCALAPPDATA%\Roblox\Versions\<version>\).
The launcher handles placement and keeps the loader up to date.
- Download the latest rml-launcher release.
- Run it and follow the prompts.
- Start Roblox Studio through the launcher — the loader and your mods are applied automatically.
- Download the latest RML release.
- Open your Studio directory — the folder that contains
RobloxStudioBeta.exe, usually%LOCALAPPDATA%\Roblox\Versions\<version>\. - Extract the archive into that folder.
- Start Roblox Studio.
The release archive is already laid out so a plain extract lands everything in the right place:
<Studio directory>/
├── RobloxStudioBeta.exe
├── dwmapi.dll proxy, loaded by Studio
└── RobloxModLoader/
├── roblox_modloader.dll native core
├── config.toml created with defaults if missing
├── runtime/ the .NET host and bundled runtime
└── mods/ your mods, one folder each
└── your-mod/
├── native/ native C++ mod DLLs
├── dotnet/ .NET mod assemblies
└── scripts/ Luau scripts (temporarily disabled)
The quickest way to start is to copy one of the examples and adapt it. Full guides: Writing .NET mods and Writing native mods.
| Example | Surface | What it shows |
|---|---|---|
basic-mod |
C++ | Minimal native mod skeleton and the hooking entry points |
internal_developer |
C++ | Enables Studio's internal developer tools |
discord_rpc |
C++ / Luau | Discord Rich Presence, native + script bridge |
example_dotnet |
C# | Services, instances, properties, and events through the typed API |
discord_rpc_dotnet |
C# | A managed Discord Rich Presence integration |
- Windows with Visual Studio 2022 (MSVC, x64)
- CMake 3.22.1 or newer
- .NET 10 SDK (for the managed runtime and mods)
- Git
git clone https://github.com/revolutionxk/roblox-modloader.git
cd roblox-modloader
cmake -B build -S . -G "Visual Studio 17 2022"
cmake --build build --config ReleaseThe build generates the dwmapi.dll proxy and the loader. Dependencies are fetched automatically
via CMake.
| Option | Description | Default |
|---|---|---|
ROBLOX_MODLOADER_BUILD_PROXY_GENERATOR |
Build the proxy generator tool | ON |
ROBLOX_MODLOADER_BUILD_PROXY_DLL |
Auto-generate the dwmapi.dll proxy |
ON |
ROBLOX_MODLOADER_BUILD_EXAMPLES |
Build the example mods | ON |
Current focus areas:
- Finish the dumper
- Re-enable Luau/internal scripting support
- Add macOS support (long-term goal)
- Finish .NET modding support (Better API, async support, etc.)
- Add a mod browser and installer
Contributions are welcome. Please open an issue to discuss substantial changes first, keep pull
requests focused, follow the existing code style, and add tests where it makes sense. The
docs/ directory is the best starting point for understanding the codebase.
Released under the MIT License. See LICENSE.
This project is provided for educational and research purposes. You are responsible for complying with Roblox's Terms of Service and any applicable laws. It is not affiliated with or endorsed by Roblox Corporation.