Thread Weave

Calculation-heavy machines, reactors and AI routines all draw on one shared processing budget in the default setup. Thread Weave divides such logic into a computation part that can run on background threads and a world part that stays on the main thread. Its simulation methods accept only pure data, so a background calculation cannot touch live level state and cause race conditions.

A mod that uses Thread Weave defines what data is used and what calculation happens, then runs the cycle: extract data from a block entity during the Minecraft tick, run the simulation on background threads, collect the updated values, and apply the changes back to the world on the main thread. Side effects are allowed inside the async execution, but placing blocks and other world changes still depend on the main thread and are kept out of it.

The framework is aimed at mod authors who have expensive logic inside block entities or tick handlers. Thread Weave is published for NeoForge only, under the MIT License, and the code is open source. Every player and the server need a copy of the mod. Files cover the NeoForge builds for 1.21 – 1.21.11, with 0.2.3-NeoForge for 1.21.11 as the latest file.