Copycats Sable Light Fix

Copycats Sable Light Fix

修复在 Sable 子层级中渲染的仿制模型环境光遮蔽（AO）异常问题。

模组 ID： copycats_sable_light_fix | 版本： 1.0.0 | 加载器： NeoForge 1.21.1

简介

此模组可修复在 Sable 子层级中渲染仿制模型时，环境光遮蔽（AO）/平滑光照异常的问题。

兼容任何提供仿制模型的模组，包括 Create、Extra Copycats、Create Connected 等。

修复前 / 修复后

修复前（AO 异常）	修复后（AO 正常）

工作原理

1. 检测 – 调用 ModelBlockRenderer.tesselateBlock() 时，模组会检查正在渲染的 BakedModel 是否为仿制模型（instanceof CopycatModel，或类名是否符合 com.fiisadev.extra_copycats.*）。

2. 拦截 – 模组不会重定向 Minecraft.useAmbientOcclusion()（该方法会被内联，因此运行时对 mixin 不可见），而是重定向 tesselateBlock() 内对 ModelBlockRenderer.tesselateWithAO() 的实际调用。

3. 回退处理 – 如果模型是仿制模型，就将调用重定向到 tesselateWithoutAO()（平面光照）；否则保留原本的 tesselateWithAO() 调用路径。

4. 安全性 – 模组使用 try-catch 和类名回退机制，因此即使未安装 Copycats 模组也不会崩溃。此修复仅影响仿制模型；其他方块仍使用正常的 AO 渲染。

5. 配置 – 可通过模组菜单或 config/copycats_sable_light_fix-client.toml 开启或关闭此修复。

技术详情

依赖项

注意：任何兼容 Copycats 的模组均可使用——例如 Create、Extra Copycats、Create Connected 等。这些模组并非必需。

基于 Sable 上游问题 #1479。