洞察宝箱

开发状态与未来移植

请注意：InSight Chests 是一个活跃且持续开发中的项目。对更多 Minecraft 版本的支持，以及向 NeoForge 和 Fabric 的移植，都在计划之中。虽然我无法承诺这些移植的具体发布时间，但我致力于在转向其他模组项目之前，长期维护和完善这个项目。

概述

InSight Chests 通过将默认的不透明界面替换为干净、半透明的槽位布局，并配合镜头过渡和箱子内部物理 3D 物品渲染，改变了标准的箱子交互方式。

主要特性

• 镜头过渡：打开箱子时，镜头会平滑地向下移动到箱子内部；关闭时，镜头会回到玩家原本的视角。
• 物理 3D 物品：容器内的物品会以物理 3D 对象的形式渲染，在箱子内部具有碰撞和堆叠物理效果，而不再仅仅是 2D 图标。
• 半透明界面：用深色磨砂玻璃风格的槽位布局替换了厚重的原版背景纹理，让你在保持标准物品栏操作不变的同时，能够清晰地看到箱子内部。
• 内部阴影与光照：箱子内部和物品会动态采样局部方块光照和天空光照，准确匹配火把、夜晚黑暗以及光影光照效果。
• 实体兼容性：箱子矿车、箱子船和驮畜（驴/骡）保留原版界面，以防止在移动实体上出现视角穿模。

兼容性

• 环境：100% 客户端模组。加入原版或模组多人服务器时完全可以安全使用。
• 模组物品：完全兼容。任何模组物品（包括自定义 3D 工具模型或动画物品）都会通过游戏原生模型注册表正确地在箱子内渲染。
• 模组箱子：适用于原版箱子、末影箱，以及继承标准箱子类的模组箱子变体（例如 Quark 的木质箱子）。自定义的非标准存储系统（如 Iron Chests 或 Sophisticated Storage）会被安全忽略，并会打开它们自己的默认菜单，不会崩溃。
• 光影兼容性：理论上？适用于所有光影。实际上？已修复主要光影 bug，并在 BSL 和 MakeUp-UltraFast（通过 OptiFine）上测试过。我还没有测试 Sodium、Embeddium 或 Oculus，但鉴于该模组的构建方式，很可能也能正常工作。目前还剩 1 个非视觉性的小 bug，但如果你遇到任何诡异的 bug，欢迎提交报告！

打开末影箱

 

打开大箱子

 

打开普通箱子：

 

其他：

版本 1.0.1（光影修复更新）：

版本 1.0.2（光影修复更新第二部分及更多内容）：

注意：1.0.2 中改进内容的截图将在我有空时添加。

---

Bug 修复：

• 箱子内部太暗/全黑（无光影）：在没有光影包的情况下游玩时，箱子内部完全没有光照或漆黑一片。现在它会正确响应你周围的真实光照——火把、阳光、黑暗，全部都能正确反应。
• 箱子内部始终明亮（有光影）：使用光影包（BSL、MakeUp 等）时，无论一天中的时间或环境有多暗，箱子内部都永久处于全亮状态。已修复——现在它会正确响应光影的光照。
• 树叶方块（及其他可透视方块）在重新打开时出错：当你把树叶方块、玻璃或其他透明/可透视方块放进箱子，关闭后再重新打开时——部分物品副本会显示为纯绿色、漆黑一片，或直接损坏。已修复。
• 大箱子 GUI 裁切到快捷栏中：大箱子物品栏面板稍微太高，向下挤入了底部的快捷栏区域。标签文本也未对齐。已修复——面板现在位于屏幕更靠上的位置，间距适当。
• 日志中刷屏的 “OpenGL Error: 1282”：游戏日志中不断出现一条无害但烦人的错误信息。它与任何实际问题都无关——只是该模组与 Minecraft 渲染管线交互时留下的噪音。已静默处理。
• 看着箱子时方块轮廓仍然可见：当你打开箱子时，黑色方块选择轮廓在 3D 视图中仍然可见。现在箱子打开时该轮廓会隐藏，关闭后会恢复。

---

性能：

显著减少了打开箱子时每帧的 GPU 绘制调用次数——在光影包下尤其明显。在光影下，一个装满的大箱子现在使用的绘制调用次数大约比以前少了 40–75%。

尽管有这些优化，InSight Chests 在较弱的机器上仍然是一个相对吃性能的模组。实时渲染箱子内数十个物理 3D 物品本质上就很昂贵——Minecraft 的渲染引擎不支持能让这件事变得廉价的那种批处理，而我已经在当前可能的范围内尽可能推进了。

如果你是开发者，并且知道有更好的技术可以在不破坏视觉质量的情况下降低渲染成本，请分享——我真心欢迎。如果出现另一个能更高效解决这类性能问题的模组，也请分享给社区。让更多人能以更好的 FPS 游玩始终是目标。

---

更新日志摘要：

• 修复了原版和光影环境下箱子内部的光照
• 修复了透明方块物品（树叶、玻璃）在重新打开箱子时损坏的问题
• 修复了大箱子 GUI 与快捷栏重叠的问题
• 修复了箱子视图内可见方块选择轮廓的问题
• 静默了无害的 OpenGL 错误日志刷屏
• 通过更高效地批处理绘制调用，提高了光影下的 FPS
• 方块物品自动限制为每堆最多 3 个副本以提升性能（可配置）
• 添加了 GUI 位置配置：可将物品栏面板移动到屏幕左侧、右侧或中间
• 默认 GUI 位置现在为右侧——屏幕中央保持空白，以便查看 3D 箱子视图

---

配置：

该模组有一个配置文件（insightchests-client.toml），位于你的 .minecraft/config/ 文件夹中。你可以用任何文本编辑器编辑它。以下是你所能修改的全部内容：

通用：

• physicsMode — 控制物品在箱子内的行为方式。

  • FULL（默认） — 完整物理：物品会掉落、碰撞、堆叠，并且当你把东西扔到上面时会翻滚。
  • STATIC — 物品会掉落并稳定到位，但不会动态地相互推挤。
  • OFF — 完全禁用所有 3D 物品渲染。箱子会以正常方式打开。

• enableCameraTransition — 打开箱子时镜头是否会平滑移向箱子。如果你觉得这让人迷失方向，或者只是不想要它，请设置为 false。（默认：true）

• cameraSpeed — 镜头过渡移动的速度。1.0 是默认速度。更高的值会让它更迅速，更低的值会让它更慢、更有电影感。（范围：0.2 到 3.0）

GUI：

• guiPosition — 物品栏面板在屏幕上的显示位置。

  • RIGHT（默认） — 面板位于右侧。屏幕中央保持空白，这样你就能真正看到箱子和里面的物品。
  • LEFT — 面板位于左侧。
  • MIDDLE — 居中显示在屏幕上，与原版相同（直接叠加在箱子视图上）。

• uiBackgroundOpacity — 槽位网格背景的不透明度。0.0 为完全透明，1.0 为完全不透明。默认是 0.25（大部分可透视）。（范围：0.0 到 1.0）

• uiBlurIntensity — 面板上磨砂玻璃模糊效果的强度。0.0 禁用它，1.0 为最大模糊。默认是 0.75。（范围：0.0 到 1.0）

• hoverHighlight — 将鼠标悬停在 GUI 中的某个槽位上时，是否会高亮箱子内对应的 3D 物品。（默认：true）

渲染：

• hollowChestModel — 当箱盖打开时，是否渲染箱子内部的 3D 中空腔体。如果关闭，箱子顶面会像平常一样保持平坦。（默认：true）

• representationCap — 普通物品（工具、食物、武器等）每堆显示的最大 3D 物品副本数量。一整堆 64 个物品最多显示这么多副本。提高它可获得更饱满的外观，降低它以节省 FPS。（默认：5，范围：1 到 16）

• blockRepresentationCap — 与上方相同，但专门用于方块物品（石头、树叶、矿石、玻璃等）。方块物品单独渲染的成本更高，因此此项单独设置。默认是 3，这已经看起来像一堆令人信服的物品了。如果想要更多，可提高到 5；在弱电脑上可降低到 1–2。（默认：3，范围：1 到 16）

• renderBatchSize — 在绘制之前，有多少普通物品会被分组到单次 GPU 提交中。数值越高，总体 FPS 越好，但某些不寻常的模组物品在高数值下可能会显示异常。如果你看到某个特定物品出现奇怪的视觉故障，请将其降低到 1。（默认：4，范围：1 到 16）