跳到主要内容

关于核心

🎮 BedrockLauncher.Core

Minecraft Bedrock Edition 核心管理库
用于安装、切换、启动、卸载 Minecraft UWP 版本的 .NET 核心库，支持多版本管理、背景自定义、自动依赖补全和开发者模式控制。

License .NET

📌 简介​

BedrockLauncher.Core 是一个轻量级、高性能的 .NET 库，专为 Minecraft Bedrock（UWP 版） 的版本管理而设计。它允许第三方启动器实现以下功能：

  • ✅ 自动下载并安装指定版本的 Minecraft
  • ✅ 切换不同游戏版本（多开支持）
  • ✅ 启动/关闭游戏实例
  • ✅ 自定义启动画面背景
  • ✅ 自动开启 Windows 开发者模式
  • ✅ 自动补全 VC++ 与 UWP 运行库
  • ✅ 多线程断点续传下载器
  • ✅ 完整的安装进度与状态回调

适用于构建属于你自己的 Minecraft 启动器 或 版本管理工具。

🔧 核心功能​

功能说明
📦 版本安装下载并注册 Minecraft UWP 包
🔁 版本切换支持多个版本共存与快速切换
▶️ 游戏启动调用系统协议启动指定版本
⏹️ 游戏关闭安全终止运行中的游戏进程
🖼️ 启动背景编辑修改 AppxManifest.xml 实现自定义启动图
⚙️ 自动环境配置自动启用开发者模式 & 安装运行库
📈 进度反馈提供下载、部署、安装全过程回调

🚀 快速开始​

1. 安装 NuGet 包（即将发布）​

目前为本地引用，未来将发布至 NuGet。

<!-- 在 .csproj 中引用 -->
<PackageReference Include="BedrockLauncher.Core" Version="1.0.0" />

2. 初始化核心​

using BedrockLauncher.Core;

// 初始化核心组件
var bedrockCore = new BedrockCore();
bedrockCore.Init();

3. Example​

var bedrockCore = new BedrockCore();
var coreOptions = new CoreOptions();
bedrockCore.Options = coreOptions;
bedrockCore.Init();
var versionInformations = VersionHelper.GetVersions("https://data.mcappx.com/v1/bedrock.json");
var cts = new CancellationTokenSource();
InstallCallback callback = new InstallCallback()
{
    zipProgress = new Progress<ZipProgress>((progress =>
    {
        Console.WriteLine(progress.ToString());
    })),
    CancellationToken = cts.Token,
    downloadProgress = (new Progress<DownloadProgress>((p =>
    {
        if (p.TotalBytes > 0)
        {
            Console.Write($"\r下载进度: {p.ProgressPercentage:F2}% ({p.DownloadedBytes / (1024.0 * 1024):F2} MB / {p.TotalBytes / (1024.0 * 1024):F2} MB)");
        }
        else
        {
            Console.Write($"\r已下载: {p.DownloadedBytes / (1024.0 * 1024):F2} MB (总大小未知)");
        }
    }))),
    registerProcess_percent = ((s, u) =>
    {

        Console.WriteLine(s + u);
    }),
    result_callback = ((status, exception) =>
    {

    }),
    install_states = (states =>
    {
        Console.WriteLine(states); ;
    })
};
var information = versionInformations[0];
bedrockCore.InstallVersion(information, Path.Combine(Directory.GetCurrentDirectory(),"testDir"),"./1.appx", callback);
bedrockCore.ChangeVersion(Path.Combine(Directory.GetCurrentDirectory(), "testDir"), callback);
bedrockCore.LaunchGame(VersionType.Preview);

4. 启动游戏​

// 先切换版本
 BedrockCore.ChangeVersion(@"C:\MyLauncher\Versions\1.20.15", callback);

// 再启动
 BedrockCore.LaunchGame(VersionType.Custom);

🛠️ 技术栈​

  • 语言：C# 9.0+
  • 平台：Windows 10 / 11（UWP）
  • 框架：.NET 8+
  • 依赖：
    • Windows.Management.Deployment（应用部署）
    • System.Threading.Tasks
    • System.Net.Http

📁 项目结构（简要）​

BedrockLauncher.Core/
├── Core/                   # 核心逻辑（BedrockCore）
├── JsonHandle/            # 版本信息数据模型
├── CoreOption/            # 配置选项
├── FrameworkComplete/     # 运行库自动安装
├── Native/                # WinRT API 调用封装
├── ManifestEditor/        # AppxManifest 修改工具
├── GameBackGroundEditer/  # 启动背景配置
└── Utils/                 # 下载器、进度类等

📄 许可证​

本项目采用 [MIT License]，欢迎用于学习、商业项目或二次开发。

Copyright (c) 2025 BedrockLauncher Team

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files, to deal in the Software
without restriction, including without limitation the rights to use, copy,
modify, merge, publish, distribute, sublicense, and/or sell copies of the
Software...

🤝 贡献​

欢迎提交 Issue 或 Pull Request！

  • 💬 报告 Bug → Issues
  • ✨ 提出建议 → Discussions
  • 🛠️ 参与开发 → Fork 本项目并提交 PR

📮 联系我们​

👏 鸣谢​

感谢以下对我们核心的支持！

✅ 现在就开始构建你自己的 Minecraft 启动器吧！