Kzeroko KTM2

战利品补丁

在服务端重载时筛选并修改战利品表。

更新于 2026/10/23 5 分钟阅读

战利品补丁在普通模组修改之后处理所选战利品表。补丁可替换整张表、修改物品条目,或追加池与函数;每次生成战利品时无需重新遍历表结构。

文件放在哪里

使用 data/<namespace>/loot_patches/<path>.json。命名空间和路径共同标识补丁。更高优先级资源包覆盖同名文件,该 ID 也可覆盖内置代码补丁。不同补丁按数值优先级升序、完整 ID 升序执行;单个补丁内按数组顺序执行操作。

内置策略为 isekaiexpansion:loot/foreign_nbt 和 isekaiexpansion:loot/pack_rewards。用同 ID 的禁用文件即可关闭对应策略。

另有三项目录表补丁:isekaiexpansion:loot/chest_pickups/common、isekaiexpansion:loot/chest_pickups/uncommon与isekaiexpansion:loot/chest_pickups/rare,优先级为20。它们填充对应的isekaiexpansion:chest_pickups/common、isekaiexpansion:chest_pickups/uncommon与isekaiexpansion:chest_pickups/rare表。普通宝箱追加3次独立抽取:装备、宝石类材料和杂项,每类最多1件。因此,装备可以与宝石或锻造石以及隐琉封印同时出现。每池总权重为10025。装备权重分别为普通300、罕见140、稀有50;宝石类权重为聚熔宝石600、锻造石碎片450、锻造石125、锻造石块35;封印权重为25。三池的空结果权重依次为9535、8815、10000。

最小示例

内置 data/isekaiexpansion/loot_patches/example_disabled.json 是不执行修改的示例:

{ "enabled": false }

字段

字段类型默认值含义
enabledbooleantruefalse 禁用此 ID,包括同 ID 的内置策略。
priorityinteger0有符号排序值,较小者先执行。
sourcesarray of strings全部VANILLA、MOD、DATA_PACK、REPLACED;空数组不选中任何表。
tablesarray of identifiers全部精确表 ID;空数组不选中任何表。
namespacesarray of strings全部精确命名空间;空数组不选中任何表。
path_prefixstring任意表路径前缀,区分大小写。
exclude_namespacesarray of strings空在正向筛选后排除的命名空间。
operationsarray of objects启用时必填按顺序执行;空数组不修改。
operations[].typestring必填下列操作名之一。
operations[].fromidentifierreplace_item 必填匹配的物品条目。
operations[].toidentifierreplace_item 必填新物品 ID;保留权重、品质、条件与函数。
operations[].itemsarray of identifiersremove_items 必填递归移除匹配条目,并清除空组合条目。
operations[].poolloot-pool objectadd_pool 必填追加原版格式的池。
operations[].functionloot-function objectappend_function、entry_function 必填追加到表或匹配的物品条目。
operations[].itemidentifierentry_function 必填接收函数的物品条目。
operations[].tableloot-table objectreplace_table 必填一并替换池、函数、上下文类型和随机序列。

clear_pools 只接受 type,保留表级函数。不同筛选类别取交集;同一数组内取并集。重复的筛选字符串会被拒绝。

普通战利品 JSON 也可使用两个函数:公共 function 字段为 isekaiexpansion:replace_item 或 isekaiexpansion:strip_nbt;可选 conditions 使用普通战利品条件数组。

字段类型默认值含义
functionidentifier必填已注册的战利品函数 ID。
conditionsarray of loot conditions空执行函数之前检查的条件。
fromitem identifier替换函数必填仅替换该生成物品。
targetsarray of objects必填且非空加权替换候选,不改变池的选中概率。
targets[].itemitem identifier必填已注册目标;minecraft:air 移除结果。
targets[].weightinteger1正相对权重,总和须能由有符号整数表示。
targets[].mininteger-1-1 保留原数量,否则为 0–2304。
targets[].maxinteger同 min不小于 min,不大于 2304;保留数量时两者均须为 -1。
chancenumber1两个函数均接受有限概率 0–1。
copy_nbtbooleanfalse替换时是否复制原物品 NBT。
defaultrule object全部清除默认 NBT 移除规则。
default.clear_allbooleantrue清除全部 NBT,忽略键模式。
default.strip_keysarray of regex strings空clear_all 为 false 时,对顶层键进行完整正则匹配。
overridesarray of objects空物品专用 NBT 规则;重复物品以后者为准。
overrides[].itemitem identifier必填应用此规则的已注册物品。
overrides[].rulerule object默认规则该物品使用的替换规则。
overrides[].rule.clear_allboolean继承默认规则是否清除全部 NBT。
overrides[].rule.strip_keysarray of regex strings空不清除全部时使用的顶层键完整匹配模式。

校验

未知补丁或操作字段、缺少必填字段、无效 ID、重复筛选值和未知操作或来源名称会使重载失败。禁用文件跳过操作解析。池、表和函数对象使用普通战利品反序列化流程;完整修改结果先通过反序列化,再替换运行中的构建器。替换目标及 NBT 覆盖物品必须存在;无效概率、数量范围或正则表达式会拒绝对应函数。两个自定义函数对象中的额外字段由其序列化器忽略。

重载

服务端启动和 /reload 会重建补丁快照,不向客户端同步补丁。运行时只执行最终战利品表及函数;筛选和递归修改均在重载时完成。

相关内容