A lightweight multiserver player data synchronization plugin using **MariaDB/MySQL**.

## 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** - **Stupidly fast** data synchronization ## Supported Modules - Inventory - Ender Chest - Health and Food - Experience - Potion Effects - Fire Ticks - Game Mode ## Commands ![Usage commands](https://cdn.modrinth.com/data/cached_images/874f9bad5e3aea0c34686e74e95835494ab1874c.png) ## Permissions - **playerdatabridge.admin** » Allows using /pdb commands ## Installation 1. Download the plugin file. 2. Drop the JAR file into your server's /plugins folder and (re)start the server. 3. Open config.yml and enter your MariaDB/MySQL database credentials. 4. Restart the server once more. 5. 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 ``` # This is the default config file for PlayerDataBridge. # This config was generated for version 1.0. # 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: "Configuration successfully reloaded." check-version: "You are running version ()." kick-error: "An error occurred while loading your player data. Please try reconnecting." ```