CurseForge · Minecraft mod
PlayerSync
A server side mod that allows synchronising player data (inventory, health, xp, ...) across different Forge or NeoForge servers.
Quick answer
Which PlayerSync release matches 1.20.1 Forge?
PlayerSync 1.20.1-2.1.4 targets 1.20.1 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.
Where it goes
Is PlayerSync required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does PlayerSync 1.20.1-2.1.4 need?
1.20.1-2.1.4 on 1.20.1 Forge. Every mod below is checked against that same setup.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add PlayerSync without breaking your instance.
Built for PlayerSync 1.20.1-2.1.4 on 1.20.1 Forge. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 1.20.1-2.1.4. It targets 1.20.1 with Forge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside 1.20.1-2.1.4. It opens that exact file at the source.
About this project
What does PlayerSync add?
PlayerSync
PlayerSync is a Minecraft mod that keeps your player data synchronized across multiple servers. Seamlessly move between servers in your network without losing your inventory, experience, advancements, or modded items.
Features
- Inventory Sync: Your main inventory, armor, ender chest, and offhand items are always up to date on every server.
- Experience & Stats: XP, health, food, and score are preserved as you travel between servers.
- Advancement Sync: Your achievements and advancements follow you everywhere.
- Potion Effects: Active potion effects are restored when you join a new server.
- Mod Support:
- Curios API: Curios slots and items are synchronized.
- Sophisticated Backpacks: Backpack contents are kept in sync.
- Cobblemon: Party, PC and Podex are supported(Only 1.21.1).
- [Aether,Cosmetic-armor-reworked,Apotheosis,Aether,Refined-storage,Extra-disks,etc](Only 1.21.1)
- [Any Mods using NeoForge AttachmentTypes]
- Placeholder Items: If a modded item is missing on a server, a placeholder is created so nothing is lost.
- Chat Sync (Optional): Synchronize chat messages between servers (can be enabled in config).
How It Works
PlayerSync uses a central MySQL or MariaDB database to store your player data. When you join a server, your data is loaded from the database. When you leave or your data is saved, it is updated in the database. This ensures your progress is always up to date, no matter which server you play on.
Getting Started
Install the Mod: Download the PlayerSync mod and place it in the
modsfolder of each server you want to synchronize.Configure the Database: Generate config file by starting server at first.Edit the
playersync.tomlconfig file in theconfigfolder to set your database connection details. Each server should have a uniqueServer_id.Start Your Servers: PlayerSync will automatically create the necessary tables and keep your data in sync.
(Optional) Enable Chat Sync: Enable chat synchronization in the config if you want messages to be shared between servers.
Configuration Options
All options are found in the playersync.toml file in your server’s config folder.
Database Settings
host The address of your MySQL/MariaDB database server. Default:
"localhost"db_port The port for your database server. Default:
3306use_ssl Whether to use SSL for the database connection. Default:
falseuser_name The username for your database. Default:
"playersync"password The password for your database.
db_name The name of the database to use. Default:
"playersync"Server_id This value distinguishes each server in your network. Each server must have a unique integer here! Default: Randomly generated.
Synchronization Options
- sync_advancements Whether to synchronize advancements (achievements) between servers. Default:
true
Serialization Options
- use_legacy_serialization Use the old (pre-Base64) serialization format for writing data to the database. Set to
trueONLY if you have mod versions older than 1.35 reading the same database. Default:false
Placeholder Item Options
item_placeholder_title_override Override the title of placeholder items (for missing modded items). Default:
""(uses default translation)item_placeholder_description_override Override the description of placeholder items. Default:
""(uses default translation)
FAQ
Q: What happens if I have modded items and join a server without that mod? A: PlayerSync will create a placeholder item so your original item is not lost. When you return to a server with the mod, your item will be restored.
Q: Is my data safe? A: Yes! All data is stored in a central database and is not lost when switching servers.
Q: Does this work for singleplayer? A: PlayerSync is designed for multi-server networks. It is not needed for singleplayer.
Q: What mods are supported? A: Curios API and Sophisticated Backpacks are supported out of the box. More mod support may be added in the future.
Support
If you have questions or need help, please contact us via the mod page or our Discord server.
Enjoy seamless play across all your servers with PlayerSync!
Project description from CurseForge.
Pick your setup
PlayerSync by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
1.20.6
1 loader build1.20.5
1 loader build1.20.4
2 loader builds1.20.3
1 loader build1.20.2
1 loader build1.20.1
1 loader build1.19.2
1 loader build1.18.2
1 loader build1.16.5
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
PlayerSync versions and loaders
1.20.1-2.1.4
playersync-1.20.1-2.1.4.jar
22 Nov 2025
1.20.1-2.1.3
playersync-1.20.1-2.1.3.jar
6 Jun 2025
1.20.1-2.1.2
playersync-1.20.1-2.1.2.jar
5 Jun 2025
1.20.1-2.1.1
playersync-1.20.1-2.1.1.jar
19 May 2025
1.20.1-2.1.0
playersync-1.20.1-2.1.0.jar
4 May 2025
playersync-1.20.1-2.0.0.jar
4 May 2025
playersync-1.20.1-1.3.5-all.jar
21 Mar 2025
playersync-1.20.1-1.3.4-all.jar
11 Oct 2024
playersync-1.20.1-1.3.3-all.jar
5 Aug 2024
playersync-1.20.1-1.3.2-all.jar
3 May 2024
playersync-1.20.1-1.3.1-all.jar
21 Mar 2024
Looking for an older file? The official CurseForge project page is in Resources.