如果你的 Minecraft 客户端在使用 TaCZ 1.1.4-hotfix 时,于重生或切换维度后报出从 ClientChunkCache 到 ServerChunkCache 的 ClassCastException,配件缓存就无法完成更新。我们的补充模组可以修复在已测试的 Forge 1.19.2 环境中的这一具体错误路径。你只需将它额外放入 Minecraft 实例的 mods 文件夹,并保留原有的 TaCZ 文件。
你需要: Minecraft 1.19.2、Forge 43.x 和 TaCZ 1.1.4-hotfix。我们测试的是 Forge 43.5.0 搭配 Java 17。该补充模组需要安装在每一位受影响玩家的客户端中。它是 mcfreehost 自制的兼容性修复,并非 TaCZ 官方发布版本。
如何识别这个 TaCZ 错误?
在出现问题的重生之后,打开你的 Minecraft 实例中的 logs/latest.log 文件。关键报错会同时提到两个类:ClientChunkCache cannot be cast to ServerChunkCache。在相关的堆栈中会出现 PacketDistributor.trackingEntity、NetworkHandler.sendToTrackingEntity、LivingEntityDrawGun.draw 和 RefreshClonePlayerDataEvent。仅在服务器上出现报错,或是其他内容的崩溃,都不足以用这一诊断来判断。
当本地玩家对象被替换时,TaCZ 会更新其武器数据。在我们检查的版本中,这条客户端路径会调用一个向服务端追踪玩家发送数据的函数。Forge 在此期望得到服务端区块缓存,却拿到了客户端区块缓存。这个异常会在配件缓存完全重建之前中断该函数。
这是该代码路径中的错误。增加服务器内存并不能修复这个错误的类型转换。反过来,没有这条日志信息的武器问题,也不能证明你遇到的是同一个错误。此时请检查版本、其他模组以及实际的崩溃报告。
下载并验证补充模组
下载 tacz-clonefix-1.19.2-1.0.0.jar。该文件大小为 2,613 字节。它的 SHA-256 为:
4211368ec9461ad28f1c90d3d2faff7c9ad2b974bbc8b730008d730338bbcdc7
在 Windows 上,你可以在 PowerShell 中使用 Get-FileHash -Algorithm SHA256 加上已下载文件的路径来校验。在 macOS 上,可对该文件路径使用 shasum -a 256。请比对完整的哈希值;十六进制输出的大小写无关紧要。哈希值不同意味着你手中的文件不是我们验证过的那个文件。此时请不要安装该文件,而是从链接的来源重新下载。
该补充模组不会替代 TaCZ 的 JAR 文件。原始文件 tacz-1.19.2-1.1.4-hotfix-all.jar 仍需保持安装。如果你的实例中缺少它,请从 Modrinth 下载对应的原版本。对于 Minecraft 1.20.1、NeoForge 或其他 TaCZ 版本,我们尚未放行此补充模组。
如需进行技术复查,你可以找到附带构建说明的源码包以及源码包校验和。该 ZIP 的 SHA-256 为 484b50152fa905e9959d8bf2e3cb9b700d8cd35fb77bb50c79beba5d47a878bb。自有源码采用 MIT 许可证;其中不包含 Minecraft、Forge 和原版 TaCZ。我们已将原因和修复建议作为 GitHub 错误报告提交给 TaCZ 项目。那里链接了经过整理的对比证据。
在正确的 Minecraft 客户端中安装
- 完全退出 Minecraft。在启动器中打开你实际用来进入模组服务器的那个实例的目录。如果有多个配置档案,每个档案可能有不同的
mods文件夹。 - 只将这个额外的 JAR 复制到该
mods文件夹中。保留其他模组和原有的 TaCZ 文件。不要同时安装两份我们的补充模组。 - 使用 Minecraft 1.19.2 和 Forge 启动同一个实例。在模组列表中检查 TaCZ 和条目
TaCZ 1.19.2 client clone refresh fix是否已加载。 - 尽量在你自己的测试服务器上测试。重生之前请备份世界,并将贵重物品从背包中存放起来;如果没有相应的游戏规则,它们可能会在死亡时丢失。连接到你的服务器,先在安全的地方测试你的武器。然后进行一次正常重生和一次维度切换。检查武器、配件以及新的
logs/latest.log中是否出现所述的错误路径。
每位受影响的队友都必须在自己的客户端中安装该补充模组。只上传到服务器的 mods 文件夹无法修复客户端功能。我们的对比服务器运行的是未经修改的原版 TaCZ,没有使用补充模组。这个修复不需要你修改世界,也不需要额外的服务器权限。
我们实际测试了什么?
2026 年 10 月 9 日,我们在相同的 Forge 1.19.2 环境中对比了原版和补充模组。在四次有针对性触发的缓存刷新中,原版都因所述异常而中断;补充模组则全部完成,并重建了消音器缓存。在功能测试中,客户端和专用服务器确认了使用 AK47 和配件 tacz:muzzle_silencer_ursus 的同样 28 次射击。重生以及在主世界与下界之间的切换也包含在内。
第一次图形对比是在包含 58 个模组文件的较大环境中进行的。这四次有针对性的刷新检验了 TaCZ 的真实玩家路径,并为此在调用前清空了缓存。你在正常游玩时不需要执行这一检验步骤。在这次对比中,原版同样可以射击。因此,我们不承诺这个补充模组能消除所有射击问题。其他武器、更多配件以及单人游戏尚未得到完整验证。
另一项独立的对比只使用 TaCZ 作为内容模组以及我们自己的测量工具。没有 TaCZ 的 Forge 不会出现所述错误;使用原版时,它在正常切换玩家时出现,而使用补充模组时则不会。在那里,原版的四次有针对性缓存刷新同样失败,而使用补充模组则四次全部成功。这项 Linux 测试是在暂停世界渲染的情况下检验网络和玩家数据的,不是额外的图形基准测试。其附加的射击测量得到 22 次本地成功提示和 21 个服务器事件;切换下界之后那次未被确认的射击,其原因尚不明确。上文提到的 28 次已确认射击来自单独的图形测试。
你可以在原版 TaCZ 1.19.2 代码中追溯原因。该修复仅在逻辑客户端一侧跳过服务端事件和服务端发送;重置、武器分配和配件更新照常运行。
FAQ
如何再次移除这个补充模组?
退出 Minecraft,仅从受影响的实例中移除 tacz-clonefix-1.19.2-1.0.0.jar。保留 TaCZ 和你其余的模组。下次启动时,原始路径将重新生效。
遇到其他错误或 TaCZ 新版本时该怎么办?
首先比对确切的报错信息和已加载的版本。如果是其他错误,本指南并不是经过确认的解决方法。一旦官方版本修复了同一错误,我们会核对版本状态并更新建议。请不要未经检查就在其他 TaCZ 版本旁安装这个补充模组。
为此我需要更大的托管套餐吗?
对于这个类型转换错误,更换套餐没有帮助。不过大型整合包可能有自己的内存需求。在搭建新的模组服务器之前,请查看你所用整合包的最低要求。对于较简单的配置,你可以找到 mcfreehost 的免费 Minecraft 服务器;但这并不意味着与整合包兼容。本指南和补充模组下载将保持免费开放。
编辑与测试状态: mcfreehost,技术测试于 2026 年 10 月 9 日完成。我们会公布已测试的版本范围,并在相应的官方修复经过验证后调整建议。如果你遇到不同的错误,可以通过我们的联系表单提交,并附上版本信息和整理过的日志。