Low Desync Framework (A OOS Cleanup)

This mod is an always-on relationship integrity system for Crusader Kings III.

It automatically monitors and fixes relationship-state inconsistencies that can lead to bugs or multiplayer desyncs (OOS).
There are no settings or modes—just enable it and it works in the background.

The mod actively checks for multiple types of relationship issues, including:

Living characters betrothed or married to dead characters

Dead characters still marked as married or betrothed

One-sided relationships (only one character recognizes the relationship)

This goes beyond simple cleanup—it tracks relationship divergence, not just leftover broken links.

When a problem is detected, the mod runs a deterministic, multi-step cleanup pipeline:

Initial cleanup on the affected character

Checks direct relationships (spouse / betrothed)

Runs another stabilization pass

Final retry if issues remain

During this process, it will:

Break invalid betrothals

End invalid marriages

Remove stale relationship links from dead characters

Fix mismatched relationship flags

All actions are safe, controlled, and consistent across all players, making it suitable for multiplayer.

The mod triggers during high-risk game events, including:

Death

War start

Imprisonment and release

Title gain

Marriage and divorce

Birth and adulthood

Court and council changes

It also runs daily, monthly, and yearly checks, but only when needed to minimize performance impact.

Includes detailed internal logging (LD_TAG diagnostics) to help identify:

What triggered the cleanup

What type of issue was found

How it was resolved

This is especially useful for tracking multiplayer desync causes.

Due to engine limitations, this mod cannot:

X Fix CK3 engine-level bugs

X Resolve network or connection-related desyncs

X Modify core systems like combat, travel, or title mechanics

X Guarantee zero OOS in every campaign

X Force identical mod/DLC setups between players

This mod is a highly aggressive relationship-state sanitizer designed to eliminate one of the most common sources of script-level desync.

✔ Fixes broken marriages and betrothals
✔ Cleans up inconsistent relationship data
✔ Improves multiplayer stability
✔ Runs automatically with minimal overhead

If desyncs still occur after using this mod, the cause is most likely outside what scripting can directly fix (engine, network, or other systems).