Skip to main content

​
Backend Config

Backend config is generated at: 
plugins/OmniSync/config.yml
Default structure: 
redis-uri: "redis://localhost:6379"
redis-key-prefix: "omnisync"
server-name: "OmniServer-1"
license-key: "YOUR_KEY_HERE"

data-ttl-days: 7
limbo-timeout-seconds: 10

sync:
  inventory: true
  enderchest: true
  armor: true
  offhand: true
  hunger: true
  health: true
  experience: true
  flight: true
  absorption: true
  environment-state: true
  game-mode: false

experimental:
  native-serialization: false

​
Redis Settings

  • redis-uri: Redis connection URI.
  • redis-key-prefix: Prefix for OmniSync keys. Must match across one network.
  • server-name: Unique backend identity used for dirty-session ownership.
Examples: 
redis-uri: "redis://:password@10.0.0.5:6379/0"
redis-key-prefix: "network:survival"
server-name: "survival-1"

​
Safety Settings

  • data-ttl-days: Number of days Redis profile hashes are retained.
  • limbo-timeout-seconds: Maximum time a player can wait in lock/quarantine limbo.

​
Sync Field Toggles

Disable fields your network manages per server. Common examples: 
sync:
  inventory: true
  experience: true
  health: true
  flight: true
  game-mode: false
game-mode is disabled by default because most networks manage game modes per server or per game.

​
Messages

Messages use MiniMessage formatting: 
messages:
  prefix: "<gray>[<gradient:#00ff00:#00aa00>OmniSync</gradient>] <reset>"
  sync_success: "<gradient:#00ff00:#00aa00>Profile synchronized successfully.</gradient>"

​
Velocity Config

Velocity config is generated at: 
plugins/omnisync/config.properties
Example: 
redis-uri=redis://localhost:6379
redis-key-prefix=omnisync
license-key=YOUR_KEY_HERE
The Velocity Redis settings must match the backend servers.