A lightweight multiserver player data synchronization plugin using
MariaDB/MySQL.
Features
Supported Modules
Commands
Permissions
Installation
Support
If you have any questions, suggestions, or found a bug, feel free to reach out on Discord or open an issue on GitHub!
Config
Features
- Data-lock mechanism to make data transfers secure and avoid item-duplication
- Modular design: Only sync the player data you need
- Fully customizable via config.yml
- Configurable Auto-saving
- Manage player data offline via GUI
- Stupidly fast data synchronization
Supported Modules
- Inventory
- Ender Chest
- Health and Food
- Experience
- Potion Effects
- Fire Ticks
- Game Mode
Commands
Permissions
- playerdatabridge.admin » Allows using /pdb commands
Installation
- Download the plugin file.
- Drop the JAR file into your server's /plugins folder and (re)start the server.
- Open config.yml and enter your MariaDB/MySQL database credentials.
- Restart the server once more.
- Done!
Support
If you have any questions, suggestions, or found a bug, feel free to reach out on Discord or open an issue on GitHub!
Config
Code (Text):
# This is the default config file for PlayerDataBridge.
# This config was generated for version 1.1.
# Configure database constants.
database:
host: "127.0.0.1"
port: 3306
database: "playerdatabridge"
username: "root"
password: ""
# HikariCP maximum pool size. If you do not know what this does, just ignore it.
max-pool-size: 10
# Enable/disable individual modules to sync.
# IMPORTANT: Disabled modules still save to the database but won't apply in-game. Keep module states identical across all servers to prevent data corruption.
modules:
inventory: true
ender-chest: true
health-and-food: true
experience: true
potion-effects: true
fire-ticks: true
game-mode: true
# Auto-saving interval in seconds. Use '-1' to disable auto-saving.
auto-save-interval-seconds: 300
# Data lock to prevent race-conditions. Defaults should be fine in most cases.
data-lock:
# Maximum number of times to retry reading from the database.
max-retry-attempts: 3
# Time to wait between retries in ms.
retry-interval-ms: 100
# Time until lock remains valid before it expires to prevent permanent lockouts.
expiration-threshold-seconds: 15
# Fully configurable messages supporting minecraft color constants and hex colors.
# https://docs.papermc.io/adventure/minimessage/format/
messages:
reload-config: "<green>Configuration successfully reloaded.</green>"
check-version: "<gray>You are running version <white><version></white> (<white><server_version></white>).</gray>"
kick-error: "<red>An error occurred while loading your player data. Please try reconnecting.</red>"
player-only-command-error: "<red>Only players can use this command.</red>"
player-currently-online-error: "<red>Player <white><player></white> is currently online.</red>"
player-not-found-error: "<red>Player <white><player></white> does not exist.</red>"
no-data-found-error: "<red>No player data found for <white><player></white>.</red>"
# This config was generated for version 1.1.
# Configure database constants.
database:
host: "127.0.0.1"
port: 3306
database: "playerdatabridge"
username: "root"
password: ""
# HikariCP maximum pool size. If you do not know what this does, just ignore it.
max-pool-size: 10
# Enable/disable individual modules to sync.
# IMPORTANT: Disabled modules still save to the database but won't apply in-game. Keep module states identical across all servers to prevent data corruption.
modules:
inventory: true
ender-chest: true
health-and-food: true
experience: true
potion-effects: true
fire-ticks: true
game-mode: true
# Auto-saving interval in seconds. Use '-1' to disable auto-saving.
auto-save-interval-seconds: 300
# Data lock to prevent race-conditions. Defaults should be fine in most cases.
data-lock:
# Maximum number of times to retry reading from the database.
max-retry-attempts: 3
# Time to wait between retries in ms.
retry-interval-ms: 100
# Time until lock remains valid before it expires to prevent permanent lockouts.
expiration-threshold-seconds: 15
# Fully configurable messages supporting minecraft color constants and hex colors.
# https://docs.papermc.io/adventure/minimessage/format/
messages:
reload-config: "<green>Configuration successfully reloaded.</green>"
check-version: "<gray>You are running version <white><version></white> (<white><server_version></white>).</gray>"
kick-error: "<red>An error occurred while loading your player data. Please try reconnecting.</red>"
player-only-command-error: "<red>Only players can use this command.</red>"
player-currently-online-error: "<red>Player <white><player></white> is currently online.</red>"
player-not-found-error: "<red>Player <white><player></white> does not exist.</red>"
no-data-found-error: "<red>No player data found for <white><player></white>.</red>"
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 26.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
! is a free Minecraft Java mod. Compatible with Minecraft 26.2. Downloaded 11 times (via Spigot). Download it and open it directly in the game.