MLVScan

MLVScan is a security-focused mod loader plugin that protects your game by scanning mods for malicious patterns before they execute.

Supports MelonLoader, BepInEx 5.x, and BepInEx 6.x (Mono & Il2Cpp).

⚡ Quick Start

For MelonLoader

1. Download the latest MLVScan.MelonLoader.dll from Releases.
2. Install by dropping it into your game's Plugins folder.
3. Play! MLVScan automatically scans mods on startup.

For BepInEx 5.x

1. Download the latest MLVScan.BepInEx5.dll from Releases.
2. Install by dropping it into your game's BepInEx/patchers folder.
3. Play! MLVScan automatically scans plugins before they load.

For BepInEx 6.x Mono

1. Download the latest MLVScan.BepInEx6.Mono.dll from Releases.
2. Install by dropping it into your game's BepInEx/plugins folder.
3. Play! MLVScan automatically scans plugins before they load.

For BepInEx 6.x Il2Cpp

1. Download the latest MLVScan.BepInEx6.IL2CPP.dll from Releases.
2. Install by dropping it into your game's BepInEx/plugins folder.
3. Play! MLVScan automatically scans plugins before they load.

📚 Documentation

Detailed documentation is available in the MLVScan Wiki:

• Getting Started - Full installation and setup guide for both MelonLoader and BepInEx.
• Whitelisting - How to use the SHA256 security whitelist.
• Understanding Reports - Interpret warnings and security levels.
• Architecture - How the ecosystem works.
• FAQ - Common questions and troubleshooting.

Key Differences

MelonLoader:

• Runs as a plugin during the mod loading phase
• Configuration stored in MelonPreferences.cfg
• Reports saved to UserData/MLVScan/Reports/

BepInEx 5.x:

• Runs as a preloader patcher (scans before chainloader)
• Configuration stored in BepInEx/config/MLVScan.json
• Reports saved to BepInEx/MLVScan/Reports/
• Install via BepInEx/patchers folder

BepInEx 6.x (Mono / Il2Cpp):

• Runs as a plugin (scans during plugin initialization)
• Configuration stored in BepInEx/config/MLVScan.json (same as 5.x)
• Reports saved to BepInEx/MLVScan/Reports/ (same as 5.x)
• Uses [BepInPlugin] attribute-based packaging
• Supports both Mono and Il2Cpp runtimes

🛡️ Powered by MLVScan.Core

MLVScan is built on MLVScan.Core, a cross-platform malware detection engine. The same protection is also available for web browsers via MLVScan.Web.

🤝 Contributing

We welcome contributions! Please see the Contributing Guidelines in the Core repository for adding new detection rules.

---

Licensed under GPL-3.0