跳到主要内容

数据包

数据包可以设置固定基础值、实例化计算器和覆盖最终结果。两个原生数据包注册表的目录均为单数:

data/<namespace>/evaluate/evaluator/<path>.json
data/<namespace>/evaluate/value_override/<path>.json

命名空间和相对路径共同组成资源 ID。例如 data/example/evaluate/evaluator/metals/iron.json 定义计算器 example:metals/iron。

固定基础值​

一个 evaluate:constant 文件为所有命中的物品设置同一个价值:

data/example/evaluate/evaluator/iron.json
{
"type": "evaluate:constant",
"item": "minecraft:iron_ingot",
"value": 256,
"priority": 10,
"comment": "用于配方推导的基础值"
}
字段类型必填默认值含义
type资源 ID是—evaluate:constant。
itemSaturn 匹配项或非空数组是—共用该价值的物品。
value有限非负 double是—单件价值,不乘物品堆叠数量。
priority有符号整数否0多条基础规则命中时,数值较大者优先。
comment字符串否—说明,不参与计算。

支持小数和科学记数法。固定值为 0 时,物品作为免费输入参与推导,但查询不会返回正价值。负数、NaN 和无穷值均无效。

物品选择​

字段名始终为 item,数组写法也不改成 items。数组条目取并集:任意一项命中即可,所有命中物品使用同一个价值。

data/example/evaluate/evaluator/shared_metal_value.json
{
"type": "evaluate:constant",
"item": ["minecraft:iron_ingot", "#c:ingots/gold"],
"value": 256.5,
"priority": 20
}

item 直接使用 Saturn 的 ItemMatcher.ENTRIES_CODEC,也接受其他模组注册的匹配项。各类匹配器字段请查阅 Saturn 物品匹配器参考,Evaluate 不再定义另一套选择器语言。

显式规则匹配实际查询的 ItemStack,组件条件不会变成整个物品类型的共同结果。推导图会收集默认栈,以及配方、计算器和 Ingredient 展示中的代表变体。未收集的变体仍能命中显式规则,但可能缺少对应的推导换算链。

最终覆盖​

使用 value_override 改变最终查询和快照,不将该数值反馈到推导中:

data/example/evaluate/value_override/iron.json
{
"item": "minecraft:iron_ingot",
"value": 1000,
"priority": 10
}

覆盖项沿用常量计算器的 item、value、priority 和可选的 comment 字段,但不使用 type 字段。

如果铁锭基础值为 256,该覆盖使查询返回 1000,铁块仍按 256 × 9 = 2304 推导。覆盖为 0 会隐藏最终正价值,不会回退到基础值或推导结果。

匹配与数据包优先级​

  1. 同一命名空间、同一路径的文件遵循普通数据包规则,高优先级数据包替换整个文件。
  2. 不同文件同时生效;同一注册表中,命中的规则按 priority 从高到低选择。
  3. 优先级相同时,按资源 ID 的自然升序选择第一条。

数据包优先级不能解决不同路径之间的规则竞争。跨文件覆盖基础值时,应提高 priority。最终覆盖与基础规则分别选择,再在推导结束后应用。

替换内置定义​

内置常量位于 data/evaluate/evaluate/evaluator/:

类别该目录下的路径
普通物品minecraft/
标签tags/<标签命名空间>/
山羊角变体minecraft/goat_horn/

例如,在数据包中提供 data/evaluate/evaluate/evaluator/tags/c/ingots/iron.json 可替换内置铁锭价值;钻石对应 tags/c/gems/diamond.json。

其他计算器类型​

type用途参考
evaluate:constant固定基础值本页
evaluate:recipe某种配方类型的关系价值推导
evaluate:ftb_quests消耗物品的任务兑换FTB Quests
evaluate:js带参数的命名脚本回调KubeJS

计算器文件通过 type 选择已注册的 MapCodec。只有数据文件或脚本创建实例后,对应类型才会执行。

校验与重载​

未知字段会被拒绝。不使用 before、after 或 phase;旧的 values、evaluators 目录及 ProjectE 数据格式均不支持。目前也没有自定义数据包 conversions。

初次加载遵循原生注册表校验,错误数据可能阻止数据包加载。执行 /reload 时,无效定义会记录日志并跳过,不回退到同路径低优先级文件。缓存行为和 FTB 任务文件的重载方式见运行与重载。