---

--- ## GENERAL INFORMATION: - Debug Mode is for Development Purposes. Use it to help Develop and Debug MelonLoader, Plugins, and 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.

- [The Official Wiki](https://melonwiki.xyz)

- [Proxies](https://github.com/LavaGang/MelonLoader/raw/master/#proxies) - [Launch Options](https://github.com/LavaGang/MelonLoader/raw/master/#launch-options) - [Debugging](https://melonwiki.xyz/#/modders/debugging)

- [Linux Support (__WINE / STEAM PROTON / NATIVE__)](https://melonwiki.xyz/#/README?id=linux-instructions) - [Android & Oculus Quest Support (__WIP__)](https://melonwiki.xyz/#/android/general)

| Usage Guides: | | - | | [INSTALLER](https://github.com/LavaGang/MelonLoader/raw/master/#how-to-use-the-installer) | | [MANUAL USE](https://github.com/LavaGang/MelonLoader/raw/master/#how-to-manually-use-melonloader) | | Example Projects: | | - | | [TestPlugin](https://github.com/LavaGang/TestPlugin) | | [TestMod](https://github.com/LavaGang/TestMod) | | Nightly Builds: | | - | | [master](https://nightly.link/LavaGang/MelonLoader/workflows/build/master) | | [alpha-development](https://nightly.link/LavaGang/MelonLoader/workflows/build/alpha-development) | | [universality](https://nightly.link/LavaGang/MelonLoader/workflows/build/universality) | --- ## ❤️ SPECIAL THANKS TO OUR WONDERFUL PATRONS ❤️ - **Givo** - **Florian Fahrenberger** - **Python** - **SirCoolness** - **SlidyDev** --- ## REQUIREMENTS: - [.NET Framework 3.5 Runtime](https://www.microsoft.com/en-us/download/details.aspx?id=21) - [.NET Framework 4.7.2 Runtime](https://dotnet.microsoft.com/download/dotnet-framework/net472) - [.NET Framework 4.8 Runtime](https://dotnet.microsoft.com/download/dotnet-framework/net48) - [.NET 6.0 Desktop Runtime](https://dotnet.microsoft.com/en-us/download/dotnet/6.0#runtime-6.0.15) - Microsoft Visual C++ 2015-2019 Re-distributable [[x86](https://aka.ms/vs/16/release/vc_redist.x86.exe)] [[x64](https://aka.ms/vs/16/release/vc_redist.x64.exe)] --- ## HOW TO USE THE INSTALLER: 1. Follow the Instructions in one of the Guides linked below. | Installer Guides: | | - | | [INSTALL](https://github.com/LavaGang/MelonLoader.Installer/blob/master/README.md#how-to-install-re-install-or-update-melonloader) | | [UPDATE](https://github.com/LavaGang/MelonLoader.Installer/blob/master/README.md#how-to-install-re-install-or-update-melonloader) | | [RE-INSTALL](https://github.com/LavaGang/MelonLoader.Installer/blob/master/README.md#how-to-install-re-install-or-update-melonloader) | | [UN-INSTALL](https://github.com/LavaGang/MelonLoader.Installer/blob/master/README.md#how-to-un-install-melonloader) | --- ## HOW TO MANUALLY USE MELONLOADER: ### UPDATE / RE-INSTALL: 1. Follow the Steps to [UN-INSTALL](https://github.com/LavaGang/MelonLoader/raw/master/#un-install) 2. Follow the Steps to [INSTALL](https://github.com/LavaGang/MelonLoader/raw/master/#install) ### INSTALL: 1. Make sure the Game is Closed and Not Running before attempting to Install. 2. Make sure you have all the [Requirements](https://github.com/LavaGang/MelonLoader/raw/master/#requirements) Installed before attempting to Install. 3. Download MelonLoader [[x86](https://github.com/LavaGang/MelonLoader/releases/latest/download/MelonLoader.x86.zip)] [[x64](https://github.com/LavaGang/MelonLoader/releases/latest/download/MelonLoader.x64.zip)] 4. Extract the MelonLoader folder from the MelonLoader Zip Archive to the Game's Installation Folder. 5. Extract version.dll & dobby.dll from the MelonLoader Zip Archive to the Game's Installation Folder. ### UN-INSTALL: 1. Make sure the Game is Closed and Not Running before attempting to UN-INSTALL. 2. Remove the version.dll & dobby.dll files from the Game's Installation Folder. 3. 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. 4. Remove the Plugins folder from the Game's Installation Folder. 5. Remove the Mods folder from the Game's Installation Folder. 6. Remove the UserData folder from the Game's Installation Folder. --- ## START SCREEN CUSTOMIZATION: - After Initial Launch the Start Screen will create a folder under `UserData/MelonStartScreen` - Inside this folder it will create a `Themes` folder and a `Config.cfg` file for Customization Settings. - You can also place Custom Themes in the created `Themes` folder. - Inside `Config.cfg` you can set what Theme folder you would like to use. - If you set your Theme folder to `Random` it will randomly pick and load from existing Themes. - For Custom Themes you can place Custom Images in their Theme folder to further customize it. - Listed below are the Compatible File Names and Extensions for the Custom Images. | Compatible File Names | | - | | Background | | Loading | | Logo | | Compatible Extensions | | - | | .gif | | .png | | .jpg | | .jpeg | --- ## LAUNCH OPTIONS: - These are additional Launch Options that MelonLoader adds to the Game. - These can be used to manipulate how MelonLoader works. | Argument | Description | | - | - | | --no-mods | Launches the Game without loading any Plugins or Mods | | --quitfix | Fixes the Hanging Process Issue with some Games | | --melonloader.consolemode | Changes the Theme Display Mode of the Console [ Default = 0 ] | | --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.maxlogs | Max Log Files [ Default: 10 ] [ NoCap: 0 ] | | --melonloader.maxwarnings | Max Warnings per Log File [ Default: 100 ] [ NoCap: 0 ] [ Disabled: -1 ] | | --melonloader.maxerrors | Max Errors per Log File [ Default: 100 ] [ NoCap: 0 ] [ Disabled: -1 ] | | --melonloader.loadmodeplugins | Load Mode for Plugins [ Default: 0 ] | | --melonloader.loadmodemods | Load Mode for Mods [ Default: 0 ] | | --melonloader.basedir | Changes the Proxy's Load Directory for the Bootstrap | | --melonloader.disablestartscreen | Disable the Start Screen | - These ones below are Unity Engine specific Launch Options. | Argument | Description | | - | - | | --melonloader.unityversion | Allows you to Specify the Version of Unity Engine | | --melonloader.agfoffline | Forces Assembly Generator to Run without Contacting the Remote API | | --melonloader.agfregenerate | Forces Regeneration of Assembly | | --melonloader.agfregex | Forces Assembly Generator to use a Specified Regex | | --melonloader.agfvdumper | Forces Assembly Generator to use a Specified Version of Dumper | | --melonloader.agfvunhollower | Forces Assembly Generator to use a Specified Version of Il2CppAssemblyUnhollower | | --melonloader.disableunityclc | Disable Unity Console Log Cleaner | --- ## LOAD MODES: - Load Mode Launch Options are a way to dictate how you want Mods or Plugins to Load. - Below is the Compatible Values 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 | --- ## CONSOLE DISPLAY MODES: - Console Display Modes are built in Themes for the Console - Below is the Compatible Values and what each of them do. | Value | Mode | | - | - | | 0 | Normal | | 1 | Magenta | | 2 | Rainbow | | 3 | Random Rainbow | --- ## PROXIES: - The Proxy DLL is able to be Renamed to the Compatible File Names below. - By Default the Proxy is named as "version.dll". - For most Games the Default File Name should work perfectly fine. - Some Games may have you use a different Proxy File Name depending on the Architecture, Operating System, version of the Engine used by the Game, etc. | File Names: | | - | | version.dll | | winhttp.dll | | winmm.dll | --- ## LICENSING & CREDITS: MelonLoader is licensed under the Apache License, Version 2.0. See [LICENSE](https://github.com/LavaGang/MelonLoader/blob/master/LICENSE.md) for the full License. Third-party Libraries used as Source Code and/or bundled in Binary Form: - [Research Detours Package](https://github.com/microsoft/Detours) is licensed under the MIT License. See [LICENSE](https://github.com/LavaGang/MelonLoader/blob/master/Bootstrap/Base/MSDetours/LICENSE.md) for the full License. - [Mono](https://github.com/Unity-Technologies/mono) is licensed under multiple licenses. See [LICENSE](https://github.com/Unity-Technologies/mono/raw/unity-master/LICENSE) for full details. - [HarmonyX](https://github.com/BepInEx/HarmonyX) is licensed under the MIT License. See [LICENSE](https://github.com/BepInEx/HarmonyX/raw/master/LICENSE) for the full License. - [MonoMod](https://github.com/MonoMod/MonoMod) is licensed under the MIT License. See [LICENSE](https://github.com/MonoMod/MonoMod/raw/master/LICENSE) for the full License. - [Mono.Cecil](https://github.com/jbevain/cecil) is licensed under the MIT License. See [LICENSE](https://github.com/jbevain/cecil/raw/master/LICENSE.txt) for the full License. - [Newtonsoft.Json](https://github.com/JamesNK/Newtonsoft.Json) is licensed under the MIT License. See [LICENSE](https://github.com/JamesNK/Newtonsoft.Json/blob/master/LICENSE.md) for the full License. - [TinyJSON](https://github.com/pbhogan/TinyJSON) is licensed under the MIT License. See [LICENSE](https://github.com/LavaGang/MelonLoader/blob/master/MelonLoader/TinyJSON/LICENSE.md) for the full License. - [Tomlet](https://github.com/SamboyCoding/Tomlet) is licensed under the MIT License. See [LICENSE](https://github.com/SamboyCoding/Tomlet/raw/master/LICENSE) for the full License. - [SharpZipLib](https://github.com/icsharpcode/SharpZipLib) is licensed under the MIT License. See [LICENSE](https://github.com/LavaGang/MelonLoader/raw/master/MelonLoader/SharpZipLib/LICENSE.txt) for the full License. - [Semver](https://github.com/maxhauser/semver) is licensed under the MIT License. See [LICENSE](https://github.com/maxhauser/semver/raw/master/License.txt) for the full License. - [UnityEngine.Il2CppAssetBundleManager](https://github.com/LavaGang/UnityEngine.Il2CppAssetBundleManager) is licensed under the Apache License, Version 2.0. See [LICENSE](https://github.com/LavaGang/UnityEngine.Il2CppAssetBundleManager/blob/master/LICENSE.md) for the full License. - [UnityEngine.Il2CppImageConversionManager](https://github.com/LavaGang/UnityEngine.Il2CppImageConversionManager) is licensed under the Apache License, Version 2.0. See [LICENSE](https://github.com/LavaGang/UnityEngine.Il2CppImageConversionManager/blob/master/LICENSE.md) for the full License. - [Illusion Plugin Architecture](https://github.com/Eusth/IPA) is licensed under the MIT License. See [LICENSE](https://github.com/Eusth/IPA/raw/master/LICENSE) for the full License. - [MuseDashModLoader](https://github.com/mo10/MuseDashModLoader) is licensed under the MIT License. See [LICENSE](https://github.com/mo10/MuseDashModLoader/raw/master/LICENSE) for the full License. - [mgGif](https://github.com/gwaredd/mgGif) is licensed under the MIT License. See [LICENSE](https://github.com/gwaredd/mgGif/raw/main/LICENSE) for the full License. - [AssetsTools.NET](https://github.com/nesrak1/AssetsTools.NET) is licensed under the MIT License. See [LICENSE](https://github.com/nesrak1/AssetsTools.NET/raw/master/LICENSE) for the full License. - [AssetRipper.VersionUtilities](https://github.com/AssetRipper/VersionUtilities) is licensed under the MIT License. See [LICENSE](https://github.com/AssetRipper/VersionUtilities/blob/master/License.md) for the full License. - Steam Library, VDF, and ACF Parsing from [SteamFinder.cs](https://github.com/Umbranoxio/BeatSaberModInstaller/raw/master/BeatSaberModManager/Dependencies/SteamFinder.cs) by [Umbranoxio](https://github.com/Umbranoxio) and [Dalet](https://github.com/Dalet). - [bHapticsLib](https://github.com/HerpDerpinstine/bHapticsLib) is licensed under the MIT License. See [LICENSE](https://github.com/HerpDerpinstine/bHapticsLib/blob/master/LICENSE.md) for the full License. - [IndexRange](https://github.com/bgrainger/IndexRange) is licensed under the MIT License. See [LICENSE](https://github.com/bgrainger/IndexRange/raw/master/LICENSE) for the full License. - [ValueTupleBridge](https://github.com/OrangeCube/MinimumAsyncBridge) is licensed under the MIT License. See [LICENSE](https://github.com/OrangeCube/MinimumAsyncBridge/raw/master/LICENSE) for the full License. - [WebSocketDotNet](https://github.com/SamboyCoding/WebSocketDotNet) is licensed under the MIT License. See [LICENSE](https://github.com/SamboyCoding/WebSocketDotNet/raw/master/LICENSE) for the full License. - [Pastel](https://github.com/silkfire/Pastel) is licensed under the MIT License. See [LICENSE](https://github.com/silkfire/Pastel/raw/master/LICENSE) for the full License. - [Il2CppInterop](https://github.com/BepInEx/Il2CppInterop) is licensed under LGPLv3 License. See [LICENSE](https://github.com/BepInEx/Il2CppInterop/raw/master/LICENSE) for the full License. External Libraries and Tools that are downloaded and used at Runtime: - [Cpp2IL](https://github.com/SamboyCoding/Cpp2IL) is licensed under the MIT License. See [LICENSE](https://github.com/SamboyCoding/Cpp2IL/raw/master/LICENSE) for the full License. - [Il2CppDumper](https://github.com/Perfare/Il2CppDumper) is licensed under the MIT License. See [LICENSE](https://github.com/Perfare/Il2CppDumper/raw/master/LICENSE) for the full License. - Unity Runtime Libraries from [Unity-Runtime-Libraries](https://github.com/LavaGang/Unity-Runtime-Libraries) are part of Unity Software. Their usage is subject to [Unity Terms of Service](https://unity3d.com/legal/terms-of-service), including [Unity Software Additional Terms](https://unity3d.com/legal/terms-of-service/software). See [MelonLoader Wiki](https://melonwiki.xyz/#/credits) 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.