MCreator 进度(Advancement)「隐藏显示(Hide Display)」参数详解:让进度在达成前从进度标签页中隐身
MCreator 进度(Advancement)「隐藏显示(Hide Display)」参数详解:让进度在达成前从进度标签页中隐身
本指南聚焦 MCreator 中「进度 / 成就(Advancement)」元素的一个实用开关参数——Hide Display(隐藏显示)。在 MCreator 的进度(Advancement)元素编辑界面中,勾选该参数即可让进度在尚未完成之前,从游戏内「进度」标签页(Advancements screen)中完全隐藏,只有玩家真正达成该进度后才会显示出来。读完本文,你将掌握该参数的含义、在编辑器中的位置、它与「Hide If Not Completed」的差异、底层数据字段与代码生成原理,以及借助 Minecraft 原生 hidden 属性实现相同效果的进阶写法。
参数含义:勾选后进度将隐身直到完成
Hide Display 是 MCreator 进度元素「逻辑(Logic)」面板中的布尔开关参数。官方帮助文档(de_DE 版)对其描述为:
Aktiviere diesen Parameter, um den Fortschritt auf der Fortschrittsregisterkarte auszublenden, bis er abgeschlossen ist.
中文直译即:激活此参数,可在进度尚未完成时,将进度从进度标签页中隐藏。en_GB 版的表述与之完全一致:Check this parameter to hide the advancement in the advancement tab until it's completed.
也就是说,它的核心作用非常明确:
- 开启前:该进度及其前置分支正常显示在「进度」标签页中,玩家可以提前看到存在哪些未解锁的目标;
- 开启后:该进度在达成之前对玩家不可见,达成(完成全部 criteria)的瞬间才会显现。
在编辑器中的位置与操作步骤
该参数位于 Advancement 元素编辑器的「逻辑(Logic)」分区内。在 MCreator 源码 AchievementGUI.java 中可以清楚地看到它的布局代码:
logicPanel.add(HelpUtils.wrapWithHelpButton(this.withEntry("advancement/hide_if_not_completed"),
L10N.label("elementgui.advancement.hide_if_not_completed")));
logicPanel.add(hideIfNotCompleted);
logicPanel.add(HelpUtils.wrapWithHelpButton(this.withEntry("advancement/hide_display"),
L10N.label("elementgui.advancement.hide_display")));
logicPanel.add(disableDisplay);
其中 withEntry("advancement/hide_display") 正是将编辑框与本地化帮助文档 hide_display.md 关联起来:用户点击参数旁的帮助按钮(?)时,MCreator 就会弹出本文所依据的这条说明。
操作步骤非常简单:
- 在 MCreator 中新建或打开一个 Advancement(进度 / 成就) 元素;
- 进入元素编辑界面,在右侧「逻辑(Logic)」分区中找到 Hide Display 复选框(界面标签文案来自
elementgui.advancement.hide_display本地化键); - 勾选该复选框,保存元素并重新生成 / 编译代码;
- 进入游戏验证:未达成前该进度不会出现在进度标签页中,达成后才会显示。
编辑界面的其他逻辑参数(如 Reward XP、Reward Function、Announce To Chat、Hide If Not Completed 等)都排列在同一分区中,UI 构造代码见 AchievementGUI.java。
两个容易混淆的参数:Hide Display 与 Hide If Not Completed
MCreator 的进度编辑器里有两个名字相近、功能易混的隐藏类参数,这里做一个明确区分:
| 参数 | 帮助文档 | 对应数据字段 | 效果 |
|---|---|---|---|
| Hide Display(隐藏显示) | advancement/hide_display.md | disableDisplay |
完成前隐藏,并且整个 display 区块都不写入生成文件 |
| Hide If Not Completed(未完成时隐藏) | advancement/hide_if_not_completed.md | hideIfNotCompleted |
完成前隐藏,但 display 区块正常保留,通过 "hidden": true 实现 |
从帮助文档看,两者效果一致(都是在完成前把进度隐藏),但底层实现路径完全不同,下一节会展开说明。实际创作进度时,日常「隐藏未完成进度」的需求优先使用 Hide If Not Completed,而 Hide Display 的典型用途是制作完全不展示 display 信息的纯功能型进度。
底层实现:数据字段与代码生成原理
数据字段 disableDisplay
在 MCreator 的数据模型中,进度元素对应 Java 类 Achievement.java。其中:
public boolean disableDisplay; // Hide Display 参数对应字段
public boolean showPopup; // Show Toast
public boolean announceToChat; // Announce To Chat
public boolean hideIfNotCompleted; // Hide If Not Completed
在编辑器 UI 中,勾选状态与数据字段的双向同步发生在 AchievementGUI.java(载入时 disableDisplay.setSelected(...))与 L313(保存时 achievement.disableDisplay = disableDisplay.isSelected())。
生成模板:display 区块的取舍
MCreator 通过 FreeMarker 模板把 Achievement 数据渲染成 Minecraft 的 advancement JSON 文件。生成目标文件由 achievement.definition.yaml 声明:
templates:
- template: advancement.json.ftl
writer: json
name: "@MODDATAROOT/advancement/@registryname.json"
即每个进度元素生成一个位于 data/<modid>/advancement/<registryname>.json 的 JSON 文件。
在 1.21.1 生成器模板 advancement.json.ftl 中:
<#if !data.disableDisplay>
"display": { ... "hidden": ${data.hideIfNotCompleted} ... },
</#if>
关键点:
- 勾选 Hide Display(
disableDisplay == true)时,整个"display"对象(图标、标题、描述、背景、frame、show_toast、announce_to_chat、hidden 等所有显示信息)都不会被写入生成的 JSON; - 模板仍然会保留
"criteria"(触发条件)与"rewards"(奖励)区块,因此该进度依旧可以被触发、达成并发放奖励,只是没有任何界面展示信息; "hidden": ${data.hideIfNotCompleted}则对应 Hide If Not Completed 参数,仅在display存在时才会出现。
26.3.x 生成器模板 advancement.json.ftl 的逻辑完全一致(仅在背景纹理路径等细节上有所不同,如 minecraft:block/stone 与 "${modid}:screens/${data.background?keep_before_last(".png")}"),两个主流生成器版本行为保持一致。
与 Minecraft 原版 hidden 属性的关系
熟悉 Minecraft advancement 格式的开发者会想到 JSON 中 display.hidden 字段——它同样用于在完成前隐藏进度。两者区别在于:
hidden: true(Hide If Not Completed):保留完整display数据,只是把进度「标为隐藏」,玩家达成后进度标签页会正常展示;- 完全省略
display(Hide Display):进度连标题、图标都不存在,在进度标签页中自然也不会出现任何踪迹。
从 advancement.json.ftl 可以看到,show_toast、announce_to_chat、hidden 三个布尔字段共同决定了进度达成时的表现:即使进度本身隐藏,show_toast 与 announce_to_chat 仍可控制达成时的 Toast 提示与聊天播报,这为「纯后台进度」提供了完整的行为组合。
典型应用场景
基于以上特性,Hide Display 参数在以下场景中尤为实用:
- 隐藏的成就 / 彩蛋:制作彩蛋类进度,玩家不知道其存在,达成后才在标签页中揭开;
- 纯功能型进度:进度仅作为触发奖励(如发放物品、执行函数、解锁配方)的机制载体,不希望它出现在任何界面中;
- 防止剧透:在冒险 / 任务地图中隐藏后续章节进度,保证玩家的探索惊喜感。
同时,勾选 Hide Display 不会影响进度树的层级关系——只要 parent 不为空且不包含 @ 引用,"parent" 字段依然会写入生成文件(见 advancement.json.ftl),隐藏进度仍可作为其他进度的前置条件参与进度树结构。
小结
Hide Display 是 MCreator 进度元素中一个简单但强大的开关:
- 作用:勾选后进度在完成前从进度标签页中隐藏;
- 本质:将进度元素的
disableDisplay字段置为true,生成代码时整个display区块被省略(advancement.json.ftl); - 区别:与
Hide If Not Completed(hidden: true)实现路径不同,前者彻底不输出显示信息,后者保留display但标记隐藏; - 验证方式:在 MCreator 中编辑进度元素时,点击参数旁的帮助按钮即可随时查看 hide_display.md 等本地化说明文档,帮助文本随语言环境(如 zh_CN 版)自动切换。
掌握了这一参数,你就能够为自定义进度添加「达成前隐身」的效果,让进度树更有层次感、更有探索乐趣。