Distant Horizons Memory Fix

By
Hecrius

Fix retained Distant Horizons 3.3.3 progress worker threads without changing LOD quality, generation or saves.

Repeated Distant Horizons request closures can leave progress reporting workers alive. Those idle threads retain native resources and memory, which can accumulate during extended play or server operation.

Distant Horizons Memory Fix closes each audited request state's progress executor when that state closes. The running reporter finishes normally, then its worker retires. Background generation, retrieval and chunk saves retain their original behavior.

Release abandoned progress worker threads after their request ends.
Preserve active work without interrupting it or waiting on the server thread.
Keep existing LOD quality, render distance and generation settings.
Run independently of Tensura and other custom mods.
Import the previous feature preference when moving from Tensura Optimizations.

This release targets the specific progress executor leak in Distant Horizons 3.3.3. It checks the supported version and implementation before applying. Unsupported or changed implementations are skipped with a log message. This is a targeted lifecycle fix; it does not claim to resolve every DH memory issue or provide a universal FPS/TPS improvement.

Installation and Compatibility

Minecraft: 1.21.1.
Loader: NeoForge 21.1.250 or newer within the 21.1 series.
Java: 21.
Install on: The client, dedicated server, or both, wherever DH runs.
Audited DH version: 3.3.3.
Required mods: None beyond Minecraft and NeoForge.
Optional project relationship: Distant Horizons (distanthorizons). Without DH, the mod loads safely and has nothing to patch.

Configuration

The fix defaults on in config/distant_horizons_memory_fix-common.toml: [general] enabled = true

Use -Ddistant_horizons_memory_fix.enabled=false to compare with upstream behavior. When no new config exists, the previous [features] distantProgressLifecycle value is imported from config/tensura_optimizations-common.toml. The legacy -Dtensura_optimizations.distantProgressLifecycle override remains a fallback; the new property takes precedence.