Fixes hostile mobs rendering at stale positions after burst packet loss. ACKs are now exact per-datagram: when a snapshot generation splits across multiple UDP datagrams, receiving one datagram no longer acknowledges entities in a lost sibling. Entity baselines promote only when the exact datagram carrying that entity is acknowledged.

Fix delta encoding cumulative ack advancing when any entity in the batch could not be applied. Prevents stationary mobs from appearing at stale positions after packet loss.

Fix dropped items spinning forever after landing. Exclude EntityItem from delta position encoding, distance-based send frequency throttling, and collision fast-path. Integer quantization in delta encoding introduced sub-pixel Y offsets that broke client-side collision detection. Includes v2 ack-based delta protocol for all other entity types. Automated integration test harness for packet-loss testing.

The AI brain throttle now keeps full-rate AI for tasks whose urgency does not depend on how far away a player is:

• Animals that still need to eat to breed are never throttled, so feeding, breeding, and domestication generation progress are not delayed.
• Land animals escaping water and aquatic creatures stranded on land react immediately.
• Owned pets answer their owner and herd animals stay together at any distance.

Diagnostics: the aithrottle dump now reports feedBypass and safetyBypass counts.

Load-adaptive activation range and AI throttle.

• Activation range shrinks proportionally to tick duration when server exceeds 200ms/tick (floor: 16 blocks)
• AI brain throttle scales DEAR divisor down under server pressure
• Post-save cooldown halves activation range for 3 ticks after autosave
• Servers under heavy load recover in 2-3 ticks instead of staying overloaded for minutes

Config: AdaptiveRangeEnabled (true), AdaptiveRangeMinBlocks (16), AdaptiveRangeThresholdMs (200)

Fixed crafting output desync. The InventoryDirtyScan optimization was skipping dirty slot sync for the crafting grid because vanilla's FindMatchingRecipe() writes to dirtySlots directly without calling MarkSlotDirty(). Players could see the craft output appear briefly then vanish, making items uncraftable until another inventory event triggered the sync.

Added postfix patches on FindMatchingRecipe and ConsumeIngredients to properly signal dirty state.

Fix invisible entities (dropped items, FallingTree) for remote clients when delta encoding is active.

• Client no longer treats relative deltas without a baseline as absolute positions
• Server forces periodic absolute resync for all entities via slot-based stagger
• Entity baselines pruned on despawn to prevent unbounded memory growth

Fix VSVillage compatibility: entities from the vsvillage mod are now excluded from activation range sleeping, AI brain throttle, and repulsion throttle. Their custom pathfinding and AI tasks require full ticking to function.

Also includes translations for 11 missing i18n keys across all 30 languages.

Fixed block tick pooling NullReferenceException that occurred under high time speed or heavy block tick load. Pool reset now guards against overwriting in-flight entries awaiting main thread consumption. Added FluidBlockPos pool for correct fluid block dispatch.

Fix NullReferenceException spam in BlockSoil.OnServerGameTick when Block Tick Pooling is active.

The pooled BlockPos was being passed by reference into BlockPosWithExtraObject, creating a race condition where the position could be overwritten before the main thread consumed it. Additionally, the Activator.CreateInstance path for constructing the wrapper object was fragile with private nested types.

Changes:

• Cache ConstructorInfo at init instead of using Activator.CreateInstance
• Copy position for extra-carrying ticks instead of referencing the pool
• Skip patch entirely if the internal wrapper type can't be resolved

Fixes a client hard-freeze when Synergy clients approach areas with high entity density (10+ traders/NPCs in one spot).

Changes:

• Delta encoding baseline resets are now staggered per-entity across a 1-second window, eliminating the synchronized absolute-packet storm that overloaded the client's main thread
• Added server-side send budget (12 absolute packets per client per tick max) to prevent UDP flooding
• Fixed first-packet baseline storage bug that caused position desync on newly tracked entities

Sleeping entities with AI (taskai behavior) now maintain their running tasks via ProcessRunningTasks, preventing timer corruption in mods like VSVillage that use ElapsedMilliseconds for internal state tracking.

What was fixed:

• Entities beyond 48 blocks no longer have their AI tasks silently corrupted
• VSVillage villagers (and other modded AI entities) stay on-task instead of wandering aimlessly
• Running AI tasks continue executing during entity sleep (ContinueExecute + PathTraverser)
• New task evaluation (StartNewTasks) is still skipped for performance (~90% AI CPU saved)

Compatibility:

• Automatically works with all mods using AiTaskBase subclasses (no config needed)
• Explicitly tested: VSVillage, PrimitiveSurvival, Pet AI

Fix infinite heightmap building loop when used with Farseer mod and no players online.

• Skip whitelisted behavior ticks for sleeping entities when no players are connected
• Prevents chunk freshness from being maintained indefinitely by breathe behavior block reads
• Allows proper chunk unloading that Farseer depends on for ChunkColumnLoaded events

Fix

• Add ActivationRangeExcludedEntities config option (default: ["smoke"])
• Entities matching the exclusion list always get full tick regardless of distance
• Prevents lifecycle-dependent mod entities (Real Smoke) from accumulating when their OnGameTick dissipation logic was being skipped by the activation range optimization
• Configurable: server admins can add other entity codes as needed

Root Cause

Smoke entities rely entirely on OnGameTick for dissipation, merging, and despawn. When Synergy's activation range skipped their tick (>48 blocks from players), smoke could never dissipate — leading to unbounded accumulation (24,000+ entities reported).

Fixed AttributeSyncResyncPrevention causing players to get stuck on mounts (spinning wheels, rafts, etc).

The optimization was converting RemoveAttribute into partial delta updates, but the client's PartialUpdate(path, null) code path does not fire OnModified listeners. This prevented client-side mount state machines (updateMountedState) from reacting to attribute removal.

Fix: only skip RemoveAttribute when the key doesn't exist (no-op removal). When the key exists, vanilla handles it with full resync — required for client listener notification.

What's New

Full diagnostic system for all 15 optimizations:

• /synergy diag all on — enable per-optimization counters
• /synergy diag all dump — see exactly what each optimization saves
• /synergy stats — live metrics (entities, AI throttle %, bandwidth)
• Auto-dump every 5 minutes to server log
• Circuit breaker visibility in /synergy status

Bug fixes:

• Network Flush Consolidation now works on dedicated servers (was patching dead method)
• Delta Encoding bandwidth savings tracked correctly
• Entity counts and delta client metrics wired to stats

Remove GC sustained low latency mode (GcSustainedLowLatencyEnabled). Setting SustainedLowLatency on long-running servers risks unbounded heap growth. GC diagnostics logging remains for admin visibility.

Removed auto-save optimization (caused SQLite transaction crash on chunk thread after server resume). 15 optimizations remain unaffected.

New Server Optimizations

• AI Brain Tick Throttle — DEAR-based distance LOD for AI task evaluation
• Block Tick Pooling — ThreadStatic BlockPos pool, eliminates ~16 MB/s GC pressure
• Auto-Save Optimization — Players written inline (crash-safe), map regions deferred to post-resume. 60-80% freeze reduction with zero player data loss risk.

New Client-Server Features

• Delta Position Encoding — ~50-60% bandwidth reduction for Synergy clients
• Entity Load Budgeting — 5 entities/tick after teleport, eliminates frame spikes
• Unified Metrics — .NET Meters API + /synergy stats command
• Network Handshake — Server-client capability negotiation

Bug Fixes

• Drowning fix — Entities in water get full tick beyond activation range
• Animation fix — Stationary entities with dirty animations no longer skipped
• Thread safety — Atomic circuit breakers on all multi-threaded paths
• Command reload — Config reference now updates correctly
• Login crash fix — Entity load budgeting skips initial login
• 1.22.2 compat — ServerUdpNetwork namespace resolved correctly

 - Removed BlockTickPooling — race condition between producer/consumer threads made it unsafe
 - Rewritten NetworkFlushConsolidation — now truly consolidates packets into single SendAsync (default disabled until validated)
 - Fixed InventoryDirtyScan — patches MarkSlotDirty instead of DidModifyItemSlot, catching all dirty paths (ovens, crafting grids, discard)
 - Fixed TrackingHysteresis — caches sqrt(trackingRangeSq) outside loop, respects TrackedEntitiesPerClient cap (256)
 - Fixed DistanceSendFrequency — per-entity phase throttle eliminates synchronized burst pattern
 - Fixed SpawnPriorityOrdering — reuses sort buffer via [ThreadStatic] to eliminate per-call allocations
 - Added GC heap monitor — prevents unbounded heap growth under SustainedLowLatency (warns at 4GB, background GC at 8GB)
 - Removed dead-code harvestable from EntityActivationRange whitelist

• Fixed inventory sync delay — Berry picking (and other actions using ItemSlot.MarkDirty()) was not triggering the dirty flag in the Inventory Dirty Scan optimization. The single-parameter DidModifyItemSlot(ItemSlot) overload was not patched, causing SendDirtySlots to be skipped until a different code path set the flag. Items now appear in inventory immediately as expected.

Bug

• Fixed rift drifter spawning — Entities beyond activation range were not despawning due to incorrect behavior whitelist entry (despawn vs timeddespawn). This caused entity accumulation that hit the MaxQuantity cap, preventing new drifters from spawning near rifts.

New features

• GC Sustained Low Latency — Eliminates 10-50ms GC pause stutters for the entire server and singleplayer
• GC Diagnostics — Logs GC configuration at startup
• Stationary position suppression — Skip force-update position packets for entities that haven't moved
• IL-emitted delegates — Replace MethodInfo.Invoke with near-native speed DynamicMethod calls
• End-of-tick network flush — Fix inventory interaction lag
• Descriptive log tags — All log messages use readable names

New config options

• GcSustainedLowLatencyEnabled (default: true)
• GcDiagnosticsEnabled (default: true)

• Add GC SustainedLowLatency mode to eliminate GC pause stutters
• Add GC diagnostics logging at startup
• Fix inventory interaction lag: flush network packets at end-of-tick
• Replace reflection hot paths with DynamicMethod IL-emitted delegates
• Replace FieldInfo.GetValue with Harmony FieldRefAccess across 4 files

Fix

• S3 Attribute Sync: Replace reflection-based base method call with Harmony reverse patch to eliminate infinite recursion in SyncedTreeAttribute.RemoveAttribute prefix
• Fixes stack overflow crash when XSkills calls RemoveAttribute during player skill loading (OnLuminiferous)
• Fixes crash when dismounting Immersive Fibercraft spinning wheel or loom (vanilla TryUnmount → RemoveAttribute("mountedOn"))

Safety

• Reverse patch failure guard: S3 skips entirely if the reverse patch cannot be applied (safe fallback to vanilla)
• All existing safety layers preserved: conflict detection, circuit breaker (5 errors → auto-disable), exception catch

New optimization:

• Entity Repulsion Throttle — Reduce O(N²) repulsion for distant entities. 3-8% TPS in dense animal pens.

Fixes:

• CollisionFastPath: never skip collision for players (prevents singleplayer crash)
• SpawnPriorityOrdering: thread-safe client list iteration (Tungsten compatibility)
• DistanceSendFrequency: fix packet type namespaces for VS 1.22

Server Performance (7)

• Entity Activation Range — Skip ticking distant entities (>48 blocks). Whitelisted behaviors still run. Entities in lava/fire always tick. ~10-30% TPS gain.
• Collision Fast-Path — Skip collision for stationary entities. ~5-15% physics CPU saved.
• Network Flush Consolidation — Batch small TCP packets within MTU. ~3-5% CPU with 10+ players.
• Block Tick Pooling — Pool BlockPos in random tick loop. Reduces GC pressure.
• Inventory Dirty Scan — Skip inventory iteration when nothing changed. Volatile dirty flag.
• Pathfinding Node Pooling — Pool A* PathNode objects via transpiler. ~87% allocation reduction.
• Pathfinding Distance Throttle — Reduce pathfinding frequency by distance to players. ~30-60% pathfinding CPU saved.

Multiplayer Fluidity (4)

• Entity Tracking Hysteresis — Buffer zone prevents entity pop-in/pop-out flickering.
• Distance-Based Send Frequency — 15Hz for distant entities (50-128 blocks). 30-40% bandwidth saved.
• Attribute Sync Delta Updates — Delta instead of full resync on RemoveAttribute. Saves 500-2000 bytes/event.
• Entity Spawn Priority Ordering — Nearest entities appear first after teleport/login.

Safety

• Auto-disable on Harmony conflict (200+ mods verified compatible)
• Circuit breaker: 5 errors → auto-disable, fallback to vanilla
• All optimizations individually toggleable via config
• Safe uninstall — no persistent changes to world data