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.
411 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 'c2c5a424fb'
${ noResults }
Go to file
William c2c5a424fb Add checks against the user being an NPC 2 years ago
.github/workflows MPDBConverter over jitpack 2 years ago
.scripts MPDBConverter over jitpack 2 years ago
bukkit Add checks against the user being an NPC 2 years ago
common Add checks against the user being an NPC 2 years ago
gradle/wrapper Initial commit 3 years ago
images [ci skip] Add data-dumping.png 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] Update badge 2 years ago
build.gradle TriumphGUI for menus, fix missing inv/echest view message, fix data saving despite no updates, close #42 2 years ago
gradle.properties Bump to 2.2 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 Banner

GitHub CI JitPack API Support Discord

Documentation, Guides & API · Resource Page · Bug Reports

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

Data snapshot viewer

  • Synchronise inventories, ender chests, advancements, statistics, experience points, health, max health, hunger, saturation, potion effects, persistent data container tags, game mode, location and more across multiple proxied servers.
  • Create and manage "snapshot" backups of user data and roll back users to previous states on-the-fly. (/userdata)
  • Preview, list, delete, restore & pin user data snapshots in-game with an intuitive menu.
  • Examine the contents of player's inventories and ender chests on-the-fly. (/inventory, /enderchest)
  • Hooks with your Player Analytics web panel to provide an overview of user data.
  • Supports segregating synchronisation across multiple distinct clusters on one network.

Requirements

  • A MySQL Database (v8.0+).
  • A Redis Database (v5.0+)
  • Any number of proxied Spigot servers (Minecraft v1.16.5+, Java 16+)

Setup

  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.

Translation

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.

bStats

This plugin uses bStats to provide me with metrics about its usage:

You can turn metric collection off by navigating to ~/plugins/bStats/config.yml and editing the config to disable plugin metrics.

Links

© William278, 2022. All rights reserved.