EnhancedLootBags

[!INFO] Git Commit: b48f13c | Updated: 2026-09-14

EnhancedLootBags（原名 Namikon / “LootBags. As they should be”）是 GTNewHorizons 维护的 GTNH 1.7.10 战利品袋模组，modid 为 enhancedlootbags，依赖 Forge@[10.13.4.1558,) 与 YAMCore@[0.5.63,)。

⚠️ 规模与形态：一个物品、零方块

这是本 wiki 中最需要先说清楚的一点。 全部 20 个 Java 文件里：

源码里不存在 ModBlocks / ModItems 之类的注册类。唯一的注册是 LootGroupsHandler.registerBagItem() 里的 GameRegistry.registerItem(new ItemLootBag(this), "lootbag")。

关于"等级"的重要澄清

任务描述里假设战利品袋有 basic → advanced 之类的代码级等级。实际源码中不存在这种结构：

• 全 mod 只有一个物品 ID，所有"档位"靠物品 metadata（伤害值）区分
• metadata 直接等于配置项 LootBags.xml 中的 <LootGroup GroupMetaID="N"> 的 N
• 本 fork 不附带任何 LootBags.xml（src/main/resources/ 下只有 4 个语言文件、2 张 GUI 贴图、1 张物品贴图、1 个音效、mcmod.info）。实际有几档袋子由整合包 / 服务端配置决定，不在本仓库内
• 因此无法给出"整合包实际有几档、每档多少格"的答案。能确定的是属性机制、每个字段的语义与源码内建的 2 档样例配置

源码里唯一真正的等级枚举是每个组各自的 Rarity（0 common / 1 uncommon / 2 rare / 3 epic），它只决定物品名颜色，不决定内容。决定内容的是 CombineTrashGroup 开关。

物品列表

• 战利品袋（LootBag） - 全 mod 唯一物品；metadata = LootGroup ID；右键消耗式开袋，108 格只读预览界面，可附时运 III

设置与系统

• 战利品组等级体系 - "档位"的真正载体：LootBags.xml 的 <LootGroup> 全部属性 + Rarity 四档枚举 + 源码内建样例配置 + MinItems 被忽略的实现细节
• 掉落条目规则 - <Loot> 字段全表：Chance 权重算法、LimitedDropCount 每玩家终身限额（LootBags.dat）、ItemGroup 捆绑掉落
• 垃圾组合并机制 - 组 0 通用垃圾组如何压低高级档概率；CombineTrashGroup 决定"唯一袋"
• 战利品袋预览界面 - 创造模式潜行右键打开的 9×12=108 格只读界面、逐层封死的取出/放入、Drop Information tooltip
• /lootbags 指令 - reload / addloot / addinventory / addgroup 四个子命令的参数、校验范围与客户端同步差异
• AllowFortuneBags 配置项 - 全 mod 唯一的布尔配置项，默认 true，注释文本与代码语义相反

物品效果

• 时运附魔效果 - FortuneLevel LV0~LV3 完整枚举、垃圾权重 33%/66%/100% 削减，以及时运 III 的"完全跳过合并"短路

不存在的内容（避免误写）

以下常被想当然地假设存在于战利品袋模组中，但本 mod 全部没有（源码关键词 filter / blacklist / whitelist / upgrade 零命中）：