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.
 
 
Go to file
dependabot[bot] 4f669170c2
Bump org.jetbrains:annotations from 24.0.0 to 24.0.1 (#107)
Bumps [org.jetbrains:annotations](https://github.com/JetBrains/java-annotations) from 24.0.0 to 24.0.1.
- [Release notes](https://github.com/JetBrains/java-annotations/releases)
- [Changelog](https://github.com/JetBrains/java-annotations/blob/master/CHANGELOG.md)
- [Commits](https://github.com/JetBrains/java-annotations/commits)

---
updated-dependencies:
- dependency-name: org.jetbrains:annotations
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2 years ago
.github Create dependabot.yml and funding.yml 2 years ago
.scripts MPDBConverter over jitpack 2 years ago
bukkit Bump net.william278:DesertWell from 1.1 to 1.1.1 (#102) 2 years ago
common Bump org.jetbrains:annotations from 24.0.0 to 24.0.1 (#107) 2 years ago
gradle/wrapper Initial commit 3 years ago
images Update README and banner 2 years ago
plugin Merge API module into bukkit for simplicity 2 years ago
.gitignore Refactor package to net.william278; update dependencies & stop shading internal modules 3 years ago
LICENSE [ci skip] Update license year (2023) 2 years ago
README.md [ci skip] Correct typos in README 2 years ago
build.gradle Update dependencies 2 years ago
gradle.properties Bump to 2.2.4 2 years ago
gradlew Fix gradlew permissions, remove old graphic 2 years ago
gradlew.bat Initial commit 3 years ago
jitpack.yml MPDBConverter over jitpack 2 years ago
settings.gradle Merge API module into bukkit for simplicity 2 years ago

README.md

HuskSync
Spigot Setup Docs Issues


HuskSync is a modern, cross-server player data synchronisation system that enables the comprehensive synchronisation 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 synchronisation — Utilises optimised Redis caching when players change server to sync player data super quickly for a seamless experience.

Complete player synchronisation — 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? Let's head down town!

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.

Building

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

./gradlew clean build

License

HuskSync is a premium resource. This source code is provided as reference only for those who have purchased the resource from an official source.

Contributing

A code bounty program is in place for HuskSync, where developers making significant code contributions to HuskSync may be entitled to a license at my discretion to use HuskSync in commercial contexts without having to purchase the resource. Please read the information for contributors in the LICENSE file before submitting a pull request.

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.

  • Docs — Read the plugin documentation!
  • Spigot — View the Spigot resource page (Also: Polymart, Songoda)
  • Issues — File a bug report or feature request
  • Discord — Get help, ask questions (Proof of purchase required)
  • bStats — View plugin metrics

© William278, 2023. All rights reserved.