OmniSync synchronizes core player profile data across backend servers using Redis.
It is built for modern proxy networks where player transfers must wait for safe data
handoff instead of racing between servers.
What OmniSync Provides
- Redis locks to protect profile saves during transfers.
- Velocity transfer guard to delay backend switches while a lock is active.
- Limbo queue to hold joining players until their data can be applied safely.
- Dirty flag protection to stop stale session overwrites after crashes.
- Folia-safe player application through entity scheduler calls.
- Admin recovery commands for force saves, unlocks, cleanup, and status checks.
Synced Data
OmniSync can synchronize:
- Inventory storage contents
- Armor and offhand
- Ender chest
- Health, hunger, saturation, and exhaustion
- Experience level, progress, and total experience
- Flight state and fly speed
- Absorption hearts
- Fire ticks and remaining air
- Optional game mode
Not Included
OmniSync does not sync economy, location, advancements, statistics, permissions,
or chat data in the current release.
BungeeCord is not supported in this release. Use Velocity for proxy transfer
protection.
Architecture
OmniSync has two jars:
- Paper/Folia backend plugin: captures and applies player profile data.
- Velocity proxy plugin: delays server transfers while Redis locks are active.
Both components must use the same Redis URI and redis-key-prefix for one network. 