Canary

矿井中毒气的早期预警。

Canary 是一个检测其他模组中危险行为并提供多种诊断工具的模组。

检测到的问题

BlockState 属性注入

某些模组试图向原版方块添加新的 BlockState 属性。 不幸的是，这很可能导致方块不同步。

解决方案：

• 使用 Statement，这是一个专为安全执行此操作而设计的库
• 改用自定义方块，并在其与原版方块之间按需进行转换

同步实体数据注入

某些模组试图向原版实体类添加新的同步数据条目（EntityDataAccessor）。 这样做很可能导致难以理解的网络错误，因为客户端与服务器之间的字段顺序并不稳定。

解决方案：

• 使用 数据附件
• 将值存储在普通字段中，并通过自定义数据包进行同步

诊断功能

此外，Canary 还具备以下诊断功能：

• 当在配置文件中启用时（"print_blockstate_report": true），BlockState 报告将被打印到日志中
• 命令 /canaryclient diagnoseDesync 将生成一份关于客户端和服务端 BlockState 的报告

趣味事实

该模组的名称源于现实生活中在煤矿中使用金丝雀来检测有毒气体的做法。与现实中的情况类似，如果金丝雀死亡（即游戏崩溃），那就说明出问题了。