跳到主要内容

价值推导

所有计算器向同一张图提交关系。任务兑换、配方和脚本计算器可以使用彼此的结果,不受注册顺序限制。

固定基础值优先于推导候选值。没有固定基础值的物品,在所有有效获取方式中取最低成本。最终覆盖只在求解结束后应用。

配方计算器​

data/evaluate/evaluate/evaluator/recipes/ 下有七个内置实例:

文件配方类型
crafting.jsonminecraft:crafting
smelting.jsonminecraft:smelting
blasting.jsonminecraft:blasting
smoking.jsonminecraft:smoking
campfire_cooking.jsonminecraft:campfire_cooking
stonecutting.jsonminecraft:stonecutting
smithing.jsonminecraft:smithing

默认附加价值为 0。要给每次熔炼增加成本,替换内置文件:

data/evaluate/evaluate/evaluator/recipes/smelting.json
{
"type": "evaluate:recipe",
"recipe_type": "minecraft:smelting",
"extra_value": 2.5
}
字段类型必填默认值含义
type资源 ID是—evaluate:recipe。
recipe_type配方类型注册表 ID是—要扫描的类型;自定义类型中的配方实现仍需受支持。
extra_value有限非负 double否0每次执行的附加价值,按产出数量分摊。
comment字符串否—可选说明。

使用其他资源 ID 新增实例时,两个实例都会保留。如果它们扫描相同配方但附加价值不同,关系会同时参与比较,较低成本者生效。修改内置参数时应覆盖同一路径。

成本计算​

输出单件价值 =
(输入总价值 - 返还物价值 + extra_value) / 产出数量

例如输入总价值为 12.5,产出两件物品,附加价值为 2.5,则每件价值为 (12.5 + 2.5) / 2 = 7.5。

输入数量会计入成本。可替代材料提供不同候选成本,合成返还物会先从对应选项中抵扣,再选择最低成本。所需输入或返还物未知时,该候选无法计算,不会被当作免费物品。

输入状态影响
固定正价值使用配置值,更便宜的配方不能降低它。
推导正价值可以继续用于其他配方和兑换。
已知零价值作为免费输入参与计算,但不公开正价值。
未知价值阻止依赖该物品的关系推导。

价值保留小数:铁锭为 256 时,铁粒为 256.0 / 9,重新打包不会因逐步取整损失价值。配置、存储和查询结果使用 double。非有限结果,以及正值超出可表示范围而下溢的结果,不会作为免费物品公开。

自动支持的配方​

Evaluate 自动映射输入数量和静态输出可确定的普通配方:

  • 有序与无序合成。
  • 熔炼、高炉、烟熏和营火烹饪。
  • 切石与锻造转换。
  • Minecraft 26.1 的 crafting_transmute。

动态特殊配方、自定义 Ingredient 实现、酿造、掉落和交易暂不自动推导。例如装有液体的桶,在没有受支持的关系时,需要显式定义或其他计算器提供价值。

循环保护​

正常的打包与拆包配方可以稳定求解。没有已知起点的循环不会凭空产生价值。

同时存在 1 A → 2 B 和 1 B → 1 A 这样的兑换时,推导成本会反复降低。Evaluate 将相互依赖的节点划分为强连通分量,先计算外部依赖,组内稳定后才发布结果。无关配方不会增加该循环的计算额度。

保护项当前行为
每个节点的成功更新次数max(64, min(256, 组内节点数 × 2))
每个循环组的计算量最多 1,000,000 次配方/输入求值步骤
浮点下限临时使用 DECIMAL128,避免 double 下溢被误判为收敛。
舍入误差循环组内使用约 1.78e-15 的相对容差。
深层依赖迭代遍历,不因递归导致 Java 调用栈增长。

超过任一计算限制时,整组推导结果会被剔除并记录日志,临时异常值不会传入下游。下游物品仍能使用独立的正常配方获得价值。固定基础值保持优先,对外结果和存储仍为 double。

保护策略偏保守:异常缓慢但能够收敛的组也可能被剔除。此时可以为合适的物品设置固定基础值,切断该推导依赖循环。