替换标记
HerobrineXia于2026-07-22 13:35:02 +08:00修改了此页面
此文件含有不可见的Unicode字符

此文件含有人类无法区分的不可见的Unicode字符,但可以由计算机进行不同的处理。如果您是想特意这样的,可以安全地忽略该警告。使用Escape按钮显示他们。

PCL 的下列自定义项中支持使用替换标记:

  • 设置 → 启动 与 版本设置 → 设置
    • 启动选项 → 游戏窗口标题、自定义信息
    • 高级选项 → Java 虚拟机参数、游戏参数、启动前执行命令
  • 设置 → 个性化 → 主页
    • 联网更新的下载地址
    • 主页文件的 XAML
  • 自定义帮助文件的 JSON 与 XAML

你可以在自定义主页的 URL 等地方使用替换标记,以根据不同的参数返回不同的 XAML。

替换标记会按照本页面中的顺序从上往下依次替换。因此若替换后的内容也包含替换标记,在顺序恰当的时候会出现嵌套替换。


基础信息

替换标记 简介 详情 示例
{pcl_version} PCL 版本号 以小数点分隔的 PCL 版本号,不保证有几段 2.10.8.0
{pcl_version_code} PCL 版本序号 纯数字的版本序号,越新的版本数字越大 369
{pcl_build_type} PCL 构建类型(英文) Snapshot , Release , Debug 之一 Snapshot
{pcl_version_branch} PCL 构建类型(中文) 快照版 , 正式版 , 开发版 之一 快照版
{pcl_branch} PCL 分支名 官方版为 Official,开源版为 OpenSource Official
{pcl_md5} PCL 程序文件的 MD5 PCL exe 文件的 MD5 9a93b7e7abad51807bb541e66352a4bb
{pcl_sha1} PCL 程序文件的 SHA1 PCL exe 文件的 SHA1 0da76deb97035f5c1fc089025e366d28689dcd4e
{identify} 识别码 每个用户均不一样的识别码 B49F-F9F4-2D63-2FE3
{path} PCL 所在文件夹 PCL 程序所在文件夹的完整路径,以 \ 结尾 D:\Minecraft\程序\
{path_with_name} PCL 程序路径 PCL 程序的完整路径,包含文件名 D:\Minecraft\程序\PCL.exe
{path_temp} 缓存文件夹路径 PCL 所使用的缓存文件夹路径,可在设置中修改,以 \ 结尾 C:\Users\...\Temp\PCL\

时间

Warning

这些替换标记仅在 游戏窗口标题 设置中替换标记会动态改变,其余场景均为一次性替换,不支持动态变化。

替换标记 简介 详情 示例
{date} 当前日期 yyyy/M/d 格式的日期 2025/10/5
{time} 当前时间 HH:mm:ss 格式的时间 20:36:28

Minecraft 信息

Warning

若遇到没有 Minecraft / Java 的情况,部分替换标记将被替换为空字符串。

这些替换标记均为一次性替换,不支持动态变化。

替换标记 简介 详情 示例
{java} Java 文件夹路径 本次启动游戏使用的 java.exe 所在的文件夹,以 \ 结尾
若没有启动过游戏则为空
D:\Program Files\Java 17\bin\
{minecraft} MC 文件夹路径 当前 MC 文件夹的路径,以 \ 结尾 D:\.minecraft\
{version_path} 或
{verpath}
版本文件夹路径 当前 MC 版本的文件夹路径,以 \ 结尾 D:\.minecraft\versions\Forge-1.20.1\
{version_indie} 或
{verindie}
版本隔离文件夹路径 若开启版本隔离则等效 {version_path},未开启则等效 {minecraft}
例如,{version_indie}mod\ 即为 Mod 文件夹路径
D:\.minecraft\versions\Forge-1.20.1\
{name} MC 版本文件夹名 当前 MC 版本文件夹的名称 Forge-1.20.1
{version} MC 版本 当前 MC 的用户友好可读名称,没有固定格式 1.20.1、16w01a 等
{forge}、{fabric}、{neoforge} 加载器版本 若安装了加载器则为其版本名称,未安装则为空字符串  、47.4.10
{liteloader} 是否安装了 Liteloader 若安装了则为 true ,未安装则为空字符串  、true

登录信息

Warning

这些替换标记均为一次性替换,不支持动态变化。

若尚未完成登录,这些替换标记将被替换为空字符串,因此仅推荐用于启动设置中。

替换标记 简介 详情 示例
{user} MC 玩家名 MC 中玩家的用户名 LTCat
{uuid} MC 玩家 UUID MC 中玩家的 UUID,固定为小写 a295ef70c3d64e65a0deca0d9b9b1ca7
{login} 登录方式 本次登录的方式 正版、离线、统一通行证、Authlib-Injector 之一

高级

Warning

这些替换标记均为一次性替换,不支持动态变化。若你想在自定义 XAML 中更新值,请使用 刷新页面 自定义事件。

这些替换标记中的每一个都会被独立处理,可能出现不一样的结果。

替换标记 简介 详情 示例
{hint} 随机 “你知道吗?” 条目 随机替换为一条启动游戏时显示的 “你知道吗?” 条目
若 PCL 文件夹中有 hints.txt,则为其中的一行随机内容
在第一次启动游戏时,PCL 会自动将语言设置为中文。
{cave} 随机回声洞条目 随机替换为一条 更多 → 百宝箱 → 回声洞 中的条目 歪比巴卜?
{setup:设置名} 读取 PCL 对应名称的设置 你可以在 Settings.vb 的开头查看其列表
若上述文件对应行有 Encoded:=True,则该项设置已加密,不允许读取
若上述文件对应行有 Source:=SetupSource.Version,则该项设置是版本独立设置,本替换标记会读取当前选中版本的对应设置
{setup:UiLauncherTransparent} → 400
{variable:变量名} 读取使用自定义事件设置的变量 读取此前使用 修改变量 / 写入变量 自定义事件设置的变量
如果变量未设置过,则替换为空
{variable:storage} → test_value
{variable:变量名:默认值} 读取使用自定义事件设置的变量 与上方的一样,不过如果变量未设置过,则替换为默认值 {variable:dont_exist:default} → default