Frequently Asked Questions

Welcome to the MelonLoader FAQ page! Below, you’ll find answers to common questions about MelonLoader, the universal mod loader for Unity games. Whether you’re new to modding or a seasoned developer, we’ve got you covered. 😊

• What is MelonLoader?

• MelonLoader is a universal mod loader designed for games built with the Unity engine. It allows you to easily load and manage custom mods for a wide variety of Unity games. This powerful tool supports both Mono and Il2Cpp games, enhancing the modding experience by injecting custom code into Unity games at runtime.

• What games does MelonLoader support?

• MelonLoader is compatible with a vast array of Unity games, both Mono and Il2Cpp. While it can work with many Unity-based games, always check the game's community or official documentation for MelonLoader compatibility.

• How do I install MelonLoader?

• You can install MelonLoader using either the Automated Installer or the Manual Installation method.
  • Automated Installation: Download and run MelonLoader.Installer.exe, select the game’s .exe file, and click install. It’s that simple!
  • Manual Installation: Download the appropriate version for your game (x86 or x64), extract the necessary files to your game’s directory, and follow the instructions.

  For more detailed steps, visit our installation guide.

• Does MelonLoader work on Linux?

• Yes, starting from version 0.6.0, MelonLoader offers native Linux support. You can also use MelonLoader with Windows games running on Linux using Proton. We provide instructions on how to use LD_PRELOAD and other methods for running MelonLoader with your games on Linux.

• Do I need any additional software for MelonLoader?

• Yes, there are a few dependencies required to run MelonLoader, such as:
  • .NET Framework (for Windows)
  • Microsoft Visual C++ Redistributables
  • .NET 6.0 Desktop Runtime for Il2Cpp games Make sure you have these installed before using MelonLoader.

• How do I uninstall MelonLoader?

• To uninstall MelonLoader, follow these steps:
  • Remove the version.dll and dobby.dll files from your game’s installation folder.
  • Delete the MelonLoader folder.
  • Optionally, you can remove the Plugins, Mods, and UserData folders for a full uninstall.

• Can I customize the MelonLoader start screen?

• Yes, after the initial launch, MelonLoader creates a UserData/MelonStartScreen folder where you can customize the start screen. You can add custom themes, change the logo, and even randomize the start screen design.

• What are some useful launch options for MelonLoader?

• MelonLoader supports several command-line launch options to control how it behaves. Some of the most common options include:
  • --no-mods: Launch the game without loading any mods or plugins.
  • --melonloader.hideconsole: Hide the MelonLoader console during gameplay.
  • --melonloader.debug: Enable debug mode for detailed logging.

• How do I update MelonLoader?

• To update MelonLoader, simply re-run the installer and select the latest version, or manually replace the MelonLoader.dll and related files in your game’s directory. Always ensure your mods are compatible with the new version.

• Is MelonLoader open-source?

• Yes, MelonLoader is open-source and licensed under the Apache 2.0 License. You can view and contribute to the source code on our GitHub page.

• Where can I find mods for MelonLoader?

• Mods for MelonLoader can often be found in the respective game communities, modding forums, and the Officially Supported Games list on our site. Always ensure you download mods from trusted sources.

• Why is my game crashing with MelonLoader?

• If your game crashes after installing MelonLoader, check the following:
  • Make sure the mods you are using are compatible with the version of MelonLoader and the game.
  • Disable mods one by one to see if one of them is causing the issue.
  • Ensure you’re using the latest version of MelonLoader.