Skip to content

Advancements

Qi-Month edited this page Nov 17, 2026 · 1 revision

进度

本模组的进度沿机械动力的成就树展开: 前置节点取自机械动力已发布的进度, 因此机械动力的进度树存在时才会显示. 进度本身只判定本模组的物品与设备.

条目定义

条目写在 dev.celestiacraft.steam_letters.datagen.advancement.SlAdvancement 中, 按前置节点分两组:

  • 前置节点属于机械动力的进度: 引用的进度 id 来自机械动力
  • 前置节点属于本模组的进度: 引用的进度 id 取 SlAdvancement 中定义的常量

单个进度由同包下的 SlAdvancementBuilder 组装. 构造器接受进度 id, 链式设置前置节点, 图标, 判定条件与帧类型, 最后由 save 写入. 图标使用设备方块或材料物品, 不额外提供贴图.

判定条件

判定以物品标签为准, 不绑定具体物品 id. 同一资源由其它模组提供时同样计入.

物品标签分两类命名空间: 模组自有的 steam_letters 与跨模组的通用命名空间. 通用命名空间随版本变化, 见 Home 的版本差异表.

两个版本的写入方式

项目 1.20.1 1.21.1
输出目录 data/<命名空间>/advancements/ data/<命名空间>/advancement/
帧类型 FrameType AdvancementType
判定条件类型 CriterionTriggerInstance Criterion
前置节点 Advancement 实例 进度 id

1.20.1 的 Advancement.Builder 在构建时要求前置节点是一个可直接取到的 Advancement, 仅给出前置 id 会抛出 IllegalStateException: Tried to build incomplete advancement!. 机械动力的做法是保存前置进度在生成期间留下的实例; 本模组没有前置进度的实例, 因此由构造器生成一个只带 id 的占位对象, 序列化时取的就是这个 id.

文本

标题与描述按进度 id 生成语言键, 由构造器统一给出:

用途 语言键
标题 advancement.<命名空间>.<路径>
描述 标题键后加 .desc

语言条目写在 datagen/language 下的中英两份文件中, 与进度定义分开维护. 缺少语言条目时游戏内直接显示键名.

描述使用机械动力的琥珀色 #DBA213, 与机械动力的进度描述一致.

Clone this wiki locally