Back to mods
PlayerSync project artwork

CurseForge · Minecraft mod

PlayerSync

A server side mod that allows synchronising player data (inventory, health, xp, ...) across different Forge or NeoForge servers.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which PlayerSync release matches 1.20.2 Forge?

Updated 4 months ago
Best match for your filters 1.20.1-2.1.1
Game version 1.20.2, 1.20.5, 1.20.3
Loader Forge

PlayerSync 1.20.1-2.1.1 targets 1.20.2, 1.20.5, 1.20.3 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.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Forge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does PlayerSync 1.20.1-2.1.1 need?

1.20.1-2.1.1 on 1.20.2 Forge. Every mod below is checked against that same setup.

No extra mods listed for this file

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.1 on 1.20.2 Forge. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 1.20.1-2.1.1. It targets 1.20.2, 1.20.5, 1.20.3 with Forge; another release may have different loader, side or dependency requirements.

  2. 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.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 1.20.1-2.1.1. 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

  1. Install the Mod: Download the PlayerSync mod and place it in the mods folder of each server you want to synchronize.

  2. Configure the Database: Generate config file by starting server at first.Edit the playersync.toml config file in the config folder to set your database connection details. Each server should have a unique Server_id.

  3. Start Your Servers: PlayerSync will automatically create the necessary tables and keep your data in sync.

  4. (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: 3306

  • use_ssl Whether to use SSL for the database connection. Default: false

  • user_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 true ONLY 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.

11 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

PlayerSync versions and loaders

1 of 25 releases match
Clear filters

Looking for an older file? The official CurseForge project page is in Resources.