DamageSource Is Not Null

DamageSource Is Not Null

尝试修复“NullPointerException: LivingDeathEvent.getSource() is null”

游戏机制

❌ 告别 NPE — LivingDeathEvent.getSource() is null

厌倦了因模组将 null DamageSource 传入 Minecraft 的伤害或死亡流程而导致的崩溃?

它为多个常见的伤害/死亡路径添加了运行时守卫,使得许多无效的 DamageSource 情况能够在导致游戏崩溃之前被拦截。它还可以记录有用的信息,以帮助识别出问题的模组。

限制

DamageSource Is Not Null 是一个防御性缓解模组,并非万能的保证性修复。

然而,由于模组化 Minecraft 的特性,它无法保证在所有情况下都提供保护。某些模组可能会绕过受守卫的路径、重写核心方法,或在此模组能够拦截之前就崩溃。

最好将此模组理解为一个安全层,它降低崩溃风险并改善诊断——而不是保证所有此类崩溃都已解决。


🆕 版本 2.0.0

版本 2.0.0+ 显著改进了内部安全守卫和调试工具。

主要改进包括:

  • 🛠 改进的命令工具,用于测试和诊断 DamageSource 问题
  • 🧱 修复了原始守卫实现中的多个漏洞

这些更改使保护在大型整合包中更可靠,并帮助整合包作者更轻松地定位有问题的模组。

⚠ 强烈建议升级到 2.0.0。

目前,2.0.0 仅在 1.20.1 Forge 上提供。2.0.0 中引入的改进将逐步回溯移植到其他受支持的版本(Forge、Fabric 以及更多 Minecraft 版本)。


🛡 此模组的功能

此模组向以下位置注入安全检查:

  • LivingEntity#hurt
  • LivingEntity#die

如果某个模组错误地以 null DamageSource 触发伤害或死亡(这本来不应发生),此模组将:

  • 防止许多常见的 NullPointerException 崩溃
  • 用回退的通用 DamageSource 替换无效的来源
  • 打印详细日志以帮助整合包作者定位问题源头

🚨 为什么需要它

虽然原版和 NeoForge 期望 DamageSource 永不为 null, 但某些模组仍会错误地触发事件并导致整个游戏崩溃。

通常,这会导致类似如下的错误:

LivingDeathEvent.getSource() is null

这会导致服务器崩溃并中断游戏,而原因并非玩家所能控制。

此模组作为此类情况的运行时安全网。


⚠ 重要说明

  • ❗ 此模组不会修复有问题的模组——它只防止崩溃。
  • ❗ 此模组是一个防御性缓解模组,并非万能的保证性修复。
  • ⚠ 如果你在日志中看到警告,仍应向模组作者报告。
  • ✅ 可在客户端和专用服务器上安全使用。
  • 🧩 设计轻量,兼容大型整合包。

📦 整合包友好

如果你是整合包作者或服务器所有者,此模组可以帮助:

  • 防止意外停机
  • 避免世界损坏
  • 在不中断游戏的情况下收集有用的崩溃信息

可以把它看作是针对不良伤害事件的断路器。


🧪 环境

NeoForge

  • 1.21.1

Forge

  • 1.20.1
  • 1.19.2
  • 1.18.2

Fabric

  • 1.20.1

📜 许可证

MIT License — 可在任何整合包中自由使用。