如何读懂 Ely Prism Launcher 的 Pack Profile:多格式实例配置文件解析与应用指南
如何读懂 Ely Prism Launcher 的 Pack Profile:多格式实例配置文件解析与应用指南
Ely Prism Launcher 是基于 Prism Launcher 的增强版 Minecraft 启动器,在保留原版多实例管理能力的同时,深度集成了 Ely.by 账号登录支持。它的核心设计之一 Pack Profile(实例组件配置系统),将每一个游戏实例抽象为"一组可独立解析、按顺序叠加的配置组件",统一兼容 Mojang 官方版本格式与 1.6+ 扩展格式。本文将带你快速理解这套实例配置文件是如何被解析并应用到游戏启动过程中的。
一、Pack Profile 是什么?实例 = 组件的有序堆叠
在传统启动器中,一个实例往往只对应"一个游戏版本 + 一堆 Mod"。而 Ely Prism Launcher 的 Pack Profile 把实例拆成了多个 Component(组件):
net.minecraft—— 原版 Minecraft 本体(重要组件,不可删除)net.neoforged/net.minecraftforge/net.fabricmc.fabric-loader/org.quiltmc.quilt-loader—— 各类 Mod 加载器custom.jarmod.xxx—— 以 jar 形式注入的 jar mod- 通过导入 MMC/Prism 组件文件安装的第三方组件
这些组件按列表顺序依次"打补丁"到最终的启动配置上,顺序不同,结果可能不同。已知的 Mod 加载器及其互斥关系定义在 Component.cpp 的 KNOWN_MODLOADERS 表中。
二、核心配置文件:mmc-pack.json 字段速查
实例根目录下有一个名为 mmc-pack.json 的文件,它是 Pack Profile 的持久化载体(路径逻辑见 PackProfile.cpp)。其结构非常直观:
{
"formatVersion": 1,
"components": [
{ "uid": "net.minecraft", "version": "1.20.1", "important": true },
{ "uid": "net.fabricmc.fabric-loader", "version": "0.15.0", "dependencyOnly": true }
]
}
每个组件条目的字段含义如下(序列化逻辑见 PackProfile.cpp):
| 字段 | 说明 |
|---|---|
uid |
组件唯一标识,必填,对应 patches/ 目录下的文件名 |
version |
组件版本,若存在自定义 JSON 覆盖,同时也是"还原"时回退到的版本 |
dependencyOnly |
为满足依赖自动加入的组件,可能在未来被自动移除 |
important |
重要组件标记,如游戏本体,不可移除 |
disabled |
为 true 时该组件不参与解析与启动 |
cachedVersion / cachedName |
离线时显示用的缓存版本号与名称 |
cachedRequires / cachedConflicts |
缓存的依赖与冲突关系,用于离线判断 |
cachedVolatile |
缓存的"易失"标记,不再需要时可自动清理 |
读取时会先校验 formatVersion 是否等于 1,JSON 解析失败或结构非法时返回明确的错误信息并保留旧状态(见 PackProfile.cpp)。写入则使用 Qt 的 QSaveFile 保证原子性,避免写一半导致文件损坏;此外还有 5 秒延迟保存定时器,日常操作不会频繁落盘,退出或需要时再立即保存。
三、多格式兼容:patches 目录下的组件文件
mmc-pack.json 只记录"有哪些组件、什么版本",每个组件的具体配置存放在实例的 patches/<uid>.json 中。这里正是 多格式解析 的关键:
- Mojang 官方格式:由 MojangVersionFormat.h 定义,对应 Mojang 原版版本描述文件(含
mainClass、libraries、minecraftArguments、旧版tweakers等字段)。 - 1.6+ 扩展格式(OneSix):由 OneSixVersionFormat.h 定义,在 Mojang 格式基础上增加了
libraries规则(rules)、jarMods、traits、natives映射等 Prism 系启动器扩展字段。
两种格式最终都解析为统一的 VersionFile 结构体——包含 mainClass、minecraftArguments、libraries、jarMods、agents、traits 等字段。因此无论是导入 Mojang 版本的 json、第三方组件文件,还是启动器自动生成的 jar mod / agent 补丁,都走同一条解析管线(ProfileUtils::parseJsonFile)。
💡 小知识:jar mod、自定义 jar(替换主 jar)、Java Agent 本质上也是"组件"。例如安装 jar mod 时,启动器会生成 uid 为
custom.jarmod.<uuid>的补丁组件(见 PackProfile.cpp)。
四、从配置到启动:LaunchProfile 的合并流程
组件解析完成后,真正"合成"可启动配置的类是 LaunchProfile。核心流程在 PackProfile.cpp 的 getProfile() 中:
- 惰性构建:首次调用时才创建
LaunchProfile并缓存,之后组件变更会调用invalidateLaunchProfile()使缓存失效; - 按序叠加:遍历
mmc-pack.json中的组件列表,依次调用每个组件的applyTo(profile)(见 Component.cpp);被禁用的组件直接跳过; - 后写覆盖:后出现的组件可覆盖先出现的设置,如加载器的
mainClass会覆盖原版的mainClass,libraries列表则合并累加; - 问题追踪:
LaunchProfile同时是ProblemProvider,组件冲突、缺失依赖等问题会按严重级别汇总,最终体现在界面上。
合并结果包含完整启动所需的一切:主类、JVM 参数、Minecraft 参数、依赖库、原生库、Java Agent、兼容 Java 版本等。
五、依赖解析:在线/离线双模式
修改组件版本后,PackProfile::resolve(Net::Mode) 会启动 ComponentUpdateTask 做依赖解析:
- 在线模式:从元数据索引拉取组件清单,自动补齐缺失的依赖组件(标记为
dependencyOnly); - 离线模式:仅用本地缓存的
cachedRequires/cachedConflicts做校验。
解析成功后组件列表会重新加载并触发界面刷新,失败时也会回滚状态,保证配置的一致性。
六、界面操作对照表:Version 页面的常用动作
在实例的 "Version" 页面(VersionPage.h)中,几乎所有 Pack Profile 操作都有对应的菜单入口:
| 界面动作 | 底层调用 | 作用 |
|---|---|---|
| Change version | setComponentVersion |
更换组件版本(如切换 Fabric 版本) |
| Install Loader | setComponentVersion |
安装/切换 NeoForge、Fabric 等加载器 |
| Move up / Move down | move |
调整组件叠加顺序 |
| Add to Minecraft jar | installJarMods |
导入 jar mod |
| Replace Minecraft jar | installCustomJar |
用自定义 jar 替换主 jar |
| Import Components | installComponents |
导入 MMC/Prism 组件文件 |
| Customize / Revert | customize / revert |
复制一份可编辑的覆盖副本 / 还原到基线版本 |
| Add Agents | installAgents |
添加 Java Agent |
| Remove | remove |
删除组件(含补丁文件与本地 jar) |
其中 Customize 是最常被忽略的功能:它会为组件生成本地覆盖版本文件,之后对它的修改不会污染原始元数据,点 Revert 即可一键还原。
七、Ely.by 专属扩展:ElyPatchTask
作为 Prism Launcher 的 fork,本项目在启动任务链中额外插入了 ElyPatchTask:它会解析并下载 Ely.by Authlib(认证库)与对应的注入器,将 Ely.by 账号体系接入启动流程。对使用者来说这意味着无需额外配置,即可使用 Ely.by 账号直接登录游戏——而整套流程同样建立在 Pack Profile 的组件机制之上。
八、关键源码路径速查
| 模块 | 路径 |
|---|---|
| Pack Profile 主类 | launcher/minecraft/PackProfile.h / PackProfile.cpp |
| 组件定义与加载器表 | launcher/minecraft/Component.cpp |
| 启动配置合并 | launcher/minecraft/LaunchProfile.cpp |
| 组件文件结构体 | launcher/minecraft/VersionFile.h |
| Mojang 格式解析 | launcher/minecraft/MojangVersionFormat.h |
| 1.6+ 格式解析 | launcher/minecraft/OneSixVersionFormat.h |
| 组件更新/依赖解析任务 | launcher/minecraft/ComponentUpdateTask.cpp |
| Version 页面 UI | launcher/ui/pages/instance/VersionPage.h |
| Ely.by 补丁任务 | launcher/minecraft/update/ElyPatchTask.cpp |
总结
Pack Profile 用"组件列表 + 补丁文件"的两层结构,优雅地解决了 Minecraft 启动器生态中格式繁杂的问题:mmc-pack.json 管顺序与状态,patches/*.json 管具体内容,多格式统一解析为 VersionFile,再按序叠加成 LaunchProfile 完成启动。理解了这套机制,无论是手动迁移实例、排查组件冲突,还是定制 jar mod 与 Agent,你都能有的放矢。