DrMod 1.5.2

dotnet add package DrMod --version 1.5.2
                    
NuGet\Install-Package DrMod -Version 1.5.2
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="DrMod" Version="1.5.2" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="DrMod" Version="1.5.2" />
                    
Directory.Packages.props
<PackageReference Include="DrMod" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add DrMod --version 1.5.2
                    
#r "nuget: DrMod, 1.5.2"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package DrMod@1.5.2
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=DrMod&version=1.5.2
                    
Install as a Cake Addin
#tool nuget:?package=DrMod&version=1.5.2
                    
Install as a Cake Tool

NuGet GitHub Repo Commits Lines of Code NuGet Downloads

DrMod

DrMod is a .NET 8 library for analyzing, validating, and managing Minecraft mods for Forge, NeoForge, Fabric, and Quilt. It provides advanced tools for reading mod metadata, dependency analysis, conflict detection, crash report resolution, performance analysis, world compatibility checking, modpack importing, and more.

Features

  • Cross-loader support: Forge, NeoForge, Fabric, Quilt
  • Read mod metadata from JARs or metadata files
  • Detect required/optional dependencies and incompatibilities
  • Validate mods and mod folders
  • Detect duplicate/conflicting/incompatible mods
  • Analyze crash reports to identify problematic mods
  • Query mods by loader, Minecraft version, dependencies, and more
  • Performance analysis and memory usage estimation
  • World/save compatibility checking
  • Modpack importing (.mrpack and .zip support)
  • Mod corruption detection and repair
  • Mod enable/disable functionality

Installation

Add the DrMod project to your solution or reference the DLL. Target .NET 8 or later.

Usage

Creating an Analyzer

using DrMod;

var analyzer = new DrMod();

API Reference with Examples

Java Detection Methods

GetRequiredJavaVersion(string modPath)

Get the required Java version for a mod (e.g., 8, 17, 21).

Example:

var javaVersion = analyzer.GetRequiredJavaVersion(@"C:\mods\jei.jar");
Console.WriteLine($"JEI requires Java {javaVersion}+");
FindRequiredJavaVersion(string modPath)

Get the required Java version for a mod (e.g., 8, 17, 21).

Example:

var jdkPath = analyzer.FindRequiredJavaVersion(@"C:\mods\jei.jar");
if (jdkPath != null)
    Console.WriteLine($"Found suitable JDK at: {jdkPath}");
else
    Console.WriteLine("No suitable JDK found for this mod's requirements.");

Performance & Resource Analysis Methods

GetModFileSize(string modPath)

Get the file size of a mod in bytes.

Example:

var fileSize = analyzer.GetModFileSize(@"C:\mods\jei.jar");
Console.WriteLine($"JEI file size: {fileSize / (1024 * 1024)} MB");

// Batch check sizes
var mods = Directory.GetFiles(@"C:\mods", "*.jar");
Console.WriteLine("Mod file sizes:");
foreach (var mod in mods)
{
    var size = analyzer.GetModFileSize(mod);
    var name = Path.GetFileNameWithoutExtension(mod);
    Console.WriteLine($"  {name}: {size / (1024 * 1024)} MB");
}
GetModsByMemoryUsage(string folderPath, bool sortDescending = true)

Get all mods in a folder sorted by estimated memory usage.

Example:

var modsByMemory = analyzer.GetModsByMemoryUsage(@"C:\mods", true);
Console.WriteLine("Mods sorted by memory usage (heaviest first):");

foreach (var mod in modsByMemory.Take(10))
{
    var perfInfo = analyzer.GetModPerformanceInfo(@"C:\mods\" + mod.modFileName);
    Console.WriteLine($"  {mod.name}: {perfInfo.EstimatedMemoryUsageMB} MB ({perfInfo.PerformanceCategory})");
}
DetectPerformanceImpactingMods(string folderPath)

Detect mods that may have performance impact.

Example:

var heavyMods = analyzer.DetectPerformanceImpactingMods(@"C:\mods");

if (heavyMods.Count > 0)
{
    Console.WriteLine($"āš ļø Found {heavyMods.Count} performance-impacting mods:");
    foreach (var modId in heavyMods)
    {
        var mod = analyzer.GetModById(modId, @"C:\mods");
        Console.WriteLine($"  - {mod?.name ?? modId}");
    }
    Console.WriteLine("\nšŸ’” Consider reviewing these mods if experiencing performance issues.");
}
GetModPerformanceInfo(string modPath)

Get detailed performance information for a mod.

Example:

var perfInfo = analyzer.GetModPerformanceInfo(@"C:\mods\create.jar");
Console.WriteLine($"=== Performance Analysis: {perfInfo.ModName} ===");
Console.WriteLine($"File Size: {perfInfo.FileSizeBytes / (1024 * 1024)} MB");
Console.WriteLine($"Estimated Memory: {perfInfo.EstimatedMemoryUsageMB} MB");
Console.WriteLine($"Performance Category: {perfInfo.PerformanceCategory}");

if (perfInfo.PerformanceWarnings.Count > 0)
{
    Console.WriteLine("Warnings:");
    foreach (var warning in perfInfo.PerformanceWarnings)
    {
        Console.WriteLine($"  āš ļø {warning}");
    }
}

Metadata & Validation Methods

ReadModMetadata(string filePath)

Read metadata from a mod JAR or metadata file.

Example:

// Reading from a JAR file
var metadata = analyzer.ReadModMetadata(@"C:\mods\jei-1.20.1-15.2.0.27.jar");
if (metadata != null)
{
    Console.WriteLine($"Mod ID: {metadata.modId}");
    Console.WriteLine($"Name: {metadata.name}");
    Console.WriteLine($"Version: {metadata.modVersion}");
    Console.WriteLine($"Loader: {metadata.loader}");
}

// Reading from a metadata file directly
var fabricMeta = analyzer.ReadModMetadata(@"C:\fabric.mod.json");
var forgeMeta = analyzer.ReadModMetadata(@"C:\META-INF\mods.toml");
ReadAllModMetadataInFolder(string folderPath)

Read metadata for all mods in a folder.

Example:

var allMods = analyzer.ReadAllModMetadataInFolder(@"C:\Minecraft\mods");
Console.WriteLine($"Found {allMods.Count} mods:");

foreach (var mod in allMods)
{
    Console.WriteLine($"- {mod.name} ({mod.modId}) v{mod.modVersion} [{mod.loader}]");
}

// Filter by specific criteria
var forgeMods = allMods.Where(m => m.loader == "Forge").ToList();
var fabricMods = allMods.Where(m => m.loader == "Fabric").ToList();
ValidateMod(string modPath)

Validate a single mod and return a list of errors.

Example:

var errors = analyzer.ValidateMod(@"C:\mods\examplemod.jar");

if (errors.Count == 0)
{
    Console.WriteLine("āœ… Mod is valid!");
}
else
{
    Console.WriteLine("āŒ Mod validation errors:");
    foreach (var error in errors)
    {
        Console.WriteLine($"  - {error}");
    }
}

Example output: āŒ Mod validation errors:

  • Missing modId.
  • Missing Minecraft version.
  • Duplicate required dependency: forge
ValidateModsFolder(string folderPath)

Validate all mods in a folder and detect folder-wide issues.

Example:

var folderErrors = analyzer.ValidateModsFolder(@"C:\Minecraft\mods");

if (folderErrors.Count == 0)
{
    Console.WriteLine("āœ… All mods in folder are valid!");
}
else
{
    Console.WriteLine($"āŒ Found {folderErrors.Count} issues:");
    foreach (var error in folderErrors)
    {
        Console.WriteLine($"  {error}");
    }
}

Example output: āŒ Found 3 issues: [badmod.jar] Missing modId. Duplicate modId detected: jei Multiple Minecraft versions detected in mods folder: 1.20.1, 1.19.4 [modA] is incompatible with [modB]

Mod Health & Corruption Detection

FindCorruptedMods(string folderPath)

Find corrupted mod files that can't be read or have invalid metadata.

Example:

var corruptedMods = analyzer.FindCorruptedMods(@"C:\mods");

if (corruptedMods.Count > 0)
{
    Console.WriteLine($"šŸ”“ Found {corruptedMods.Count} corrupted mods:");
    foreach (var corruptedMod in corruptedMods)
    {
        Console.WriteLine($"  - {Path.GetFileName(corruptedMod)}");
    }
    Console.WriteLine("\nšŸ’” Consider re-downloading these mods.");
}
else
{
    Console.WriteLine("āœ… No corrupted mods detected!");
}
RepairMod(string modPath)

Attempt to repair a corrupted mod.

Example:

var corruptedMods = analyzer.FindCorruptedMods(@"C:\mods");
foreach (var corruptedMod in corruptedMods)
{
    Console.WriteLine($"Attempting to repair: {Path.GetFileName(corruptedMod)}");
    bool repaired = analyzer.RepairMod(corruptedMod);
    
    if (repaired)
        Console.WriteLine("  āœ… Repair successful!");
    else
        Console.WriteLine("  āŒ Repair failed - consider re-downloading");
}

World/Save Compatibility

IsModSafeToRemove(string modId, string folderPath)

Check if a mod is safe to remove (no other mods depend on it).

Example:

string modToRemove = "optifine";
bool isSafe = analyzer.IsModSafeToRemove(modToRemove, @"C:\mods");

if (isSafe)
{
    Console.WriteLine($"āœ… {modToRemove} is safe to remove - no dependencies");
}
else
{
    var dependents = analyzer.GetDependents(modToRemove, @"C:\mods");
    Console.WriteLine($"āš ļø {modToRemove} is required by {dependents.Count} other mods:");
    foreach (var dependent in dependents)
    {
        Console.WriteLine($"  - {dependent}");
    }
}
GetWorldRequiredMods(string worldPath)

Get list of required mods for a world/save.

Example:

var requiredMods = analyzer.GetWorldRequiredMods(@"C:\Minecraft\saves\MyWorld");

Console.WriteLine($"World requires {requiredMods.Count} mods:");
foreach (var modId in requiredMods)
{
    Console.WriteLine($"  - {modId}");
}

// Check if current mods satisfy world requirements
var installedMods = analyzer.ReadAllModMetadataInFolder(@"C:\mods")
    .Select(m => m.modId).Where(id => !string.IsNullOrEmpty(id)).ToHashSet();

var missingMods = requiredMods.Where(mod => !installedMods.Contains(mod)).ToList();
if (missingMods.Count > 0)
{
    Console.WriteLine($"\nāŒ Missing {missingMods.Count} required mods for this world!");
}
CheckWorldCompatibility(string worldPath, string modsFolder)

Check compatibility between a world and current mod setup.

Example:

var compatibility = analyzer.CheckWorldCompatibility(@"C:\Minecraft\saves\MyWorld", @"C:\mods");

Console.WriteLine($"=== World Compatibility Report ===");
Console.WriteLine($"Compatible: {(compatibility.IsCompatible ? "āœ… YES" : "āŒ NO")}");
Console.WriteLine($"Minecraft Version: {compatibility.MinecraftVersion}");
Console.WriteLine($"Mod Loader: {compatibility.ModLoader}");

if (compatibility.MissingMods.Count > 0)
{
    Console.WriteLine($"\nMissing Mods ({compatibility.MissingMods.Count}):");
    foreach (var mod in compatibility.MissingMods)
    {
        Console.WriteLine($"  - {mod}");
    }
}

if (compatibility.Warnings.Count > 0)
{
    Console.WriteLine($"\nWarnings:");
    foreach (var warning in compatibility.Warnings)
    {
        Console.WriteLine($"  āš ļø {warning}");
    }
}

Modpack Management

ImportModPack(string modPackPath, string destinationPath)

Import a modpack from .mrpack (Modrinth) or .zip (CurseForge) file.

Example:

// Import Modrinth modpack
bool success = analyzer.ImportModPack(@"C:\Downloads\mypack.mrpack", @"C:\mods");
if (success)
{
    Console.WriteLine("āœ… Modrinth modpack imported successfully!");
}

// Import CurseForge modpack
success = analyzer.ImportModPack(@"C:\Downloads\cursepack.zip", @"C:\mods");
if (success)
{
    Console.WriteLine("āœ… CurseForge modpack imported successfully!");
}
else
{
    Console.WriteLine("āŒ Failed to import modpack");
}

// Validate imported mods
var errors = analyzer.ValidateModsFolder(@"C:\mods");
Console.WriteLine($"Imported modpack validation: {(errors.Count == 0 ? "āœ… Success" : $"āŒ {errors.Count} issues")}");

Mod Enable/Disable Management

DisableMod(string modPath)

Disable a mod by renaming it to .disabled extension.

Example:

string modToDisable = @"C:\mods\problematic-mod.jar";
bool disabled = analyzer.DisableMod(modToDisable);

if (disabled)
{
    Console.WriteLine($"āœ… Mod disabled: {Path.GetFileName(modToDisable)}.disabled");
}
else
{
    Console.WriteLine($"āŒ Failed to disable mod (already disabled or file not found)");
}

// Batch disable performance-heavy mods
var heavyMods = analyzer.DetectPerformanceImpactingMods(@"C:\mods");
foreach (var modId in heavyMods)
{
    var modFile = Directory.GetFiles(@"C:\mods", "*.jar")
        .FirstOrDefault(f => analyzer.ReadModMetadata(f)?.modId == modId);
    
    if (modFile != null)
    {
        analyzer.DisableMod(modFile);
        Console.WriteLine($"Disabled heavy mod: {Path.GetFileName(modFile)}");
    }
}
EnableMod(string disabledModPath)

Enable a disabled mod by removing the .disabled extension.

Example:

// Find all disabled mods
var disabledMods = Directory.GetFiles(@"C:\mods", "*.disabled");
Console.WriteLine($"Found {disabledMods.Length} disabled mods:");

foreach (var disabledMod in disabledMods)
{
    Console.WriteLine($"  - {Path.GetFileName(disabledMod)}");
    
    // Ask user or apply logic to determine which to enable
    bool shouldEnable = true; // Your logic here
    
    if (shouldEnable)
    {
        bool enabled = analyzer.EnableMod(disabledMod);
        if (enabled)
        {
            Console.WriteLine($"    āœ… Re-enabled!");
        }
        else
        {
            Console.WriteLine($"    āŒ Failed to enable (target file may already exist)");
        }
    }
}

Compatibility & Conflict Detection Methods

IsCompatible(string modPath, string mcVersion, string loader, string loaderVersion)

Check if a mod is compatible with specific game/loader versions.

Example:

// Check compatibility with specific versions
bool isCompatible = analyzer.IsCompatible(
    @"C:\mods\jei.jar",
    mcVersion: "1.20.1",
    loader: "Forge",
    loaderVersion: "47.1.0"
);

Console.WriteLine($"JEI is compatible: {isCompatible}");

// Batch check multiple mods
var mods = Directory.GetFiles(@"C:\mods", "*.jar");
var targetMC = "1.20.1";
var targetLoader = "Forge";
var targetLoaderVer = "47.1.0";

foreach (var mod in mods)
{
    var compatible = analyzer.IsCompatible(mod, targetMC, targetLoader, targetLoaderVer);
    var modName = Path.GetFileNameWithoutExtension(mod);
    Console.WriteLine($"{modName}: {(compatible ? "āœ…" : "āŒ")}");
}
DetectConflicts(List<string> modPaths)

Detect duplicate mod IDs in a list of mod files.

Example:

var modFiles = Directory.GetFiles(@"C:\mods", "*.jar").ToList();
var conflicts = analyzer.DetectConflicts(modFiles);

if (conflicts.Count > 0)
{
    Console.WriteLine("šŸ”“ Conflicting mods detected:");
    foreach (var conflict in conflicts)
    {
        Console.WriteLine($"  Duplicate mod ID: {conflict}");
        // Find which files have the same ID
        var conflictingFiles = modFiles.Where(f => 
        {
            var meta = analyzer.ReadModMetadata(f);
            return meta?.modId == conflict;
        });
        foreach (var file in conflictingFiles)
        {
            Console.WriteLine($"    - {Path.GetFileName(file)}");
        }
    }
}
DetectIncompatibilities(List<string> modPaths)

Detect explicit incompatibilities between mods.

Example:

var modFiles = Directory.GetFiles(@"C:\mods", "*.jar").ToList();
var incompatibilities = analyzer.DetectIncompatibilities(modFiles);

if (incompatibilities.Count > 0)
{
    Console.WriteLine("āš ļø Incompatible mods detected:");
    foreach (var (modId, incompatibleWith) in incompatibilities)
    {
        Console.WriteLine($"  {modId} is incompatible with {incompatibleWith}");
    }
    Console.WriteLine("\nšŸ’” Consider removing one mod from each incompatible pair.");
}

Dependency Analysis Methods

GetRequiredDependencies(string modPath)

Get required dependencies for a mod.

Example:

var requiredDeps = analyzer.GetRequiredDependencies(@"C:\mods\jei.jar");

Console.WriteLine("Required dependencies:");
foreach (var dep in requiredDeps)
{
    Console.WriteLine($"  - {dep}");
}

Example output: Required dependencies:

  • forge
  • minecraft
GetOptionalDependencies(string modPath)

Get optional dependencies for a mod.

Example:

var optionalDeps = analyzer.GetOptionalDependencies(@"C:\mods\jei.jar");

Console.WriteLine("Optional dependencies:");
foreach (var dep in optionalDeps)
{
    Console.WriteLine($"  - {dep}");
}
GetIncompatibilities(string modPath)

Get explicit incompatibilities for a mod.

Example:

var incompatibilities = analyzer.GetIncompatibilities(@"C:\mods\optifine.jar");

if (incompatibilities.Count > 0)
{
    Console.WriteLine("āš ļø This mod is incompatible with:");
    foreach (var inc in incompatibilities)
    {
        Console.WriteLine($"  - {inc}");
    }
}
GetAllDependencies(string modPath, bool includeOptional = false)

Recursively get all (transitive) dependencies for a mod.

Example:

// Get only required dependencies (including transitive)
var allRequired = analyzer.GetAllDependencies(@"C:\mods\complexmod.jar", false);

// Get all dependencies including optional ones
var allDeps = analyzer.GetAllDependencies(@"C:\mods\complexmod.jar", true);

Console.WriteLine($"Total required dependencies: {allRequired.Count}");
Console.WriteLine($"Total dependencies (inc. optional): {allDeps.Count}");

Console.WriteLine("\nFull dependency tree:");
foreach (var dep in allDeps)
{
    Console.WriteLine($"  - {dep}");
}
GetDependents(string modId, string folderPath)

Get all mods that depend on a given mod.

Example:

var dependents = analyzer.GetDependents("jei", @"C:\mods");

Console.WriteLine($"Mods that depend on JEI ({dependents.Count}):");
foreach (var dependent in dependents)
{
    Console.WriteLine($"  - {dependent}");
}

// Useful for understanding impact of removing a mod
if (dependents.Count > 0)
{
    Console.WriteLine($"\nāš ļø Removing JEI will affect {dependents.Count} other mods!");
}
GetModsWithMissingDependencies(string folderPath)

Get mods that have missing required dependencies.

Example:

var modsWithMissingDeps = analyzer.GetModsWithMissingDependencies(@"C:\mods");

if (modsWithMissingDeps.Count > 0)
{
    Console.WriteLine($"šŸ”“ {modsWithMissingDeps.Count} mods have missing dependencies:");
    foreach (var modId in modsWithMissingDeps)
    {
        var modPath = Directory.GetFiles(@"C:\mods", "*.jar")
            .FirstOrDefault(f => analyzer.ReadModMetadata(f)?.modId == modId);
        if (modPath != null)
        {
            var requiredDeps = analyzer.GetRequiredDependencies(modPath);
            var availableMods = analyzer.ReadAllModMetadataInFolder(@"C:\mods")
                .Select(m => m.modId).ToHashSet();
            var missingDeps = requiredDeps.Where(dep => !availableMods.Contains(dep));
            Console.WriteLine($"  {modId}:");
            foreach (var missing in missingDeps)
            {
                Console.WriteLine($"    - Missing: {missing}");
            }
        }
    }
}

Mod Query & Summary Methods

GetModById(string modId, string folderPath)

Get metadata for a mod by its ID.

Example:

var jeiMeta = analyzer.GetModById("jei", @"C:\mods");

if (jeiMeta != null)
{
    Console.WriteLine($"Found JEI: {jeiMeta.name} v{jeiMeta.modVersion}");
    Console.WriteLine($"Description: {jeiMeta.description}");
}
else
{
    Console.WriteLine("JEI not found in mods folder");
}
GetModVersion(string modPath)

Get the version of a mod.

Example:

var version = analyzer.GetModVersion(@"C:\mods\jei.jar");
Console.WriteLine($"JEI version: {version ?? "Unknown"}");

// Batch check versions
var mods = Directory.GetFiles(@"C:\mods", "*.jar");
Console.WriteLine("Mod versions:");
foreach (var mod in mods)
{
    var ver = analyzer.GetModVersion(mod);
    var name = Path.GetFileNameWithoutExtension(mod);
    Console.WriteLine($"  {name}: {ver ?? "Unknown"}");
}
GetModFileName(string modId, string folderPath)

Get the file name of a mod by its ID.

Example:

var fileName = analyzer.GetModFileName("jei", @"C:\mods");
if (fileName != null)
{
    Console.WriteLine($"JEI file: {fileName}");
    // You can now use this to get the full path
    var fullPath = Path.Combine(@"C:\mods", fileName);
    Console.WriteLine($"Full path: {fullPath}");
}
GetModSummary(string modPath)

Get a comprehensive summary string of all key metadata.

Example:

var summary = analyzer.GetModSummary(@"C:\mods\jei.jar");
Console.WriteLine("=== JEI Summary ===");
Console.WriteLine(summary);

Example output:

=== JEI Summary === ID: jei Name: Just Enough Items Version: 15.2.0.27 Loader: Forge LoaderVersion: 47.1.0 MCVersion: 1.20.1 Required: [forge, minecraft] Optional: [waila, nei] Incompatibilities: [toomanyitems]

GetModsByLoader(string loader, string folderPath)

Get all mods in a folder that use a specific loader.

Example:

var forgeMods = analyzer.GetModsByLoader("Forge", @"C:\mods");
var fabricMods = analyzer.GetModsByLoader("Fabric", @"C:\mods");

Console.WriteLine($"Forge mods ({forgeMods.Count}):");
foreach (var mod in forgeMods)
{
    Console.WriteLine($"  - {mod.name} ({mod.modId})");
}

Console.WriteLine($"\nFabric mods ({fabricMods.Count}):");
foreach (var mod in fabricMods)
{
    Console.WriteLine($"  - {mod.name} ({mod.modId})");
}

// Check for mixed loaders (potential issue)
if (forgeMods.Count > 0 && fabricMods.Count > 0)
{
    Console.WriteLine("\nāš ļø Warning: Mixed Forge and Fabric mods detected!");
}
GetModsByMinecraftVersion(string mcVersion, string folderPath)

Get all mods compatible with a specific Minecraft version.

Example:

var mods1201 = analyzer.GetModsByMinecraftVersion("1.20.1", @"C:\mods");
var mods1194 = analyzer.GetModsByMinecraftVersion("1.19.4", @"C:\mods");

Console.WriteLine($"Mods compatible with 1.20.1 ({mods1201.Count}):");
foreach (var mod in mods1201)
{
    Console.WriteLine($"  - {mod.name} ({mod.minecraftVersion})");
}

// Find mods that work with multiple versions
var modsWithWildcard = analyzer.GetModsByMinecraftVersion("1.20.x", @"C:\mods");
Console.WriteLine($"\nMods supporting 1.20.x ({modsWithWildcard.Count}):");
foreach (var mod in modsWithWildcard)
{
    Console.WriteLine($"  - {mod.name}");
}

Crash Report Analysis

ResolveCrashReport(string modsFolderPath, string crashReport)

Analyze a crash report to identify potentially problematic mods.

Example:

// Read crash report from file
var crashReport = File.ReadAllText(@"C:\crash-reports\crash-2023-12-01.txt");

// Analyze the crash
var result = analyzer.ResolveCrashReport(@"C:\mods", crashReport);

if (result is List<string> suspiciousMods)
{
    Console.WriteLine($"šŸ” Found {suspiciousMods.Count} potentially problematic mods:");
    foreach (var modId in suspiciousMods)
    {
        var modMeta = analyzer.GetModById(modId, @"C:\mods");
        if (modMeta != null)
        {
            Console.WriteLine($"  - {modMeta.name} ({modId}) v{modMeta.modVersion}");
        }
        else
        {
            Console.WriteLine($"  - {modId}");
        }
    }
    Console.WriteLine("\nšŸ’” Try removing these mods one by one to isolate the issue.");
    Console.WriteLine("šŸ’” Check for mod updates or compatibility issues.");
}
else
{
    Console.WriteLine("ā„¹ļø No obvious problematic mods identified in crash report.");
    Console.WriteLine("šŸ’” The crash might be caused by:");
    Console.WriteLine("   - Missing dependencies");
    Console.WriteLine("   - Incompatible mod versions");
    Console.WriteLine("   - Java/Minecraft version issues");
}

// Advanced: Combine with other analysis
var missingDeps = analyzer.GetModsWithMissingDependencies(@"C:\mods");
if (missingDeps.Count > 0)
{
    Console.WriteLine($"\nāš ļø Also check missing dependencies for {missingDeps.Count} mods");
}

Complete Example: Comprehensive Mod Folder Analysis

Here's a comprehensive example that uses multiple methods to analyze a mods folder:

using DrMod;

class Program
{
    static void Main()
    {
        var analyzer = new DrMod();
        var modsPath = @"C:\Minecraft\mods";
        
        Console.WriteLine("=== DrMod Analysis Report ===\n");
        
        // 1. Basic folder validation
        var errors = analyzer.ValidateModsFolder(modsPath);
        Console.WriteLine($"šŸ“‹ Validation: {(errors.Count == 0 ? "āœ… PASSED" : $"āŒ {errors.Count} ISSUES")}");
        
        if (errors.Count > 0)
        {
            foreach (var error in errors.Take(5)) // Show first 5 errors
            {
                Console.WriteLine($"   {error}");
            }
            if (errors.Count > 5) Console.WriteLine($"   ... and {errors.Count - 5} more");
        }
        
        // 2. Mod inventory
        var allMods = analyzer.ReadAllModMetadataInFolder(modsPath);
        Console.WriteLine($"\nšŸ“¦ Total mods: {allMods.Count}");
        
        var byLoader = allMods.GroupBy(m => m.loader).ToDictionary(g => g.Key, g => g.Count());
        foreach (var (loader, count) in byLoader)
        {
            Console.WriteLine($"   {loader}: {count} mods");
        }
        
        // 3. Performance analysis
        var heavyMods = analyzer.DetectPerformanceImpactingMods(modsPath);
        Console.WriteLine($"\n⚔ Performance: {(heavyMods.Count == 0 ? "āœ… OPTIMIZED" : $"āš ļø {heavyMods.Count} HEAVY MODS")}");
        
        if (heavyMods.Count > 0)
        {
            var modsByMemory = analyzer.GetModsByMemoryUsage(modsPath, true);
            Console.WriteLine("   Top memory users:");
            foreach (var mod in modsByMemory.Take(3))
            {
                var perfInfo = analyzer.GetModPerformanceInfo(Path.Combine(modsPath, mod.modFileName ?? ""));
                Console.WriteLine($"     {mod.name}: {perfInfo.EstimatedMemoryUsageMB} MB");
            }
        }
        
        // 4. Health check
        var corruptedMods = analyzer.FindCorruptedMods(modsPath);
        Console.WriteLine($"\nšŸ„ Health: {(corruptedMods.Count == 0 ? "āœ… HEALTHY" : $"šŸ”“ {corruptedMods.Count} CORRUPTED")}");
        
        // 5. Dependency analysis
        var missingDeps = analyzer.GetModsWithMissingDependencies(modsPath);
        Console.WriteLine($"\nšŸ”— Dependencies: {(missingDeps.Count == 0 ? "āœ… ALL SATISFIED" : $"āŒ {missingDeps.Count} MISSING")}");
        
        // 6. Conflict detection
        var conflicts = analyzer.DetectConflicts(Directory.GetFiles(modsPath, "*.jar").ToList());
        var incompatibilities = analyzer.DetectIncompatibilities(Directory.GetFiles(modsPath, "*.jar").ToList());
        
        Console.WriteLine($"\nāš”ļø Conflicts: {conflicts.Count} duplicates, {incompatibilities.Count} incompatibilities");
        
        // 7. Most depended-on mods
        Console.WriteLine("\n🌟 Most popular dependencies:");
        var dependencyCounts = new Dictionary<string, int>();
        
        foreach (var mod in allMods)
        {
            foreach (var dep in mod.requiredDependencies)
            {
                dependencyCounts[dep] = dependencyCounts.GetValueOrDefault(dep, 0) + 1;
            }
        }
        
        var topDeps = dependencyCounts.OrderByDescending(kvp => kvp.Value).Take(5);
        foreach (var (dep, count) in topDeps)
        {
            Console.WriteLine($"   {dep}: required by {count} mods");
        }
        
        // 8. World compatibility (if world path provided)
        var worldPath = @"C:\Minecraft\saves\MyWorld";
        if (Directory.Exists(worldPath))
        {
            var compatibility = analyzer.CheckWorldCompatibility(worldPath, modsPath);
            Console.WriteLine($"\nšŸŒ World Compatibility: {(compatibility.IsCompatible ? "āœ… COMPATIBLE" : "āŒ ISSUES")}");
            if (compatibility.MissingMods.Count > 0)
            {
                Console.WriteLine($"   Missing: {string.Join(", ", compatibility.MissingMods.Take(3))}");
            }
        }
        
        Console.WriteLine("\nāœ… Analysis complete!");
    }
}

License

MIT

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net8.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

🚀 DrMod 1.5.2 Release Notes

added icon