Async - Minecraft Entity Multi-Threading Mod ⚙️

Async is a Fabric mod designed to improve entity performance by processing them in parallel using multiple CPU cores and threads.

Important❗

Async is currently in alpha testing and is experimental. Its use may lead to incorrect entity behavior and crashes.

What is Async? 🤔

Async is a Fabric mod that enhances the performance of entity processing. The mod leverages multithreading, which allows multiple CPU cores to improve performance when handling a large number of entities.

💡 Key Benefits:

• ⚡ Improved TPS: Maintains stable tick times even with a large number of entities.
• 🚀 Multithreading: Utilizes multiple CPU cores for parallel entity processing.
• 🎲 Async Random Ticks (Experimental): Processes random ticks asynchronously for better performance.

📊 Performance Comparison (9000 Villagers)

| Configuration | TPS | MSPT |
| ----------------------- | ---- | ------ |
| Lithium + Async | 20 | 41.8 |
| Lithium (without Async) | 4.4 | 225.4 |
| Purpur | 5.72 | 176.18 |

🛠️ Test Configuration

• Processor: AMD Ryzen 9 7950X3D
• RAM: 64 GB (16 GB allocated to the server)
• Minecraft Version: 1.21.4
• Number of Entities: 9000
• Entity Type: Villagers

⚠️ Incompatible Mods

• ❌ Moonrise - Known incompatibility
• ⚠️ ...and there may be conflicts with other mods.

If you encounter issues with other mods, please report them on our GitHub or Discord.

🔧 Commands

• /async config toggle — Enables or disables the mod in-game (no server restart required). Use this command to instantly see how Async improves your server.
• /async config setAsyncEntitySpawn — Enables or disables parallel mob spawn processing (disabled by default). Warning: Not compatible with Carpet mod lagFreeSpawning rule.
• /async config setAsyncRandomTicks — Enables or disables async random ticks processing (experimental feature).
• /async config synchronizedEntities add — Adds selected entity to synchronized processing.
• /async config synchronizedEntities remove — Removes selected entity from synchronized processing.
• /async stats — Displays the number of threads in use.
• /async stats entity — Shows the number of entities processed by Async in various worlds.
• /async stats entity [number] — Shows the top [number] entity types by count in descending order. For example, /async stats entity 10 displays the top 10 most numerous entity types.
• /async stats entity [number] [ticks] displays the top [number] most numerous entity types with their average mspt usage per [ticks].

📥 Download

The mod is available on Modrinth

🔄 Minecraft Version Support

Full support is provided only for the latest version of Minecraft. Older versions receive critical fixes only. Support for older Minecraft snapshots is not planned.

📭 Feedback

Our tracker for feedback and bug reports is available on GitHub:

You can also chat with us on Discord:

🙌 Acknowledgements

This mod is based on code from MCMTFabric, which in turn was based on JMT-MCMT. Huge thanks to Grider and jediminer543 for their invaluable contributions!