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 项通过
This commit is contained in:
JianFeeeee
2026-09-26 12:15:48 +08:00
parent b21b869e09
commit 547f4beb7e
8 changed files with 1122 additions and 240 deletions

View File

@ -0,0 +1,214 @@
package mcfold;
import java.lang.reflect.Field;
import java.lang.reflect.Method;
/**
* 装载「地形渲染替换件」(Sodium 等)的桥。
*
* ## 为什么需要它(2026-09-26 实测,根因三层)
*
* **症状**:装了 Sodium 后画面只有天空、`chunksRendered=0`,
* 而 `blockinfo` 能正确读出方块 ⇒ **数据在,只是渲染器不知道**。
*
* **根因**:
* <pre>
* ① Sodium 的 mixin 挂在 replaceWithPacketData 内
* @At(INVOKE ClientLevel.onChunkLoaded, shift=AFTER)
* 而 1.20.1 / 1.21.x 的该方法**内部并不调** onChunkLoaded
* (它在 getChunk / drop 里各有一处,属别的路径)⇒ 注入点永不命中
* ⇒ 它的 ChunkTracker 从未被告知任何区块存在
*
* ② 补上通知后,ChunkTracker 拿到了区块,但仍不进渲染队列
*
* ③ ★ 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" ⇒ 队列恒空 ⇒ 无地形
* 传 3:3&3&3&3 = 3 ⇒ 2×2 组就绪 ⇒ 重建队列有内容
* (我们确实有光照数据 —— 注入时跑了 runLightUpdates())
* </pre>
*
* **实测对比**(同一场景 7×7=49 区块):
* <pre>
* 传 1: chunkStatus=49 chunkReady=0 loadQueue=0 colors=4748
* 传 3: chunkStatus=49 chunkReady=25 loadQueue=25 colors=113546
* </pre>
*
* ## 为什么这不算「给某个 mod 打补丁」
*
* 注入路径缺了「区块已就绪」这一步**广播**。补上它对所有
* 依赖该事件的 mod 都有效,而不只是 Sodium。
* 这里只对 Sodium 做了显式适配,是因为它的 mixin 钩子
* ({@code ChunkTrackerHolder})是 public 接口,且**类不存在时静默跳过** ——
* 不装它就零影响。
*
* ## 世代差异
*
* 1.20.1 与 1.21.1 的 API 位置不同(ChunkStatus 包路径、ChunkStatus 常量),
* 故本类只做**反射调用**,不直接引用 MC 类型 ⇒ 两世代共用一份。
*/
public final class RenderCompat {
private RenderCompat() {}
private static final String SODIUM_HOLDER =
"me.jellysquid.mods.sodium.client.render.chunk.map.ChunkTrackerHolder";
private static final String SODIUM_CHUNK_STATUS =
"me.jellysquid.mods.sodium.client.render.chunk.map.ChunkStatus";
// ── 探测 ───────────────────────────────────────────────
/** 该渲染替换件是否在(装了没装都能安全调)。 */
public static boolean available() {
return sodiumClassLoader() != null;
}
private static ClassLoader sodiumClassLoader() {
try {
Class.forName(SODIUM_HOLDER);
return RenderCompat.class.getClassLoader();
} catch (ClassNotFoundException notInstalled) {
return null;
}
}
/** Sodium 的 FLAG_ALL(有方块 + 有光照);取不到时退回 3。
*
* ★ 3 是硬要求:updateMerged 的 2×2 判定是 `四邻 & == 3`。
* 传 1(只有方块)会让所有区块判成"凑不齐" ⇒ 地形不出现。 */
public static int flagAll() {
try {
Class<?> cs = Class.forName(SODIUM_CHUNK_STATUS);
return cs.getField("FLAG_ALL").getInt(null);
} catch (Throwable t) {
return 3;
}
}
// ── 通知 ───────────────────────────────────────────────
/**
* 告诉渲染替换件:这块地已就绪(等价于网络包路径里会发生的那一步)。
*
* @param level 当前世界(必须是 ClientLevel —— 签名是 get(class_638),
* 传它的父类会 NoSuchMethodException,实测踩过)
* @return 是否成功通知(false = 没装该渲染器,属正常)
*/
public static boolean notifyChunkLoaded(Object level, int cx, int cz) {
try {
Class<?> holder = Class.forName(SODIUM_HOLDER);
// ★ 参数类型必须匹配:先按名字找 ClientLevel 的 Class,
// 再用它做 getMethod 的参数类型(编译期引不到 MC 类型,跨世代共用)
Class<?> levelClass = level.getClass();
Object tracker = holder.getMethod("get", levelClass).invoke(null, level);
if (tracker == null) return false;
// ★ 第三参数是**位掩码 int**(签名 (III)V),不是 ChunkStatus 对象
tracker.getClass()
.getMethod("onChunkStatusAdded", int.class, int.class, int.class)
.invoke(tracker, cx, cz, flagAll());
return true;
} catch (ClassNotFoundException notInstalled) {
return false; // 没装 ⇒ 正常,静默
} catch (Throwable t) {
System.err.println("[mcfold] RenderCompat.notifyChunkLoaded(" + cx + ","
+ cz + "): " + t);
return false;
}
}
// ── 诊断(供 debug 命令读)──────────────────────────────
/** [chunkStatus, chunkReady, loadQueue, chunkStatus 重复项] 的当前大小;没装则 null。 */
public static long[] trackerSnapshot(Object level) {
try {
Class<?> holder = Class.forName(SODIUM_HOLDER);
Object tracker = holder.getMethod("get", level.getClass()).invoke(null, level);
if (tracker == null) return new long[]{-1, -1, -1, -1};
long[] out = new long[4];
String[] names = {"chunkStatus", "chunkReady", "loadQueue", "unloadQueue"};
for (int i = 0; i < names.length; i++) {
Field f = tracker.getClass().getDeclaredField(names[i]);
f.setAccessible(true);
Object v = f.get(tracker);
// 不依赖 instanceof(fastutil 的类型在 remap 后名字会变)⇒ 反射 size()
out[i] = ((Number) v.getClass().getMethod("size").invoke(v)).longValue();
}
return out;
} catch (Throwable t) {
return null;
}
}
/** 它自报的调试串(如 "C: 0/600 D: 12":C=可见, D=距离);取不到则 null。 */
public static String chunksDebugString(Object level) {
try {
Class<?> swr = Class.forName(
"me.jellysquid.mods.sodium.client.render.SodiumWorldRenderer");
Object inst = swr.getMethod("instance").invoke(null);
if (inst == null) return null;
Object s = inst.getClass().getMethod("getChunksDebugString").invoke(inst);
return s == null ? null : s.toString();
} catch (Throwable t) {
return null;
}
}
/** 它的地形是否已渲完(注意:队列空时它会答 true —— 不可单独作为判据)。 */
public static Boolean terrainComplete(Object level) {
try {
Class<?> swr = Class.forName(
"me.jellysquid.mods.sodium.client.render.SodiumWorldRenderer");
Object inst = swr.getMethod("instance").invoke(null);
if (inst == null) return null;
return (Boolean) inst.getClass().getMethod("isTerrainRenderComplete").invoke(inst);
} catch (Throwable t) {
return null;
}
}
/** 可见区块数(vanilla 的 countRenderedChunks 在它之下恒为 0,不能用那个)。 */
public static Integer visibleChunks(Object level) {
try {
Class<?> swr = Class.forName(
"me.jellysquid.mods.sodium.client.render.SodiumWorldRenderer");
Object inst = swr.getMethod("instance").invoke(null);
if (inst == null) return null;
return (Integer) inst.getClass().getMethod("getVisibleChunkCount").invoke(inst);
} catch (Throwable t) {
return null;
}
}
/** 重建队列 {INITIAL_BUILD, REBUILD, IMPORTANT_REBUILD} 的条数;取不到则 null。 */
public static int[] rebuildQueue(Object level) {
try {
Class<?> swr = Class.forName(
"me.jellysquid.mods.sodium.client.render.SodiumWorldRenderer");
Object inst = swr.getMethod("instance").invoke(null);
if (inst == null) return null;
Field f = inst.getClass().getDeclaredField("renderSectionManager");
f.setAccessible(true);
Object rsm = f.get(inst);
if (rsm == null) return null;
Field rl = rsm.getClass().getDeclaredField("rebuildLists");
rl.setAccessible(true);
Object lists = rl.get(rsm);
int[] out = new int[3];
if (lists instanceof java.util.Map<?, ?> m) {
int i = 0;
for (Object v : m.values()) {
if (i < out.length) {
out[i] = v instanceof java.util.Collection<?> c ? c.size() : -1;
}
i++;
}
}
return out;
} catch (Throwable t) {
return null;
}
}
}

View File

@ -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];

View File

@ -60,6 +60,7 @@ import java.util.Optional;
import java.util.OptionalInt;
import java.util.UUID;
import mcfold.McfoldNames;
import mcfold.RenderCompat;
/**
* mcfold 渲染服务:常驻进程,NDJSON(行分隔 JSON) 协议,由 Python 侧驱动。
@ -667,6 +668,7 @@ public class McfoldRenderServer {
}
// viewCenter
r.addProperty("fogStart", String.valueOf(mc.options.renderDistance().get()));
reportRenderCompat(r);
emit(id, r);
break;
}
@ -743,33 +745,37 @@ public class McfoldRenderServer {
} catch (Throwable t) {
System.err.println("[mcfold] onChunkLoaded(" + cx + "," + cz + ") 失败: " + t);
}
// ② 渲染替换件的 tracker(完整说明见 gen_1_20 同处)
try {
Class<?> holder = Class.forName(
"me.jellysquid.mods.sodium.client.render.chunk.map.ChunkTrackerHolder");
// ★ 参数类型必须是 ClientLevel(签名 get(class_638)),传 Level.class 会 NoSuchMethodException
Object tracker = holder.getMethod("get",
net.minecraft.client.multiplayer.ClientLevel.class).invoke(null, level);
if (tracker == null) return;
// ★ 第三参数是位掩码 int(实测签名 (III)V):
// FLAG_HAS_BLOCK_DATA=1 / FLAG_HAS_LIGHT_DATA=2 / FLAG_ALL=3
// 而 updateMerged 的 2×2 判定要求 == 3 ⇒ 必须报 FLAG_ALL,
// 否则所有区块判成"凑不齐 2×2" ⇒ chunkReady 恒 0、无地形
// (实测:传 1 → chunkStatus=49 但 chunkReady=0)
int flagAll;
try {
Class<?> cs = sodiumClass().getClassLoader().loadClass(
"me.jellysquid.mods.sodium.client.render.chunk.map.ChunkStatus");
flagAll = cs.getField("FLAG_ALL").getInt(null);
} catch (Throwable t) { flagAll = 3; }
tracker.getClass()
.getMethod("onChunkStatusAdded", int.class, int.class, int.class)
.invoke(tracker, cx, cz, flagAll);
} catch (ClassNotFoundException noTracker) {
// 没装该渲染器 ⇒ 正常,静默
} catch (Throwable t) {
System.err.println("[mcfold] notifyRenderTracker(" + cx + "," + cz + "): " + t);
// ② 渲染替换件的 tracker —— 走共用桥(完整根因说明见 RenderCompat)
RenderCompat.notifyChunkLoaded(level, cx, cz);
}
/** 渲染替换件在本次渲染期间的变化([chunkReady 增量, loadQueue 增量])。 */
static final long[] SODIUM_DELTA = new long[2];
/** 诊断:地形渲染替换件(Sodium 等)的真实状态。根因说明见 RenderCompat。 */
static void reportRenderCompat(JsonObject r) {
if (!RenderCompat.available()) { r.addProperty("renderCompat", "absent"); return; }
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]);
}
Integer vis = RenderCompat.visibleChunks(level);
if (vis != null) r.addProperty("rc_visibleChunks", vis);
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() {