About Synergy
From Vintage Story ModDBCoordinated client-server performance optimizations, specially for modded gameplays
Coordinated server-side performance and fluidity optimizations for Vintage Story. Reduces TPS overhead, bandwidth, and GC pressure while improving multiplayer smoothness.
Works as server-only or with both client+server installed. Clients are not required - but installing on both enables delta position encoding (~70% bandwidth reduction). Compatible with Tungsten and OptiTime.
All 15 optimizations are individually toggleable. Runtime circuit breaker with auto-fallback to vanilla on any error.
Optimizations
Server-Side Performance (9)
- Entity Activation Range - Skip ticking entities beyond 48 blocks of any player (whitelisted behaviors still tick)
- Collision Fast-Path - Skip collision resolution for stationary entities with zero motion
- Network Flush Consolidation - Batch small TCP packets into fewer SendAsync calls per tick
- Block Tick Pooling - Pool 512 BlockPos objects per thread in random tick loop
- Inventory Dirty Scan - Skip full inventory iteration when nothing has been modified
- Pathfinding Node Pooling - Pool 4096 PathNode objects per thread (transpiler, zero heap allocs)
- Pathfinding Distance Throttle - Reduce pathfinding frequency based on distance to player
- Repulse Agents Throttle - Throttle O(N²) repulsion checks for distant entities
- AI Brain Tick Throttle - Distance-based AI evaluation LOD (DEAR formula)
Server-Client Fluidity (6)
- Entity Tracking Hysteresis - Speed-proportional buffer zone prevents entity pop-in flickering
- Distance-Based Send Frequency - 15Hz for distant entities, stationary suppression
- Attribute Sync No-Op Skip - Skip unnecessary full tree resyncs on no-op RemoveAttribute calls
- Entity Spawn Priority Ordering - Nearest entities appear first after teleport/login
- Entity Load Budgeting - Eliminate login/teleport frame spikes (5 entities/tick budget)
- Delta Position Encoding - Varint/zigzag delta encoding (~70% bandwidth reduction with Synergy client)
Built-in Diagnostics
Per-optimization measurement framework. See exactly how much each optimization saves:
/synergy diag all on- enable counters (auto-dumps every 5 min to server log)/synergy diag all dump- print stats immediately/synergy stats- live metrics (entities, AI throttle %, bandwidth saved)
Real measurements from a dedicated server session (~2 min, 1 player, ~234 entities):
<table style="border-collapse: collapse; width: 60%;" border="1"> <tbody> <tr> <th>Optimization</th> <th>Metric</th> <th>Result</th> </tr> <tr> <td>Entity Activation Range</td> <td>Entities sleeping</td> <td>68% of ticks saved</td> </tr> <tr> <td>AI Brain Throttle</td> <td>StartNewTasks skipped</td> <td>62% CPU saved</td> </tr> <tr> <td>Network Flush</td> <td>Packets consolidated</td> <td>80% (1263 buffered, 302 passthrough)</td> </tr> <tr> <td>Delta Encoding</td> <td>Bandwidth reduction</td> <td>70% (~56 KB/s saved)</td> </tr> <tr> <td>Repulse Throttle</td> <td>O(N²) checks skipped</td> <td>69% at distance</td> </tr> <tr> <td>Send Frequency</td> <td>Position packets saved</td> <td>29% bandwidth</td> </tr> <tr> <td>Tracking Hysteresis</td> <td>Flicker prevented</td> <td>96% of boundary entities kept</td> </tr> <tr> <td>Pathfinding Pool</td> <td>Heap allocations</td> <td>100% reuse (3352 nodes pooled)</td> </tr> <tr> <td>Inventory Scan</td> <td>Scans skipped</td> <td>100% while idle</td> </tr> <tr> <td>Block Tick Pool</td> <td>Heap allocations</td> <td>100% reuse</td> </tr> </tbody> </table>Combined: ~68% entity tick reduction, ~70% position bandwidth reduction, 80% TCP syscall reduction, 100% pathfinding GC elimination.
Safety
- Circuit breaker: each optimization auto-disables after 5 errors, falls back to vanilla
- Conflict detection: checks Harmony.GetPatchInfo() before patching - skips if another mod is there
- Graceful degradation: all prefixes return true (run vanilla) on any unexpected exception
- No client-side requirement: works with vanilla clients (delta encoding is optional enhancement)
Commands
/synergy- show optimization status + circuit breaker health/synergy stats- live metrics (entities, AI throttle, bandwidth)/synergy all on|off- toggle all optimizations (restart required)/synergy <opt> on|off- toggle individual optimization/synergy reload- reload config from disk/synergy diag [all|<module>] [on|off|dump|reset]- per-optimization diagnostics
Compatibility
Compatible with most mods. Harmony conflicts are auto-detected - Synergy skips its patch when another mod already patches the same method. Verified compatible with Tungsten, OptiTime, and 200+ content mods.
License
Copyright (c) 2026 Zaldaryon - All Rights Reserved
Synergy - Coordinated optimizations so your server runs smoother.
Highlights
From source dataGame versions
Built for Vintage Story 1.22.0.
Footprint
Rated a light load on a server.
Synergy on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Vintage Story servers. We download it from Vintage Story ModDB, place it, and restart the server.
- Server side
- Required on the server
- Server load
- light
- Smallest plan we suggest
- Vintage Story — 1 GB (1 GB RAM). This follows our own load rating above, not a benchmark.
Run Synergy on a Vintage Story server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogQuality of life & UI
Small conveniences, tweaks and interface improvements players notice straight away.
Runs on your server
From source side supportVintage Story ModDB lists Synergy as required on the server. Check its Vintage Story ModDB page to see whether players need it too.
Compatibility
- Game
- Vintage Story
- Runs on
- Serverrequired on the server
- Game versions
- 1.22.0
Verified at the source
- ✓Vintage Story ModDBOfficial listing, checked 2026-09-24Open ↗
- ✓AuthorZaldaryon, as published on Vintage Story ModDB
- ✓LicenseNot published by the sourceFree













