✨ ChaPlayerDataBridge ✅ | Sync Inventories | MySQL

A cross-server player data synchronization plugin using MySQL. Syncs inventory, armor, enderchest, experience, potion effects, health, hunger, air level, game mode, location, bed spawn, and economy (via Vault). Features async database operations, configurable sync options, combat tag protection, and API with events for third-party integration.

REQUIREMENTS:
✅️ Java 8 or higher (Java 17+ recommended for newer MC versions)
✅️ A Spigot/Paper based server (1.13+)
✅️ A MySQL or MariaDB database (SQLite is supported as a fallback but not recommended for cross-server sync)

FEATURES:
✅️ Cross-Server Player Data Synchronization - Syncs player data across multiple servers using MySQL/SQLite database

✅️ Automatic Fallback - Falls back to SQLite if MySQL connection fails

✅️ Comprehensive Data Syncing:

• Inventory, armor, offhand, ender chest

• Experience levels and XP

• Health, max health, food, saturation, air

• Potion effects

• Gamemode

• Location and bed spawn points

• Economy (via Vault)

• Selected hotbar slot

• Statistics (local and global)

• Advancements

Combat Tag System - Prevents players from logging out during combat (configurable duration)

Auto-Save - Periodic automatic data saving (configurable interval)

Load Delay - Prevents data conflicts with configurable delay after loading

New Player Commands - Execute commands for first-time players

World Blacklist - Disable syncing in specific worlds

Database Maintenance - Auto-cleanup of inactive players (configurable days)

PLUGIN INTEGRATION:
Essentials Support:

• Homes, money, nickname

• Mute/jail status with timeouts

• God mode and flying state

CMI Support:

• Homes, money, nickname

• God mode, flying, vanish

• Playtime tracking

• Mute/jail status

SHOWCASE

CONFIG.YML

database:
host: localhost
port: 3306
database: minecraft
username: root
password: password
pool-size: 10
connection-timeout: 30000

sync:
inventory: true
armor: true
offhand: true
enderchest: true
experience: true
potion-effects: true
health: true
food: true
air: true
gamemode: true
location: false
bed-spawn: false
economy: true
selected-slot: true

statistics-local: false
statistics-global: false
advancements: false
luckperms-permissions: false

commands:
enabled: false
list:
- "spawn"
- "home"
- "warp"

essentials:
homes: true
money: true
nickname: true
mute: true
jail: true
god-mode: true
flying: true

cmi:
homes: true
money: true
nickname: true
god-mode: true
flying: true
vanish: true
playtime: true
mute: true
jail: true

settings:
save-on-death: true
save-interval: 300
load-delay: 20
combat-tag-duration: 10
debug: false

new-player-commands:
enabled: false
commands:
- "give %player% minecraft:bread 16"

disabled-worlds:
- "example_world"

maintenance:
enabled: false
inactive-days: 90
run-on-startup: false

PERMISSIONS:

• pdb.* - All permissions (default: op)
• pdb.admin - Admin commands
• pdb.info - View own data info
• pdb.info.others - View other players' data
• pdb.sync - Sync own data
• pdb.sync.others - Sync other players' data
• pdb.export - Export player data
• pdb.import - Import player data
• pdb.purge - Purge player data
• pdb.backup - Backup database
• pdb.restore - Restore player data
• pdb.setup - Database configuration
• pdb.bypass.combattag - Bypass combat tag restrictions

COMMANDS:

• /pdb - Main admin command

• /pdbinfo - View player data info

• /pdbsync - Force sync player data

• /pdbexport - Export data to file

• /pdbimport - Import data from file

• /pdbpurge - Purge player data

• /pdbbackup - Create database backup

• /pdbrestore - Restore player data

• /pdbsetup - Database configuration GUI