Description
🛡️ Heracles
Technical optimization mod focused on drastically reducing MSPT, alleviating CPU load, and stabilizing memory.

🛠️ Optimization Features
- Crowd Control: Optimization of collision tests and movement events to reduce lag in dense areas (players/entities).
- AI Throttling: Dynamic regulation of CPU load consumed by mob AI.
- Explosion Caching: Caching of explosion calculations to prevent lag spikes during massive destructions.
- Block Entity Stasis: Puts block entities (furnaces, chests, etc.) into sleep mode when out of player range.
- Multi-threading: Offloading of AI calculations and network management onto Virtual Threads.
- Network Management (QoS): Packet prioritization system and rate limiting to prevent bandwidth saturation.
- Async Furnace Ticking: Asynchronous processing of furnace smelting to free up the main loop.
📦 Test Environment (Optimization Modpack)
To prove its relevance, Heracles was tested on NeoForge 1.21.1 within a modpack that already included current optimization standards. Heracles is designed to be layered on top of these mods, offering additional performance gains:
- Rendering Engine & Graphics: Sodium, Iris, Distant Horizons, ImmediatelyFast, EntityCulling, Dynamic FPS, MoreCulling.
- Logic & Memory: Lithium, ModernFix, FerriteCore, Krypton, Create Better FPS.
📊 Spark Profiling (60-Player Test)
The following data was recorded under real conditions using the modpack listed above, with 60 simultaneously connected players and approximately 375 active entities.
| Metric | With Base Modpack | With Modpack + Heracles | Gain Provided by Heracles |
|---|---|---|---|
| TPS | 20.00 | 20.00 | Stable |
| MSPT (Median) | 34.5 ms | 21.3 ms | -38% server load |
| MSPT (Max Peak) | 167 ms | 122 ms |


