HuskLegacy
/
HuskSync
forked from public-mirrors/HuskSync
1
0
Fork 0
Code Pull Requests Activity
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.
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 '854bf37186'
${ noResults }
HuskSync/docs/Troubleshooting.md

2.3 KiB
Raw Blame History

This page contains a number of common issues and how you can troubleshoot and resolve them.

Topics

Duplicate UUIDs in database

This is most frequently caused by running a cracked "offline mode" network of servers. We don't provide support for problems caused by cracked servers and the most advice we can offer you is:

  • Ensure bungee_online_mode is set to the correct value in the paper.yml config file on each of your Bukkit servers
  • Ensure your authenticator plugin is passing valid, unique IDs to each backend Spigot server.

Cannot set data with newer Minecraft version than the server

This is caused when you attempt to downgrade user data from a newer version of Minecraft to an older one, or when your Spigot servers are running mismatched Minecraft versions.

HuskSync will identify this and safely prevent the synchronisation from occuring. Your Spigot servers must be running the same version of both Minecraft and HuskSync.

User data failing to synchronise

This can occur due to misaligned timings between your Spigot servers and your Redis server. HuskSync has a built in way of tuning this. Try continously increasing the network_latency_milliseconds option in your config to a higher value.

Synchronisation issues with Keep Inventory enabled

On servers that use Keep Inventory move (where players keep their items when they die), you can run into synchronisation issues. See Keep Inventory for details on why this happens and how to resolve it.

Exceptions when compressing data via Snappy (lightweight Linux distros)

Some lightweight Linux distros such as Alpine Linux (used on Pterodactyl) might not have the dependencies needed for the Snappy compressor. It's possible to disable data compression by changing compress_data to false in your config. Note that after changing this setting you will need to reset your database. Alternatively, find the right libraries for your distro!

Redis connection problems on Pterodactyl

The internal firewall on Pterodactyl can block Redis connections between servers. Add an allocation to each server allowing them to communicate with your Redis server. It may be easier to install Redis in an egg than trying to use the backend internal service.