Don't Crash Obscura

Crash-guard mod for NeoForge 1.21.1 that intercepts Tom’s Storage capability lookups and inventory tracking to prevent server crashes from invalid caches, failing safely instead of halting your world.

File Details
DownloadInstall

dontcrashobscura-1.21.1-v5.0

ByNavrelis
  • R
  • Jan 12, 2026
  • 18.21 KB
  • 31
  • 1.21.1
  • NeoForge

File Name

dontcrashobscura-1.21.1-v5.0.jar

Supported Versions

  • 1.21.1

Curse Maven Snippet

NeoForge

implementation "curse.maven:dont-crash-obscura-1420775:7451257"
Curse Maven does not yet support mods that have disabled 3rd party sharing

Learn more about Curse Maven

Changelog v5.0

For Minecraft 1.21.1 / NeoForge 21.1.217

Changes

  • Hardened Tom’s Storage capability access to stop
    IllegalStateException: Do not call getCapability on an invalid cache.

  • BlockInventoryAccessMixin

    • Adds cache-validity checks to:
    • tracker()
    • exists()
    • get()
    • Uses both Tom’s Storage valid flag and NeoForge cache state
      (with reflection fallback).
    • Returns safe defaults instead of crashing:
    • no-op tracker
    • false
    • null

  • MultiChangeTrackerMixin

    • Wraps all tracker() call sites with try/catch:
    • getChangeTracker
    • multithreadProcessing
    • streamWrappedStacks
    • countItems
    • findSlot*
    • findSlotDest*
    • Returns InventoryChangeTracker.NULL on failure.

  • Both mixins are set to priority 1500 to apply after other Tom’s Storage fixes.

Behavior impact

  • Prevents BasicInventoryHopper / CraftingTerminal crash chains during:
    • chunk unloads
    • capability invalidations
  • Fails safe instead of crashing:
    • inventory tracking may temporarily degrade to no-op when caches are invalid
    • avoids server downtime