CrossOverSync

GitHub Description (Short)
Synchronizes player inventory, stats, and optional position across Paper servers via MySQL.

Overview

CrossOverSync stores and loads player data from MySQL and shares it between servers.
Server identity is resolved via the plugin messaging channel bungeecord:main (Velocity/Bungee GetServer).

Features

• Inventory, enderchest, armor, effects, XP, health/food
• Optional position sync on selected servers
• Async MySQL writes with retry and queue
• In‑memory cache with TTL
• Health checks with admin notifications

Projects in This Repo

• Main project: src/ (CrossOverSync)
• Separate Paper plugin: paper-plugin/ (CrossOverSyncPaper)

Requirements

• Paper 1.21.x (API: 1.21.11-R0.1-SNAPSHOT)
• MySQL/MariaDB
• Proxy with GetServer support (Velocity/Bungee)

Build

Main project:

mvn -DskipTests package

Separate Paper plugin:

cd paper-plugin
mvn -DskipTests package

Installation

1. Place the JAR into the Paper server plugins/ folder.
2. Start the server once, edit config.yml.
3. Restart the server.

Configuration (Excerpt)

File: src/main/resources/config.yml or paper-plugin/src/main/resources/config.yml

• mysql.host / port / database / username / password
• sync.serverNames: servers where data is actively saved
• sync.positionServerNames: servers allowed to set player positions
• sync.saveQueue.enabled: queue‑based saving
• sync.cache.enabled: enable cache
• sync.healthCheck.*: health checks and notifications

Note About Server Names

The plugin queries the server name via the proxy channel bungeecord:main with GetServer.
Make sure your proxy returns the correct server name and allows the channel.