
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:
Requirement | Why It’s Needed | Notes |
---|---|---|
Microsoft Visual C++ 2015–2019 | Required runtime support | Install x64 or x86 based on your game |
.NET Desktop Runtime 6.0 | Needed for IL2CPP games (botnet 6.0) | Choose the correct version (x64/x86) |
Windows Task Manager | To detect architecture of your game | Check 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
Download the latest MelonLoader Installer.
Open it — it will scan your system for Unity-based games.
Pick the game you want to mod.
Select the correct version (match your game’s architecture).
Click Install.
Supported Launchers (Windows & Linux):
Launcher | Windows 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)
Download:
MelonLoader.x64.zip
for 64-bit gamesMelonLoader.x86.zip
for 32-bit games,
Extract contents into the game’s main folder (where the .exe is located).
Place both:
The
MelonLoader
folderThe
version.dll
file
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:
Also, install .NET Desktop Runtime using:
For Native Linux Games
Set LD_LIBRARY_PATH
and LD_PRELOAD
in your launch options:
Proton/Wine users: If Cpp2IL fails, try running:
Optional Nightly Builds
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:
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
Discord or game-specific modding communities
Please respect modding guidelines and don’t use mods to cheat in online games.
Need Help?
#support
channel. When asking for help, include:Game title and architecture (32/64-bit)
What you’ve tried
Error logs/screenshots