CaveSpeedThing

CaveSpeedThing

MC 1.12.2 // CLEANROOM

tl;dr

CaveSpeedThing optimizes Minecraft 1.12.2 world generation by parallelizing expensive noise calculations and cave generation work. It uses automatic workload detection, dedicated helper threads, caching, and pooled buffers to reduce generation time and unnecessary overhead.

what this mod does

• parallel noise generation: distributes expensive noise calculations across helper threads while preserving vanilla's exact floating-point results.
• automatic workload detection: measures execution times and only parallelizes work when doing so is beneficial. Small workloads remain inline.
• shared task distribution: the server thread and helper threads pull tasks from a common counter, reducing unnecessary waiting.
• pooled buffers: reuses temporary arrays instead of allocating new buffers for every task.
• biome caching: avoids repeated biome type lookups and reuses cached biome data.
• reduced overhead: optimizes thread context lookups and other frequently executed operations.

performance

In an earlier Flare profile, cave and cavern carving was measured at around 3.01x faster than unmodified Better Caves under an extreme chunk-generation workload. This is a historical benchmark, not a guaranteed result for the latest version. Actual gains depend on hardware, modpack, world generation settings, and workload.

threading configuration

• Max Helper Threads: controls the maximum number of helper threads. Set to 0 for automatic selection.
• Enable Parallel Noise: enables or disables parallel noise generation.
• Automatic thread selection: takes available CPU resources and the presence of Pulsar into account, with a maximum of 8 helper threads.

requirements & compatibility

Requires Minecraft 1.12.2 and Cleanroom. Better Caves and Better Mineshafts integrations are activated automatically when the respective mods are present in the mods folder.

CaveSpeedThing is a Mixin-based optimization layer, not a replacement for the original mods.

Pulsar: Supported as a companion mod. CaveSpeedThing adjusts its automatic helper thread selection when Pulsar is present. .

OTG is not supported. CaveSpeedThing does not provide integration for  Open Terrain Generator.

Not compatible with NoiseThreader. Both projects modify overlapping Better Caves classes through Mixins and cannot run together.

where it came from

The original idea was inspired by NoiseThreader and its approach to parallelizing Better Caves world generation.

CaveSpeedThing is an independent implementation with its own architecture, including:

• Dedicated parallel task engine with shared task distribution.
• Pooled buffers and optimized noise storage.
• Biome caches and optimized biome lookups.
• Better Mineshafts optimizations.
• Automatic workload-based parallelization.
• Runtime diagnostics and configurable thread limits.

credits

• fonnymunkey for NoiseThreader and the inspiration behind parallel Better Caves generation: CurseForge
• YUNGNICKYOUNG for Better Caves and Better Mineshafts: Better Caves · Better Mineshafts

CaveSpeedThing is an independent implementation and does not reuse NoiseThreader code.

license

CaveSpeedThing is licensed under the GNU Lesser General Public License v3.0 (LGPL-3.0).

// works on my machine.