Skip to content

Per World User Data

NotMyFault edited this page May 24, 2021 · 1 revision

Per World User Data

This system is experimental. Use it at your own risk. If you are moving from Multiverse-Inventories it is recommended that you switch to PWI.

Description

Hyperverse allows you to setup world profile groups, that share user data. When a player moves into a world belonging to a different group, their user data will be saved in a folder, and the user data for the new profile group will be loaded.

Details

Unlike Multiverse-Inventories and PWI, this isn't done by writing to and reading from a database. Instead, Hyperverse makes use of Minecraft's built in player NBT data. Switching data like this is not really supported by (Craft)Bukkit, but it is still very possible. It works by parsing the NBT data by using Minecraft internals, and it then force applies this data to the player. It then forcefully removes the player from the world, and adds them back.

Because of this, our system manages to separate almost all aspects of player data between worlds, including (but not limited to): experience, potion effects, abilities, inventories, ender chests, bed spawn locations, etc.

Enabling

To enable the system, change grouped-inventories to true in hyperverse.conf. You will also need to link worlds together by setting the profile-group flag, as such:

/hv flag set <world> profile-group <group name>.

All worlds with the same profile group, will share profile data.