Structure DFU Cache
- By
Moves repetitive structure DataFixerUpper (DFU) migration to the startup phase and caches the result to improve TPS during heavy chunk loading.
Curse Maven Snippet
What's new
Structure DFU Cache 1.2.0
Features & Improvements
- TOML configuration: Added
config/structure_dfu_cache.toml(loaded on game startup; restart required after editing). - Configurable processing limits:
maxDecodedNbtMiB(default1024): Positive integer in MiB tracking the NBT decoder's accounting of in-memory NBT objects and allocation overhead during processing (this does not measure total DFU memory).maxCompressedResourceMiB(default64): Positive integer in MiB setting the limit for compressed structure resource size.
- Concurrency & memory estimation: Worker concurrency is budgeted based on available heap after deducting resident memory and a 2 GiB reserve, estimating total DFU memory at roughly 4x
maxDecodedNbtMiBper worker (capped at 4 threads, leaving 1 CPU core free when more than 1 core is available). Higher quota values reduce worker concurrency to allocate more memory headroom. - Fallback behavior: Structures exceeding
maxCompressedResourceMiBbypass startup pre-processing and are handed back to vanilla reading. Structures exceedingmaxDecodedNbtMiBor failing conversion cache the raw compressed bytes as unoptimized resources to retry during future load or reload.
All Relations
- All Relations
- Embedded Library
- Optional Dependency
- Required Dependency
- Tool
- Incompatible
- Include
