ironchest

[!INFO] Git Commit: 7681237 | Updated: 2026-05-12

Iron Chests（@Mod 类 cpw.mods.ironchest.IronChest，modid = IronChest，name = "Iron Chests"）是一个纯方块/物品型存储模组：它只注册 1 个方块（IronChest:BlockIronChest），用 11 个 metadata 变体提供 1 ~ 135 格的箱子，另有 17 个升级器物品用于把箱子就地升级。

本仓库为 GTNH（GregTech: New Horizons）fork，Minecraft 1.7.10 / Forge，cpw 原作，作者 Lishid 提供原始创意。全部内容仅 29 个 Java 文件，根包 cpw.mods.ironchest（client/ 与 plugins/nei/ 两个子包）。

[!IMPORTANT] 三个容易踩空的前提，均由源码核实：

1. modid 是大写 IronChest，但资源域是小写 ironchest（贴图/语言文件）。注册名写 IronChest:xxx，图标与本地化键写 ironchest:xxx。
2. IronChestType 有 12 个枚举常量，但只有 11 个是真实箱子。第 12 个 WOOD（size = 0、clazz = null、tier = -1、textureRow = -1）是哨兵，仅代表"原版木箱子"这个升级来源，不注册任何方块、物品或 TileEntity。
3. 构造函数的第 6 个参数不是 metadata。它是 textureRow（贴图行号）；箱子 metadata 恒等于枚举的 ordinal()。

核心：IronChestType 全枚举

IronChestType 是整个 mod 的唯一数据源，构造函数 13 个参数（IronChestType.java:94）：

IronChestType(int size, int rowLength, int tier, String friendlyName, String modelTexture,
        int textureRow, List<String> mats, Class<? extends TileEntityIronChest> clazz,
        Item itemFilter, String recipeDirect, String recipeUpgradeOneTier,
        String recipeUpgradeTwoTiers, int resistance)

DIRTCHEST9000 走 12 参数重载（itemFilter 传 null），其余全部走 13 参数重载。

完整常量表

size = 容量（槽位数），rowLength = 每行格数，tier = 箱子等级，textureRow = 贴图行号（非 metadata），resistance = 抗爆标志（最后一个参数，0/1 而非抗爆数值）。

rowCount 由 getRowCount() = size / rowLength 推导（WOOD 会除零，因此永不被实例化）。

配方字符串（12 个字段逐条）

recipeDirect / recipeUpgradeOneTier / recipeUpgradeTwoTiers 均为 9 字符串，切成 3 行 3 列；P = 前一级箱子，m = 本级材质，G = 玻璃，C = 原版木箱，O = 黑曜石。

[!NOTE] 配方只在未加载 GTNH 时生成：IronChestType.registerBlocksAndRecipes 末尾有 if (!IronChest.isGTNHLoaded) { ... }，ChestChangerType.generateRecipes() 开头有 if (IronChest.isGTNHLoaded) return;。GTNH（装了 DreamCraft）上本 mod 一条合成配方都不注册。

resistance 的两重用途

1. 抗爆：isExplosionResistant() = resistance >= 1 → BlockIronChest.getExplosionResistance 返回 10000.0F。全仓库没有任何 setResistance() 调用。
2. 配方过滤：getRegistredChestsByTier(parent, tier, resistance) 要求候选 typ.resistance >= resistance。直做配方传 typ.resistance - 1（放宽），升级配方传 typ.resistance（收紧）。最直接的后果：下界合金箱子（resistance 1，tier 6）只能从黑曜石箱子升级，钻石/水晶箱（resistance 0）被过滤掉。

未被使用的字段

• textureRow：getTextureRow() 是死代码（全仓库除定义与赋值外零调用）。
• modelTexture / getModelTexture()：只被 TileEntityIronChestRenderer 用来拼 textures/model/<name> 路径。
• IronChestType.VALUES：注释明确 “the array should NOT be mutated”，是高频只读缓存。

依赖与注册入口

@Mod(modid = "IronChest", name = "Iron Chests", dependencies = "required-after:Forge@[10.10,);required-after:FML@[7.2,)")

preInit 里 ChestChangerType.buildItems(cfg)（注册 17 个升级器物品）与配置读取在同一个 try 块内。

旧存档名重映射

IronChest.missingMapping（FMLMissingMappingEvent）：

后两条是 if / else if 串联，先判 DARKSTEEL。GTNH 上 DARKSTEEL 默认开、NETHERITE 默认关，故走第一支。

代码结构

本 mod 没有的内容（grep 证据）

以下 9 个维度在 src/main/java/ 全仓库零命中，因此未建目录：

另外：

• 无多方块结构：BlockIronChest 继承 BlockContainer，无 createTileEntity 之外的成组检测。
• 无世界生成：无 WorldGen / MapGen 相关类，src/main/resources 下无任何世界生成配置文件。
• 无伤害/生物：mod 不注册实体，豹猫是原版 EntityOcelot。
• 无附魔 / 无 potion / 无成就。
• 无第三方 mod 整合点，唯一外部引用是 NEI（plugins/nei/NEIConfig.java，仅注册书签 handler）与 InvTweaks（ContainerIronChest 上的 @ChestContainer(isLargeChest = true) 与 @ChestContainer.RowSizeCallback）。
• 无合成表文件：所有配方都是 ShapedOreRecipe 代码注册；src/main/resources 下无 _recipes 目录。

方块列表

宿主方块（1 个注册方块 + 11 个 metadata 变体）：

• Iron Chest 方块（IronChest:BlockIronChest） - metadata 分配、硬度 3.0F、抗爆覆写、比较器、旋转、猫判定

11 个 metadata 变体：

• Iron Chest（铁箱子） - 54 格 / 6×9 / tier 2
• Copper Chest（铜箱子） - 45 格 / 5×9 / tier 1，全表最小
• Steel Chest（钢箱子） - 72 格 / 8×9 / tier 3，复用银箱子贴图
• Silver Chest（银箱子） - 72 格 / 8×9 / tier 3，默认关闭
• Gold Chest（金箱子） - 81 格 / 9×9 / tier 4，唯一正方形布局
• Diamond Chest（钻石箱子） - 108 格 / 9×12 / tier 5
• Crystal Chest（水晶箱子） - 108 格 / 9×12 / tier 5，全 mod 唯一透明
• Obsidian Chest（黑曜石箱子） - 108 格 / 9×12 / tier 5，抗爆
• Netherite Chest（下界合金箱子） - 135 格 / 9×15 / tier 6，抗爆，GTNH 上默认关闭
• Dark Steel Chest（玄钢箱子） - 135 格 / 9×15 / tier 6，GTNH 上默认开启
• Dirt Chest 9000（泥箱子 9000） - 1 格 / 只收泥土 / 出厂附说明书

物品列表

箱子物品形态：

• ItemIronChest（箱子物品形态） - damage 即 metadata，getMetadata 走 validateMeta

17 个升级器物品（全部 setMaxStackSize(1)，无耐久，右键已放置的方块触发）：

符号：m = 目标材质，s = 来源材质，G = 玻璃，O = 黑曜石。

游戏设定列表

• 箱子类型开关（enable*Chests） - 4 个 boolean，GTNH 上 darkSteel=true / netherite=false
• 升级黑名单（blocklistUpgrades） - String 列表，SOURCE:TARGET 格式，可屏蔽任意升级器与其配方
• 透明箱子渲染（transparentRender*） - boolean + double 128D，只影响水晶箱子
• 猫与箱子行为（ocelots*） - 2 个 boolean，替换豹猫坐箱 AI 与开箱门禁

[!NOTE] mod 共 9 个配置项，全在 config/ironchest.cfg 的 general 段。blocklistUpgrades 的读取与 ChestChangerType.buildItems(cfg) 在同一 try 块内，配置加载异常会连带导致 17 个升级器全部不注册。