Seamless Multi-Server Inventory Sync with MySQL Inventory Bridge
Running a Minecraft network with multiple servers often means players need to move between worlds without losing their hard-earned gear. The MySQL Inventory Bridge plugin solves this elegantly by storing player inventories, armor, and much more in a central MySQL database, then loading that data whenever a player joins any linked server. Whether you operate a survival hub, minigame lobby, or a sprawling RPG network, this lightweight tool keeps everything consistent and frustration-free.
What Makes This Plugin Stand Out
Unlike many sync solutions that rely on file-based storage or complex proxy setups, MySQL Inventory Bridge focuses on simplicity and reliability. It uses direct database queries on join and leave events, ensuring minimal performance overhead. The plugin supports both premium and offline UUIDs, so cracked servers are fully compatible. Best of all, it handles modded items seamlessly, which is a rare find in free inventory sync tools.
Core Features at a Glance
- Full inventory synchronization across all connected servers.
- Armor syncing (can be disabled in the config if you prefer to keep armor separate).
- Modded item support via ProtocolLib, preserving custom NBT data and textures.
- Automatic database maintenance that cleans up inactive user records to keep your database lean.
- Premium and offline UUID support — no player is left behind.
- No commands or permissions to manage; it just works silently in the background.
How the Sync Process Works
The magic happens through two simple events. When a player disconnects from a server, the plugin immediately uploads their entire inventory and armor set to the MySQL database. The next time that player connects to any server running the plugin, it checks the database for their UUID, downloads the stored data, and applies it before the player even finishes loading. This means you can hop from a creative building world to a hardcore survival map and still have the exact same sword, pickaxe, and enchanted boots you left with. No more chests full of duplicated items or lost progress.
Because the plugin uses a MySQL database, the sync is nearly instant and can handle hundreds of players across dozens of servers without breaking a sweat. The database maintenance task also runs periodically to remove entries for players who haven't logged in for a configurable amount of time, preventing bloat.
Setting Up MySQL Inventory Bridge
Installation is straightforward and takes only a few minutes. Follow these steps to get your cross-server inventory sharing operational:
- Place the plugin JAR file into your server’s
pluginsfolder. - Start the server once to generate the default configuration file, then stop it.
- Open the
config.ymlfile and enter your MySQL database credentials (host, port, database name, username, password). - Create the database manually if it doesn’t exist; the plugin will automatically create the required tables on next launch.
- Start the server again. The plugin will connect to the database and begin syncing inventories immediately.
That’s all there is to it. There are no in-game commands to learn, no permission nodes to assign. The plugin operates entirely behind the scenes.
Dependencies You Should Know
The only hard requirement is a MySQL database — MariaDB works just as well. If you plan to use modded items (items from mods like Tinkers’ Construct, Twilight Forest, or custom plugin items with complex NBT), you’ll need ProtocolLib installed on each server. Download ProtocolLib separately (search for it on SpigotMC or Bukkit) and place it in your plugins folder. Without ProtocolLib, the plugin still syncs vanilla items perfectly, but modded items may lose their custom data upon transfer.
For those running modded servers, managing plugins like MySQL Inventory Bridge is a breeze, especially when you can easily install related mods via the foxygame.net launcher — a convenient, flexible, and modern Minecraft launcher where you can download mods right from the menu. This launcher streamlines the client-side experience so your players can jump into your network without hassle.
Expanding Beyond Inventories
While MySQL Inventory Bridge focuses on inventory and armor, its developer, CraftersLand, also offers a companion tool called MySQL Player Data Bridge. That extended plugin can synchronize economy balances, ender chest contents, health, active potion effects, experience levels, and more. If you find yourself needing deeper data sharing across your network, upgrading to the full data bridge is a natural next step. Both plugins share the same reliable database backbone and UUID handling.
Why Choose MySQL Inventory Bridge Over Alternatives
Many multi-server inventory solutions rely on BungeeCord or Velocity proxy plugins, which can introduce latency or require complex channel setups. This plugin bypasses the proxy entirely, talking directly to the database. That means it works even if your servers are on different physical machines or hosted in different locations, as long as they can reach the same MySQL server. The lightweight design also means you won’t see TPS drops during peak hours — the plugin only performs database operations on join and leave, never during active gameplay.
Another advantage is the built-in maintenance task. Over time, player databases can accumulate entries from users who tried the server once and never returned. MySQL Inventory Bridge automatically prunes these stale records based on your configured inactivity threshold, keeping the database fast and your storage costs low.
Final Thoughts
MySQL Inventory Bridge delivers exactly what it promises: a simple, no-fuss way to share player inventories and armor across an unlimited number of Minecraft servers. Its support for both online and offline modes, modded items, and automatic cleanup makes it a versatile choice for network owners of all sizes. The setup is minimal, the performance impact is negligible, and the reliability of MySQL ensures your players’ data is always safe. If you’ve been struggling with inventory loss between worlds or looking for a lightweight alternative to proxy-based sync, this plugin deserves a spot in your server toolkit.