MelonLoader

What MelonLoader is
MelonLoader is a free mod loader for Unity games that use either Il2Cpp or Mono. It injects mods and supports plugins, load-order control and dependency handling. The repository directs users to keep mods and plugins in separate folders in the game's installation directory, with logs written to a MelonLoader/Logs folder. Installation guidance covers an installer and manual setup from a release archive. For Il2Cpp games, the listed requirement is the .NET 6.0 Desktop Runtime, which the project says is installed automatically on Windows. Windows loading uses a proxy DLL at game startup, a method the project identifies as Windows-only. Linux guidance covers WINE, Steam Proton and native use. Android and Oculus Quest support is marked as work in progress. Debug mode is intended for work on MelonLoader, plugins and mods; the configuration also includes a Mono debug server. The Il2Cpp Assembly Generator can be configured to run without contacting its remote API. MelonLoader is licensed under Apache License, Version 2.0.
Who it suits
MelonLoader suits players and mod developers working with Unity games that use Mono or Il2Cpp. Its debug mode and plugin support may also suit people developing or troubleshooting mods.
What it does well
- Supports Unity games using Mono or Il2Cpp.
- Includes plugin support, load-order control and dependency handling.
- Offers installer and manual installation guidance.
- Linux guide covers WINE, Steam Proton and native use.
- Licensed under Apache License, Version 2.0.
What to know first
- Android and Oculus Quest support is work in progress.
- Windows startup loading uses a Windows-only proxy DLL.
- Il2Cpp games require the .NET 6.0 Desktop Runtime.
Limits
Android and Oculus Quest support is work in progress. For Il2Cpp games, the .NET 6.0 Desktop Runtime is required.
Plans
| Plan | Billed and limits | Price |
|---|---|---|
| MelonLoader | Windows/Linux installers · x86/x64 packages · nightly builds | Free |
As github.com lists them, read 15 Oct 2026. The maker's own page has the final word.
Getting started
- Open the MelonLoader repository website.
- Follow its installer guide or use the manual installation instructions with a release archive.
- For an Il2Cpp game, ensure the .NET 6.0 Desktop Runtime requirement is met; the project says Windows installs it automatically.
- Place mods in the Mods folder and plugins in the Plugins folder within the game's installation directory.
- Use the MelonLoader/Logs folder in the game installation directory to find logs.
MelonLoader is aimed at players adding mods to Unity games and developers building or debugging those add-ons. It combines support for Mono and Il2Cpp with separate mod and plugin loading, though its platform reach is uneven: Android and Oculus Quest remain works in progress.
Overview
MelonLoader injects into compatible Unity games and supports both Mono and Il2Cpp, giving players a common loader across those two runtimes. It is a focused tool rather than a general mod manager: games outside Unity are beyond its stated scope.
Mods and plugins go in separate folders within the game installation directory, while load-order control and dependency handling help with setups that have multiple add-ons. Installation can follow an installer guide or be done manually from a release archive. Logs are written to a MelonLoader/Logs folder in the game directory, a useful place to start when troubleshooting.
Debug mode is intended for developing and debugging MelonLoader, plugins, and mods, making the loader relevant to creators as well as players. For Il2Cpp games, the requirement is the .NET 6.0 Desktop Runtime; the page says Windows installs it automatically. The Il2Cpp Assembly Generator can be configured to work without contacting its remote API, an option for users who need offline operation.
Key features
- Mono and Il2Cpp support: Covers both Unity runtime types, so runtime choice alone does not force users to seek a different loader.
- Separate mod and plugin loading: Dedicated Mods and Plugins folders keep add-ons distinct; load-order control and dependency handling are useful when several are installed together.
- Installation choice: An installer guide and manual release-archive instructions accommodate different installation preferences, though manual installation puts more of the process in the user's hands.
- Development and diagnostics: Debug mode and game-directory logs give mod and plugin developers relevant tools beyond basic loading. Configuration includes a Mono debug server listening by default at 127.0.0.1 on port 55555.
- Offline generator option: The Il2Cpp Assembly Generator can run without contacting the remote API, useful where that network access is unwanted or unavailable.
Pricing
MelonLoader costs nothing under the Apache License 2.0. There is no paid tier or trial to weigh against the free option; the stated scope is Unity games using Mono or Il2Cpp. Its open-source license and zero price suit players who want a no-cost loader, while the license does not remove the need to check whether a particular game and platform are supported.
Platforms
MelonLoader supports Windows, Linux, and macOS, with Android and Oculus Quest marked as work in progress. Linux guidance covers WINE, Steam Proton, and native use, giving Linux users more than one route to consider. Windows uses a proxy DLL to load at game startup; that mechanism applies only to Windows, so it should not be assumed to describe installation on other systems. For Il2Cpp games, the .NET 6.0 Desktop Runtime requirement matters, although Windows installs it automatically.
Who it's for
MelonLoader is a strong fit for players whose target game is a Unity title using Mono or Il2Cpp and who need mod or plugin support, particularly when managing several add-ons. It also suits developers who need a debug mode, a Mono debug server, and logs in a predictable game-directory location. It is a weaker choice for anyone seeking a loader for non-Unity games or relying on Android or Quest support today, since those platforms are still in progress.
Pros and cons
- Pro: Broad Unity runtime coverage. Mono and Il2Cpp support serves two runtime types within the same focused loader.
- Pro: Useful for multi-add-on setups. Separate folders, load-order control, and dependency handling address practical organization needs.
- Pro: Developer-oriented diagnostics. Debug mode and game-local logs help creators work on mods and plugins as well as load them.
- Con: Android and Quest are not mature targets. Both are marked as work in progress, so users who need established support there should look elsewhere.
- Con: The scope is limited to Unity. Players modding games built on other engines need a different tool.
- Con: Il2Cpp adds a runtime prerequisite. The .NET 6.0 Desktop Runtime is required, even though Windows handles installation automatically.
Alternatives
Browse Game Mod Loaders for more options. Choose SMAPI instead when Stardew Valley is the target: it is free and supports Android, Linux, macOS, and Windows, with a requirement of Stardew Valley 1.6.14 or later on Linux, macOS, Windows, or Steam Deck. BepInEx is another free option for Linux, macOS, and Windows, with manual installation and stable and bleeding-edge builds.
MWSE is a free, open-source loader that welcomes contributions including ideas, bug fixes, documentation, and new features. For a BattleTech PC game mod loader, consider ModTek, which is free and supports Linux, macOS, and Windows. Satisfactory Mod Loader is free, has no required dependencies, and supports Windows client and server use plus Linux servers. Hell2Modding is a free option for macOS and Windows. Everest is free and supports API, Linux, macOS, and Windows; Northstar is free for Linux and Windows.
Verdict
Choose MelonLoader when you want a free loader for a Unity game using Mono or Il2Cpp, especially if you need plugin support, add-on ordering, or developer debugging tools. Its runtime coverage and practical organization make it a capable focused choice; look elsewhere if your game is not built on Unity or you need Android or Oculus Quest support now.
Verdict
MelonLoader provides a free route to loading mods and plugins in Unity games, with guidance for Windows and Linux use. Android and Oculus Quest support is still marked as work in progress.
Questions
How much does MelonLoader cost?
The MelonLoader plan is free under Apache License 2.0.
Which games does it support?
It supports Unity games that use Mono or Il2Cpp.
Which platforms are supported?
Listed platforms are Windows, Linux, macOS, and Android. Linux guidance covers WINE, Steam Proton, and native use; Android support is work in progress. Oculus Quest support is also marked as work in progress.
Does MelonLoader support plugins?
Yes. The listed capabilities include plugin support, load-order control, and dependency handling.
What license does it use?
MelonLoader is licensed under Apache License, Version 2.0. The repository lists HarmonyX and MonoMod as third-party libraries, each under MIT.
How can I install it?
The repository links to an installer guide and provides instructions for manual installation from a release archive.
Facts from MelonLoader's own pages
- 32/64-bit dependencies
- The wiki requires matching Microsoft Visual C++ 2015–2019 Redistributables for 32-bit or 64-bit games. · github.com, 15 Oct 2026
- Android status
- Android and Oculus Quest support is explicitly marked work in progress. · github.com, 15 Oct 2026
- Community and support
- The repository links to the Official Wiki and an official Discord invite. · github.com, 30 Sept 2026
- Configuration
- After first launch, Loader.cfg exposes loader, console, logging, Mono debugger and Unity/Il2Cpp settings. · github.com, 15 Oct 2026
- Debugging
- A debug mode and numerous command-line switches support diagnosing loader, Unity and mod problems. · github.com, 15 Oct 2026
- Debugging configuration
- The configuration includes a Mono debug server with a default listen address of 127.0.0.1 and port 55555. · github.com, 30 Sept 2026
- Development
- Debug mode is intended to help develop and debug MelonLoader, plugins, and mods. · github.com, 30 Sept 2026
- Documentation depth
- The official wiki documents automated and manual installation, launcher detection, Linux environment variables, troubleshooting pitfalls, support contact and launch arguments. · github.com, 15 Oct 2026
- Game logs
- MelonLoader writes logs to a MelonLoader/Logs folder in the game's installation directory. · github.com, 30 Sept 2026
- Il2Cpp requirement
- Il2Cpp games require the .NET 6 Desktop Runtime; Windows installation can install it automatically. · github.com, 15 Oct 2026
- Installation methods
- Users can install through the dedicated installer or manually copy the loader directory and proxy DLLs into a closed game directory. · github.com, 15 Oct 2026
- Install options
- The repository links to an installer guide and provides instructions for manual installation from a release archive. · github.com, 30 Sept 2026
- Licence
- The repository and installer are licensed under Apache License 2.0. · github.com, 15 Oct 2026
- License
- The repository states MelonLoader is licensed under Apache License, Version 2.0. · github.com, 30 Sept 2026
- Limit: anti-cheat
- The same review warns that DLL injection is unsuitable for games with kernel-level anti-cheat because of ban risk. · hysenlabs.com, 15 Oct 2026
- Limit: compatibility
- An independent technical review says games with their own version.dll or launchers that verify files can fail to start with the proxy approach. · hysenlabs.com, 15 Oct 2026
- Limit: difficult setup
- A Steam community poster describes the tool as aimed at expert users, complicated, dependent on old versions for some patches and difficult to remove. · steamcommunity.com, 15 Oct 2026
- Limit: launch failures
- A BONELAB Steam discussion reports the game stopping before launch, a missing Bootstrap.dll message and difficulty removing residual loader files. · steamcommunity.com, 15 Oct 2026
- Limit: platform maturity
- The independent review characterizes Android/Quest support as experimental and notes uneven platform parity. · hysenlabs.com, 15 Oct 2026
- Linux integration
- The installer supports Steam games on Linux and documentation covers Wine, Proton and native launches. · github.com, 15 Oct 2026
- Linux support
- The repository links to a Linux support guide covering WINE, Steam Proton, and native use. · github.com, 30 Sept 2026
- Logging
- Runtime logs are written under MelonLoader/Logs in the game installation directory. · github.com, 15 Oct 2026
- macOS integration
- The installer lists Steam games on macOS and provides a launch script for macOS installation. · github.com, 15 Oct 2026
- Maker identity
- The project is maintained by the LavaGang GitHub organization and contributors. · github.com, 15 Oct 2026
Where MelonLoader stands on Freedom251
- Game Mod Loaders#3 of 26