DHJComical
diff --git a/‎celeritas-common/src/main/java/org/embeddedt/embeddium/impl/render/chunk/DefaultChunkRenderer.java‎
Lines changed: 30 additions & 0 deletions b/‎celeritas-common/src/main/java/org/embeddedt/embeddium/impl/render/chunk/DefaultChunkRenderer.java‎
Lines changed: 30 additions & 0 deletions
diff --git a/‎celeritas-common/src/main/java/org/embeddedt/embeddium/impl/render/chunk/RenderSectionManager.java‎
Lines changed: 15 additions & 1 deletion b/‎celeritas-common/src/main/java/org/embeddedt/embeddium/impl/render/chunk/RenderSectionManager.java‎
Lines changed: 15 additions & 1 deletion
diff --git a/‎celeritas-common/src/main/java/org/embeddedt/embeddium/impl/render/chunk/occlusion/OcclusionCuller.java‎
Lines changed: 55 additions & 0 deletions b/‎celeritas-common/src/main/java/org/embeddedt/embeddium/impl/render/chunk/occlusion/OcclusionCuller.java‎
Lines changed: 55 additions & 0 deletions
diff --git a/‎celeritas-common/src/main/java/org/embeddedt/embeddium/impl/render/chunk/occlusion/OcclusionNode.java‎
Lines changed: 63 additions & 0 deletions b/‎celeritas-common/src/main/java/org/embeddedt/embeddium/impl/render/chunk/occlusion/OcclusionNode.java‎
Lines changed: 63 additions & 0 deletions
diff --git a/‎docs/architecture.md‎
Lines changed: 6 additions & 2 deletions b/‎docs/architecture.md‎
Lines changed: 6 additions & 2 deletions
diff --git a/‎docs/compatibility-matrix.md‎
Lines changed: 6 additions & 1 deletion b/‎docs/compatibility-matrix.md‎
Lines changed: 6 additions & 1 deletion
@@ -382,6 +382,36 @@ protected GlTessellation createRegionTessellation(CommandList commandList, Rende
         return tessellation;
     }
 
+    /**
+     * Legacy Celeritas command-buffer fill API — HBM-CE compatibility seam.
+     *
+     * <p>HBM-CE's {@code MixinDefaultChunkRenderer} (from {@code hbm.mod.mixin.json})
+     * applies {@code @Redirect} injections on this class that replace direct reads of
+     * the camera transform's integer coordinates with unsafe accessors (see HBM's
+     * {@code CeleritasCameraTransformAccess}). One group of those redirects targets
+     * {@link #setModelMatrixUniforms} (which this renderer retains); the other group
+     * targets a {@code fillCommandBuffer} method that existed in the upstream Celeritas
+     * {@code DefaultChunkRenderer} but no longer exists in Actinium's rewritten pipeline
+     * (command buffers are now filled by {@code BatchAssembler}). Without this method the
+     * whole mixin application aborts with a Critical injection error, which poisons this
+     * class and breaks world loading (a subsequent {@code NoClassDefFoundError} on
+     * {@code VintageRenderSectionManager$ChunkRenderer} surfaces during
+     * {@code Minecraft.loadWorld}).
+     *
+     * <p>This method is never invoked by Actinium's render path; it exists purely so the
+     * third-party mixin finds its injection targets and applies cleanly. The reads below
+     * are kept so the redirects have a {@code CameraTransform.intX/intY/intZ} getfield to
+     * rewrite, matching the same unsafe camera access they apply to
+     * {@code setModelMatrixUniforms}.</p>
+     */
+    @SuppressWarnings("unused")
+    void fillCommandBuffer(CameraTransform camera) {
+        int originX = camera.intX;
+        int originY = camera.intY;
+        int originZ = camera.intZ;
+        // Intentionally unused: the values are consumed by HBM-CE's redirected accessors.
+    }
+
     @Override
     public void delete(CommandList commandList) {
         super.delete(commandList);
 
@@ -198,7 +198,17 @@ protected boolean isDebugInfoShown() {
      * per-frame camera bookkeeping.
      */
     public void update(Viewport positionedViewport, int frame, boolean spectator) {
-        this.updateCameraPosition(positionedViewport);
+        // HBM-CE compatibility seam. MixinRenderSectionManager (hbm.mod.mixin.json) applies
+        // @Redirect injections on this exact method body that rewrite the CameraTransform
+        // x/y/z getfields below to its unsafe accessors (CeleritasCameraTransformAccess).
+        // The reads must stay inline here — delegating to updateCameraPosition() leaves the
+        // redirector with zero scanned targets and the mixin application aborts with a
+        // Critical injection error, poisoning this class (NoClassDefFoundError during mod
+        // construction). updateCameraPosition is kept for the shadow pass, which HBM-CE
+        // does not redirect. See HbmCameraRedirectContractTest.
+        this.lastCameraPosition = positionedViewport.getBlockCoord();
+        var transform = positionedViewport.getTransform();
+        this.cameraPosition = new Vector3d(transform.x, transform.y, transform.z);
 
         if (this.shadowPassRanThisFrame) {
             // The shadow pass searched for this frame if the graph was dirty then. Any needsUpdate raised by
@@ -237,6 +247,10 @@ public void updateForShadowPass(Viewport playerViewport, Viewport shadowViewport
                 this.getSearchDistance(), lightVector, this.getTargetQueueSize());
     }
 
+    /**
+     * Shadow-pass camera bookkeeping. Not shared with {@link #update} any more: HBM-CE's
+     * redirector must find the CameraTransform getfields inside {@code update}'s own body.
+     */
     private void updateCameraPosition(Viewport positionedViewport) {
         this.lastCameraPosition = positionedViewport.getBlockCoord();
         var transform = positionedViewport.getTransform();
 
@@ -473,6 +473,61 @@ public static boolean isWithinFrustum(Viewport viewport, int chunkX, int chunkY,
         return viewport.isBoxVisible((chunkX << 4) + 8, (chunkY << 4) + 8, (chunkZ << 4) + 8, CHUNK_SECTION_SIZE);
     }
 
+    // --------------------------------------------------------------------------------------------------------
+    // Legacy object-node API — HBM-CE compatibility seam.
+    //
+    // HBM-CE's MixinOcclusionCuller (hbm.mod.mixin.json) applies MixinExtras @WrapOperation injections
+    // against the pre-lattice upstream OcclusionCuller API: it wraps the isWithinFrustum(Viewport,
+    // OcclusionNode) calls inside isSectionVisible and tryVisitNode (require=2 total) and the
+    // isWithinRenderDistance(CameraTransform, OcclusionNode, float) call inside isSectionVisible
+    // (require=1), expanding the culling bounds for its chunk-spanning machines. Actinium's
+    // lattice-based search never uses object nodes, so the members below are never invoked by the
+    // render path; they exist purely as injection targets. Without them the critical injections fail,
+    // poison this class, and break world loading with a NoClassDefFoundError inside the join task
+    // (issue #47).
+
+    /**
+     * Legacy frustum test operating on an object node — HBM-CE injection target.
+     */
+    public static boolean isWithinFrustum(Viewport viewport, OcclusionNode section) {
+        return viewport.isBoxVisible(section.getOriginX() + 8, section.getOriginY() + 8, section.getOriginZ() + 8, CHUNK_SECTION_SIZE);
+    }
+
+    /**
+     * Legacy render-distance test operating on an object node — HBM-CE injection target.
+     */
+    private static boolean isWithinRenderDistance(CameraTransform camera, OcclusionNode section, float maxDistance) {
+        int ox = section.getOriginX() - camera.intX;
+        int oy = section.getOriginY() - camera.intY;
+        int oz = section.getOriginZ() - camera.intZ;
+
+        float dx = nearestToZero(ox, ox + 16) - camera.fracX;
+        float dy = nearestToZero(oy, oy + 16) - camera.fracY;
+        float dz = nearestToZero(oz, oz + 16) - camera.fracZ;
+
+        return ((((dx * dx) + (dz * dz)) < (maxDistance * maxDistance)) && (Math.abs(dy) < maxDistance));
+    }
+
+    /**
+     * Legacy per-section visibility test — HBM-CE injection target. Never called by Actinium's
+     * render path.
+     */
+    @SuppressWarnings("unused")
+    private static boolean isSectionVisible(OcclusionNode section, Viewport viewport, float maxDistance) {
+        return isWithinRenderDistance(viewport.getTransform(), section, maxDistance) && isWithinFrustum(viewport, section);
+    }
+
+    /**
+     * Legacy node visit — HBM-CE injection target providing the second wrapped
+     * isWithinFrustum(Viewport, OcclusionNode) call site. Never called by Actinium's render path.
+     */
+    @SuppressWarnings("unused")
+    private static void tryVisitNode(Viewport viewport, OcclusionNode section) {
+        if (section == null || !isWithinFrustum(viewport, section)) {
+            return;
+        }
+    }
+
     /**
      * Choose the search seed. A loaded in-world camera section is processed
      * inline; an out-of-height or unloaded camera is handled by scanning a
 
@@ -0,0 +1,63 @@
+package org.embeddedt.embeddium.impl.render.chunk.occlusion;
+
+import org.embeddedt.embeddium.impl.render.chunk.RenderSection;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Legacy object-graph occlusion node — HBM-CE compatibility seam.
+ *
+ * <p>Upstream Celeritas represented the visibility graph with object nodes of this type until
+ * upstream commit {@code 450dc85f} ("Implement a better storage system for occlusion node
+ * data") replaced them with {@link SectionLattice}'s dense cell storage, which Actinium
+ * follows. HBM-CE's {@code MixinOcclusionCuller} still targets the object-node API: it wraps
+ * the {@code OcclusionCuller.isWithinFrustum(Viewport, OcclusionNode)} and
+ * {@code isWithinRenderDistance(CameraTransform, OcclusionNode, float)} call sites and reads
+ * node origins plus the backing render section from its handlers.</p>
+ *
+ * <p>This class is never instantiated by Actinium's render path. It exists purely so the
+ * third-party mixin finds its injection targets and applies cleanly; without it the critical
+ * injections fail, poison {@link OcclusionCuller}, and break world loading with a
+ * {@code NoClassDefFoundError} inside the join task (issue #47).</p>
+ */
+public final class OcclusionNode {
+    private final @Nullable RenderSection section;
+    private final int originX;
+    private final int originY;
+    private final int originZ;
+
+    public OcclusionNode(@Nullable RenderSection section, int originX, int originY, int originZ) {
+        this.section = section;
+        this.originX = originX;
+        this.originY = originY;
+        this.originZ = originZ;
+    }
+
+    /**
+     * @return the render section this node was derived from, or {@code null} for a
+     * position-only node
+     */
+    public @Nullable RenderSection getRenderSection() {
+        return this.section;
+    }
+
+    /**
+     * @return block-space X coordinate of the section's minimum corner
+     */
+    public int getOriginX() {
+        return this.originX;
+    }
+
+    /**
+     * @return block-space Y coordinate of the section's minimum corner
+     */
+    public int getOriginY() {
+        return this.originY;
+    }
+
+    /**
+     * @return block-space Z coordinate of the section's minimum corner
+     */
+    public int getOriginZ() {
+        return this.originZ;
+    }
+}
@@ -99,7 +99,8 @@ GTNHLib ← glsm ← celeritas-common ← shader ← 根项目 src/main（compil
   - `mixin/features/iris`（含 `startup/`）：约 35 个 Iris 兼容注入
     （实体、粒子、渲染器、纹理地图接入与启动期纹理注入）。
   - `mixin/mod/`：按模组分组的 conditional 注入 —— `betterfoliage`、`ccl`、`dh`（7 个）、
-    `gibbed`、`ichunutil`、`lumenized`、`revoui`、`voxelmap`（3 类，小地图兼容）；
+    `gibbed`、`hbm`（2 类，机器状态与世界光照兼容）、`ichunutil`、`lumenized`、`revoui`、
+    `voxelmap`（3 类，小地图兼容）；
     `stellarcore` 为空目录（规划占位）。
   - `mixin/vintage/`：原版 1.12.2 注入分支 —— `core`（Minecraft/RenderGlobal/Tessellator/
     纹理上传）、`core/collections`、`core/crash`（SplashProgress）、`core/frustum`、
@@ -125,6 +126,8 @@ GTNHLib ← glsm ← celeritas-common ← shader ← 根项目 src/main（compil
 - **`compat/fluidlogged/`**：`FluidloggedCompat`、`FluidStateStorage`、`FluidloggedBlockAccess`
   —— 流体方块状态存取，供区块克隆离线读取。
 - **`compat/gibbed/`**：`ActiniumModelRenderer` —— Gibbed 尸块渲染模型扩展。
+- **`compat/hbm/`**：`HbmRenderStateCompat` —— HBM attribute scope 到 GLSM 状态栈的映射，
+  以及方块实体世界 lightmap 同步（配 `mixin/mod/hbm`）。
 - **`compat/ichunutil/`**：`PortalViewportFactory` / `PortalViewportProvider` /
   `PortalChunkRenderMatrices` / `PortalRenderState` / `WorldBoxVisibility`
   —— 传送门视口与渲染状态管理。
@@ -422,7 +425,7 @@ LWJGL 后端（并入本子项目）：
 
 ## Mixin 配置清单
 
-`src/main/resources/` 下 10 个配置 + 1 个门控声明：
+`src/main/resources/` 下的 early/conditional 配置与 1 个门控声明：
 
 | 配置 | 阶段 | 用途 |
 | --- | --- | --- |
@@ -435,6 +438,7 @@ LWJGL 后端（并入本子项目）：
 | `mixins.actinium.revoui.json` | late/conditional（neofontrender_ui_enhancements） | `mixin/mod/revoui` 3 类 |
 | `mixins.actinium.betterfoliage.json` | late/conditional（betterfoliage） | `MixinChunkBuilderMeshingTaskBetterFoliage` |
 | `mixins.actinium.ccl.json` | late/conditional（codechickenlib） | `MixinGlStateTracker` |
+| `mixins.actinium.hbm.json` | late/conditional（hbm） | `MixinRenderUtil`、`MixinTileEntityRendererDispatcherLightmap` |
 | `mixins.actinium.voxelmap.json` | late/conditional（voxelmap） | `mixin/mod/voxelmap` 3 类（GLUtils/GLShim/renderMap，小地图 CPU 路径与 HudCaching alpha 保护） |
 
 门控映射在 `mixins.actinium.conditions.properties`（mixin loader 不认 json 自定义字段），
 
@@ -1,6 +1,6 @@
 # Actinium 兼容性矩阵
 
-最后更新：2026-08-31。
+最后更新：2026-09-02。
 
 状态定义：`已验证` 表示在记录的版本和场景中通过；`部分` 表示能运行但存在已知缺口；
 `无法启用` 表示光影包不能成功开启；`未验证` 不代表不兼容。更新记录时必须填写 Actinium commit、
@@ -64,6 +64,10 @@ Windows 10、NVIDIA GeForce RTX 5070 Laptop GPU（驱动 610.74）。
 > [docs/compat/oldresearch.md](compat/oldresearch.md)。dev 人工回归确认研究笔记 GUI 不再卡死，
 > 优化后约 500+ FPS，与背包界面同量级；研究树视觉回归仍待补充。
 
+> 2026-08-29 追加：HBM's Nuclear Tech - Community Edition 2.5.0.5 的机器黑色剪影、
+> lightmap 和深度状态异常修复——见下方 [模组与环境](#模组与环境) 的 HBM 行。
+> dev 实际场景回归覆盖 FENSU 与其他 HBM 机器，模型不再显示为黑色剪影。
+
 > 2026-09-02 追加：BetterPortals Refitted 0.4.1 末地传送门无看穿效果（洞口只见星野贴图）+
 > 视觉位置低约一格 + 修复后星野被拉成竖直条纹的修复——见下方 [模组与环境](#模组与环境) 的
 > BetterPortals Refitted 行与 [docs/compat/betterportals.md](compat/betterportals.md)。
@@ -102,6 +106,7 @@ Windows 10、NVIDIA GeForce RTX 5070 Laptop GPU（驱动 610.74）。
 | Chunk Animator   | 部分 | 条件桥（ChunkAnimationProvider）+ 动画 section 单独绘制 | 1.12.2-1.2.1（236484:3850023）dev 运行通过（coremod 加载、兼容层启用、进世界无异常）；动画视觉确认待补，详见 [docs/compat/chunkanimator.md](compat/chunkanimator.md) |
 | VoxelMap         | 部分 | 条件 Mixin（CPU 纹理路径 + 线性过滤 + scissor 重路由 + HudCaching alpha 保护） | 1.9.25 小地图黑屏/黑块已修复（dev 验证圆内正常显示地图内容、HUD 不被缓存隐藏，见 [docs/compat/voxelmap.md](compat/voxelmap.md)）；已知缺口：与 StellarCore `HudCaching` 组合时小地图圆周仍可能残留黑块（VoxelMap 全屏清 alpha + DST_ALPHA 混合与 HUD 缓存 FBO 的第三方冲突，`HudCaching=false` 即消失，非本模组缺陷）；验证 VoxelMap 需停用 JourneyMap（二者频道冲突） |
 | ModernUI         | 代码支持 | GUI scale hook                     | 尚缺当前运行时验证记录      |
+| HBM's Nuclear Tech - Community Edition | 已验证 | 条件 Mixin（RenderUtil 状态栈 + TileEntityRendererDispatcher 世界 lightmap 同步） | 2.5.0.5（CurseForge 1312314:8330665）：FENSU 与其他 HBM 机器的 WaveFront raw VAO 模型在实际场景中正常显示；修复前的 stale lightmap、黑色剪影和 depth 恢复异常不再复现；Java 25.0.3、Cleanroom 0.6.12-alpha dev 回归通过 |
 | Depths Update    | 已验证 | 兼容门控（`compat/depthsupdate`：公开 API 推导 section 范围 + storage 索引映射） | 1.0.0-a10：扩展世界高度（默认 -64..320）下 Y<0 与 Y>255 的方块不再缺失（渲染器原先硬编码 0-255）；dev 实测正常；无 Depths 时回退 vanilla 行为 |
 | EnderIO CEu / EnderCore CEu | 已验证 | 无（核心渲染语义修复，非模组接入） | 5.4.2 + EnderCore 0.5.81：光影开启时流体罐内液体被罐体玻璃窗深度遮挡的问题已修复（`cb4feaa5`，translucent terrain pass 不再写深度）；MakeUp Ultra Fast 9.4c + Cleanroom 0.5.17-alpha 实测通过；2026-09-02 修复 #85（`da83c59`）引入的回潮——translucent pass 被错误翻转为写深度导致有无光影流体均被玻璃遮挡，已恢复 vanilla 深度语义，双路径实测通过 |
 | Snow! Real Magic! | 已验证 | 兼容门控（SRM 的 snow_layer 块退回 vanilla dispatcher 路径） | 0.7.4：带雪栅栏不渲染已修复（SRM 把被覆盖方块替换为带 SnowTile 的雪层、仅在 `BlockRendererDispatcher.renderBlock` 内重绘，快速区块路径已绕过）；`6aee395`，dev 运行验证通过（MakeUp Ultra Fast 下无光影 + 光影各验一次） |