agentmc

jianf/agentmc

Fork 0

Commit Graph

Author	SHA1	Message	Date
JianFeeeee	d0fb5517a0	修复 gen_1_21 渲染：1.21 的 gameLoadFinished 门禁（第 13 处世代差异）症状：gen_1_21 启动成功、数据注入成功（loadedChunks=49），但 chunksRendered=0、画面停在 Mojang 加载屏（distinctColors≈199）。根因（1.21 GameRenderer.render 内部，编译期看不出）： boolean ok = minecraft.isGameLoadFinished(); if (ok && renderLevel && level != null) renderLevel(...); 该标志只在 reloadResourcePacks 回调（onResourceLoadFinished）里置 true。我们不跑异步 reload（会死锁）⇒ 恒 false ⇒ 世界永不渲染。 1.20.x 无此门禁 ⇒ gen_1_20 从未受影响。修法：gen_1_21 的 McfoldBridge 加 markGameLoadFinished（反射置位），在 boot 里 shader 编译后调用 —— 差异留在 Java 侧。 ★ 教训：这类差异不崩不报错，只是画面不对 ⇒ 判据必须用 chunksRendered/distinctColors，不能只看进程活着。顺带修：tick 异常不再静默吞掉（try{tick()}catch(ignore){} → 打印第一帧异常）新增诊断字段：screenNow/overlayNow/levelNow/playerNow/noRender 实测：gen_1_21 现在 chunksRendered=25、has_world_content=True （草地/天空/太阳/HUD 正常）	2026-09-25 19:45:24 +08:00
JianFeeeee	253146cffe	gen_1_21 实测启动成功 + provision 工具决定性验证：gen_1_21 后端在 1.21.1 上收到 {"event":"ready"} ⇒ 世代分派架构成立：同一套 Python 层，两个独立编译的 Java 后端运行时发现第 12 处世代差异（编译期看不出）： 1.20.x registryAccess 是可变 LayeredRegistryAccess → 事后反射替换 1.21.x registryAccess 是 final RegistryAccess$Frozen → 反射抛 "Can not set final field" 处理：gen_1_21 改为先载注册表 → 经 CommonListenerCookie.receivedRegistries 传入 → 再构造 listener。比 1.20 的反射做法更干净。新增 mcfold/provision.py（从官方 manifest 装任意版本，版本无关）： - 跳过音频资源：1.21.1 实测 3911 条里跳过 3744 条 - natives 两种形态都认（1.21 起是独立库条目，非 classifiers） - 实测 1.21.1：274 文件 / 200MB / 32s / 0 失败	2026-09-25 18:35:28 +08:00
JianFeeeee	8c7d5b9d38	世代分派体系：Python 层 switch + 各世代独立编译的 Java 后端用户定向：在 python 层写 switch，调用不同 java 后端（而非一个文件里 switch）。新增： mcfold/backends/{__init__,base,gen_1_20,gen_1_21}.py 后端体系与分派 scaffold/java/gen_1_20/ 对 1.20.x client jar 编译 scaffold/java/gen_1_21/ 对 1.21.1 client jar 编译（✅ 实测编译通过） scaffold/java/VERSION-DIFFS.md 实测差异全表判据：DeltaTracker 类是否存在（1.21 引入，正是 render 签名变化的根源） ⇒ 比硬编码版本号稳实测差异共 11 处（21 个检查点里 13 个跨世代完全一致）： setLevel / GameRenderer.render / countRendered* / createPackRepository / ResourceLocation 构造 / enableDataFixerOptimizations(移除) / User 构造 / ChunkStatus 包路径 / ClientPacketListener 构造(参数个数语义都变) / loadEffect(变 private) 为什么必须分后端：DeltaTracker 在 1.20.x jar 中不存在，两代调用无法共存于一份源码（实测编译报 cannot find symbol）。 1.21.1 反混淆已验证（29MB named jar，DeltaTracker 3 处）	2026-09-25 18:21:08 +08:00

Author

SHA1

Message

Date

JianFeeeee

d0fb5517a0

修复 gen_1_21 渲染：1.21 的 gameLoadFinished 门禁（第 13 处世代差异）

症状：gen_1_21 启动成功、数据注入成功（loadedChunks=49），
      但 chunksRendered=0、画面停在 Mojang 加载屏（distinctColors≈199）。

根因（1.21 GameRenderer.render 内部，编译期看不出）：
    boolean ok = minecraft.isGameLoadFinished();
    if (ok && renderLevel && level != null) renderLevel(...);
  该标志只在 reloadResourcePacks 回调（onResourceLoadFinished）里置 true。
  我们不跑异步 reload（会死锁）⇒ 恒 false ⇒ 世界永不渲染。
  1.20.x 无此门禁 ⇒ gen_1_20 从未受影响。

修法：gen_1_21 的 McfoldBridge 加 markGameLoadFinished（反射置位），
      在 boot 里 shader 编译后调用 —— 差异留在 Java 侧。

★ 教训：这类差异不崩不报错，只是画面不对 ⇒ 判据必须用
  chunksRendered/distinctColors，不能只看进程活着。

顺带修：tick 异常不再静默吞掉（try{tick()}catch(ignore){} → 打印第一帧异常）
新增诊断字段：screenNow/overlayNow/levelNow/playerNow/noRender

实测：gen_1_21 现在 chunksRendered=25、has_world_content=True
      （草地/天空/太阳/HUD 正常）

2026-09-25 19:45:24 +08:00

JianFeeeee

253146cffe

gen_1_21 实测启动成功 + provision 工具

决定性验证：gen_1_21 后端在 1.21.1 上收到 {"event":"ready"}
  ⇒ 世代分派架构成立：同一套 Python 层，两个独立编译的 Java 后端

运行时发现第 12 处世代差异（编译期看不出）：
  1.20.x  registryAccess 是可变 LayeredRegistryAccess → 事后反射替换
  1.21.x  registryAccess 是 final RegistryAccess$Frozen → 反射抛
          "Can not set final field"
  处理：gen_1_21 改为先载注册表 → 经 CommonListenerCookie.receivedRegistries
        传入 → 再构造 listener。比 1.20 的反射做法更干净。

新增 mcfold/provision.py（从官方 manifest 装任意版本，版本无关）：
  - 跳过音频资源：1.21.1 实测 3911 条里跳过 3744 条
  - natives 两种形态都认（1.21 起是独立库条目，非 classifiers）
  - 实测 1.21.1：274 文件 / 200MB / 32s / 0 失败

2026-09-25 18:35:28 +08:00

JianFeeeee

8c7d5b9d38

世代分派体系：Python 层 switch + 各世代独立编译的 Java 后端

用户定向：在 python 层写 switch，调用不同 java 后端（而非一个文件里 switch）。

新增：
  mcfold/backends/{__init__,base,gen_1_20,gen_1_21}.py  后端体系与分派
  scaffold/java/gen_1_20/  对 1.20.x client jar 编译
  scaffold/java/gen_1_21/  对 1.21.1 client jar 编译（✅ 实测编译通过）
  scaffold/java/VERSION-DIFFS.md  实测差异全表

判据：DeltaTracker 类是否存在（1.21 引入，正是 render 签名变化的根源）
  ⇒ 比硬编码版本号稳

实测差异共 11 处（21 个检查点里 13 个跨世代完全一致）：
  setLevel / GameRenderer.render / countRendered* / createPackRepository /
  ResourceLocation 构造 / enableDataFixerOptimizations(移除) / User 构造 /
  ChunkStatus 包路径 / ClientPacketListener 构造(参数个数语义都变) /
  loadEffect(变 private)

为什么必须分后端：DeltaTracker 在 1.20.x jar 中不存在，
两代调用无法共存于一份源码（实测编译报 cannot find symbol）。

1.21.1 反混淆已验证（29MB named jar，DeltaTracker 3 处）

2026-09-25 18:21:08 +08:00

3 Commits