Sync Features

This page contains a list of the features HuskSync is and isn't able to syncrhonise on your server.

You can customise how much data HuskSync saves about a player by turning each synchronization feature on or off. When a synchronization feature is turned off, HuskSync won't touch that part of a player's profile; in other words, the data they will inherit when changing servers will be read from their player data file on the local server.

Feature table

✅—Supported  ❌—Unsupported  ⚠️—Experimental

NameDescriptionAvailability
InventoriesItems in player inventories & selected hotbar slot
Ender chestsItems in ender chests
HealthPlayer health points and scale
HungerPlayer hunger, saturation & exhaustion
AttributesPlayer max health, movement speed, reach, etc. (wiki)
ExperiencePlayer level, experience points & score
Potion effectsActive status effects on players
AdvancementsPlayer advancements, recipes & progress
Game modesPlayer's current game mode
Flight statusIf the player is currently flying / can fly
StatisticsPlayer's in-game stats (ESC -> Statistics)
LocationPlayer's current coordinate position and world (see below)
Persistent Data ContainerCustom plugin persistent data key map✅️
Locked mapsMaps/treasure maps locked in a cartography table
Unlocked mapsRegular, unlocked maps/treasure maps (why?)
Economy balancesVault economy balance. (why?)
  • What about modded items (Arclight, etc.)? – Though we can't provide support for these setups to work, they have been reported to save & sync correctly with HuskSync v3.x+.
  • What about SlimeFun, MMOItems, etc.? – Yes, items created via these plugins should save & sync correctly, but be sure to test thoroughly first.
  • What about Purpur's custom ender chest resizing feature? – Yes, this is supported (but make sure it's enabled on all servers!).
  • What do you mean by location syncing? – This is intended for servers that have mirrored worlds across instances (such as RPG servers). With this enabled, players will be placed at the same coordinates when changing servers.

Map syncing

Map items are a special case, as their data is not stored in the item itself, but rather in the game world files. In addition to this, their data is dynamic and changes based on the updating of the world, something that can't be tracked across multiple instances. As a result, it's not possible to sync unlocked map items. Locked maps, however, are supported. This works by saving the pixel canvas grid to the map NBT itself, and generating virtual maps on the other servers.

Economy syncing

Although it's a common request, HuskSync doesn't synchronize economy data for a number of reasons!

I strongly recommend making use of economy plugins that have cross-server economy balance synchronization built-in, of which there are a multitude of options available. Please see our FAQs section for more details on this decision.

Toggling Sync Features

All synchronization features, except location and locked map synchronizing, are enabled by default. To toggle a feature, navigate to the features: section in the synchronization: part of your config.yml file, and change the option to true/false respectively.

Example in config.yml
synchronization:
  # ...
  features:
    health: true
    statistics: true
    location: false
    potion_effects: true
    ender_chest: true
    experience: true
    advancements: true
    game_mode: true
    inventory: true
    persistent_data: true
    hunger: true
  #...