Home

Synergy

Coordinated server-side performance and fluidity optimizations for Vintage Story. Reduces TPS overhead, bandwidth usage, and GC pressure while improving multiplayer smoothness.

Current version: v1.1.24 | Vintage Story 1.22.0+

What it does

• Entity activation range (skip ticking distant entities)
• Collision fast-path (skip collision for stationary entities)
• Network flush consolidation (batch TCP packets, end-of-tick flush)
• Block tick pooling and pathfinding node pooling (GC reduction)
• Inventory dirty scan (skip iteration when nothing changed)
• Pathfinding distance throttle and entity repulsion throttle
• AI brain tick throttle (distance-based AI evaluation LOD)
• Entity tracking hysteresis (prevent pop-in/pop-out flickering)
• Distance-based send frequency (15Hz for distant entities)
• Attribute sync delta updates and entity spawn priority ordering
• Delta position encoding (varint/zigzag, ~50-60% bandwidth reduction)
• Entity load budgeting (eliminate login/teleport frame spikes)
• GC diagnostics (logs heap/fragmentation info at startup)
• Per-optimization diagnostic system with auto-dump and circuit breaker visibility

15 optimizations + 1 runtime tuning feature, all individually toggleable. Auto-disables on Harmony conflict. Admin command: /synergy

Pages

• Usage Guide: Installation, commands, configuration, and troubleshooting
• How It Works: What Synergy does under the hood
• Mod Compatibility: 200+ mods tested, known conflicts, detection system

Related mods

• OptiTime: Client-side performance optimizations
• Tungsten: Server-side allocation reduction