Vladance - BeltBalancer Imp (Factorio 2.0 Space Age)

A complete from-the-ground-up overhaul of the legendary dynamic belt balancer mod, built exclusively for extreme throughput and zero-UPS-impact in Factorio 2.0!

The Space Age Overhaul

The entire Lua backend math engine has been gutted and rewritten. Say goodbye to the massive RAM leaks and $O(N*M)$ stuttering loops of older balancer mods. This engine processes belts natively in $O(1)$ batch time, allowing you to seamlessly weave 240+ items/sec through Turbo Belts and heavily modded high-speed belts without dropping a single frame.

New Routing Mechanics

You can now configure complex logic for every single output lane independently using the native routing GUI:

• Fractional Ratios: Instead of simple splitters, you can route exact N:M fractions across your factory lines using custom Weight sliders!
• Quality Filtering: Siphon off Normal, Uncommon, Rare, Epic, or Legendary items exclusively to dedicated output lanes!
• Gleba Spoilage Routing: Force the balancer to act as an automated trash-sorter by dumping compost (items >90% spoiled) directly onto specified priority trash lanes!
• Belt Stack Preservation: Items keep their stack height when passing through the balancer, no more unstacking on Space Age stacked belts.
• Live Belt Labels: While the routing GUI is open, connected belts show In-N / Out-N labels in-world so you can match lanes to settings.
• Copy / Paste Settings: Copy a balancer’s routing config and paste it onto another network in one click.

Advanced Performance & UPS Optimizations

Engineered from the ground up for massive, high-throughput megabases:

• Advanced Sleep-Throttling (UPS Savior): Idle or backed-up balancers automatically enter a low-frequency sleep cycle (running once every 10 ticks), reducing CPU overhead by 90%. Can be toggled on/off at runtime via map settings!
• Zero GC Table-Pooling: The core Lua engine recycles item stack tables using an internal pool. All properties are scrubbed on release to prevent logic leaks, dramatically reducing Lua allocations and GC pressure.
• Space-Age Quality Bypass: Automatically detects if the Space-Age expansion is disabled to completely bypass quality prototype lookups and C++/Lua crossings, maximizing UPS for vanilla players.
• GCD Tick Scaling: Balancer tick rates dynamically scale to the Greatest Common Divisor (GCD) of all connected output belt speeds, avoiding unnecessary execution ticks.
• Cached Hot-Paths: Key properties (lane counts, quality filters, spoilage checks) are cached and pre-computed to eliminate loop scanning and table lookups inside the active tick loop.
• Speed-Aware Buffers: Internal buffers scale automatically to connected belt speeds, including modded megabelts.

How to Use

1. Place the Balancer entity down and connect belts to the inputs and outputs.
2. Shift + Left Click on the Balancer to open the Advanced Routing Configuration GUI.
3. Check the (Priority) boxes to force the balancer to drain specific inputs first, or feed specific outputs first.
4. Adjust the Weight Ratios and Quality Filters to perfectly tune your output logistics.

Compatibility

Fully compatible with Space Age, all modern modded loaders, and complex multi-belt weaves. Existing saves using this mod upgrade cleanly on load. (Not compatible with older Belt Balancer mod entities, this mod replaces them as a standalone rewrite.)

Special Thanks & Credits

While we have completely gutted and rewritten the core math engine to support Factorio 2.0 and eliminate UPS bottlenecks, this project was built standing on the shoulders of giants. A massive thank you to NightPablo, Soundwave, and the authors of previous iterations of the Belt Balancer mods. Their original scaffolding and entity tracking made this massive overhaul possible!