如何使用 PCL 制作整合包

我可以使用 PCL 制作整合包吗

PCL 正式版没有分发限制，因此可以发给其他人或是用于制作整合包、服务器客户端。

自动安装整合包

将你的整合包重命名为 modpack.zip 或 modpack.mrpack，和 PCL 的 exe 文件放在同一文件夹下。如果这样做，打开 PCL 时，PCL 会自动安装这一整合包。

删除自己的账号信息

PCL 将你的账号、密码等重要信息加密存储在注册表中，而不是文件中。因此，你无需刻意删除你的账号信息，它们不会随着你的整合包被发放给其他人。

备份配置文件

PCL 会在 PCL 文件夹中存储部分个性化设置（例如音乐、背景图片、启动器样式、自定义主页等），不包含个人信息。
如果你正在制作整合包，且需要保留所设置的启动器个性化内容，你就需要在整合包中包含该文件夹。 打开 PCL 主程序所在文件夹，将该文件夹下的 PCL 文件夹复制到合适位置即可。

自定义主页

你可以在 设置→个性化→主页 中自定义启动器的主页。你也可以将你的主页 XAML 文件上传到服务器，并通过 “联网更新” 选项实现主页的动态更新。 关于如何自定义主页，相关语法由于内容繁多，建议下载代码参考学习。

关闭启动器更新与公告

你可以在 设置→启动器→系统 中修改启动器的更新方式与公告推送方式。 如果你能通过 QQ 群等方式通知到所有使用你的整合包的玩家，你可以完全关闭启动器更新。如果你无法通知到使用整合包的所有玩家，则请至少选择 “仅在有重大漏洞更新时显示提示”，以免有玩家因为无法收到重大漏洞更新而无法正常游戏。 启动器公告包含紧急漏洞通知、PCL 的活动通知、新功能投票等推送弹窗。如果你需要屏蔽 PCL 的活动通知，你可以降低公告推送等级。如果没有必要，则推荐设置为 “显示所有公告”。

修改启动时 “你知道吗?” 的内容

在 PCL 文件夹下新建一个名为 hints.txt 的文件，然后每一行写入一条信息，即可修改启动时 “你知道吗?” 的内容。PCL 读取该文件时会忽略空行。若写入后出现乱码，可以尝试将编码改为 UTF-8。

自带 Java

如果你想让整合包自带某个版本的 Java，可以直接将 Java 放在版本文件夹（versions/版本名）中，PCL 会自动搜索并优先选用放在版本文件夹里的 Java。

关闭不需要的功能

你可以在 设置→个性化→功能隐藏 中关闭你不需要的功能入口，例如下载、个性化设置等页面。

修改帮助文件

PCL 允许你自由修改帮助页面：你可以添加自己的帮助条目，或是隐藏内置的帮助条目。 如果你是服主或整合包作者，你可以将教程或是必要信息列入帮助中，为玩家提供便利。 此后，你还可以通过自定义主页功能，在主页添加一个打开特定帮助页面的按钮！ 此外，你还可以添加让帮助条目之间互通的链接，也可以让它从主页或搜索结果中隐藏。

添加自定义帮助条目

PCL 会从 PCL\Help 文件夹中读取自定义帮助条目，你需要在 PCL 文件夹中创建名为 Help 的文件夹，并把所有相关文件存放在其中。 每个帮助条目都是一个 JSON 文件。在加载帮助页面时，PCL 会查找帮助文件夹及其子文件夹中的所有扩展名为 .json 的文件，并作为帮助条目加载。 此外，查找时会忽略名称以英文句号开头的文件夹，例如 .git。 换而言之，你需要新建一个 JSON 文件来创建帮助条目。该文件的格式详见以下页面： 如果你的帮助条目不会触发事件（即第一类，IsEvent=False），你就需要创建一个与该 JSON 文件同名的 XAML 文件。 在你点击这个帮助条目的时候，PCL 会从该 XAML 文件中加载页面的实际内容。 XAML 文件的格式与自定义主页一致，你可以查看下述条目来了解详情： 在编辑完 JSON 与 XAML 文件后，你可以点击左边栏 帮助 项右侧的刷新按钮来快速重载所有帮助页面。

隐藏内置帮助条目

与读取自定义帮助条目时类似，PCL 会在帮助文件夹查找扩展名为 .helpignore 的文件，该文件可以用于隐藏 PCL 内置的帮助条目。 该文件的每行都是一条正则表达式，PCL 会对这些正则逐条进行匹配，如果某内置条目的相对路径符合该正则，那么该条目就会被忽略。

在读取 .helpignore 文件的内容时，空行、行首行尾空格以及每行的 # 符号之后的内容均会被忽略。