LemonLoader (https://lemonloader.com) is a cutting-edge modding framework derived from the popular MelonLoader, designed to inject powerful code mods into Unity-based games on Android—especially on standalone VR headsets like the Meta Quest. Whether you’re enhancing gameplay, unlocking hidden features, or building custom experiences, this guide walks you through every step of installing LemonLoader on any Android device.
⚠️ Disclaimer: Always mod games responsibly. Use trusted sources and avoid violating any terms of service.
đź§ What Is LemonLoader?
LemonLoader functions as a mod injector. When a Unity game starts, LemonLoader intercepts the launch process and loads custom .DLL
files found in mod folders. These files modify gameplay, add features, or unlock tools—far beyond what basic asset swaps can do.
Key characteristics:
- 🎮 Target: Unity-based games on Android or VR headsets (e.g., Meta Quest, Pico).
- đź”§ Root Not Required: No rooting needed, but Developer Mode + USB Debugging are essential.
- 📦 Sideloading: Since it’s not on Google Play, you’ll sideload the LemonLoader APK and compatible games.
âś… Prerequisites Checklist
Before diving in, ensure you have the following:
Requirement | Details |
---|---|
Android Device | Smartphone, tablet, or VR headset running Unity games |
PC | Windows recommended for easier sideloading and ADB/SideQuest tools |
USB Cable | For connecting Android device to PC |
ADB / SideQuest | ADB (command line) or SideQuest (UI-based, great for VR) |
LemonLoader APK | 📥 Download from lemonloader.com or trusted GitHub/modding forums |
Target Game APK/OBB | Get the correct version—most mods need a specific patch |
File Explorer (on device) | CX File Explorer or Solid Explorer for Android file management |
Code Mods (.DLL) | Mods downloaded from reputable communities like NexusMods, ModDB, or Discord groups |
🛠️ Step-by-Step Installation Process
🔌 Phase 1: Prepare Your PC & Android Device
- Install ADB or SideQuest
- Android SDK Platform Tools (for ADB)
- SideQuest (for Meta Quest VR)
- Enable Developer Options on Android:
- Go to Settings > About Device
- Tap Build Number 7 times until you see “You are now a developer.”
- Enable USB Debugging:
- Go to Settings > System > Developer Options
- Toggle USB Debugging ON and confirm.
- Connect Device to PC via USB:
- Accept the “Allow USB Debugging” prompt and check “Always allow.”
- Verify Connection:
- ADB:
adb devices
(should list your device) - SideQuest: Look for green “Connected” status
- ADB:
- (Optional) Sideload a File Explorer:
adb install path/to/CXFileExplorer.apk
- Or use SideQuest’s “Install APK” feature
🎮 Phase 2: Set Up the Target Game
- Check Game Version Compatibility:
- Refer to game-specific modding forums (e.g., Bonelab modding Discord)
- Uninstall Existing Game (if needed):
- If current version is too new, uninstall it.
- Get Compatible APK + OBB:
- Use reputable modding sources. NEVER download APKs from random websites.
- Sideload the Game:
adb install path/to/game.apk
- Place OBB at
/Android/obb/com.developer.game/
using:adb push obb_file.obb /sdcard/Android/obb/com.developer.game/
- or drag-and-drop via SideQuest
- Launch Game Once:
- This initializes required folders (e.g., Mods, UserData)
đź§© Phase 3: Install LemonLoader
- Download the Right LemonLoader APK:
- Sideload LemonLoader:
adb install path/to/LemonLoader.apk
- Or use SideQuest
- Open LemonLoader App:
- Find it in your app drawer or “Unknown Sources”
- Patch the Game:
- Select your game (e.g.,
com.developer.game
) - Tap Patch
- Wait for it to complete. Don’t close the app!
- Select your game (e.g.,
🚀 Phase 4: First Launch After Patching (Important!)
- Launch the Game Immediately:
- From your app drawer—not the store or system UI.
- “Restore App” Prompt (on Quest):
- Tap “Open App” or “Keep App”
- Do NOT choose “Restore App”—this will undo the patch!
- Black Screen = OK!
- The first launch may take 1–3 minutes. Let it finish.
- LemonLoader is injecting code and creating mod folders.
đź“‚ Phase 5: Add Code Mods (.DLL Files)
- Check LemonLoader Mod Folder:
/Android/data/com.developer.game/files/Mods/
- Download Mods to PC:
- Use only trusted forums, GitHub, or Discord servers
- Transfer Mods to Device:
- ADB:
adb push your_mod.dll /sdcard/Android/data/com.developer.game/files/Mods/
- SideQuest: Use file browser to navigate and drag/drop
- File Explorer App: Move mods from Downloads → Mods
- ADB:
- Launch the Game Again:
- Mods should load at startup!
- Some games show mod menus or console prompts on boot.
đź”§ Troubleshooting Tips
Issue | Solution |
---|---|
Game stuck on black screen | Confirm game version matches mod version. Be patient on first load. |
“Restore App” prompt broke patch | Reinstall LemonLoader and re-patch game. Avoid selecting “Restore.” |
OBB not loading | Verify OBB file exists in the correct directory. |
Mods not working | Ensure .dll files are in /Mods/ and check for missing dependencies. |
LemonLoader doesn’t detect game | APK may not be compatible or the game might not be Unity-based. |
🛡️ Stay Safe & Respectful
- 🔍 Always scan files for malware.
- 🧩 Respect developers’ work—don’t distribute pirated content.
- đź’¬ Join official communities for updates and support:
- LemonLoader Discord
- [Modding forums for your specific game]
🎉 Conclusion
LemonLoader unlocks endless possibilities for modding Unity games on Android—from small tweaks to game-changing enhancements. By following the guide above and ensuring compatibility, you’ll have your modded experience up and running in no time.
🟡 Learn more and get updates at https://lemonloader.com
Need help customizing this guide for a specific game like Bonelab, Blade & Sorcery: Nomad, or others? Just ask!