Ender Chest

基本信息

属性 值
注册名 enderstorage:enderChest
metadata 0（高 4 位表示种类，低 12 位表示频率三元色）
TileEntity codechicken.enderstorage.storage.item.TileEnderChest
硬度 20
爆炸抗性 100
类别 BlockContainer（带方块实体）
渲染类型 -1（TESR 自定义渲染）
光照 来自附属 EnderItemStorage（默认 0）
对应物品 ItemEnderStorage（enderstorage:enderChest，hasSubtypes=true）

注：源码侧只有一个注册块 BlockEnderStorage（注册名 enderChest），通过 metadata 切换两个 TileEntity；本页对应 metadata=0 的 Ender Chest 分支。

功能

Ender Chest 是 EnderStorage 的物品库存分支方块。每个 Ender Chest 由一个 12-bit 频率值（freq，0–4095）和一个 owner（用户名 / "global"）共同标识。同 (owner, freq, "item") 组合的所有方块共享同一份物品库存，并通过网络在跨维度、跨服务器间自动同步。

  • 频率值由三个 4-bit 染料颜色分量（红绿蓝风格）编码：高 4 位 / 中 4 位 / 低 4 位。
  • 默认频率（频率值 0）下三个颜色分量都是白色（0xF），所有玩家共享一个公共库存（owner="global"）。
  • 三色频率任意一个分量被修改，库存就会切到不同的"频道"。

摆放要求

  • 硬度 20，挖掘需要石镐或更高。
  • 放置朝向：基于放置者 rotationYaw 计算 0–3 的 rotation，旋转通过 rotateBlock（扳手类工具）可切换 4 个方向。
  • 自身对碰撞箱做 0..1 的全方块覆盖，但用 RayTracer 子立方体拾取按钮（三个染料按钮 + 一个 knob 锁扣）。

数值

数值 值
频率范围 0–4095（12-bit，3 × 4-bit 颜色分量）
库存容量 由 storage-size 配置决定（0=3×3=9 / 1=3×9=27 / 2=6×9=54）
物品堆叠上限 64（getInventoryStackLimit）
染料颜色 16 种标准 Minecraft 染料（EnderStorageRecipe.oreDictionaryNames）
默认 owner "global"（共享）

染料面板（subHit 1–3）

subHit 位置 行为
1 顶面左侧按钮 调整频率 freq 的高 4-bit 颜色分量（红）
2 顶面中间按钮 调整频率 freq 的中 4-bit 颜色分量（绿）
3 顶面右侧按钮 调整频率 freq 的低 4-bit 颜色分量（蓝）
  • 仅在玩家手持任意染料（Items.dye、EnderStorageDyeTool、或 OreDictionary 注册为 dyeBlack/dyeRed/… 的物品）时生效。
  • 单击 → 替换该分量为对应染料颜色（~dye & 0xF），并消耗 1 个染料或调用 EnderStorageDyeTool.expendToolUse。
  • 频率修改后调用 tile.setFreq，内部重新装载 EnderItemStorage，已存放的物品继续可见（同一个 (owner, freq) 库存保留）。

锁扣（subHit 4）

操作 行为 消耗
潜行 + 点击 把当前方块 owner 重置为 "global"（公开化） 返回 1 个 personalItem（默认 1 颗钻石；可通过 personalItemID 配置）
手持 personalItem + 点击 当前 owner 为 "global" 时，把 owner 设置为玩家 getCommandSenderName()（私有化） 消耗 1 个 personalItem
  • 私有的 Ender Chest 死亡/被破坏时也会按 owner 留出对应库存；破坏时通过 getDrops 按 freq | meta<<12 重建物品并写回 owner tag。

合成（无 dreamcraft 时由 addNormalRecipies 注册）

bWb
OCO
bpb
  • b = Items.blaze_rod
  • p = Items.ender_pearl
  • O = Blocks.obsidian
  • C = Blocks.chest
  • W = Blocks.wool（meta 0–15，每个颜色对应一个频率三元组）
  • 输出：enderstorage:enderChest（meta 包含对应颜色分量计算的 freq）

EnderStorageRecipe 还支持在工作台中以"已放置的 Ender Chest + 染料行/列"的形式合成直接改色的 Ender Chest。

红石 / 比较器

  • hasComparatorInputOverride=true，getComparatorInputOverride 返回 Container.calcRedstoneFromInventory(this)（按库存填充率输出 0–15）。
  • canConnectRedstone 委托给 TileEnderChest.redstoneInteraction() → false（Ender Chest 不接受红石交互）。

库存生命周期

  • 打开 GUI 时（玩家右键或服务端命令），EnderItemStorage.openInventory() 会把 openCount++，并在第一个玩家打开时广播 open=true 给附近玩家，让箱子盖开启动画播放。
  • 服务端 updateEntity 每 20 tick 同步一次打开数与朝向；客户端通过 BlockEvent 1 收到 c_numOpen 后驱动 lidAngle 动画与开关音效。
  • 频率变更后 tile.setFreq 会 markDirty + worldObj.markBlockForUpdate 并重新装载 EnderItemStorage。

第三方 mod 集成

  • CodeChickenCore（依赖）：codechicken.enderstorage 全代码依赖 codechicken.lib（配置、向量、PacketCustom、RayTracer 等）。
  • NEI：internal.NEIEnderStorageConfig 通过 codechicken.nei.api.API.hideItem 在 disableVanillaEnderChest=true 时隐藏原版 Blocks.ender_chest，并注册 StorageStackStringifyHandler 区分频率/owner。
  • EnderStorageDyeTool（API）：其他 mod 可让自己的工具实现 getDye() + expendToolUse() 来直接当作染料点击 Ender Chest/Tank 的颜色按钮（BlockEnderStorage.onBlockActivated subHit 1–3 路径会优先调用 EnderStorageDyeTool.expendToolUse，所以可以做出"无限染料"的工具）。
  • DreamCraft：EnderStorageRecipe.init() 检测到 Loader.isModLoaded("dreamcraft") 时跳过 addNormalRecipies，沿用 GTNH 自带配方。

相关条目