Worldthreader is a free and open-source Minecraft mod which optimizes the processing of multiple dimensions, by ticking dimensions in parallel. Thread safety is ensured, with fallbacks to serial execution if no other solution can be found. After each tick the dimensions wait for each other to ensure that everything stays in sync, avoiding breaking many advanced redstone contraptions. Mod incompatibilities are expected, please report any issues to the worldthreader issue tracker.
The mod works on both the client (singleplayer) and server, and does not require the mod to be installed on both sides.
Installation
Must be installed on the server to work in multiplayer. For usage in singleplayer worlds, the mod has to be installed on the client.
- Download the mod from Modrinth or CurseForge.
- Place the downloaded
.jarfile into themodsfolder of your Minecraft directory. - Launch Minecraft with the Fabric mod loader.
Configuration
To use the gamerules, you need fabric-api. Without fabric-api, worldthreader will use the default settings.
/gamerule worldthreader_Active <true/false>(default true) enables/disables the mod/gamerule worldthreader_AdditionalEntityTickAfterTeleport <true/false>(default false) enables/disables ticking entities immediately after teleporting from the main overworld to the nether or end to simulate the timings of vanilla portal use
FAQ
Does the mod change Vanilla behaviour?
Worldthreader aims to conserve vanilla-parity in most points.
Behavior that is based on the timing of entities going through portals might be delayed by a gametick when the entity is
leaving the overworld. However /gamerule worldthreader_AdditionalEntityTickAfterTeleport ticks entities which are not
teleporting to the overworld once after being placed in the world. This should allow them to catch up on the tick they
missed out on. However, this happens at the end of the tick, meaning that no other mobs or pistons were able to push or
damage the entity in that tick, because it hasn't been there yet.
Interdimensional commands in command blocks or shared scoreboard accesses from different dimensions can be observed to be in a different order, since there are no interdimensional ordering guarantees within a single gametick for interdimensional commands. The order of commands within one dimension stays the same as vanilla.
Can my dimensions get de-synchronized?
No. Worldthreader will always synchronize the dimensions with each other, setting the overall MSPT to the slowest individual dimension.
Are dimension counts above 3 supported?
Yes.
Can I use Worldthreader if I have fewer threads on my CPU than dimensions?
Yes, but that may reduce the performance.
How is the compatibility with other mods?
Compatibility issues with other mods will be very common. Please report all issues you encounter to worldthreader directly to avoid giving other mod authors headaches. The author of Worldthreader is willing to cooperate and suggest changes to other mods for compatibility.
What about older versions of Minecraft?
There is the DimThread mod which supports a few older versions: https://github.com/WearBlackAllDay/DimensionalThreading
License
Worldthreader is licensed under MIT, a free and open-source license. For more information, please read the license file.
