Skip to content

Home

Jump to bottom
ifBars edited this page Feb 5, 2026 · 5 revisions

MLVScan Wiki

Welcome to the MLVScan wiki! This is your comprehensive guide to using MLVScan, a security-focused MelonLoader plugin designed to detect and prevent malicious mods from harming your system.

📚 Table of Contents

🔍 What is MLVScan?

MLVScan is a security tool that scans mods before they execute, detecting malicious patterns commonly found in malware. It supports MelonLoader, BepInEx 5.x, and BepInEx 6.x (Mono & Il2Cpp). It was created in response to a rise in malware mods being uploaded to modding sites like NexusMods.

✨ Key Features

  • Pre-load Scanning: Analyzes mods before execution
  • SHA256 Hash-Based Whitelisting: Uses cryptographic hashes for secure mod verification
  • Modular Detection Rules: Powered by MLVScan.Core
  • Cross-Platform Engine: Same detection engine used across MelonLoader, BepInEx 5.x/6.x, Web, and CLI
  • Detailed Threat Reports: Comprehensive findings with severity levels
  • Automatic Protection: Disables suspicious mods automatically
  • Developer CLI: Scan mods during development with remediation guidance and CI/CD integration

🚀 Quick Start

For MelonLoader

  1. Download the latest release from Releases
  2. Place MLVScan.MelonLoader.dll in your game's Plugins folder
  3. Launch your game - MLVScan will automatically scan all mods

For BepInEx 5.x

  1. Download the latest release from Releases
  2. Place MLVScan.BepInEx.dll in your game's BepInEx/patchers folder
  3. Launch your game - MLVScan will automatically scan all plugins

For BepInEx 6.x Mono

  1. Download the latest release from Releases
  2. Place MLVScan.BepInEx6.Mono.dll in your game's BepInEx/plugins folder
  3. Launch your game - MLVScan will automatically scan all plugins

For BepInEx 6.x Il2Cpp

  1. Download the latest release from Releases
  2. Place MLVScan.BepInEx6.IL2CPP.dll in your game's BepInEx/plugins folder
  3. Launch your game - MLVScan will automatically scan all plugins

🏗️ Architecture

MLVScan uses a modular architecture:

  • MLVScan (MelonLoader, BepInEx 5.x/6.x) - Runtime mod scanner
  • MLVScan.DevCLI - Developer CLI for mod development
  • MLVScan.Core - Shared scanning engine (NuGet package)
  • MLVScan.Web - Web-based scanner

📖 More Resources

⚠️ Important Security Notice

While MLVScan is designed to catch many malicious patterns, no security tool is perfect. Always:

  • Only download mods from trusted sources (NexusMods, Thunderstore)
  • Be cautious with newly uploaded mods
  • Read scan reports carefully before whitelisting
  • Keep your antivirus software updated

Clone this wiki locally