DontCrashTom (Fixes for Tom’s Simple Storage Mod)

别让 Tom 崩溃（NeoForge 1.21.1）
针对 Tom’s Simple Storage 的微型补丁，可修复因区块卸载、维度切换（传送门）或能力缓存失效时的 BlockCapabilityCache 导致的罕见但恼人的崩溃。

修复内容

• Tom’s Simple Storage 的 PlatformInventoryAccess.BlockInventoryAccess 即使缓存已经失效，仍会调用 itemCache.getCapability()。
• 缓存失效后，NeoForge 会抛出 IllegalStateException，导致服务器/客户端崩溃或玩家被踢出。
• 此模组会拦截 tracker() 和 exists()，如果缓存为空或已失效，就直接退出，不再访问失效缓存。

适用范围

• 仅用于提升稳定性。不影响玩法、平衡性、战利品、GUI 或配置。
• 可安全添加到现有世界；上游包含修复后，可随时移除。
• 占用极小：仅通过一个 mixin 为能力查询添加保护。

需求

• 加载器：NeoForge 21.1.x
• 游戏：Minecraft 1.21.1
• 目标模组：Tom’s Simple Storage（已使用 1.21-2.2.3 测试）。其他小版本应该也能正常使用，前提是存在相同的 BlockInventoryAccess 类/方法。

兼容性

• 不涉及世界生成、物品/方块，也不会对 Tom’s Simple Storage PlatformInventoryAccess.BlockInventoryAccess之外的内容应用 mixin。
• 应该能与其他存储/网络模组及常见优化模组共存。

如何确认修复生效

• 区块卸载/通过传送门旅行时，不会再出现特定的 BlockCapabilityCache 崩溃。
• 加载时的日志行：“DontCrashTom loaded – Tom’s Storage BlockCapabilityCache fix active”。
• 阻止访问失效缓存时，偶尔会出现调试日志（可忽略）。

为什么需要它

• 在区块频繁卸载/重新加载或玩家频繁使用传送门的繁忙服务器上，避免意外崩溃。
• 无需配置，不影响玩法；纯粹用于提升稳定性的补丁。

许可 / 致谢

• 许可：保留所有权利（与上游源资产的政策一致）。
• 作者：Navrelis