Low-overhead memory-leak mitigation and deep cache-management utility tailored for heavy modpacks and marathon sessions.
In large modpacks with extensive exploration, high-intensity combat, and continuous dimension-hopping, retained object references gradually accumulate over time. Nicelight Memory Fix Deep prevents progressive performance degradation and out-of-memory crashes by actively severing orphaned references that standard Java Garbage Collection (GC) cannot reclaim on its own.
Engineered to run seamlessly alongside the modern Forge optimization ecosystem with zero mixin conflicts:
Brain memory references immediately upon entity removal.destroyingBlocks map upon leaving a dimension, preventing cross-dimension texture retention leaks.instanceToChannel map on sound termination, stopping OpenAL audio handle exhaustion.Unsafe accessor to detach retained world and classloader references without requiring --add-opens JVM startup flags.Optional.empty() instead of stripping map keys entirely. This effectively severs memory links from dead mobs while preserving 100% crash-free stability with Epic Fight and third-party entity AI routines.DistanceManager tickets, unloads abandoned POI SectionStorage, and flushes cached 3D StructureTemplate NBT payloads from memory.BufferBuilder.System.gc() pauses during active gameplay./nm or /nmem)| Command | Description |
|---|---|
/nm stats (or /nm) |
Displays real-time used heap, committed memory, watchdog world status, and active mixin counters. |
/nm sweep |
[Full Deep Clean] Triggers an exhaustive purge across all 16+ cache tiers (audio, textures, tickets, thread locals, brain states) and outputs a diagnostic breakdown. |
/nm scan |
Runs a non-destructive diagnostic scan to inspect objects currently retained on background worker threads. |
/nm gc |
Executes targeted cache cleanups followed by a single manual JVM garbage collection cycle. |
/nm pressure |
Evaluates current heap pressure against configured thresholds and executes the corresponding mitigation tier. |
/nm watchdog |
Checks whether any unloaded dimensions or worlds remain retained in memory. |
/nm config |
Prints an overview of active runtime configuration values. |
/nm discover |
Scans loaded mod JARs to identify newly registered cache classes. |
All memory thresholds, sweep intervals, and subsystem hooks can be configured in:
config/nicelight_memoryfix_deep.json
