MinecraftDownloader.Core 1.0.0

MinecraftDownloader

一个用于下载和安装 Minecraft 的 .NET 库，支持 Vanilla、Forge、Fabric 和 Quilt。

特性

• 支持多种 Minecraft 加载器：Vanilla、Forge、Fabric、Quilt
• 并行下载，可配置并发数
• SHA1 文件校验确保下载完整性
• 支持跳过已存在的文件
• 进度回调支持
• 可取消的异步操作
• 依赖注入友好设计

安装

dotnet add package MinecraftDownloader.Core

快速开始

基础用法

using MinecraftDownloader.Core.Models;
using MinecraftDownloader.Core.Orchestration;

// 创建安装器实例
var installer = MinecraftInstaller.CreateDefault();

// 创建安装请求
var request = new InstallRequest(
    GameVersion: "1.21.1",
    GameDirectory: @"C:\Games\.minecraft",
    Loader: LoaderKind.Vanilla,
    MaxParallelism: 128,
    SkipIfExists: true
);

// 执行安装
var result = await installer.InstallAsync(request);

if (result.Succeeded)
{
    Console.WriteLine($"安装成功！共下载 {result.Tasks.Count} 个文件，耗时 {result.Elapsed}");
}
else
{
    Console.WriteLine($"安装失败：{result.Error?.Message}");
}

安装 Fabric

var request = new InstallRequest(
    GameVersion: "1.21.1",
    GameDirectory: @"C:\Games\.minecraft",
    Loader: LoaderKind.Fabric,
    LoaderVersion: null,  // null 表示使用最新稳定版
    MaxParallelism: 128
);

安装 Forge

var request = new InstallRequest(
    GameVersion: "1.21.1",
    GameDirectory: @"C:\Games\.minecraft",
    Loader: LoaderKind.Forge,
    LoaderVersion: "52.0.0"
);

进度回调

var progress = new Progress<DownloadProgress>(p =>
{
    Console.WriteLine($"[{p.Completed}/{p.Total}] {p.Kind}: {p.CurrentFile}");
});

var result = await installer.InstallAsync(request, progress);

取消操作

using var cts = new CancellationTokenSource();

// 在需要时取消
// cts.Cancel();

var result = await installer.InstallAsync(request, progress, cts.Token);

API 参考

InstallRequest

LoaderKind

public enum LoaderKind
{
    Vanilla,
    Forge,
    Fabric,
    Quilt
}

InstallResult

架构

项目采用分层架构设计：

• Abstractions - 核心接口定义
• Models - 数据模型
• Manifest - 版本清单解析（Mojang、Forge、Fabric）
• Pipeline - 下载任务构建管道
• Download - 并行下载执行器
• Storage - 本地存储提供者
• Verify - 文件校验（SHA1）
• Orchestration - 顶层 API 编排

依赖注入

库设计为 DI 友好，可以与 Microsoft.Extensions.DependencyInjection 等容器集成：

services.AddSingleton<HttpClient>();
services.AddSingleton<IStorageProvider, LocalStorageProvider>();
services.AddSingleton<IFileVerifier, Sha1FileVerifier>();
services.AddSingleton<IManifestParser, MojangManifestParser>();
services.AddSingleton<IForgeMetaResolver, ForgeMetaResolver>();
services.AddSingleton<IFabricMetaResolver, FabricMetaResolver>();
services.AddSingleton<IFabricMetaResolver, QuiltMetaResolver>();
services.AddSingleton<IDownloadPipeline, DownloadPipeline>();
services.AddSingleton<IDownloadExecutor, ParallelDownloadExecutor>();
services.AddSingleton<MinecraftInstaller>();

许可证

MIT License

Copyright (c) 2026 墨渊