|
|
547f4beb7e
|
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 项通过
|
2026-09-26 12:15:48 +08:00 |
|
|
|
d4ba586ac7
|
反射名的 extern 机制（B 方案）：19 处字符串反射 → 0
## 问题
Java 后端要访问 MC 的**私有字段/方法**（Minecraft.resourceManager 等），
只能走反射。而反射参数是**字符串**：
Minecraft.class.getDeclaredField("resourceManager")
remap 工具只改常量池里的**符号引用**，**改不了字符串字面量** ⇒
把产物从 named remap 到 intermediary 时，`Xxx.class` 都对了，
`"resourceManager"` 原样留着 ⇒ 运行期 NoSuchFieldException（实测撞到过）。
## 做法：语义名 → 物理名，表由 extern 参数传入
源码写**语义路径**（跨命名空间稳定）：
McfoldNames.field(Minecraft.class, "net/minecraft/client/Minecraft/resourceManager")
- named 模式（无表）：退化为取末段 ⇒ "resourceManager" ✅
- intermediary 模式：表里查 ⇒ "field_1745" ✅
⇒ **同一份 class 在两种命名空间下都能跑**，切换不必重编。
这是「mod 要 intermediary」与「我们的产物本来是 named」能共存的**前提**。
## 表的来源（scaffold/gen_names.py）
扫源码里的语义引用 → 经两份映射复合解析：
named ──(mappings.srg 反查)──> official ──(intermediary tiny)──> intermediary
运行时按此序找表：
1. -Dmcfold.names=<path> ★ 显式 extern 参数（调用方只传路径）
2. <class 同级>/names.json
3. 都无 ⇒ named 模式
★ 调用方（Python）**不需要知道任何 MC 名字**，只传一个路径 ——
命名空间知识全部留在 jar 与构建产物里。这就是「接口统一、非通用数据走 extern」。
## 实测踩坑（都在 gen_names.py 里记了原因）
① 查表必须**带描述符**：同一个 obf 名（如 fjq/b）有十几个重载，
只按 (kind, owner, name) 会取到第一个重载 ——
症状：reloadShaders(Lala;)V 被解成 method_3207()V（无参），运行期 NoSuchMethodException。
② 字段要单建一张 (owner,name) 表：tiny 的 FIELD 行带字段类型描述符，
而 srg 的 FD 行没有 ⇒ 拿 None 去查永远不命中（7 个字段全漏）。
③ **不能靠首字母大小猜字段/方法**，必须在 srg 里实查 kind。
④ MC 里存在**同名字段与方法**（如 ClientPacketListener.registryAccess
既有 FD fex/B 又有 MD fex/r）⇒ 用 McfoldNames.field/method 的**调用形式**
判定 kind，与运行期用法一致。
## 验证
- 名字表 11/11 解析成功（gen_1_20）
- 两世代后端字符串反射归零（gen_1_20 10 处、gen_1_21 9 处）
- 加载器路线端到端跑通（见后续提交）
|
2026-09-26 10:17:29 +08:00 |
|
