A Minecraft Forge mod that synchronizes player data across multiple servers using a MySQL backend.

Go to file

laforetbrut 6bb8aeba39 Fix RS2 disk + SS shulker data loss: use in-memory API, not .dat files ROOT CAUSE for both: - RS2: We removed dataStorage.save() to avoid fastasyncworldsave crash, but then read the .dat file which had stale data. Disks appeared empty because the file didn't contain the latest in-memory state. - SS: getOrCreateStorageContents() could create empty content if the data wasn't loaded yet for that UUID. FIX RS2: - Save: Use SavedData.save(CompoundTag, Provider) which serializes from MEMORY, not disk. No file I/O, no fastasyncworldsave conflict. - Restore: Decode entries via RS2's codec (reflection on getMapCodec) and inject via repo.set(). Falls back to direct NBT injection if codec fails. - Removed dead code: getRS2DataFile, injectRS2EntryIntoNbt FIX SS: - Already using StackStorageWrapper.fromStack() API for UUID extraction (DataComponent-based, not CustomData). This was fixed in previous commit. If data still missing, the save() logging will show which UUIDs fail to find in ItemContentsStorage. Vyrriox		2026-03-26 19:12:02 +01:00
.github	Bump gradle/actions from 4 to 5	2025-10-14 16:55:21 +08:00
gradle/wrapper	migrate from ForgeGradle to ModDevGradle legacy	2025-05-02 22:40:39 +00:00
src/main	Fix RS2 disk + SS shulker data loss: use in-memory API, not .dat files	2026-03-26 19:12:02 +01:00
.gitattributes	Initial commit	2022-12-08 16:59:20 +08:00
.gitignore	add support for Minecraft 1.20.4 with ModDevGradle	2025-05-04 18:43:11 +00:00
build.gradle	Fix Sophisticated Storage shulkers/chests/barrels losing contents on transfer	2026-03-26 17:12:29 +01:00
docker-compose.yml	use volume for docker-compose db to persist data	2025-05-01 18:42:58 +00:00
gradle.properties	fix #151	2026-01-14 20:26:26 +08:00
gradlew	migrate from ForgeGradle to ModDevGradle legacy	2025-05-02 22:40:39 +00:00
gradlew.bat	migrate from ForgeGradle to ModDevGradle legacy	2025-05-02 22:40:39 +00:00
LICENSE	Create LICENSE	2022-12-08 17:11:47 +08:00
README.md	readme: add section on how to setup a dev env	2025-05-01 16:59:05 +00:00
settings.gradle	half done, noticed about advancement can't store normally	2025-06-07 00:55:30 +08:00

README.md

PlayerSync

PlayerSync is a Minecraft Forge mod that synchronizes player data across multiple servers using a MySQL backend. It allows players to maintain their inventory, equipment, experience, advancements, and more when moving between servers in a network.

Mod Support

Any other mods support is also possible.

Development Setup

Database Setup (Docker)

A docker-compose.yml file is provided for easily setting up a MariaDB database instance for development testing.

Make sure Docker is installed.
Inside your work directory run:
```
docker compose up -d
```
This will download the MariaDB image (if not already present) and start a database container in the background.
Stoppinng the Database
```
docker compose down
```

Data Persistence: The database uses a Docker volume, ensuring your data persists even if you stop and restart the containers.

Database Management Tool

The docker-compose.yml also includes an Adminer service, a lightweight database management tool.

Access Adminer in your web browser at http://localhost:8080.
Log in using the server with
- username: playersync
- database: playersync
- password: see docker-compose.yml

For debugging purposes, you can enable use_legacy_serialization to have readable database fields. This can cause crashes and unintended side-effects. Do not enable this on a production server if not absolutely necessary!

Running the Mod

The project uses Gradle for building and running. Use the provided Gradle wrapper (gradlew for Linux/macOS, gradlew.bat for Windows).

Make sure that the MySQL database you configured is running.
Run the Server
```
./gradlew runServer
```
or on Windows:
```
.\gradlew.bat runServer
```
This task compiles the mod and starts a dedicated Minecraft server instance with the mod loaded in the run directory.

Run the Client

./gradlew runClient

or on Windows:

.\gradlew.bat runClient