从零开始使用 PCL2：Minecraft 开源启动器全指南

PCL2 启动器简介

PCL2（Plain Craft Launcher 2）是一款开源的 Minecraft 启动器，提供游戏管理、版本控制、模组集成等核心功能。该项目包含完整的 UI 库、动画模块、下载系统和启动核心，支持 Forge、OptiFine 等主流模组加载器，适合开发者二次开发或玩家自定义使用。


环境准备与安装

获取源代码

通过 Git 克隆项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/pc/PCL2

编译前准备

进入项目根目录，使用 .NET CLI 还原依赖项：

cd PCL2
dotnet restore

项目构建与运行

编译项目

执行以下命令编译解决方案，默认生成 Release 版本：

dotnet build "Plain Craft Launcher 2.sln"

启动应用

编译完成后直接运行启动器：

dotnet run --project "Plain Craft Launcher 2/Plain Craft Launcher 2.vbproj"

核心功能模块解析

启动核心模块

位于 Modules/Minecraft/ModLaunch.vb，负责 Minecraft 进程启动、JVM 参数配置和游戏环境检测。关键功能包括：

• 多版本共存管理
• 自定义内存分配
• 启动参数优化

下载系统

实现在 Modules/Minecraft/ModDownload.vb，支持：

• 游戏资源文件断点续传
• 多源镜像选择
• 下载速度限制

UI 组件库

在 Controls/ 目录下提供丰富的自定义控件，如：

• MyButton.xaml：主题化按钮控件
• MyMsg/：消息对话框组件集
• MySearchBox.xaml：带自动补全的搜索框


实用操作指南

版本管理

1. 在左侧导航栏选择「版本管理」
2. 点击「安装新游戏版本」选择 Minecraft 版本
3. 勾选需要的模组加载器（如 Forge）
4. 点击「安装」完成版本部署

模组管理

通过 PageVersionMod.xaml 页面管理已安装模组：

• 启用/禁用模组（右键菜单）
• 批量导出配置
• 冲突检测与解决

开发与扩展

二次开发准备

项目使用 VB.NET + WPF 开发，建议开发环境：

• Visual Studio 2022
• .NET Framework 4.8
• XAML 设计器扩展

自定义主题

修改 Resources/Custom.xaml 文件可自定义界面样式，主要调整：

• SolidColorBrush 资源定义
• 控件模板重写
• 动画时间线调整

功能扩展示例

通过继承 ModBase.vb 基类创建自定义模块：

Public Class MyCustomModule
    Inherits ModBase
    
    Public Overrides Sub Initialize()
        ' 注册自定义命令
        RegisterCommand("mycmd", AddressOf ExecuteMyCommand)
    End Sub
    
    Private Sub ExecuteMyCommand(args As String())
        ' 实现自定义逻辑
    End Sub
End Class

常见问题解决

依赖缺失

若编译时提示缺少 Newtonsoft.Json.dll，执行以下命令修复：

dotnet add package Newtonsoft.Json

启动失败

检查 App.config 中的以下配置：

• JAVA_HOME 路径是否正确
• Minecraft 根目录权限
• .NET Framework 版本兼容性

相关资源

• 帮助文档：内置帮助系统可通过启动器「设置 > 帮助」访问
• 模块源码：核心功能实现位于 Modules/ 目录
• 主题资源：默认主题图片存储在 Images/Themes/ 目录