Skip to content

The World's First Universal Mod Loader for Unity Games that is Compatible with both Il2Cpp and Mono

License

Notifications You must be signed in to change notification settings

yowchap/MelonLoader

 
 

Repository files navigation



GENERAL INFORMATION:

Nightly Builds:
master
alpha-development
Usage Guides:
INSTALLER
MANUAL USE
Example Projects:
TestPlugin
TestMod

REQUIREMENTS:


HOW TO USE THE INSTALLER:

  1. Follow the Instructions in one of the Guides linked below.
Installer Guides:
INSTALL
UPDATE
RE-INSTALL
UN-INSTALL

HOW TO MANUALLY USE MELONLOADER:

UPDATE / RE-INSTALL:

  1. Follow the Steps to UN-INSTALL
  2. Follow the Steps to INSTALL

INSTALL:

  1. Make sure the Game is Closed and Not Running before attempting to Install.
  2. Make sure you have all the Requirements Installed before attempting to Install.
  3. Download MelonLoader [x86] [x64]
  4. Extract the MelonLoader folder from the MelonLoader Zip Archive to the Game's Installation Folder.
  5. Extract version.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 file 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.

  1. Remove the Plugins folder from the Game's Installation Folder.
  2. Remove the Mods folder from the Game's Installation Folder.
  3. Remove the UserData folder from the Game's Installation Folder.

WINE / STEAM PROTON USAGE:

  • GUIDE COMING SOON

DNSPY DEBUGGER USAGE:

  1. Go into dnSpy, then in the top, select Debug -> Start Debugging and select Unity as the debug engine.
  2. Then, for the executable, select your game's executable
  3. And in the Arguments box, add --melonloader.debug and any other arguments you want
  4. Finally, to add breakpoints, simply drag and drop the mod you want to debug into dnSpy's Assembly Explorer, then add breakpoints regularly.

You can read more about attaching the dnSpy debugger in the MelonLoader wiki.


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.agfoffline Forces Assembly Generator to Run without Contacting the Remote API
--melonloader.agfregenerate Forces Regeneration of Assembly
--melonloader.agfvunity Forces Assembly Generator to use a Specified Version of Unity Dependencies
--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.basedir Changes the Proxy's Load Directory for the Bootstrap
--melonloader.disablestartscreen Disable the Start Screen
--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 Unity Games the Default File Name should work perfectly fine.
  • Some Unity Games may have you use a different Proxy File Name depending on the Architecture, Operating System, version of the Unity Engine used by the Game, etc.
File Names:
psapi.dll
version.dll
winhttp.dll
winmm.dll

LICENSING & CREDITS:

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:

External Libraries and Tools that are downloaded and used at Runtime:

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.

About

The World's First Universal Mod Loader for Unity Games that is Compatible with both Il2Cpp and Mono

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 66.5%
  • ASP.NET 19.2%
  • C++ 11.3%
  • Assembly 3.0%