M1+M2：1.21.1 构建跑通 + 协议客户端进 play 阶段

M1（构建）：
- build.sh 编译 CP 加入 $OUT/fabric/*.jar，解决 net.fabricmc.* 找不到
- gen_1_21 内联 Sodium 通知改为委托共用 RenderCompat，补 reportRenderCompat
- 1.21.1 全量七步构建产物齐备（classes-intermediary.jar / names*.json / srg / inheritance.map）

M2（协议）：
- login_start 按协议数据发 UUID（1.21 必填；1.20 可选）
- login_acknowledged / serverbound 包 id 改为查表，不再写死 0x00
- send() 实现压缩帧格式（varint(dataLen)+数据，小包不压）
- configuration 双向协商：发 settings、回 select_known_packs、拒 resource_pack
- protodef 补 bitflags / entityMetadataLoop / count(ctx引用) / compareTo 路径表达式
- NBT 读取器由占位符改为真实现（anonymousNbt 支撑 registry_data）
- 坏包容错：长度前缀是帧层权威，解不开整包丢弃并布告，不断流

实测：login→configuration(11 注册表)→play，位置 (5.5,-60.0,-0.5)，map_chunk×9
判据：protodef 6→13 项（含线上真实 entity_metadata 字节回归）；全量 77 项通过

scaffold/java/gen_1_20/McfoldRenderServer.java

@@ -61,6 +61,7 @@ import java.util.OptionalInt;
 import java.util.UUID;
 import java.lang.reflect.Method;
 import mcfold.McfoldNames;
+import mcfold.RenderCompat;
 
 /**
  * mcfold 渲染服务：常驻进程，NDJSON(行分隔 JSON) 协议，由 Python 侧驱动。
@@ -676,7 +677,7 @@ public class McfoldRenderServer {
                 }
                 // viewCenter
                 r.addProperty("fogStart", String.valueOf(mc.options.renderDistance().get()));
-                probeSodium(id, r);
+                reportRenderCompat(r);
                 emit(id, r);
                 break;
             }
@@ -756,206 +757,56 @@ public class McfoldRenderServer {
             System.err.println("[mcfold] onChunkLoaded(" + cx + "," + cz + ") 失败: " + t);
         }
         // ② 渲染替换件的 tracker（实测：Sodium 靠这个才知道区块存在）
-        notifyRenderTracker(cx, cz);
+        RenderCompat.notifyChunkLoaded(level, cx, cz);
     }
 
-    /**
-     * 告诉「渲染替换件」的区块 tracker：这块地已就绪。
+
+    /** 诊断：地形渲染替换件（Sodium 等）的真实状态，写进 debug 响应。
      *
-     * ★ 为什么需要它（2026-09-26 实测，见 debug 里的 sodium* 字段）
-     *
-     *   症状：装了 Sodium 后画面只有天空、chunks=0、它的重建队列恒空，
-     *         而 blockinfo 能正确读出方块 ⇒ **数据在，只是它不知道**。
-     *
-     *   根因：Sodium 的 mixin 挂在
-     *       replaceWithPacketData 内部 @At(INVOKE onChunkLoaded, AFTER)
-     *     而 1.20.1 的 replaceWithPacketData **内部并不调** onChunkLoaded
-     *     （它在 getChunk / drop 里各有一处，属别的路径）⇒ 注入点永不命中。
-     *     我们直接调 onChunkLoaded 也救不了：mixin 只在 replaceWithPacketData
-     *     **执行期间**生效。
-     *
-     * ★ 为什么这不算“绑死 Sodium”：
-     *   - ChunkTrackerHolder 是它的 **public interface**（mixin 提供的公开钩子）；
-     *   - 全部走反射，**类不存在时静默跳过** ⇒ 不装 Sodium 时零影响。
-     *   - 将来别的渲染器若有同名钩子，改这一处即可。
+     *  ★ 为什么需要它：vanilla 的 countRenderedChunks() 在 Sodium 下**恒为 0**
+     *    （它数的是 vanilla 的网格，替换件不走那条路）⇒ 光看这个数会把
+     *    「换了渲染器」误判成「没有数据」。而 blockinfo 能读方块 ⇒ 数据是在的。
+     *  ⇒ 排障必须问**渲染器自己**。
      */
-    static void notifyRenderTracker(int cx, int cz) {
-        try {
-            Class<?> holder = Class.forName(
-                    "me.jellysquid.mods.sodium.client.render.chunk.map.ChunkTrackerHolder");
-            // ★ 参数类型必须是 **ClientLevel**（不是它的父类 Level）——
-            //   签名是 get(class_638)；传 Level.class 会 NoSuchMethodException
-            //   （实测踩过：'get(net.minecraft.world.level.Level)' 找不到）。
-            Object tracker = holder.getMethod("get", ClientLevel.class).invoke(null, level);
-            if (tracker == null) return;
-            // ★ 第三参数是**位掩码 int**（实测签名 (III)V）。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）
-            //   ⇒ **必须报 3**：只报 1 会让所有区块判成"凑不齐 2×2"，
-            //     结果 chunkReady 恒 0、loadQueue 恒空、画面无地形
-            //     （实测：传 1 → chunkStatus=49 但 chunkReady=0）。
-            //   我们确实有光照数据 —— 注入时就跑了 light.runLightUpdates()。
-            int flagAll = sodiumFlagAll();
-            tracker.getClass()
-                  .getMethod("onChunkStatusAdded", int.class, int.class, int.class)
-                  .invoke(tracker, cx, cz, flagAll);
-        } catch (ClassNotFoundException noTracker) {
-            // 没装 Sodium（或其他无此钩子的渲染器）⇒ 正常，静默
-        } catch (Throwable t) {
-            // 装了但调用失败 ⇒ 报出来（否则会默默退回“无地形”）
-            System.err.println("[mcfold] notifyRenderTracker(" + cx + "," + cz + "): " + t);
+    static void reportRenderCompat(JsonObject r) {
+        if (!RenderCompat.available()) {
+            r.addProperty("renderCompat", "absent");
+            return;
         }
-    }
-
-    /** Sodium 的 FLAG_ALL（有方块 + 有光照）；取不到时退回 3。 */
-    static int sodiumFlagAll() {
-        try {
-            Class<?> cs = sodiumClass().getClassLoader()
-                    .loadClass("me.jellysquid.mods.sodium.client.render.chunk.map.ChunkStatus");
-            return cs.getField("FLAG_ALL").getInt(null);
-        } catch (Throwable t) {
-            return 3;
+        r.addProperty("renderCompat", "present");
+        long[] snap = RenderCompat.trackerSnapshot(level);
+        if (snap != null) {
+            r.addProperty("rc_chunkStatus", snap[0]);
+            r.addProperty("rc_chunkReady", snap[1]);
+            r.addProperty("rc_loadQueue", snap[2]);
+            r.addProperty("rc_unloadQueue", snap[3]);
         }
+        Integer vis = RenderCompat.visibleChunks(level);
+        if (vis != null) r.addProperty("rc_visibleChunks", vis);
+        Boolean done = RenderCompat.terrainComplete(level);
+        if (done != null) r.addProperty("rc_terrainComplete", done);
+        String dbg = RenderCompat.chunksDebugString(level);
+        if (dbg != null) r.addProperty("rc_chunksDebug", dbg);
+        int[] q = RenderCompat.rebuildQueue(level);
+        if (q != null) {
+            JsonObject qo = new JsonObject();
+            qo.addProperty("INITIAL_BUILD", q[0]);
+            qo.addProperty("REBUILD", q[1]);
+            qo.addProperty("IMPORTANT_REBUILD", q[2]);
+            r.add("rc_rebuildQueue", qo);
+        }
+        r.addProperty("rc_deltaChunkReady", SODIUM_DELTA[0]);
+        r.addProperty("rc_deltaLoadQueue", SODIUM_DELTA[1]);
     }
 
     static void levelRendererAllChanged() {
         mc.levelRenderer.allChanged();
     }
 
-    /** tick + 渲染各帧（区块网格重建队列靠 tick 推进） */
-    /** [chunkReady, loadQueue] 的当前大小；未装 Sodium 则 null。 */
-    static long[] sodiumTrackerSnapshot() {
-        var holder = sodiumClass();
-        if (holder == null) return null;
-        try {
-            Class<?> h = holder.getClassLoader()
-                    .loadClass("me.jellysquid.mods.sodium.client.render.chunk.map.ChunkTrackerHolder");
-            Object tracker = h.getMethod("get",
-                    net.minecraft.client.multiplayer.ClientLevel.class).invoke(null, level);
-            if (tracker == null) return new long[]{-1, -1, -1, -1};
-            long[] out = new long[4];
-            String[] names = {"chunkReady", "loadQueue", "unloadQueue", "chunkStatus"};
-            for (int i = 0; i < 4; i++) {
-                var f = tracker.getClass().getDeclaredField(names[i]);
-                f.setAccessible(true);
-                Object v = f.get(tracker);
-                out[i] = ((Number) v.getClass().getMethod("size").invoke(v)).longValue();
-            }
-            return out;
-        } catch (Throwable t) {
-            return null;
-        }
-    }
 
     /** 本次渲染期间 [chunkReady 增量, loadQueue 增量]。 */
     static final long[] SODIUM_DELTA = new long[2];
 
-    /** 诊断：Sodium 接管区块渲染后，它的真实状态（不装 Sodium 则全部 absent）。
-     *
-     * ★ 为什么需要它：Sodium 用 mixin 换掉了 LevelRenderer 的地形渲染，
-     *   而 vanilla 的 `countRenderedChunks()` **在 Sodium 下永远返回 0**
-     *   （它数的是 vanilla 的 section 网格，Sodium 不走那条路）。
-     *   实测症状：`chunks=0` + `hasRenderedAllChunks=true` + 画面无地形
-     *   —— 而 `blockinfo` 表明数据已在区块里。
-     *   ⇒ 光看 vanilla 计数会误判成「没数据」，实为「换了渲染器」。
-     */
-    static void probeSodium(int id, JsonObject r) {
-        r.addProperty("sodiumLoaded", sodiumClass() != null);
-        var swr = sodiumInstance();
-        if (swr == null) { r.addProperty("sodiumState", "absent"); return; }
-        try {
-            Method m = swr.getClass().getMethod("getVisibleChunkCount");
-            r.addProperty("sodiumVisibleChunks", String.valueOf(m.invoke(swr)));
-            Method c = swr.getClass().getMethod("isTerrainRenderComplete");
-            r.addProperty("sodiumTerrainComplete", String.valueOf(c.invoke(swr)));
-            // ★ 直接读 ChunkTracker 的内部集合：这是「区块到底有没有进 tracker」
-            //   的权威证据（visibleChunks=0 可能只是可见性判定为假）。
-            try {
-                Class<?> holder = sodiumClass().getClassLoader()
-                        .loadClass("me.jellysquid.mods.sodium.client.render.chunk.map.ChunkTrackerHolder");
-                Object tracker = holder.getMethod("get",
-                        net.minecraft.client.multiplayer.ClientLevel.class).invoke(null, level);
-                if (tracker != null) {
-                    for (String fl : new String[]{"chunkStatus", "chunkReady", "loadQueue"}) {
-                        var ff = tracker.getClass().getDeclaredField(fl);
-                        ff.setAccessible(true);
-                        Object v = ff.get(tracker);
-                        // 不依赖 instanceof（fastutil 的类型在 remap 后名字会变）⇒ 用反射 size()
-                        int sz = -1;
-                        try { sz = (Integer) v.getClass().getMethod("size").invoke(v); }
-                        catch (Throwable ignore) { }
-                        r.addProperty("sodiumTracker_" + fl, sz);
-                    }
-                    Method mc2 = tracker.getClass().getMethod("getReadyChunks");
-                    Object rc = mc2.invoke(tracker);
-                    try { r.addProperty("sodiumReadyChunks",
-                            String.valueOf(rc.getClass().getMethod("size").invoke(rc))); }
-                    catch (Throwable ignore) { r.addProperty("sodiumReadyChunks", "n/a"); }
-                }
-            } catch (Throwable t) {
-                r.addProperty("sodiumTrackerProbeError", String.valueOf(t));
-            }
-            r.addProperty("sodiumDeltaChunkReady", SODIUM_DELTA[0]);
-            r.addProperty("sodiumDeltaLoadQueue", SODIUM_DELTA[1]);
-            r.addProperty("sodiumUnloadQueue", sodiumTrackerSnapshot() == null ? -1
-                    : sodiumTrackerSnapshot()[2]);
-            r.addProperty("sodiumNeighboursAfter", sodiumTrackerSnapshot() == null ? -1
-                    : sodiumTrackerSnapshot()[3]);
-            Method dbg = swr.getClass().getMethod("getChunksDebugString");
-            Object s = dbg.invoke(swr);
-            r.addProperty("sodiumChunksDebug", s == null ? "null" : s.toString());
-            // 重建队列里还剩多少活？
-            var f = swr.getClass().getDeclaredField("renderSectionManager");
-            f.setAccessible(true);
-            Object rsm = f.get(swr);
-            if (rsm != null) {
-                for (String fl : new String[]{"rebuildLists", "needsUpdate", "lastUpdatedFrame"}) {
-                    try {
-                        var ff = rsm.getClass().getDeclaredField(fl);
-                        ff.setAccessible(true);
-                        Object v = ff.get(rsm);
-                        if (fl.equals("rebuildLists") && v instanceof java.util.Map<?,?> m2) {
-                            JsonObject q = new JsonObject();
-                            for (var en : m2.entrySet()) {
-                                Object de = en.getValue();
-                                int sz = de instanceof java.util.Collection<?> c2 ? c2.size() : -1;
-                                q.addProperty(String.valueOf(en.getKey()), sz);
-                            }
-                            r.add("sodiumRebuildQueue", q);
-                        } else {
-                            r.addProperty("sodium_" + fl, String.valueOf(v));
-                        }
-                    } catch (NoSuchFieldException ignore) { }
-                }
-            }
-        } catch (Throwable t) {
-            r.addProperty("sodiumProbeError", String.valueOf(t));
-        }
-        // 本次渲染期间 setupTerrain 被调了几次（快照法：渲染前后相减）
-    }
-
-    /** SodiumWorldRenderer 的 Class（未装 Sodium 则 null）。 */
-    static Class<?> sodiumClass() {
-        try {
-            return Class.forName("me.jellysquid.mods.sodium.client.render.SodiumWorldRenderer");
-        } catch (Throwable t) {
-            return null;
-        }
-    }
-
-    /** 当前 SodiumWorldRenderer 单例（未装 / 未初始化则 null）。 */
-    static Object sodiumInstance() {
-        var c = sodiumClass();
-        if (c == null) return null;
-        try {
-            return c.getMethod("instance").invoke(null);
-        } catch (Throwable t) {
-            return null;
-        }
-    }
 
     /** 探针：Sodium 的 setupTerrain/processChunkEvents 到底有没有被调（计数）。 */
     static final java.util.concurrent.atomic.AtomicLong SODIUM_SETUP_TERRAIN =
@@ -994,10 +845,10 @@ public class McfoldRenderServer {
 
     static void render(Integer id, int frames, String out) throws Exception {
         // ★ 观测：渲染**前**的 tracker 快照（用来判断 processChunkEvents 有没有被调）
-        long[] before = sodiumTrackerSnapshot();
+        long[] before = RenderCompat.trackerSnapshot(level);
         tickFrames(frames);
-        long[] after = sodiumTrackerSnapshot();
-        if (after != null) {
+        long[] after = RenderCompat.trackerSnapshot(level);
+        if (after != null && before != null) {
             // delta 放进静态字段，供 debug 读取
             SODIUM_DELTA[0] = after[0] - before[0];
             SODIUM_DELTA[1] = after[1] - before[1];