EndCraft 4.2.0

EndCraft 4.2.0

适配终末地 1.6.3，更新宿主模块至 endcraft.gameplay38。本版重点修正 NeoForge 的界面颜色、TaCZ 配件预览和菜单点击穿透，并减少桥接网格、纹理与队列处理开销。

下载与升级

NeoForge 用户下载三个文件：

• EndCraft-gameplay38-4.2.0-win-x64.zip：终末地玩法模块。
• EndCraft-probe-4.2.0-win-x64.zip：必需的共享内存模块。
• endcraft-neoforge-guest-4.2.0.jar：放入 MC 1.21.1 NeoForge 实例的 mods 目录。

推荐使用 EFML 的 xinput 代理，并从官方鹰角启动器进入终末地。导入并启用两个 ZIP，停用旧版玩法模块；关闭 MC 后替换 JAR，再重新启动。不要同时运行多个玩法模块或 MC 桥接客户端。操作见 README。

同时提供 Fabric 26.3 客户端 endcraft-guest-4.2.0.jar、包含固定上游源码的源代码归档及 SHA256SUMS.txt。下列本轮界面修复与光影预览针对 NeoForge；Fabric 与 NeoForge 的存档不能混用。

修正

• 修正宿主再次解码 MC 最终显示颜色导致的 HUD、背包和手持物品偏暗。HUD 保持原透明度，不透明界面不会变成半透明。
• TaCZ 的 Z 配件界面临时切为第一人称，关闭后恢复视角；去掉盖在枪械上的暗色菜单背景，预览使用全亮光照。普通手持物品保留原光照。
• 打开 MC 菜单时拦截终末地 UI 的事件派发，点击右上角配件按钮不会同时打开终末地菜单。关闭菜单后等待鼠标松开并经过释放帧，再恢复原生 UI。
• 跳过 MC 世界绘制时仍更新光照队列并重置漫反射灯光、shader 颜色，减少不同界面之间的渲染状态残留。
• 补充标准图集粒子、屏障标记、三角形动态网格和字体字形的导出。屏障本体仍遵循 MC 原版不可见规则。
• Mob 接入原生三角面碰撞，短程女仆行走验证通过；地形数据重建、离开采样区等情况下的长期支撑仍待完善，见下方已知限制。

性能与调试

• 复用区块、实体和透明裁剪的暂存缓冲区，减少重复直接内存和临时对象分配。
• 缓存最多 64MiB 的区块快照用于恢复重发，按脏标记失效；每帧最多建模两个区块，完成一个区块后检查 3ms 预算。
• 动画图集使用 PBO/fence 异步读回；渲染队列拥塞时暂停新捕获并重试必要消息。
• 航空学坐标变换改为每艘物理体采样一次仿射变换，顶点使用矩阵计算；尚未缓存整艘物理体的几何。
• F6 切换终末地原生人物模型显示，默认隐藏；没有打开 MC 界面且桥接就绪时生效。
• 增加可选 Iris/Sodium 光影预览流程，验证完整 MC 渲染及帧读回。预览覆盖原生场景，尚未实现终末地与 MC 光影的深度融合。

局部离线基准不代表双游戏 FPS；本版没有同场景优化前后的联动性能百分比。详细范围见 性能说明 与 渲染说明。

内容模组与构建

开发组合包含 TaCZ 1.1.8-hotfix-r7、Touhou Little Maid 1.5.3、GeckoLib 4.9.3，以及原有 Create、Aeronautics、Sable 和 Flight Control。第三方 JAR、枪包及用户光影包不附在发行附件中；来源与 SHA-512 见 mc-neoforge/modpack.lock.json。

YSM 2.6.3 因本机原生库加载失败（err: 54）保持停用，下载到 libs-disabled/ 仅用于字节码审计。Maid Addition 没有已锁定的发布下载地址，作为可选本地文件；缺少它不再阻断干净环境构建，提供文件时仍严格校验哈希。EFML 工具优先读取实际运行配置，通过 CLI 注册和切换模块，旧加载器卸载不会删除已归 EFML 管理的代理。

验证与限制

• NeoForge 本地构建和 58 项检查通过；安装、EFML 与依赖工具 15 项 Python 检查通过。
• 原生输入、焦点切换、菜单关闭释放、透明裁剪和 ABI 生命周期检查通过。
• 终末地 1.6.3 + NeoForge 实机中，HUD 抽查的 78,666 个不透明灰阶像素与 MC 源图完全一致。
• 新版配件界面已重新加载并截帧核对，用户确认“亮度正常，点击不再穿透”。
• 女仆曾完成 120 次短程采样、移动 7.2 格且未穿地；后续会话仍记录到女仆掉出世界，因此不能保证长期行走和地形重建期间的支撑。
• 尚未完成两台电脑各运行终末地的联机、复杂航空学起降、全部枪械特效及 YSM 的实机验收。

本版仍是实验性项目。终末地适配详情见 1.6.3 记录。