Skip to content

Mod Compatibility

Zaldaryon edited this page Jun 17, 2026 · 4 revisions

Mod Compatibility

Synergy v1.0.0 has been tested against the 200 most popular mods on the Vintage Story ModDB (120+ decompiled, all Harmony patches cross-referenced). All patches include automatic conflict detection. If another mod patches the same method, Synergy auto-disables that specific optimization and logs a warning.

Known Conflicts (auto-handled)

These mods patch the same vanilla methods as Synergy. No action needed. Synergy detects them and auto-disables the conflicting optimization.

Mod Downloads Conflict Synergy Action Tested Version
Scaffolding 61K CollisionTester.ApplyTerrainCollision (transpiler) Collision Fast-Path disabled latest
Tungsten 6K TickEntities (transpiler) Entity Activation Range disabled 1.3.0
Tungsten 6K SendTrackedEntitiesStateChanges (transpiler) Spawn Priority Ordering coexists (prefix + transpiler) 1.3.0
Overhaullib (Combat Overhaul) 644K InventoryBase.DidModifyItemSlot (transpiler, exception path) Inventory Dirty Scan postfix coexists safely 0.16.16

Tested Compatible (no conflicts)

These mods were decompiled and their Harmony patches cross-referenced against all 11 Synergy patch targets. Zero conflicts found.

Top mods with Harmony patches (no overlap)

Mod Downloads Harmony Targets Conflict?
Combat Overhaul 644K 30+ patches (combat, rendering, animation) ❌ None
XSkills 407K 80+ patches (farming, cooking, smithing, combat) ✅ Tested (v1.1.1)
Immersive Fibercraft 45K Mountable seats (spinning wheel, loom) ✅ Tested (v1.1.1)
Carry On 780K EntitySeat.onControls ❌ None
Primitive Survival 805K 1 patch (block methods) ❌ None
Pet AI 408K Entity grow/multiply/nametag behaviors ❌ None
VSVillage 53K Custom AI tasks (villager work/pathfinding) ✅ Compatible (v1.1.17, entities excluded from throttles)
Hydrate or Diedrate 171K 25+ patches (food, thirst, temperature) ❌ None
Toolsmith 135K 11 patches (CollectibleObject methods) ❌ None
Rivers 299K 10 patches (worldgen, chunk tesselation, water physics) ❌ None
Smithing Plus 269K 20+ patches (anvil, smithing methods) ❌ None
Dana Tweaks 118K 12 patches (gameplay QoL) ❌ None
A Culinary Artillery 572K 17 patches (cooking, food containers) ❌ None
Extra Info 142K 16 patches (info display) ❌ None
Butchering 435K Harvestable behavior (postfix) ❌ None
From Golden Combs 418K 1 patch (hive management) ❌ None
ProspectTogether 319K OreMapLayer (client-side) ❌ None
Auto Map Markers 229K Interaction handlers ❌ None
Wild Farming Revival 282K TreeGen, Block.GetPlacedBlockInfo ❌ None
Rubberbandaid 77K SyncedTreeAttribute.MarkPathDirty (different method than Synergy's AttributeSync) ❌ None
Player Model Lib 284K 10 patches (rendering, character) ❌ None
Knapster 206K Knapping/clayforming UI ❌ None

Top mods without Harmony (zero conflict risk)

Mod Downloads Type
BetterRuins 878K Content (worldgen)
QP's Chisel Tools 604K API-only
Expanded Foods 584K Content-only (no DLL)
Firearms 509K Uses OverhaulLib
ConfigLib 484K Library
Player Corpse 459K API-only
Stone Quarry 439K API-only
Food Shelves 424K Content
Animal Cages 362K API-only
Wolf Taming 304K Uses PetAI
Farseer 147K Own renderer
All Fauna packs 60K-115K each Content-only

How Conflict Detection Works

Before applying each Harmony patch, Synergy calls Harmony.GetPatchInfo() to check if any other mod has already patched the same method. If a foreign transpiler or prefix is found, Synergy auto-disables that optimization and logs a warning:

[Synergy] Skipping patch on TickEntities: transpiler conflict with: com.zaldaryon.tungsten

This means Synergy is compatible with any mod, even ones not listed here. If a future mod patches the same method, Synergy will detect it and yield gracefully.

Reporting Compatibility Issues

If you encounter a crash or conflict with a mod not listed here, please report it with:

  • The mod name and version
  • Your server-main.log (look for [Synergy] entries)
  • Steps to reproduce

Clone this wiki locally