战利品补丁
在服务端重载时筛选并修改战利品表。
战利品补丁在普通模组修改之后处理所选战利品表。补丁可替换整张表、修改物品条目,或追加池与函数;每次生成战利品时无需重新遍历表结构。
文件放在哪里
使用 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 }
字段
| 字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
enabled | boolean | true | false 禁用此 ID,包括同 ID 的内置策略。 |
priority | integer | 0 | 有符号排序值,较小者先执行。 |
sources | array of strings | 全部 | VANILLA、MOD、DATA_PACK、REPLACED;空数组不选中任何表。 |
tables | array of identifiers | 全部 | 精确表 ID;空数组不选中任何表。 |
namespaces | array of strings | 全部 | 精确命名空间;空数组不选中任何表。 |
path_prefix | string | 任意 | 表路径前缀,区分大小写。 |
exclude_namespaces | array of strings | 空 | 在正向筛选后排除的命名空间。 |
operations | array of objects | 启用时必填 | 按顺序执行;空数组不修改。 |
operations[].type | string | 必填 | 下列操作名之一。 |
operations[].from | identifier | replace_item 必填 | 匹配的物品条目。 |
operations[].to | identifier | replace_item 必填 | 新物品 ID;保留权重、品质、条件与函数。 |
operations[].items | array of identifiers | remove_items 必填 | 递归移除匹配条目,并清除空组合条目。 |
operations[].pool | loot-pool object | add_pool 必填 | 追加原版格式的池。 |
operations[].function | loot-function object | append_function、entry_function 必填 | 追加到表或匹配的物品条目。 |
operations[].item | identifier | entry_function 必填 | 接收函数的物品条目。 |
operations[].table | loot-table object | replace_table 必填 | 一并替换池、函数、上下文类型和随机序列。 |
clear_pools 只接受 type,保留表级函数。不同筛选类别取交集;同一数组内取并集。重复的筛选字符串会被拒绝。
普通战利品 JSON 也可使用两个函数:公共 function 字段为 isekaiexpansion:replace_item 或 isekaiexpansion:strip_nbt;可选 conditions 使用普通战利品条件数组。
| 字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
function | identifier | 必填 | 已注册的战利品函数 ID。 |
conditions | array of loot conditions | 空 | 执行函数之前检查的条件。 |
from | item identifier | 替换函数必填 | 仅替换该生成物品。 |
targets | array of objects | 必填且非空 | 加权替换候选,不改变池的选中概率。 |
targets[].item | item identifier | 必填 | 已注册目标;minecraft:air 移除结果。 |
targets[].weight | integer | 1 | 正相对权重,总和须能由有符号整数表示。 |
targets[].min | integer | -1 | -1 保留原数量,否则为 0–2304。 |
targets[].max | integer | 同 min | 不小于 min,不大于 2304;保留数量时两者均须为 -1。 |
chance | number | 1 | 两个函数均接受有限概率 0–1。 |
copy_nbt | boolean | false | 替换时是否复制原物品 NBT。 |
default | rule object | 全部清除 | 默认 NBT 移除规则。 |
default.clear_all | boolean | true | 清除全部 NBT,忽略键模式。 |
default.strip_keys | array of regex strings | 空 | clear_all 为 false 时,对顶层键进行完整正则匹配。 |
overrides | array of objects | 空 | 物品专用 NBT 规则;重复物品以后者为准。 |
overrides[].item | item identifier | 必填 | 应用此规则的已注册物品。 |
overrides[].rule | rule object | 默认规则 | 该物品使用的替换规则。 |
overrides[].rule.clear_all | boolean | 继承默认规则 | 是否清除全部 NBT。 |
overrides[].rule.strip_keys | array of regex strings | 空 | 不清除全部时使用的顶层键完整匹配模式。 |
校验
未知补丁或操作字段、缺少必填字段、无效 ID、重复筛选值和未知操作或来源名称会使重载失败。禁用文件跳过操作解析。池、表和函数对象使用普通战利品反序列化流程;完整修改结果先通过反序列化,再替换运行中的构建器。替换目标及 NBT 覆盖物品必须存在;无效概率、数量范围或正则表达式会拒绝对应函数。两个自定义函数对象中的额外字段由其序列化器忽略。
重载
服务端启动和 /reload 会重建补丁快照,不向客户端同步补丁。运行时只执行最终战利品表及函数;筛选和递归修改均在重载时完成。