Files
agentmc/scaffold/java/gen_1_21
JianFeeeee c3a57256ac McfoldBridge 改反射 + 新增 Sodium tracker 通知与 hideGui
三件事,其中后两件是实测查出来的。

## ① McfoldBridge:「同包直调」在 intermediary 下失效 ⇒ 改反射

原来把桥类放进 `net.minecraft.client.renderer` 包,靠**同包**访问
GameRenderer 的 package-private 方法。这个技巧只在 **named** 下成立:

    named        桥与 GameRenderer 同在 net.minecraft.client.renderer  ⇒ 同包 ✅
    intermediary GameRenderer → net.minecraft.class_757(包变成 net.minecraft)
                 桥仍在 net.minecraft.client.renderer                ⇒ 异包 ❌
    ⇒ IllegalAccessError: McfoldBridge tried to access method
       'void net.minecraft.class_757.method_34538(...)'

★ **包名本身也被 remap**,所以「靠包名对齐」切换命名空间就断了。
  反射 + 语义名(McfoldNames)与命名空间无关,是唯一两态都通的形态。
  (gen_1_21 本来就为 loadEffect 用了反射,现在两处统一。)

## ② Sodium 通知:装载地形渲染的 mod 现在能看见了(根因三层,逐层实测)

**症状**:装了 Sodium 后画面只有天空、chunks=0,而 blockinfo 能正确读出
方块 ⇒ 数据在,只是它不知道。

**三层根因(每层都有实测数据)**:

┌ ① mixin 永不命中
│   Sodium 挂在 replaceWithPacketData 内 @At(INVOKE onChunkLoaded, AFTER)
│   而 1.20.1 该方法**内部不调** onChunkLoaded(在 getChunk/drop 里各有一处)
│   ⇒ 它的 ChunkTracker 从未被告知任何区块
│   【修】notifyRenderTracker() 补通知
│
├ ② 反射签名错
│   ChunkTrackerHolder.get 的参数是 **ClientLevel** 不是 Level
│   第三参数是**位掩码 int** 不是 ChunkStatus 对象(签名 (III)V)
│
└ ③ ★ status 值错(真正的那道坎)
    Sodium 的语义:
        FLAG_HAS_BLOCK_DATA = 1   FLAG_HAS_LIGHT_DATA = 2   FLAG_ALL = 3
    而 ChunkTracker.updateMerged 的 2×2 邻域判定是
        `四邻 status 按位与 == 3`   (字节码 :54 iand / :71 iconst_3)
    ⇒ 传 1:1&1&1&1=1 ≠ 3 ⇒ 全部判成"凑不齐 2×2"
            ⇒ chunkReady 恒 0、loadQueue 恒空、画面无地形
      传 3:3&3&3&3=3 == 3 ⇒ 25 个 2×2 组就绪 ⇒ 重建队列有 25 项
    (我们确实有光照数据:注入时跑了 light.runLightUpdates())

**实测对比**(同一场景 7×7=49 区块):
    传 1:  chunkStatus=49  chunkReady=0   loadQueue=0   colors=4748
    传 3:  chunkStatus=49  chunkReady=25  loadQueue=25  colors=113546

★ 走反射 + 类不存在时静默跳过 ⇒ 不装 Sodium 时零影响。
  这不是"给某个 mod 打补丁":注入路径缺了"区块已就绪"广播,
  补上它对所有依赖该事件的 mod 都有效。

**同时广播官方的 level.onChunkLoaded(pos)** —— 与网络包路径等价的那一步。

## ③ hideGui:截图场景关掉 HUD

走**官方选项** `options.hideGui`(= 游戏里 F1),不改渲染代码 ——
GameRenderer.render 里就是 `if (!options.hideGui) gui.render(...)`。
为什么要关:截图只关心画面,HUD 是噪声,而且它给 distinctColors
掺一大块固定像素(实测污染判据)。

两个世代后端都加了 hideGui;Python 侧 set_view(hide_gui=...)。
2026-09-26 10:17:48 +08:00
..