{"id":14960352,"url":"https://github.com/lavagang/melonloader","last_synced_at":"2025-05-11T11:02:58.517Z","repository":{"id":37104884,"uuid":"256651878","full_name":"LavaGang/MelonLoader","owner":"LavaGang","description":"The World's First Universal Mod Loader for Unity Games compatible with both Il2Cpp and Mono","archived":false,"fork":false,"pushed_at":"2025-03-27T23:44:25.000Z","size":457070,"stargazers_count":2990,"open_issues_count":46,"forks_count":513,"subscribers_count":39,"default_branch":"master","last_synced_at":"2025-04-23T03:08:30.563Z","etag":null,"topics":["dll","dotnet","framework","il2cpp","melonloader","mod","mod-loader","modding","mono","plugin","unity"],"latest_commit_sha":null,"homepage":"https://discord.gg/2Wn3N2P","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LavaGang.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://melonwiki.xyz/#/credits"]}},"created_at":"2020-04-18T02:16:35.000Z","updated_at":"2025-04-23T02:27:41.000Z","dependencies_parsed_at":"2023-02-12T02:45:44.575Z","dependency_job_id":"fcd25d26-0f26-40df-bad4-08af60dfb935","html_url":"https://github.com/LavaGang/MelonLoader","commit_stats":{"total_commits":1621,"total_committers":62,"mean_commits":26.14516129032258,"dds":0.3158544108574953,"last_synced_commit":"4242569146df4ba5984116ccb572db15aa61d7a4"},"previous_names":[],"tags_count":33,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LavaGang%2FMelonLoader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LavaGang%2FMelonLoader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LavaGang%2FMelonLoader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LavaGang%2FMelonLoader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LavaGang","download_url":"https://codeload.github.com/LavaGang/MelonLoader/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253554073,"owners_count":21926610,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dll","dotnet","framework","il2cpp","melonloader","mod","mod-loader","modding","mono","plugin","unity"],"created_at":"2024-09-24T13:22:06.237Z","updated_at":"2025-05-11T11:02:58.486Z","avatar_url":"https://github.com/LavaGang.png","language":"C#","readme":"\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/LavaGang/MelonLoader.Installer/master/Resources/ML_Icon.png\"\u003e\u003c/a\u003e\n  \u003ca href=\"#\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/LavaGang/MelonLoader.Installer/master/Resources/ML_Text.png\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n\u003cp align=\"center\"\u003e\n\t\u003ca href=\"https://github.com/LavaGang/MelonLoader/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/LavaGang/MelonLoader?label=latest\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n\t\u003ca href=\"https://github.com/LavaGang/MelonLoader/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/downloads/LavaGang/MelonLoader/total.svg?style=for-the-badge\"\u003e\u003c/a\u003e\n\t\u003ca href=\"https://github.com/LavaGang/MelonLoader/graphs/contributors\"\u003e\u003cimg src=\"https://img.shields.io/github/contributors/LavaGang/MelonLoader?style=for-the-badge\"\u003e\u003c/a\u003e\n\t\u003ca href=\"https://discord.gg/2Wn3N2P\"\u003e\u003cimg src=\"https://img.shields.io/discord/663449315876012052?label=discord\u0026style=for-the-badge\u0026color=blueviolet\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\t\u003ca href=\"https://github.com/LavaGang/MelonLoader.Installer/releases/latest/download/MelonLoader.Installer.exe\"\u003e\u003cimg src=\"https://img.shields.io/github/downloads/LavaGang/MelonLoader.Installer/latest/MelonLoader.Installer.exe?style=for-the-badge\u0026label=Windows%20Installer\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\t\u003ca href=\"https://github.com/LavaGang/MelonLoader.Installer/releases/latest/download/MelonLoader.Installer.Linux\"\u003e\u003cimg src=\"https://img.shields.io/github/downloads/LavaGang/MelonLoader.Installer/latest/MelonLoader.Installer.Linux?style=for-the-badge\u0026label=Linux%20Installer\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## GENERAL INFORMATION:\n\n- Debug Mode is for Development Purposes.  \nUse it to help Develop and Debug MelonLoader, Plugins, and Mods.\n\u003cbr\u003e\u003c/br\u003e\n- All Logs are made in the created `MelonLoader/Logs` folder in your Game's Installation Folder.\n- All Plugins get placed in the created `Plugins` folder in your Game's Installation Folder.\n- All Mods get placed in the created `Mods` folder in your Game's Installation Folder.\n\u003cbr\u003e\u003c/br\u003e\n- [The Official Wiki](https://melonwiki.xyz)\n\u003cbr\u003e\u003c/br\u003e\n- [Proxies](#proxies)\n- [Launch Options](#launch-options)\n- [Debugging](https://melonwiki.xyz/#/modders/debugging)\n\u003cbr\u003e\u003c/br\u003e\n- [Linux Support (__WINE / STEAM PROTON / NATIVE__)](https://melonwiki.xyz/#/README?id=linux-instructions)\n- [Android \u0026 Oculus Quest Support (__WIP__)](https://melonwiki.xyz/#/android/general)\n\u003cbr\u003e\u003c/br\u003e\n\n| Usage Guides: |\n| - |\n| [INSTALLER](#how-to-use-the-installer) |\n| [MANUAL USE](#how-to-manually-use-melonloader) |\n\n| Example Projects: |\n| - |\n| [TestPlugin](https://github.com/LavaGang/TestPlugin) |\n| [TestMod](https://github.com/LavaGang/TestMod) |\n\n| Nightly Builds: |\n| - |\n| [master](https://nightly.link/LavaGang/MelonLoader/workflows/build/master) |\n| [alpha-development](https://nightly.link/LavaGang/MelonLoader/workflows/build/alpha-development) |\n| [universality](https://nightly.link/LavaGang/MelonLoader/workflows/build/universality) |\n\n---\n\n## ❤️ SPECIAL THANKS TO OUR WONDERFUL PATRONS ❤️\n\n- **Givo**  \n- **Florian Fahrenberger**  \n- **Python**  \n- **SirCoolness**  \n- **SlidyDev**  \n\n---\n\n## REQUIREMENTS:\n\n### Il2Cpp Games:\n- [.NET 6.0 Desktop Runtime](https://dotnet.microsoft.com/en-us/download/dotnet/6.0#runtime-6.0.15)\n\u003e On Windows, the .NET 6.0 Desktop Runtime will be installed automatically\n\n---\n\n## HOW TO USE THE INSTALLER:\n\n1. Follow the Instructions in one of the Guides linked below.\n\n| Installer Guides: |\n| - |\n| [INSTALL](https://github.com/LavaGang/MelonLoader.Installer/blob/master/README.md#how-to-install-re-install-or-update-melonloader) |\n| [UPDATE](https://github.com/LavaGang/MelonLoader.Installer/blob/master/README.md#how-to-install-re-install-or-update-melonloader) |\n| [RE-INSTALL](https://github.com/LavaGang/MelonLoader.Installer/blob/master/README.md#how-to-install-re-install-or-update-melonloader) |\n| [UN-INSTALL](https://github.com/LavaGang/MelonLoader.Installer/blob/master/README.md#how-to-un-install-melonloader) |\n\n---\n\n## HOW TO MANUALLY USE MELONLOADER:\n\n### UPDATE / RE-INSTALL:\n\n1. Follow the Steps to [UN-INSTALL](#un-install)\n2. Follow the Steps to [INSTALL](#install)\n\n\n### INSTALL:\n\n1. Make sure the Game is Closed and Not Running before attempting to Install.\n2. Make sure you have all the [Requirements](#requirements) Installed before attempting to Install.\n3. 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)]\n4. Extract the MelonLoader folder from the MelonLoader Zip Archive to the Game's Installation Folder.\n5. Extract version.dll \u0026 dobby.dll from the MelonLoader Zip Archive to the Game's Installation Folder.\n\n\n### UN-INSTALL:\n\n1. Make sure the Game is Closed and Not Running before attempting to UN-INSTALL.\n2. Remove the version.dll file from the Game's Installation Folder.\n3. Remove the MelonLoader folder from the Game's Installation Folder.\n\nThese additional steps below are OPTIONAL if you want to do a FULL UN-INSTALL.\n\n4. Remove the Plugins folder from the Game's Installation Folder.\n5. Remove the Mods folder from the Game's Installation Folder.\n6. Remove the UserData folder from the Game's Installation Folder.\n\n---\n\n## CONFIG:\n\nMelonLoader has its own config file at `./UserData/Loader.cfg` (you need to run MelonLoader at least once for it to appear).\n\nHere is a list of the current config options (and their default values):\n```toml\n[loader]\n# Disables MelonLoader. Equivalent to the '--no-mods' launch option\ndisable = false\n# Equivalent to the '--melonloader.debug' launch option\ndebug_mode = true\n# Only use this if the game freezes when trying to quit. Equivalent to the '--quitfix' launch option\nforce_quit = false\n# Disables the start screen. Equivalent to the '--melonloader.disablestartscreen' launch option\ndisable_start_screen = false\n# Starts the dotnet debugger (only for Il2Cpp games). Equivalent to the '--melonloader.launchdebugger' launch option\nlaunch_debugger = false\n# Sets the loader theme. Currently, the only available themes are \"Normal\" and \"Lemon\". Equivalent to the '--melonloader.consolemode' launch option (0 for Normal, 4 for Lemon)\ntheme = \"Normal\"\n\n[console]\n# Hides warnings from displaying. Equivalent to the '--melonloader.hidewarnings' launch option\nhide_warnings = false\n# Hides the console. Equivalent to the '--melonloader.hideconsole' launch option\nhide_console = false\n# Forces the console to always stay on-top of all other applications. Equivalent to the '--melonloader.consoleontop' launch option\nconsole_on_top = false\n# Keeps the console title as original. Equivalent to the '--melonloader.consoledst' launch option\ndont_set_title = false\n\n[logs]\n# Sets the maximum amount of log files in the Logs folder (Default: 10). Equivalent to the '--melonloader.maxlogs' launch option\nmax_logs = 10\n\n[unityengine]\n# Overrides the detected UnityEngine version. Equivalent to the '--melonloader.unityversion' launch option\nversion_override = \"\"\n# Disables the console log cleaner (only applies to Il2Cpp games). Equivalent to the '--melonloader.disableunityclc' launch option\ndisable_console_log_cleaner = false\n# Forces the Il2Cpp Assembly Generator to run without contacting the remote API. Equivalent to the '--melonloader.agfoffline' launch option\nforce_offline_generation = false\n# Forces the Il2Cpp Assembly Generator to use the specified regex. Equivalent to the '--melonloader.agfregex' launch option\nforce_generator_regex = \"\"\n# Forces the Il2Cpp Assembly Generator to use the specified Il2Cpp dumper version. Equivalent to the '--melonloader.agfvdumper' launch option\nforce_il2cpp_dumper_version = \"\"\n# Forces the Il2Cpp Assembly Generator to always regenerate assemblies. Equivalent to the '--melonloader.agfregenerate' launch option\nforce_regeneration = false\n# Enables the CallAnalyzer processor for Cpp2IL. Equivalent to the '--cpp2il.callanalyzer' launch option\nenable_cpp2il_call_analyzer = false\n# Enables the NativeMethodDetector processor for Cpp2IL. Equivalent to the '--cpp2il.nativemethoddetector' launch option\nenable_cpp2il_native_method_detector = false\n```\n\n---\n\n## LAUNCH OPTIONS:\n\n- These are additional Launch Options that MelonLoader adds to the Game.\n- These can be used to manipulate how MelonLoader works.\n\n| Argument | Description |\n| - | - |\n| --no-mods | Launches the Game without loading any Plugins or Mods |\n| --quitfix | Fixes the Hanging Process Issue with some Games |\n| --melonloader.consolemode | Changes the Theme Display Mode of the Console [ Default = 0 ] |\n| --melonloader.consoleontop | Forces the Console to always stay on-top of all other Applications |\n| --melonloader.consoledst | Keeps the Console Title as Original |\n| --melonloader.hideconsole | Hides the Console |\n| --melonloader.hidewarnings | Hides Warnings from Displaying |\n| --melonloader.debug | Debug Mode |\n| --melonloader.maxlogs | Max Log Files [ Default: 10 ] [ NoCap: 0 ] |\n| --melonloader.loadmodeplugins | Load Mode for Plugins [ Default: 0 ] |\n| --melonloader.loadmodemods | Load Mode for Mods [ Default: 0 ] |\n| --melonloader.basedir | Changes the Proxy's Load Directory for the Bootstrap |\n| --melonloader.disablestartscreen | Disable the Start Screen |\n\n\n- These ones below are Unity Engine specific Launch Options.\n\n| Argument | Description |\n| - | - |\n| --melonloader.unityversion | Allows you to Specify the Version of Unity Engine |\n| --melonloader.agfoffline | Forces Assembly Generator to Run without Contacting the Remote API |\n| --melonloader.agfregenerate | Forces Regeneration of Assembly |\n| --melonloader.agfregex | Forces Assembly Generator to use a Specified Regex |\n| --melonloader.agfvdumper | Forces Assembly Generator to use a Specified Version of Dumper |\n| --melonloader.disableunityclc | Disable Unity Console Log Cleaner |\n\n\n- These ones below are Cpp2IL specific Launch Options.\n\n| Argument | Description |\n| - | - |\n| --cpp2il.callanalyzer | Enables CallAnalyzer processor |\n| --cpp2il.nativemethoddetector | Enables NativeMethodDetector processor |\n\n---\n\n## PROXIES:\n\nMelonLoader uses a proxy DLL to trick the game into loading itself on startup. This only applies for Windows.\n\n- The Proxy DLL is able to be Renamed to the Compatible File Names below.\n- By Default the Proxy is named as \"version.dll\".\n- For most Games the Default File Name should work perfectly fine.\n- 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.\n\n| File Names: |\n| - |\n| version.dll |\n| winhttp.dll |\n| winmm.dll |\n| dinput.dll |\n| dinput8.dll |\n| dsound.dll |\n| d3d8.dll |\n| d3d9.dll |\n| d3d10.dll |\n| d3d11.dll |\n| d3d12.dll |\n| ddraw.dll |\n| msacm32.dll |\n\n---\n\n## LICENSING \u0026 CREDITS:\n\nMelonLoader is licensed under the Apache License, Version 2.0. See [LICENSE](https://github.com/LavaGang/MelonLoader/blob/master/LICENSE.md) for the full License.\n\nThird-party Libraries used as Source Code and/or bundled in Binary Form:\n- [Dobby](https://github.com/jmpews/Dobby) is licensed under the Apache License, Version 2.0. See [LICENSE](https://github.com/jmpews/Dobby/blob/master/LICENSE) for the full License.\n- [Mono](https://github.com/Unity-Technologies/mono) is licensed under multiple licenses. See [LICENSE](https://github.com/Unity-Technologies/mono/blob/unity-master/LICENSE) for full details.\n- [HarmonyX](https://github.com/BepInEx/HarmonyX) is licensed under the MIT License. See [LICENSE](https://github.com/BepInEx/HarmonyX/blob/master/LICENSE) for the full License.\n- [MonoMod](https://github.com/MonoMod/MonoMod) is licensed under the MIT License. See [LICENSE](https://github.com/MonoMod/MonoMod/blob/master/LICENSE) for the full License.\n- [Mono.Cecil](https://github.com/jbevain/cecil) is licensed under the MIT License. See [LICENSE](https://github.com/jbevain/cecil/blob/master/LICENSE.txt) for the full License.\n- [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.\n- [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.\n- [Tomlet](https://github.com/SamboyCoding/Tomlet) is licensed under the MIT License. See [LICENSE](https://github.com/SamboyCoding/Tomlet/blob/master/LICENSE) for the full License.\n- [AsmResolver](https://github.com/Washi1337/AsmResolver) is licensed under the MIT License. See [LICENSE](https://github.com/Washi1337/AsmResolver/blob/master/LICENSE.md) for the full License.\n- [SharpZipLib](https://github.com/icsharpcode/SharpZipLib) is licensed under the MIT License. See [LICENSE](https://github.com/LavaGang/MelonLoader/blob/master/MelonLoader/SharpZipLib/LICENSE.txt) for the full License.\n- [Semver](https://github.com/maxhauser/semver) is licensed under the MIT License. See [LICENSE](https://github.com/maxhauser/semver/blob/master/License.txt) for the full License.\n- [Illusion Plugin Architecture](https://github.com/Eusth/IPA) is licensed under the MIT License. See [LICENSE](https://github.com/Eusth/IPA/blob/master/LICENSE) for the full License.\n- [MuseDashModLoader](https://github.com/mo10/MuseDashModLoader) is licensed under the MIT License. See [LICENSE](https://github.com/mo10/MuseDashModLoader/blob/master/LICENSE) for the full License.\n- [mgGif](https://github.com/gwaredd/mgGif) is licensed under the MIT License. See [LICENSE](https://github.com/gwaredd/mgGif/blob/main/LICENSE) for the full License.\n- [AssetsTools.NET](https://github.com/nesrak1/AssetsTools.NET) is licensed under the MIT License. See [LICENSE](https://github.com/nesrak1/AssetsTools.NET/blob/master/LICENSE) for the full License.\n- [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.\n- Steam Library, VDF, and ACF Parsing from [SteamFinder.cs](https://github.com/Umbranoxio/BeatSaberModInstaller/blob/master/BeatSaberModManager/Dependencies/SteamFinder.cs) by [Umbranoxio](https://github.com/Umbranoxio) and [Dalet](https://github.com/Dalet).\n- [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. \n- [IndexRange](https://github.com/bgrainger/IndexRange) is licensed under the MIT License. See [LICENSE](https://github.com/bgrainger/IndexRange/blob/master/LICENSE) for the full License.  \n- [ValueTupleBridge](https://github.com/OrangeCube/MinimumAsyncBridge) is licensed under the MIT License. See [LICENSE](https://github.com/OrangeCube/MinimumAsyncBridge/blob/master/LICENSE) for the full License.  \n- [WebSocketDotNet](https://github.com/SamboyCoding/WebSocketDotNet) is licensed under the MIT License. See [LICENSE](https://github.com/SamboyCoding/WebSocketDotNet/blob/master/LICENSE) for the full License.\n- [Pastel](https://github.com/silkfire/Pastel) is licensed under the MIT License. See [LICENSE](https://github.com/silkfire/Pastel/blob/master/LICENSE) for the full License.\n- [Il2CppInterop](https://github.com/BepInEx/Il2CppInterop) is licensed under the LGPLv3 License. See [LICENSE](https://github.com/BepInEx/Il2CppInterop/blob/master/LICENSE) for the full License.\n\nExternal Libraries and Tools that are downloaded and used at Runtime:\n- [Cpp2IL](https://github.com/SamboyCoding/Cpp2IL) is licensed under the MIT License. See [LICENSE](https://github.com/SamboyCoding/Cpp2IL/blob/master/LICENSE) for the full License.\n- Unity Runtime Libraries from [MelonLoader.UnityDependencies](https://github.com/LavaGang/MelonLoader.UnityDependencies) are part of Unity Software.  \nTheir 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).\n- [.NET Runtime](https://github.com/dotnet/runtime) is licensed under the MIT License. See [LICENSE](https://github.com/dotnet/runtime/blob/main/LICENSE.TXT) for the full License.\n\nSee [MelonLoader Wiki](https://melonwiki.xyz/#/credits) for the full Credits.\n\nMelonLoader is not sponsored by, affiliated with or endorsed by Unity Technologies or its affiliates.  \n\"Unity\" is a trademark or a registered trademark of Unity Technologies or its affiliates in the U.S. and elsewhere.\n","funding_links":["https://melonwiki.xyz/#/credits"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flavagang%2Fmelonloader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flavagang%2Fmelonloader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flavagang%2Fmelonloader/lists"}