ObsMCLauncher - 黑曜石MC启动器

🎮 一个现代化、美观的 Minecraft 启动器

---

📖 简介

ObsMCLauncher 是一款采用现代 UI 设计的 Minecraft 启动器，提供流畅的游戏管理体验。

---

运行要求

• Windows 10/11 (x64)
• .NET 8.0 Desktop Runtime
  • 如果运行时提示缺少 .NET，请下载并安装上述 Runtime

---

🔧 快速开始

前置要求

• Windows 10/11 (x64)
• .NET 8.0 SDK

构建运行

# 克隆项目
git clone https://github.com/x1aoren/ObsMCLauncher.git
cd ObsMCLauncher

# 还原依赖
dotnet restore

# 构建项目
dotnet build

# 运行启动器
dotnet run

发布为可执行文件

dotnet publish -c Release -r win-x64 -p:PublishSingleFile=true

---

📦 项目结构

ObsMCLauncher/
├── App.xaml                         # 全局样式和主题配置
├── MainWindow.xaml                  # 主窗口（导航框架）
├── Assets/                          # 资源文件
│   ├── LoaderIcons/                 # 模组加载器图标
│   └── mod_translations.txt         # MOD中文翻译数据
├── Pages/                           # 页面目录
│   ├── HomePage.xaml                # 主页（版本列表）
│   ├── AccountManagementPage.xaml   # 账号管理页面
│   ├── VersionDownloadPage.xaml     # 版本下载页面
│   ├── VersionDetailPage.xaml       # 版本详情页（安装Forge/Fabric等）
│   ├── ResourcesPage.xaml           # 资源中心（MOD/材质包等）
│   ├── ModDetailPage.xaml           # 资源详情页
│   ├── MorePage.xaml                # 更多功能页面（插件市场/已安装已迁移到 MVVM）
│   └── SettingsPage.xaml            # 设置页面
├── ViewModels/                      # MVVM 视图模型（逐步迁移中）
│   └── PluginsViewModel.cs          # 更多-插件区 ViewModel（市场/已安装/详情/命令）
├── Plugins/                         # 启动器插件系统
│   ├── PluginLoader.cs              # 插件加载器（扫描/加载/启用禁用/卸载）
│   ├── PluginMarketService.cs       # 插件市场服务（索引/分类/下载安装）
│   ├── PluginContext.cs             # 插件上下文实现
│   ├── IPluginContext.cs            # 插件上下文接口
│   ├── ILauncherPlugin.cs           # 插件接口
│   └── PluginMetadata.cs            # plugin.json 元数据模型
├── Models/                          # 数据模型
│   ├── LauncherConfig.cs            # 启动器配置模型
│   ├── GameDirectoryType.cs         # 版本隔离类型
│   ├── GameAccount.cs               # 游戏账号模型
│   ├── ServerInfo.cs                # 服务器信息模型
│   ├── ScreenshotInfo.cs            # 截图信息模型
│   ├── WorldInfo.cs                 # 世界信息模型
│   ├── CurseForgeModels.cs          # CurseForge API模型
│   ├── ModrinthModels.cs            # Modrinth API模型
│   └── ModTranslation.cs            # MOD翻译模型
├── Services/                        # 服务层
│   ├── MinecraftVersionService.cs   # Minecraft版本管理
│   ├── DownloadService.cs           # 文件下载服务
│   ├── DownloadSourceManager.cs     # 下载源管理
│   ├── DownloadTaskManager.cs       # 下载任务管理
│   ├── GameLauncher.cs              # 游戏启动服务
│   ├── ForgeService.cs              # Forge服务
│   ├── NeoForgeService.cs           # NeoForge服务
│   ├── FabricService.cs             # Fabric服务
│   ├── OptiFineService.cs           # OptiFine服务
│   ├── QuiltService.cs              # Quilt服务
│   ├── CurseForgeService.cs         # CurseForge API服务
│   ├── ModrinthService.cs           # Modrinth API服务
│   ├── ModpackInstallService.cs     # 整合包安装服务
│   ├── ModTranslationService.cs     # MOD翻译服务
│   ├── LocalVersionService.cs       # 本地版本服务
│   ├── MicrosoftAuthService.cs      # 微软账号登录
│   └── AccountService.cs            # 账号管理服务
└── Utils/                           # 工具类
    ├── Converters/                  # XAML 转换器
    │   ├── ValueConverters.cs       # 常用转换器（Bool/Null -> Visibility 等）
    │   ├── PluginTabToBoolConverter.cs # 插件子标签页转换器
    │   └── EnumEqualsConverter.cs   # 枚举比较转换器
    ├── DialogManager.cs             # 对话框管理器
    ├── NotificationManager.cs       # 通知管理器
    ├── ThemeTransitionManager.cs    # 主题切换过渡遮罩
    ├── SystemInfo.cs                # 系统信息
    ├── VersionInfo.cs               # 版本信息
    ├── GameVersionNumber.cs         # 游戏版本号解析
    └── ApiTester.cs                 # API测试工具

---

📄 许可证

本项目采用 GNU General Public License v3.0 开源。

这意味着：

• ✅ 可以自由使用、修改和分发
• ✅ 必须开源修改后的代码
• ✅ 必须使用相同的 GPL-3.0 许可证
• ✅ 必须声明变更内容

详见 LICENSE 文件。

---

⚠️ 免责声明

本启动器为第三方工具，与 Mojang Studios 和 Microsoft 无关。Minecraft 是 Mojang Studios 的注册商标。

---

使用 ❤️ 和 C# 构建

© 2025 ObsMCLauncher