download melonloader

MelonLoader -The World's First Universal Mod Loader for Unity Games

MelonLoader is an open-source mod loader for Unity games, letting you add custom mods, plugins, and tweaks easily—no need to alter original game files. It’s fast, flexible, and works on popular platforms like Steam and Epic Games.

What is MelonLoader?

MelonLoader is the official, community-driven mod loader for games built with the Unity engine. Whether you’re a casual player wanting fun tweaks or a developer working on plugin systems, MelonLoader gives you powerful modding capabilities—safely and cleanly.

🛡️ Reminder: MelonLoader is intended for single-player experiences or mod-supported titles. Cheating in multiplayer games is strictly discouraged.

System Requirements

To use MelonLoader smoothly, make sure your system includes:

RequirementWhy It’s NeededNotes
Microsoft Visual C++ 2015–2019Required runtime supportInstall x64 or x86 based on your game
.NET Desktop Runtime 6.0Needed for IL2CPP games (botnet 6.0)Choose the correct version (x64/x86)
Windows Task ManagerTo detect architecture of your gameCheck if “(32-bit)” shows next to game

🎯 Check Architecture Tip:
Run the game and open Task Manager. If the game’s name includes “(32 bit)”, it’s 32-bit—otherwise, it’s 64-bit.

Installing MelonLoader

🚀 Automatic Installation

  1. Download the latest MelonLoader Installer.

  2. Open it — it will scan your system for Unity-based games.

  3. Pick the game you want to mod.

  4. Select the correct version (match your game’s architecture).

  5. Click Install.

Supported Launchers (Windows & Linux):

LauncherWindows Support ✅Linux Support ✅
Steam✅✅
Epic Games✅❌
GOG✅❌
Other (Manual)✅✅

If your game isn’t auto-detected, click “Add Game Manually” and select its folder.

Manual Installation (Advanced)

  1. Download:

  2. Extract contents into the game’s main folder (where the .exe is located).

  3. Place both:

    • The MelonLoader folder

    • The version.dll file

  4. Run the game.

⚠️ Be sure the version matches your game architecture. Check via Task Manager if needed.

Linux Installation (Proton / Native)

For Proton / Wine

Use this launch option:

bash- WINEDLLOVERRIDES=“version=n,b” %command%
 

Also, install .NET Desktop Runtime using:

bash – protontricks <appid> dotnetdesktop6

For Native Linux Games

Set LD_LIBRARY_PATH and LD_PRELOAD in your launch options:

bash – LD_LIBRARY_PATH=“/path/to/game:$LD_LIBRARY_PATH” LD_PRELOAD=“libversion.so” %command%

🔐 Proton/Wine users: If Cpp2IL fails, try running:

bash – chmod +x MelonLoader/Cpp2IL/Cpp2IL

Optional Nightly Builds

Want bleeding-edge features? Enable Nightly Builds (with caution):
  • Click the Nightly Builds checkbox in the installer.

  • Updates pull directly from the development branch.

  • May include bugs or incomplete features.

Use only if you understand the risks.

Launch Options Cheat Sheet

Here are useful command-line arguments to tweak your experience:

  • –no-mods
    Disables all mods/plugins

  • –quitfix
    Fixes games hanging on exit

  • –melonloader.consolemode
    Sets console color mode

  • –melonloader.consoleontop
    Forces console to stay on top

  • –melonloader.consoledst
    Keeps default console title

  • –melonloader.hideconsole
    Hides the console window

  • –melonloader.hidewarnings
    Hides warning messages

  • –melonloader.debug
    Enables debug logging

  • –melonloader.maxlogs
    Sets max log count (0 = unlimited)

  • –melonloader.loadmodeplugins
    Changes plugin load mode

  • –melonloader.loadmodemods
    Changes mod load mode

  • –melonloader.basedir
    Specifies a custom mod directory

  • –melonloader.disablestartscreen
    Hides the MelonLoader splash screen

Troubleshooting

❌ Cpp2IL Permissions on Linux

If Cpp2IL fails to run:

bash – chmod +x MelonLoader/Cpp2IL/Cpp2IL

⛔ Game Doesn’t Launch

  • Double-check if you’re using the right version (x64/x86)

  • Try removing mods/plugins temporarily

  • Check logs in the MelonLoader folder 

Mods & Plugins

⚠️ Please respect modding guidelines and don’t use mods to cheat in online games.

Need Help?

Final Notes