docs: update sync features docs/faq

feat/data-edit-commands
William 8 months ago
parent 8293d767da
commit 328d4476aa
No known key found for this signature in database

@ -12,14 +12,16 @@ HuskSync supports synchronising a wide range of different data elements, each of
<details>
<summary>&nbsp;<b>Are modded items supported?</b></summary>
Modded items are not supported.
If you're running HuskSync on Arclight or similar, please note we will not be able to provide you with support, but have been reported to save & sync correctly with HuskSync v3.x+.
**TL;DR** &mdash; modded items may work, but since we can't guarantee compatibility, we do not officially mark them as supported. Be sure to test thoroughly before deploying on production!
</details>
<details>
<summary>&nbsp;<b>Are MMOItems / SlimeFun / ItemsAdder items supported?</b></summary>
These plugins, which provide custom items, should be supported as of HuskSync v3.x; but do note we cannot guarantee compatibility with all methods of injecting custom data to create custom items. Be sure to test thoroughly before deploying on production!
These plugins, which provide custom items, should be supported as of HuskSync v3.x+; but do note we cannot guarantee compatibility with all methods of injecting custom data to create custom items. Be sure to test thoroughly before deploying on production!
</details>

@ -8,7 +8,7 @@ You can customise how much data HuskSync saves about a player by [turning each s
| Name | Description | Availability |
|---------------------------|---------------------------------------------------------------------------------------------|:------------:|
| Inventories | Items in player inventories & selected hotbar slot | ✅ |
| Ender chests | Items in ender chests&midast; | ✅ |
| Ender chests | Items in ender chests | ✅ |
| Health | Player health points and scale | ✅ |
| Hunger | Player hunger, saturation & exhaustion | ✅ |
| Attributes | Player max health, movement speed, reach, etc. ([wiki](https://minecraft.wiki/w/Attribute)) | ✅ |
@ -18,17 +18,16 @@ You can customise how much data HuskSync saves about a player by [turning each s
| Game modes | Player's current game mode | ✅ |
| Flight status | If the player is currently flying / can fly | ✅ |
| Statistics | Player's in-game stats (ESC -> Statistics) | ✅ |
| Location | Player's current coordinate position and world&dagger; | ✅ |
| Location | Player's current coordinate position and world (see below) | ✅ |
| Persistent Data Container | Custom plugin persistent data key map | ✅️ |
| Locked maps | Maps/treasure maps locked in a cartography table | ✅ |
| Unlocked maps | Regular, unlocked maps/treasure maps ([why?](#map-syncing)) | ❌ |
| Economy balances | Vault economy balance. ([why?](#economy-syncing)) | ❌ |
What about modded items? Or custom item plugins such as MMOItems or SlimeFun? These items are **not compatible**&mdash;check the [[FAQs]] for more information.
&midast;Purpur's custom ender chest resizing feature is also supported.
&dagger;This is intended for servers that have mirrored worlds across instances (such as RPG servers). With this option enabled, players will be placed at the same coordinates when changing servers.
* What about modded items (Arclight, etc.)? &ndash; 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.? &ndash; 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? &ndash; Yes, this is supported (but make sure it's enabled on _all_ servers!).
* What do you mean by location syncing? &ndash; 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.

Loading…
Cancel
Save