- Debug Mode is for Debugging MelonLoader, Plugins, Mods.
- All Logs are made in the created MelonLoader/Logs folder in your Game's Installation Folder.
- All Plugins get placed in the created Plugins folder in your Game's Installation Folder.
- All Mods get placed in the created Mods folder in your Game's Installation Folder.
- Proxies
- Launch Options
- dnSpy Debugger Usage
- Wine / Steam Proton Usage
- Guides: INSTALLER | MANUAL USE
- Example Projects: TestPlugin & TestMod
- .NET Framework 3.5 Runtime
- .NET Framework 4.7.2 Runtime
- .NET Framework 4.8 Runtime
- Microsoft Visual C++ 2015-2019 Re-distributable [x86] [x64]
- Follow the Instructions in one of the Guides linked below.
- Follow the Steps to UN-INSTALL
- Follow the Steps to INSTALL
- Make sure the Game is Closed and Not Running before attempting to Install.
- Make sure you have all the Requirements Installed before attempting to Install.
- Download MelonLoader [x86] [x64]
- Extract the MelonLoader folder from the MelonLoader Zip Archive to the Game's Installation Folder.
- Extract version.dll from the MelonLoader Zip Archive to the Game's Installation Folder.
- Make sure the Game is Closed and Not Running before attempting to UN-INSTALL.
- Remove the version.dll file from the Game's Installation Folder.
- Remove the MelonLoader folder from the Game's Installation Folder.
These additional steps below are OPTIONAL if you want to do a FULL UN-INSTALL.
- Remove the Plugins folder from the Game's Installation Folder.
- Remove the Mods folder from the Game's Installation Folder.
- Remove the UserData folder from the Game's Installation Folder.
- You are able to rename the Proxy DLL to the list of allowed DLLs below.
- These are mainly for compatibility reasons.
| Name |
|---|
| version.dll |
| winmm.dll |
| winhttp.dll |
- Load Mode Launch Options are a way to dictate how you want Mods or Plugins to Load.
- These are the Values that those Launch Options accept and what each of them do.
| Value | Action |
|---|---|
| 0 | Load Only if the File doesn't have the ".dev.dll" Extension |
| 1 | Load Only if the File has the ".dev.dll" Extension |
| 2 | Load All |
- COMING SOON
- COMING SOON
- These are additional Launch Options that MelonLoader adds to the Game.
- These can be used to manipulate how MelonLoader works.
- After First Launch with MelonLoader these Launch Options can also be configured in MelonLoader/LaunchOptions.ini
If a Launch Option is in your Game's Command Line it will ignore its value in the INI file.
| Argument | Description |
|---|---|
| --no-mods | Launch game without loading any Plugins Mods |
| --quitfix | Fixes the Hanging Process Issue with some Games |
| --melonloader.consoleontop | Forces the Console to always stay on-top of all other Applications |
| --melonloader.consoledst | Keeps the Console Title as Original |
| --melonloader.hideconsole | Hides the Console |
| --melonloader.hidewarnings | Hides Warnings from Displaying |
| --melonloader.debug | Debug Mode |
| --melonloader.dab | Debug Analytics Blocker |
| --melonloader.magenta | Magenta Console Color |
| --melonloader.rainbow | Rainbow Console Color |
| --melonloader.randomrainbow | Random Rainbow Console Color |
| --melonloader.maxlogs | Max Log Files [ Default: 10 ] [ Disable: 0 ] |
| --melonloader.maxwarnings | Max Warnings per Log File [ Default: 100 ] [ Disable: 0 ] |
| --melonloader.maxerrors | Max Errors per Log File [ Default: 100 ] [ Disable: 0 ] |
| --melonloader.loadmodeplugins | Load Mode for Plugins [ Default: 0 ] |
| --melonloader.loadmodemods | Load Mode for Mods [ Default: 0 ] |
| --melonloader.agfregenerate | Forces Regeneration of Assembly |
| --melonloader.agfvunity | Forces use a Specified Version of Unity Dependencies |
| --melonloader.agfvdumper | Forces use a Specified Version of Dumper |
| --melonloader.agfvunhollower | Forces use a Specified Version of Il2CppAssemblyUnhollower |
MelonLoader is licensed under the Apache License, Version 2.0. See LICENSE for the full License.
Third-party libraries used as Source Code and/or bundled in Binary Form:
- Research Detours Package is licensed under the MIT License. See LICENSE for the full License.
- Mono is licensed under multiple licenses. See LICENSE for full details.
- HarmonyX is licensed under the MIT License. See LICENSE for the full License.
- MonoMod is licensed under the MIT License. See LICENSE for the full License.
- Mono.Cecil is licensed under the MIT License. See LICENSE for the full License.
- TinyJSON is licensed under the MIT License. See LICENSE for the full License.
- Tomlyn is licensed under the BSD 2-Clause "Simplified" License. See LICENSE for the full License.
- SharpZipLib is licensed under the MIT License. See LICENSE for the full License.
- UnityEngine.Il2CppAssetBundleManager is licensed under the Apache License, Version 2.0. See LICENSE for the full License.
- UnityEngine.Il2CppImageConversionManager is licensed under the Apache License, Version 2.0. See LICENSE for the full License.
- Illusion Plugin Architecture is licensed under the MIT License. See LICENSE for the full License.
- bHaptics Haptic Library is licensed under All rights reserved Copyright (c) 2016-2021 bHaptics Inc.
See Terms and Conditions for the full License. Express permission from the company.
External libraries and tools downloaded and used at runtime:
- Cpp2IL is licensed under the MIT License. See LICENSE for the full License.
- Il2CppDumper is licensed under the MIT License. See LICENSE for the full License.
- Il2CppAssemblyUnhollower is licensed under the GNU Lesser General Public License v3.0. See LICENSE for the full License.
- Unity Runtime Libraries from Unity-Runtime-Libraries are part of Unity Software.
Their usage is subject to Unity Terms of Service, including Unity Software Additional Terms.
See MelonLoader Wiki for the full Credits.
MelonLoader is not sponsored by, affiliated with or endorsed by Unity Technologies or its affiliates.
"Unity" is a trademark or a registered trademark of Unity Technologies or its affiliates in the U.S. and elsewhere.