Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

MelonLoader

github.com

  • Free plan
  • Open source
  • Windows
  • macOS
  • Linux
  • Android
8.0 Club score Visit github.com

What MelonLoader is

MelonLoader is a free mod loader for Unity games built with either Il2Cpp or Mono. It supports plugins as well as mods, with separate Mods and Plugins folders in the game's installation directory. Listed capabilities include load-order control and dependency handling. The project provides an installer guide and instructions for installing manually from a release archive, and it writes game logs to a MelonLoader/Logs folder. For Il2Cpp games, the listed requirement is the .NET 6.0 Desktop Runtime; the repository says Windows installs it automatically. Windows loading uses a proxy DLL when a game starts, and this mechanism applies only to Windows. 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 the loader, plugins, and mods. Its configuration includes a Mono debug server, and the Il2Cpp Assembly Generator can be set to run without contacting its remote API. MelonLoader is licensed under Apache License, Version 2.0.

Who it suits

MelonLoader suits Unity game players who want to load mods or plugins, and developers working on either. Linux users can consult guidance for WINE, Steam Proton, and native use; Android and Quest users should note that support is still in progress.

Good to know, and what to watch

  • Supports Unity games using Mono or Il2Cpp.
  • Supports plugins and mods.
  • Includes load-order control and dependency handling.
  • Offers installer and manual setup guidance.
  • Il2Cpp generator can run without remote API contact.
  • Android and Oculus Quest support is work in progress.
  • Windows loading relies on a proxy DLL.
  • Il2Cpp games require the .NET 6.0 Desktop Runtime.

MelonLoader

Free

Free plan

Getting started

  1. Open the MelonLoader GitHub repository
  2. Follow the installer guide or manual release-archive instructions
  3. Install the .NET 6.0 Desktop Runtime for Il2Cpp games
  4. Place mods in the game installation's Mods folder
  5. Place plugins in the game installation's Plugins folder
  6. Use the Linux guide for WINE, Steam Proton, or native setups

Limits to check

Android and Oculus Quest support is marked as work in progress. Il2Cpp games require the .NET 6.0 Desktop Runtime.

The Club's review

MelonLoader is a free injection-based loader for Unity games, covering both Mono and Il2Cpp runtimes. It suits players building modded game installations and developers maintaining mods or plugins. Its broad Unity coverage and debugging tooling make it a strong default for compatible games, while unfinished mobile support and Windows-specific startup mechanics narrow its reach.

Overview

MelonLoader injects into a supported Unity game at startup, then loads add-ons from dedicated Mods and Plugins folders inside the game directory. Load-order control and dependency handling matter when several mods must coexist, giving experienced users a way to keep a larger setup predictable. This is a Unity-focused loader, not a universal mod manager for games built on other engines.

Installation is available through an installer guide or by placing files from a release archive manually. That choice helps users who want guided setup as well as those who need direct control over the game directory. MelonLoader writes diagnostic files to a MelonLoader/Logs folder, so troubleshooting has a defined location rather than relying on scattered game output.

The project is licensed under Apache License 2.0. Its listed third-party libraries include HarmonyX and MonoMod, both under MIT licenses. An Official Wiki and official Discord provide community reference and discussion channels.

Key features

  • Mono and Il2Cpp support: One loader covers the two Unity runtime types named by the project, avoiding a runtime-specific choice for supported games.
  • Injection startup: The loader enters the game process at launch, which is appropriate for add-ons that need to modify runtime behavior but makes correct game-directory installation essential.
  • Separate mod and plugin folders: Keeping mods and plugins apart clarifies where each kind of add-on belongs, especially in installations maintained by developers or advanced players.
  • Load order and dependencies: These controls help coordinate multiple add-ons; they become increasingly valuable as a setup grows beyond a single mod.
  • Debug mode: Intended for developing and debugging MelonLoader itself, plugins, and mods, so it is more useful to creators and maintainers than to players who only install finished packages.
  • Logs and offline generation: Logs are stored under MelonLoader/Logs, and the Il2Cpp Assembly Generator can be configured to work without contacting its remote API. The offline option suits restricted or deliberately disconnected environments.
  • Mono debug server: Configuration includes a server listening by default on 127.0.0.1 port 55555, giving developers a defined local debugging endpoint.

Pricing

MelonLoader costs nothing under the MelonLoader plan. The plan is covered by the Apache License 2.0 and has no trial conversion or paid renewal to manage. It is a practical fit for individual players, mod authors, and teams that need a permissively licensed loader without per-seat charges or usage quotas.

Platforms

Supported platforms are Windows, Linux, macOS, and Android, with Android and Oculus Quest support marked as work in progress. Windows uses a proxy DLL to load MelonLoader at game startup; the project says this mechanism applies only to Windows. Linux guidance covers WINE, Steam Proton, and native use, making the choice relevant to both desktop Linux users and Steam Deck-style Proton setups.

For Il2Cpp games, the listed requirement is the .NET 6.0 Desktop Runtime. On Windows, the project says this runtime is installed automatically. Android and Quest users should expect an evolving implementation rather than the same maturity as desktop targets.

Who it's for

Choose MelonLoader when a Unity game uses Mono or Il2Cpp and you want a free loader with both player-facing organization and developer-oriented diagnostics. It is especially suitable for mod authors who need debug mode, logs, dependency handling, and an offline Il2Cpp generation option. Players managing several compatible add-ons also benefit from load-order controls and clear folder conventions.

Look elsewhere when the game is not built on Unity, when you require a finished Android or Oculus Quest workflow, or when your preferred ecosystem already has a game-specific loader with tighter integration.

Pros and cons

Pros

  • Broad Unity runtime coverage: Mono and Il2Cpp support accommodates more Unity game architectures.
  • Useful maintenance tools: Debug mode, structured logs, dependency handling, and load-order control support serious mod development and larger installations.
  • Flexible installation: Users can follow an installer guide or install manually from a release archive.
  • Permissive free license: Apache License 2.0 avoids subscription or paid-plan barriers.

Cons

  • Unity-only scope: It does not address games built on other engines.
  • Mobile uncertainty: Android and Oculus Quest support remains work in progress.
  • Windows-specific proxy design: The proxy DLL startup method does not apply across platforms.
  • Il2Cpp prerequisite: Il2Cpp games require the .NET 6.0 Desktop Runtime, even though Windows installation is automated.

Alternatives

Game Mod Loaders is the broader starting point when you want to compare loaders rather than commit to a Unity-specific option.

  • Satisfactory Mod Loader is the better pick for Satisfactory, with Windows client and server support and Linux server support at no cost.
  • MWSE fits users who want a free, contribution-friendly loader under the GNU GPL and accept its stated no-warranty terms.
  • SMAPI is preferable for Stardew Valley installations, including Android, Linux, macOS, Windows, and Steam Deck environments meeting its version requirement.
  • Baldur's Gate 3 Script Extender is the game-specific choice for Baldur's Gate 3.
  • BepInEx suits users seeking an open-source loader with manual installation and stable or bleeding-edge builds across Linux, macOS, and Windows.
  • Hollow Knight Modding API is tailored to Hollow Knight and has no paid tiers or usage limits stated.
  • ModTek is the dedicated option for the BattleTech PC game.
  • RED4ext is the focused choice for Cyberpunk 2077 on Windows.

Verdict

MelonLoader is the right choice for Unity players and developers who need one free loader for Mono and Il2Cpp games, with organized add-on loading and real debugging support. Choose it for broad desktop Unity coverage and a permissive license; look elsewhere if your game is outside Unity or your Android or Quest setup requires a mature, finished path.

The verdict

MelonLoader provides mod and plugin loading for Unity games using Mono or Il2Cpp, with installation guidance and debugging options. Platform status varies: Windows uses a proxy DLL, while Android and Oculus Quest support remains in progress.

Questions people ask

What does MelonLoader cost?

MelonLoader is free. Its listed MelonLoader plan is free under Apache License 2.0.

Which games does MelonLoader support?

It supports Unity games using Mono or Il2Cpp.

Which platforms are supported?

Supported platforms are Windows, Linux, macOS, and Android, with Android and Oculus Quest support marked as work in progress. Linux guidance covers WINE, Steam Proton, and native use.

Where do mods and plugins go?

Mods go in the Mods folder and plugins go in the Plugins folder inside the game installation directory.

Can it work offline?

The Il2Cpp Assembly Generator can be configured to run without contacting its remote API.

What the maker publishes

32/64-bit dependencies
The wiki requires matching Microsoft Visual C++ 2015–2019 Redistributables for 32-bit or 64-bit games. source
Android status
The repository links to Android and Oculus Quest support marked as work in progress. source
Android status
Android and Oculus Quest support is explicitly marked work in progress. source
Community and support
The repository links to the Official Wiki and an official Discord invite. source
Configuration
After first launch, Loader.cfg exposes loader, console, logging, Mono debugger and Unity/Il2Cpp settings. source
Debugging
A debug mode and numerous command-line switches support diagnosing loader, Unity and mod problems. source
Debugging configuration
The configuration includes a Mono debug server with a default listen address of 127.0.0.1 and port 55555. source
Development
Debug mode is intended to help develop and debug MelonLoader, plugins, and mods. source
Documentation depth
The official wiki documents automated and manual installation, launcher detection, Linux environment variables, troubleshooting pitfalls, support contact and launch arguments. source
Game logs
MelonLoader writes logs to a MelonLoader/Logs folder in the game's installation directory. source
Il2Cpp requirement
For Il2Cpp games, the listed requirement is the .NET 6.0 Desktop Runtime, which the page says is installed automatically on Windows. source
Il2Cpp requirement
Il2Cpp games require the .NET 6 Desktop Runtime; Windows installation can install it automatically. source
Installation methods
Users can install through the dedicated installer or manually copy the loader directory and proxy DLLs into a closed game directory. source
Install options
The repository links to an installer guide and provides instructions for manual installation from a release archive. source
Licence
The repository and installer are licensed under Apache License 2.0. source
License
The repository states MelonLoader is licensed under Apache License, Version 2.0. source
Limit: anti-cheat
The same review warns that DLL injection is unsuitable for games with kernel-level anti-cheat because of ban risk. source
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. source
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. source
Limit: launch failures
A BONELAB Steam discussion reports the game stopping before launch, a missing Bootstrap.dll message and difficulty removing residual loader files. source
Limit: platform maturity
The independent review characterizes Android/Quest support as experimental and notes uneven platform parity. source
Linux integration
The installer supports Steam games on Linux and documentation covers Wine, Proton and native launches. source
Linux support
The repository links to a Linux support guide covering WINE, Steam Proton, and native use. source
Logging
Runtime logs are written under MelonLoader/Logs in the game installation directory. source

Checked against the maker's pages on 15 Oct 2026.