premium banner
A parallel entity processing engine that distributes entity ticking and mob spawning across multiple CPU threads to reduce main thread load

Description

HariMultiThread | Async Entity Processing


Massively Parallel Entity Ticking & Spawning


What Is HariMultiThread

HariMultiThread is a multi-threaded entity processing engine (based on Async) that parallelizes entity ticking across all available CPU cores.

More Entities. Same TPS.

By distributing entity updates across a thread pool, HariMultiThread eliminates the single biggest bottleneck on entity-heavy servers — the main thread.


Technical Architecture

Designed for safe, scalable parallel entity processing.

  • Parallel Entity Ticking: Entities are batched and processed concurrently across all CPU cores
  • Async Mob Spawning: Natural mob spawning calculations run in parallel with the main tick
  • Thread-Safe Synchronization: Critical entities (TNT, items, projectiles) are always processed on the main thread
  • Explosion Processing: Dedicated thread pool for explosion calculations independent of entity ticking
  • Dynamic Thread Pool: Automatically scales to use all available processors

Configuration

Located in config/async.toml.

  • Thread Count: Maximum parallel threads (default: all available processors)
  • Async Spawn: Toggle asynchronous entity spawning
  • Synchronized Entities: Configure which entities must tick on the main thread
  • In-game Commands: /async config and /async stats for runtime management

Safety & Compatibility

Not all entities can be safely parallelized.

  • Always Synchronized: Projectiles, minecarts, boats, players, falling blocks, and shulkers
  • Configurable: TNT, items, experience orbs, creepers, withers, and more can be toggled
  • Mod Compatibility: Special handling for Harium, HariPlayer, and HariChunk integration

Fork Information

HariMultiThread is a fork of Async.

Experimental: Parallel entity processing may cause issues with some mods. Test thoroughly.

Credits & Support

Original Async created and maintained by the community.

HariMultiThread maintains the cutting-edge parallel processing improvements.


Join the Community

Get help and updates on our Discord.

JOIN DISCORD

HariMultiThread - Maintained by Hari - High Performance Minecraft