HuskLegacy
/
HuskSync
forked from public-mirrors/HuskSync
1
0
Fork 0
Code Pull Requests Activity
A modern, cross-server player data synchronisation system
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
585 Commits
7 Branches
46 Tags
11 MiB
Java 98.2%
Python 1.8%
 
 
master
dependabot/gradle/xyz.jpenilla.run-paper-2.3.1
dependabot/gradle/org.junit.jupiter-junit-jupiter-api-5.11.0
dependabot/gradle/com.google.guava-guava-33.3.0-jre
dependabot/gradle/org.junit.jupiter-junit-jupiter-params-5.11.0
dependabot/gradle/org.junit.jupiter-junit-jupiter-engine-5.11.0
feat/data-edit-commands
1.3
1.3.2
1.4
1.4-SNAPSHOT
1.4.1
2.0
2.0.1
2.0.2
2.1
2.1.1
2.1.2
2.2
2.2.1
2.2.2
2.2.3
2.2.4
2.2.5
2.2.6
2.2.7
2.2.8
3.0
3.0.1
3.0.2
3.1
3.1.1
3.1.2
3.2
3.2.1
3.3
3.3.1
3.3.2
3.3.3
3.4
3.5
3.5.1
3.5.2
3.5.3
3.6
3.6.1
3.6.2
3.6.3
3.6.4
3.6.5
3.6.6
3.6.7
3.6.8
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'e7078c9542'
${ noResults }
Go to file
William e7078c9542
docs: Document updated default sync mode 		11 months ago
.github ci: Use wiki-action@v3 11 months ago
.scripts MPDBConverter over jitpack 2 years ago
bukkit fix: Improve accuracy of max health syncing #148 11 months ago
common refactor: change default sync mode to `LOCKSTEP` 11 months ago
docs docs: Document updated default sync mode 11 months ago
gradle/wrapper gradle: Update to Gradle 8.0.2, bump shadow to 8.1.0 2 years ago
images v3.0: New modular, more compatible data format, new API, better UX (#160) 1 year ago
paper refactor: Use native adventure implementation on Paper 11 months ago
plugin Paper plugin support, save player itemsToKeep rather than drops if not empty (#179) 1 year ago
test test: bump test suite to 1.20.4 12 months ago
.gitignore v3.0: New modular, more compatible data format, new API, better UX (#160) 1 year ago
HEADER license: Relicense under Apache-2.0 1 year ago
LICENSE v3.0: New modular, more compatible data format, new API, better UX (#160) 1 year ago
README.md [ci skip] update readme 1 year ago
build.gradle Bump org.junit.jupiter:junit-jupiter-params from 5.10.0 to 5.10.1 (#205) 1 year ago
gradle.properties deps: Bump runtime dependencies 11 months ago
gradlew gradle: Update to Gradle 8.0.2, bump shadow to 8.1.0 2 years ago
gradlew.bat gradle: Update to Gradle 8.0.2, bump shadow to 8.1.0 2 years ago
jitpack.yml MPDBConverter over jitpack 2 years ago
settings.gradle Paper plugin support, save player itemsToKeep rather than drops if not empty (#179) 1 year ago

README.md

HuskSync
Spigot — Setup — Docs — Issues


HuskSync is a modern, cross-server player data synchronization system that enables the comprehensive synchronization of your user's data across multiple proxied servers. It does this by making use of Redis and MySQL to optimally cache data while players change servers.

Features

⭐ Seamless synchronization — Utilises optimised Redis caching when players change server to sync player data super quickly for a seamless experience.

⭐ Complete player synchronization — Sync inventories, Ender Chests, health, hunger, effects, advancements, statistics, locked maps & more—no data left behind!

⭐ Backup, restore & rotate — Something gone wrong? Restore players back to a previous data state. Rotate and manage data snapshots in-game!

⭐ Import existing data — Import your MySQLPlayerDataBridge data—or from your existing world data! No server reset needed!

⭐ Works great with Plan — Stay in touch with your community through HuskSync analytics on your Plan web panel.

⭐ Extensible API & open-source — Need more? Extend the plugin with the Developer API. Or, submit a pull request through our code bounty system!

Ready? It's syncing time!

Setup

Requires a MySQL (v8.0+) database, a Redis (v5.0+) server and any number of Spigot-based 1.16.5+ Minecraft servers, running Java 16+.

  1. Place the plugin jar file in the /plugins/ directory of each Spigot server. You do not need to install HuskSync as a proxy plugin.
  2. Start, then stop every server to let HuskSync generate the config file.
  3. Navigate to the HuskSync config file on each server (~/plugins/HuskSync/config.yml) and fill in both the MySQL and Redis database credentials.
  4. Start every server again and synchronization will begin.

Development

To build HuskSync, simply run the following in the root of the repository:

./gradlew clean build

License

HuskSync is licensed under the Apache 2.0 license.

Contributions to the project are welcome—feel free to open a pull request with new features, improvements and/or fixes!

Support

Due to its complexity, official binaries and customer support for HuskSync is provided through a paid model. This means that support is only available to users who have purchased a license to the plugin from Spigot, Polymart, Craftaro, or BuiltByBit and have provided proof of purchase. Please join our Discord server if you have done so and need help!

Translations

Translations of the plugin locales are welcome to help make the plugin more accessible. Please submit a pull request with your translations as a .yml file.

Links

© William278, 2023. Licensed under the Apache-2.0 License.