promotional bannermobile promotional banner

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.
Back to Files

dontcrashobscura-1.21.1-v5.0

File namedontcrashobscura-1.21.1-v5.0.jar
Uploader
NavrelisNavrelis
Uploaded
Jan 12, 2026
Downloads
38
Size
18.2 KB
Mod Loaders
NeoForge
File ID
7451257
Type
R
Release
Supported game versions
  • 1.21.1

Curse Maven Snippet

NeoForge

implementation "curse.maven:dont-crash-obscura-1420775:7451257"

Learn more about Curse Maven

What's new

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

 

This mod has no additional files