Shuttlecore

Shuttlecore

Adaptive multithreaded region balancing for Paper and Folia servers.

Shuttlecore reworks how your server distributes work across CPU cores. Instead of relying on fixed-size world regions that stay put once assigned, Shuttlecore continuously watches how much work each region of your world is actually generating; tick time, entity count, tile entity load, player density, and shuttles that load around in real time: splitting overloaded regions apart, merging quiet ones back together, and reassigning regions across threads so no single core becomes the bottleneck while others sit idle.

Most region-based threading keeps its boundaries relatively static once set. Shuttlecore treats region placement as a moving target, rebalancing on a rolling interval with hysteresis built in so it settles rather than thrashes. a farm district that suddenly fills up with players and redstone gets split and spread out; a corner of the map that empties out gets folded back in and freed up for somewhere else that needs it.

What it does:

Continuously profiles per-region tick time, entity load, and player count Dynamically splits overloaded regions and merges underloaded ones Rebalances region-to-thread assignment to even out load across all available cores Ships a live/threadload dashboard so you can see per-thread and per-region tick times, not just guess Includes a built-in stress-test/benchmark mode to measure real before/after performance

Compatibility:

Plugins that aren't thread-region-aware are automatically pinned to a dedicated single-threaded region so they keep working safely rather than causing corruption or crashes.

⚠️ Server-side only. Requires Paper or Folia. No client mod, and no singleplayer or LAN-world support — Shuttlecore is built exclusively for dedicated multiplayer servers where there's actually load to balance.