Kzeroko KTM2

战利品 API

注册有序的重载补丁和加权替换。

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

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 覆盖代码补丁。空配方不选择任何表,因此禁用覆盖不会导致无意义的序列化。

相关内容