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=...)。
This commit is contained in:
JianFeeeee
2026-09-26 10:17:48 +08:00
parent d4ba586ac7
commit c3a57256ac
4 changed files with 425 additions and 39 deletions

View File

@ -59,6 +59,8 @@ import java.util.Base64;
import java.util.Optional;
import java.util.OptionalInt;
import java.util.UUID;
import java.lang.reflect.Method;
import mcfold.McfoldNames;
/**
* mcfold 渲染服务:常驻进程,NDJSON(行分隔 JSON) 协议,由 Python 侧驱动。
@ -240,6 +242,26 @@ public class McfoldRenderServer {
});
light.setLightEnabled(new ChunkPos(cx, cz), true);
light.runLightUpdates();
// ★★★ 补一步官方广播:ClientLevel.onChunkLoaded(pos)
//
// 背景(2026-09-26 实测):装了 Sodium(或任何靠「区块加载
// 事件」得知区块存在的渲染替换件)时,区块**画不出来**:
// 画面只有天空、chunks=0、它的重建队列恒空,
// 而 blockinfo 能正确读出方块 ⇒ 数据在,只是它不知道。
//
// 根因:Sodium 的 mixin 挂在
// replaceWithPacketData 内部 @At(INVOKE onChunkLoaded, AFTER)
// 而 1.20.1 的 replaceWithPacketData **内部并不调** onChunkLoaded
//(它在 getChunk / drop 里各有一处,是别的路径)⇒ 注入点永不命中。
//
// 为什么这一步是**官方调用**而不是给某个 mod 打补丁:
// onChunkLoaded 是「区块已就绪」的公开广播点
// (染色缓存 + 实体存储启动),
// 我们绕过网络包直接塞数据 ⇒ 补上这一步才与官方路径等价。
// 幂等:官方实现只做广播;Sodium 的 onChunkStatusAdded
// 先读已有 status,相同即 return(实测字节码 :13/:31)
// ⇒ 重复调安全。
announceChunkLoaded(cx, cz);
// ★ 必须触发网格重建 —— 否则渲染器不知道该 section 有数据(实测)
mc.levelRenderer.allChanged();
JsonObject r = new JsonObject();
@ -275,10 +297,12 @@ public class McfoldRenderServer {
var shaper = mc.getBlockRenderer().getBlockModelShaper();
Object missing = null;
try {
var mmF = Minecraft.class.getDeclaredField("modelManager");
var mmF = McfoldNames.field(Minecraft.class,
"net/minecraft/client/Minecraft/modelManager");
mmF.setAccessible(true);
Object mm = mmF.get(mc);
missing = mm.getClass().getMethod("getMissingModel").invoke(mm);
Object mm = mmF.get(mc);
missing = McfoldNames.method(mm.getClass(),
"net/minecraft/client/resources/model/ModelManager/getMissingModel").invoke(mm);
} catch (Throwable t) { }
var lookup = BuiltInRegistries.BLOCK.asLookup();
JsonArray rows = new JsonArray();
@ -294,9 +318,10 @@ public class McfoldRenderServer {
ro.addProperty("isMissing", baked == missing);
ro.addProperty("modelClass", baked.getClass().getSimpleName());
try {
Object icon = baked.getClass().getMethod("getParticleIcon",
Object icon = McfoldNames.method(baked.getClass(),
"net/minecraft/client/resources/model/BakedModel/getParticleIcon",
com.mojang.serialization.Codec.class).invoke(baked,
net.minecraft.client.renderer.texture.TextureAtlasSprite.class == null ? null : null);
(Object) null);
} catch (Throwable ignore) { }
} catch (Throwable t) {
ro.addProperty("error", String.valueOf(t));
@ -462,6 +487,16 @@ public class McfoldRenderServer {
level.getChunkSource().updateViewRadius(rd);
mc.levelRenderer.allChanged();
}
// ── HUD(截图场景下应关掉)──
// ★ 用**官方选项**而非改渲染代码:
// GameRenderer.render 里 `if (!options.hideGui) gui.render(...)`
// (字节码 :559 getfield hideGui / :562 ifeq)
// ⇒ 这就是官方 F1 的同一条路径,改一个 bool 即可。
// 为什么要关:截图只关心画面,HUD 是噪声,而且它会给
// distinctColors 掺一大块固定像素(实测污染判据)。
if (req.has("hideGui")) {
mc.options.hideGui = req.get("hideGui").getAsBoolean();
}
if (req.has("fov")) {
mc.options.fov().set(req.get("fov").getAsInt());
}
@ -508,8 +543,9 @@ public class McfoldRenderServer {
r.addProperty("ok", true);
JsonObject cur = new JsonObject();
try {
java.lang.reflect.Field pf = net.minecraft.client.renderer.GameRenderer.class
.getDeclaredField("postEffect");
java.lang.reflect.Field pf = McfoldNames.field(
net.minecraft.client.renderer.GameRenderer.class,
"net/minecraft/client/renderer/GameRenderer/postEffect");
pf.setAccessible(true);
cur.addProperty("postEffect", pf.get(mc.gameRenderer) != null ? "active" : "none");
} catch (Throwable ignore) {
@ -640,6 +676,7 @@ public class McfoldRenderServer {
}
// viewCenter
r.addProperty("fogStart", String.valueOf(mc.options.renderDistance().get()));
probeSodium(id, r);
emit(id, r);
break;
}
@ -702,11 +739,244 @@ public class McfoldRenderServer {
return r;
}
/**
* 广播「区块已就绪」(等价于网络包路径里会发生的那一步)。
*
* ★ 为什么单独一个方法:两个世代后端都要用,且它是**加载器共存的关键** ——
* 渲染替换件(Sodium 等)靠这个事件发现区块,缺了它们就永远看不见地形。
* 实测症状:画面只有天空 + chunks=0 + 它的重建队列恒空,
* 而 blockinfo 能读出方块(数据在,只是没人通知)。
*/
static void announceChunkLoaded(int cx, int cz) {
// ① 官方广播:对 vanilla 路径无害(只做染色缓存 + 实体存储启动),
// 但让**依赖该事件的 mod** 能正常感知区块。
try {
level.onChunkLoaded(new ChunkPos(cx, cz));
} catch (Throwable t) {
System.err.println("[mcfold] onChunkLoaded(" + cx + "," + cz + ") 失败: " + t);
}
// ② 渲染替换件的 tracker(实测:Sodium 靠这个才知道区块存在)
notifyRenderTracker(cx, cz);
}
/**
* 告诉「渲染替换件」的区块 tracker:这块地已就绪。
*
* ★ 为什么需要它(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 时零影响。
* - 将来别的渲染器若有同名钩子,改这一处即可。
*/
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);
}
}
/** 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;
}
}
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 =
new java.util.concurrent.atomic.AtomicLong();
static final java.util.concurrent.atomic.AtomicLong SODIUM_PROCESS_EVENTS =
new java.util.concurrent.atomic.AtomicLong();
/**
* 探针:Sodium 的 setupTerrain 到底有没有被它的 hook 调到。
*
* ★ 为什么需要它(实测困境):
* Sodium 的 mixin 挂 LevelRenderer.setupRender(private),
* 而 setupRender 只在 renderLevel 内部被调(字节码 :484),
* 我们**确实**调了 renderLevel —— 按理 setupTerrain 该被调到,
* 但 chunkReady 恒 0。
* ⇒ 缺一个「它被调了几次」这个数,否则无法区分:
* (a) hook 没走到 (b) 走到了但参数无效 (c) 走到了但内部失败
*
* 做法:在调用**之前**记录现状(已调次数),渲染后由 debug 报差值。
* 只观测,不驱动 —— 驱动它要构造 Frustum,属于接管渲染循环。
*/
static void tickFrames(int n) {
MainTarget target = (MainTarget) mc.getMainRenderTarget();
for (int f = 0; f < n; f++) {
@ -723,7 +993,15 @@ public class McfoldRenderServer {
}
static void render(Integer id, int frames, String out) throws Exception {
// ★ 观测:渲染**前**的 tracker 快照(用来判断 processChunkEvents 有没有被调)
long[] before = sodiumTrackerSnapshot();
tickFrames(frames);
long[] after = sodiumTrackerSnapshot();
if (after != null) {
// delta 放进静态字段,供 debug 读取
SODIUM_DELTA[0] = after[0] - before[0];
SODIUM_DELTA[1] = after[1] - before[1];
}
MainTarget target = (MainTarget) mc.getMainRenderTarget();
int w = mc.getWindow().getWidth(), h = mc.getWindow().getHeight();
@ -811,8 +1089,9 @@ public class McfoldRenderServer {
var layered = net.minecraft.client.multiplayer.ClientRegistryLayer.createRegistryAccess()
.replaceFrom(net.minecraft.client.multiplayer.ClientRegistryLayer.REMOTE,
new RegistryAccess.Frozen[]{loaded});
var rf = ClientPacketListener.class.getDeclaredField("registryAccess");
rf.setAccessible(true);
var rf = McfoldNames.field(ClientPacketListener.class,
"net/minecraft/client/multiplayer/ClientPacketListener/registryAccess");
rf.setAccessible(true);
rf.set(listener, layered);
Holder<DimensionType> dimHolder = loaded.registryOrThrow(Registries.DIMENSION_TYPE)
@ -961,13 +1240,14 @@ public class McfoldRenderServer {
try {
for (Class<?> c = blockReg.getClass(); c != null; c = c.getSuperclass()) {
try {
var f = c.getDeclaredField("frozen");
var f = McfoldNames.field(c, "net/minecraft/core/MappedRegistry/frozen");
f.setAccessible(true);
f.setBoolean(blockReg, false);
} catch (NoSuchFieldException ignore) { }
try {
var f = c.getDeclaredField("unregisteredIntrusiveHolders");
f.setAccessible(true);
try {
var f = McfoldNames.field(c,
"net/minecraft/core/MappedRegistry/unregisteredIntrusiveHolders");
f.setAccessible(true);
if (f.get(blockReg) == null) f.set(blockReg, new java.util.IdentityHashMap<>());
} catch (NoSuchFieldException ignore) { }
}
@ -1070,11 +1350,13 @@ public class McfoldRenderServer {
// 再手工驱动 listener(不能 join Minecraft.reloadResourcePacks,会死锁)
java.util.List<net.minecraft.server.packs.PackResources> packs = new java.util.ArrayList<>();
for (var pk : repo.getSelectedPacks()) packs.add(pk.open());
var rmF = Minecraft.class.getDeclaredField("resourceManager");
var rmF = McfoldNames.field(Minecraft.class,
"net/minecraft/client/Minecraft/resourceManager");
rmF.setAccessible(true);
var rm = (net.minecraft.server.packs.resources.ReloadableResourceManager) rmF.get(mc);
var resF = net.minecraft.server.packs.resources.ReloadableResourceManager.class
.getDeclaredField("resources");
var resF = McfoldNames.field(
net.minecraft.server.packs.resources.ReloadableResourceManager.class,
"net/minecraft/server/packs/resources/ReloadableResourceManager/resources");
resF.setAccessible(true);
resF.set(rm, new net.minecraft.server.packs.resources.MultiPackResourceManager(
net.minecraft.server.packs.PackType.CLIENT_RESOURCES, packs));
@ -1127,7 +1409,8 @@ public class McfoldRenderServer {
/** 同步驱动各 reload listener(不能 join Minecraft 的 reloadResourcePacks:等主循环 → 死锁)*/
static void reloadResources(Minecraft mc) throws Exception {
var rmF = Minecraft.class.getDeclaredField("resourceManager");
var rmF = McfoldNames.field(Minecraft.class,
"net/minecraft/client/Minecraft/resourceManager");
rmF.setAccessible(true);
var rm = (net.minecraft.server.packs.resources.ReloadableResourceManager) rmF.get(mc);
mc.getResourcePackRepository().reload();

View File

@ -2,6 +2,7 @@ package net.minecraft.client.renderer;
import net.minecraft.resources.ResourceLocation;
import net.minecraft.server.packs.resources.ResourceProvider;
import mcfold.McfoldNames;
/**
* 包私有成员桥。
@ -10,14 +11,42 @@ import net.minecraft.server.packs.resources.ResourceProvider;
* 我们不跑主循环、不连服,所以要用同包类直接调。
* reloadShaders —— 官方由匿名内部类 GameRenderer$1(资源重载 listener)调
* loadEffect —— 官方由 onResourceManagerReload / 药水效果改
*
* ★★ 为什么这里必须用反射,而不是同包直调(2026-09-26 实测)
*
* 「把桥塞进 `net.minecraft.client.renderer` 包」这个技巧只在 **named** 命名空间下成立:
*
* named 桥在 net.minecraft.client.renderer
* GameRenderer 也在 net.minecraft.client.renderer ⇒ 同包 ✅
* intermediary 桥仍在 net.minecraft.client.renderer(我们自己的类不被改名)
* GameRenderer → **net.minecraft.class_757**(包变成 net.minecraft)
* ⇒ 异包 ❌
* ⇒ `IllegalAccessError: McfoldBridge tried to access method
* 'void net.minecraft.class_757.method_34538(...)'`
*
* ⇒ **包名本身也被 remap**,所以「靠包名对齐」的做法切换命名空间就断了。
* 反射 + 语义名(见 McfoldNames)与命名空间无关,是唯一两态都通的形态。
*/
public class McfoldBridge {
public static void reloadShaders(GameRenderer gr, ResourceProvider provider) {
gr.reloadShaders(provider);
try {
McfoldNames.method(GameRenderer.class,
"net/minecraft/client/renderer/GameRenderer/reloadShaders",
ResourceProvider.class).invoke(gr, provider);
} catch (Exception e) {
throw new RuntimeException("reloadShaders 调用失败", e);
}
}
/** 载入一个原版后处理链(如 minecraft:shaders/post/invert.json)。 */
public static void loadEffect(GameRenderer gr, ResourceLocation id) {
gr.loadEffect(id);
try {
McfoldNames.method(GameRenderer.class,
"net/minecraft/client/renderer/GameRenderer/loadEffect",
ResourceLocation.class).invoke(gr, id);
} catch (Exception e) {
throw new RuntimeException("loadEffect 调用失败", e);
}
}
}

View File

@ -59,6 +59,7 @@ import java.util.Base64;
import java.util.Optional;
import java.util.OptionalInt;
import java.util.UUID;
import mcfold.McfoldNames;
/**
* mcfold 渲染服务:常驻进程,NDJSON(行分隔 JSON) 协议,由 Python 侧驱动。
@ -240,6 +241,12 @@ public class McfoldRenderServer {
});
light.setLightEnabled(new ChunkPos(cx, cz), true);
light.runLightUpdates();
// ★★★ 补一步官方广播(见 gen_1_20 同处的完整说明):
// 渲染替换件(Sodium 等)靠「区块加载事件」得知区块存在;
// 我们绕过网络包直接塞数据 ⇒ 缺这一步它们永远看不见地形
// (实测:画面只有天空、chunks=0、它的重建队列恒空,
// 而 blockinfo 能读出方块 ⇒ 数据在,只是没人通知)
announceChunkLoaded(cx, cz);
// ★ 必须触发网格重建 —— 否则渲染器不知道该 section 有数据(实测)
mc.levelRenderer.allChanged();
JsonObject r = new JsonObject();
@ -275,10 +282,12 @@ public class McfoldRenderServer {
var shaper = mc.getBlockRenderer().getBlockModelShaper();
Object missing = null;
try {
var mmF = Minecraft.class.getDeclaredField("modelManager");
var mmF = McfoldNames.field(Minecraft.class,
"net/minecraft/client/Minecraft/modelManager");
mmF.setAccessible(true);
Object mm = mmF.get(mc);
missing = mm.getClass().getMethod("getMissingModel").invoke(mm);
Object mm = mmF.get(mc);
missing = McfoldNames.method(mm.getClass(),
"net/minecraft/client/resources/model/ModelManager/getMissingModel").invoke(mm);
} catch (Throwable t) { }
var lookup = BuiltInRegistries.BLOCK.asLookup();
JsonArray rows = new JsonArray();
@ -294,9 +303,10 @@ public class McfoldRenderServer {
ro.addProperty("isMissing", baked == missing);
ro.addProperty("modelClass", baked.getClass().getSimpleName());
try {
Object icon = baked.getClass().getMethod("getParticleIcon",
Object icon = McfoldNames.method(baked.getClass(),
"net/minecraft/client/resources/model/BakedModel/getParticleIcon",
com.mojang.serialization.Codec.class).invoke(baked,
net.minecraft.client.renderer.texture.TextureAtlasSprite.class == null ? null : null);
(Object) null);
} catch (Throwable ignore) { }
} catch (Throwable t) {
ro.addProperty("error", String.valueOf(t));
@ -463,6 +473,15 @@ public class McfoldRenderServer {
level.getChunkSource().updateViewRadius(rd);
mc.levelRenderer.allChanged();
}
// ── HUD(截图场景下应关掉)──
// ★ 用**官方选项**而非改渲染代码:
// GameRenderer.render 里 `if (!options.hideGui) gui.render(...)`
// ⇒ 这就是官方 F1 的同一条路径,改一个 bool 即可。
// 为什么要关:截图只关心画面,HUD 是噪声,而且它会给
// distinctColors 掺一大块固定像素(实测污染判据)。
if (req.has("hideGui")) {
mc.options.hideGui = req.get("hideGui").getAsBoolean();
}
if (req.has("fov")) {
mc.options.fov().set(req.get("fov").getAsInt());
}
@ -509,8 +528,9 @@ public class McfoldRenderServer {
r.addProperty("ok", true);
JsonObject cur = new JsonObject();
try {
java.lang.reflect.Field pf = net.minecraft.client.renderer.GameRenderer.class
.getDeclaredField("postEffect");
java.lang.reflect.Field pf = McfoldNames.field(
net.minecraft.client.renderer.GameRenderer.class,
"net/minecraft/client/renderer/GameRenderer/postEffect");
pf.setAccessible(true);
cur.addProperty("postEffect", pf.get(mc.gameRenderer) != null ? "active" : "none");
} catch (Throwable ignore) {
@ -709,6 +729,49 @@ public class McfoldRenderServer {
return r;
}
/**
* 广播「区块已就绪」(等价于网络包路径里会发生的那一步)。
*
* ★ 加载器共存的关键:渲染替换件(Sodium 等)靠这个事件发现区块,
* 缺了它们就永远看不见地形(画面只有天空、chunks=0、它的队列恒空,
* 而 blockinfo 能读出方块 —— 数据在,只是没人通知)。
*/
static void announceChunkLoaded(int cx, int cz) {
// ① 官方广播(对 vanilla 路径无害)
try {
level.onChunkLoaded(new ChunkPos(cx, cz));
} 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);
}
}
static void levelRendererAllChanged() {
mc.levelRenderer.allChanged();
}
@ -1006,12 +1069,13 @@ public class McfoldRenderServer {
try {
for (Class<?> c = blockReg.getClass(); c != null; c = c.getSuperclass()) {
try {
var f = c.getDeclaredField("frozen");
var f = McfoldNames.field(c, "net/minecraft/core/MappedRegistry/frozen");
f.setAccessible(true);
f.setBoolean(blockReg, false);
} catch (NoSuchFieldException ignore) { }
try {
var f = c.getDeclaredField("unregisteredIntrusiveHolders");
try {
var f = McfoldNames.field(c,
"net/minecraft/core/MappedRegistry/unregisteredIntrusiveHolders");
f.setAccessible(true);
if (f.get(blockReg) == null) f.set(blockReg, new java.util.IdentityHashMap<>());
} catch (NoSuchFieldException ignore) { }
@ -1117,11 +1181,13 @@ public class McfoldRenderServer {
// 再手工驱动 listener(不能 join Minecraft.reloadResourcePacks,会死锁)
java.util.List<net.minecraft.server.packs.PackResources> packs = new java.util.ArrayList<>();
for (var pk : repo.getSelectedPacks()) packs.add(pk.open());
var rmF = Minecraft.class.getDeclaredField("resourceManager");
var rmF = McfoldNames.field(Minecraft.class,
"net/minecraft/client/Minecraft/resourceManager");
rmF.setAccessible(true);
var rm = (net.minecraft.server.packs.resources.ReloadableResourceManager) rmF.get(mc);
var resF = net.minecraft.server.packs.resources.ReloadableResourceManager.class
.getDeclaredField("resources");
var resF = McfoldNames.field(
net.minecraft.server.packs.resources.ReloadableResourceManager.class,
"net/minecraft/server/packs/resources/ReloadableResourceManager/resources");
resF.setAccessible(true);
resF.set(rm, new net.minecraft.server.packs.resources.MultiPackResourceManager(
net.minecraft.server.packs.PackType.CLIENT_RESOURCES, packs));
@ -1176,7 +1242,8 @@ public class McfoldRenderServer {
/** 同步驱动各 reload listener(不能 join Minecraft 的 reloadResourcePacks:等主循环 → 死锁)*/
static void reloadResources(Minecraft mc) throws Exception {
var rmF = Minecraft.class.getDeclaredField("resourceManager");
var rmF = McfoldNames.field(Minecraft.class,
"net/minecraft/client/Minecraft/resourceManager");
rmF.setAccessible(true);
var rm = (net.minecraft.server.packs.resources.ReloadableResourceManager) rmF.get(mc);
mc.getResourcePackRepository().reload();

View File

@ -2,6 +2,7 @@ package net.minecraft.client.renderer;
import net.minecraft.resources.ResourceLocation;
import net.minecraft.server.packs.resources.ResourceProvider;
import mcfold.McfoldNames;
/**
* 包私有成员桥。
@ -24,8 +25,8 @@ public class McfoldBridge {
*/
public static void markGameLoadFinished(net.minecraft.client.Minecraft mc) {
try {
java.lang.reflect.Field f = net.minecraft.client.Minecraft.class
.getDeclaredField("gameLoadFinished");
java.lang.reflect.Field f = McfoldNames.field(net.minecraft.client.Minecraft.class,
"net/minecraft/client/Minecraft/gameLoadFinished");
f.setAccessible(true);
f.setBoolean(mc, true);
} catch (Throwable t) {
@ -33,7 +34,13 @@ public class McfoldBridge {
}
}
public static void reloadShaders(GameRenderer gr, ResourceProvider provider) {
gr.reloadShaders(provider);
try {
McfoldNames.method(GameRenderer.class,
"net/minecraft/client/renderer/GameRenderer/reloadShaders",
ResourceProvider.class).invoke(gr, provider);
} catch (Exception e) {
throw new RuntimeException("reloadShaders 调用失败", e);
}
}
/**
@ -47,9 +54,9 @@ public class McfoldBridge {
*/
public static void loadEffect(GameRenderer gr, ResourceLocation id) {
try {
java.lang.reflect.Method m = GameRenderer.class.getDeclaredMethod("loadEffect", ResourceLocation.class);
m.setAccessible(true);
m.invoke(gr, id);
McfoldNames.method(GameRenderer.class,
"net/minecraft/client/renderer/GameRenderer/loadEffect",
ResourceLocation.class).invoke(gr, id);
} catch (Exception e) {
throw new RuntimeException("loadEffect 不可用(1.21+ 为 private)", e);
}