Keep Inventory

If your server uses Keep Inventory, in which players keep the contents of their inventory after dying, HuskSync's built-in snapshot-on-death and dead-player synchronisation features can conflict with this.

To solve this issue, you need to update two settings in your config.yml file, as described below.

Why does this happen?

HuskSync has some special handling when players die, to account for scenarios where users change servers after death (to prevent item loss).

• Death state saving—HuskSync has special logic to save player snapshots except their inventory when they change servers while dead. When keepInventory is enabled, though, the inventory still contains items, so the snapshot is not saved correctly. This logic is enabled by default.
• Snapshot creation on death —HuskSync can create a special snapshot for backup purposes when a player dies, formed by taking their drops and setting this to their inventory. When keepInventory is enabled, the player drops are empty, so this creates an inaccurate snapshot. This option is disabled by default.

How can this be fixed?

You will need to set both the synchronization.save_on_death and synchronization.save_dead_player_inventories following options to false in config.yml

Example in config.yml

   synchronization:
     # ...
     save_on_death: false # <-- Set this to false
     # ...
     save_dead_player_inventories: false # <-- Set this to false

Custom keepInventory setups

If your server uses an advanced custom setup where some items are kept and others are not through custom plugin logic, you'll need to use the HuskSync API to create a custom hook to update data on the DataSaveEvent when a player changes server while dead, transforming their inventory data as appropriate.

If your server uses a permission node to control whether the user keeps their inventory on death, you should be able to follow the above instructions although your mileage may vary dependent on your setup and how you handle players when they die. Note that this option will often conflict with other plugins anyway that make certain expectations about death item persistence too.