战利品 API
注册有序的重载补丁和加权替换。
LootAPI 委托内部战利品实现执行操作。补丁是加载表时求值的不可变配方;普通战利品生成无需重复筛选或递归修改。
入口
使用 net.kzeroko.isekaiexpansion.api.LootAPI。门面返回的构建结果类型属于内部实现契约。数据包作者请使用战利品补丁 JSON。
常见用法
替换条目并保留其选中规则
LootAPI.register(LootAPI.patch(new Identifier("example", "dungeon_rewards"))
.priority(20)
.namespace("minecraft").pathPrefix("chests/")
.replaceItem(new Identifier("minecraft", "emerald"), new Identifier("minecraft", "diamond"))
.build());
构建加权输出函数
var replacement = LootAPI.replace(Items.EMERALD)
.chance(0.5F).target(Items.DIAMOND, 1, 1)
.target(Items.IRON_INGOT, 3, 2, 4).build();
通过普通战利品构建器附加函数。补丁的 JSON 函数方法需要使用普通战利品函数序列化器生成对象;函数仅在条目被池选中之后执行。
共用宝箱附加掉落
LootAPI.addChestPickups(id, builder)为路径以chests/开头的表追加3个独立池:装备、宝石类材料和杂项。每池无幸运加掷,抽取一次,最多追加1件物品;同一宝箱可以同时获得全部3类。每池总权重为10025,保留各物品原有概率,单项概率等于权重除以10025。
| 类别 | 结果 | 权重 |
|---|---|---|
| 装备 | 无 | 9535 |
| 装备 | 普通装备 | 300 |
| 装备 | 罕见装备 | 140 |
| 装备 | 稀有装备 | 50 |
| 宝石类 | 无 | 8815 |
| 宝石类 | 聚熔宝石 | 600 |
| 宝石类 | 锻造石碎片 | 450 |
| 宝石类 | 锻造石 | 125 |
| 宝石类 | 锻造石块 | 35 |
| 杂项 | 无 | 10000 |
| 杂项 | 隐琉封印 | 25 |
PackLootPatches在资源加载时根据EquipmentAPI.entries()构建isekaiexpansion:chest_pickups/common、isekaiexpansion:chest_pickups/uncommon和isekaiexpansion:chest_pickups/rare。每张表等概率选择1件对应品质的目录装备;目录扩充不会改变类别概率。整表替换补丁的优先级为20,ID分别为isekaiexpansion:loot/chest_pickups/common、isekaiexpansion:loot/chest_pickups/uncommon和isekaiexpansion:loot/chest_pickups/rare。这些表的路径不会再次获得宝箱附加抽取。
方法一览
| 方法 | 侧 | 契约 |
|---|---|---|
LootAPI.patch(id) | 公共初始化 | 创建补丁构建器。 |
LootAPI.register(patch) | 公共初始化 | 注册唯一 ID;重复注册抛出异常。 |
LootAPI.replace(item) | 公共初始化 | 加权替换构建器,可设置概率、目标数量及 NBT 复制。 |
LootAPI.stripNbt() | 公共初始化 | NBT 规则构建器;默认清除全部,可设置正则和物品覆盖。 |
priority, table, tables, namespace, pathPrefix, excludeNamespace, sources | 构建器 | 排序及交集筛选。 |
replaceTable, clearPools, addPool, function | 构建器 | 整表操作和内容追加;复制传入 JSON。 |
replaceItem, removeItems, itemFunction | 构建器 | 递归物品操作,保留无关条目数据。 |
pools, entries, edit | 构建器 | 高级回调;条目回调返回 null 可移除该条目。 |
线程与生命周期
在加载世界之前的模组初始化阶段注册。回调在服务端资源加载流程执行,不得修改世界或实体;捕获的状态应保持不可变。资源管理器快照采用弱引用缓存;注册会清除缓存,影响后续加载,不会修改已经构建的表。
Fabric 修改阶段位于默认阶段之后,也接受被替换的表。其他模组若明确安排在此阶段之后,仍可继续修改结果。数据包补丁按 ID 覆盖代码补丁。空配方不选择任何表,因此禁用覆盖不会导致无意义的序列化。