
实体看门狗
以最高拦截优先级监视所有实体加载路径,一旦任何实体加载失败,立即崩溃游戏/服务器,并附带详细诊断报告,明确指出是哪个模组以及导致失败的原因。
实体看门狗(Entity Watchdog)

原版 Minecraft 在实体加载失败时(未注册的实体 ID、实体构造函数或 Entity.load 抛出的异常,或客户端数据包创建失败)会静默丢弃实体,仅打印一条“Skipping Entity”警告,这会导致生物消失、数据损坏,且无法追溯原因。实体看门狗(Entity Watchdog)以 100000 的注入优先级,将 Mixin 精准定位到最低级别的实体加载入口点(EntityType.create / loadStaticEntity / loadEntityRecursive 以及客户端的 ClientboundAddEntityPacket 处理)
— 高于任何普通模组 —
并通过抛出 Error 来触发崩溃,从而避免被其他模组的 catch(Exception) 回退逻辑吞没。
崩溃报告包含失败场景、实体 ID、注册表解析、维度/侧/线程、被吞没原始异常的完整堆栈跟踪、实体 NBT 的完整转储、最接近的已注册实体 ID(重命名检测)、已加载模组的完整列表以及修复说明 —
从而能够立即明确是哪个模组以及何种原因导致了失败。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。