审计与签名
Forge 在锻造成功后会向结果物品写入审计数据,用于追溯锻造来源和防篡改验证。
审计数据
锻造完成后,以下信息通过 ForgeAuditBuilder 写入物品 PDC:
| 字段 | 说明 |
|---|---|
recipe_id | 使用的配方 ID。 |
quality | 品质等级名称。 |
multiplier | 品质倍率。 |
forged_at | 锻造时间戳。 |
materials_signature | 材料贡献数据的稳定哈希签名。 |
output_item | 输出物品来源简写。仅在配方配置了输出物品来源时写入。 |
materials | 材料贡献列表。 |
材料签名
materials_signature 只对实际消耗数量大于 0 的材料贡献计算稳定哈希签名。相同的材料贡献组合总是得到相同签名,因此可以用于比对物品的锻造材料数据是否与预期一致。
与刷新的关系
Forge 的物品刷新服务会读取审计数据中的 recipe_id 和 quality,据此重建锻造层展示。审计数据缺失或配方已被删除时,对应物品无法重建锻造层展示。
用途场景
- 交易或回收系统可读取审计数据判断物品的配方来源与品质。
- 外部统计可按
recipe_id、quality和forged_at聚合锻造产出。
Forge 未提供查看审计数据的内置命令。需要人工查看时,请使用支持读取物品 PDC 的外部工具。