UUID conversion - rutgerkok/BetterEnderChest GitHub Wiki

BetterEnderChest 2.2.* automatically converts the old playername.dat chest files to uuid.dat files. When you are using MySQL, it does the same for the database.

Networking

The conversion process (and all later UUID lookups) require access to api.mojang.com. If you wish to not use api.mojang.com, set BetterEnderChest.useUUIDs to false in the config.yml. This will make BetterEnderChest continue using names instead of UUIDs. You have to do this before the chests are converted to the UUID format.

Offline mode

The conversion process does not support offline mode. BetterEnderChest saved the chests with the lowercase version of the username. Offline mode UUIDs are based on the correct cased name of the player. This makes conversion almost impossible. Set BetterEnderChest.useUUIDs to false in the config.yml to disable UUID support, and continue using names.

The above does not apply to servers behind Bungeecord. As long as the Bungeecord instance is a) running in online mode and b) has set ip-forwarding to true, everything will work fine.

Backups

Make a backup. The conversion process cannot be undone, and you cannot downgrade to earlier versions of BetterEnderChest unless you restore a backup.

Errors

BetterEnderChest 2.2.0 cannot convert more than 500 chests anymore, it's getting rate-limited by Mojang. Mojang has created a more efficient API, that has much higher rate limits. BetterEnderChest 2.2.1 uses this new API, so please update the plugin.

If there are other errors, please report them to me at BukkitDev. You can send me a PM, or you can open a ticket.

BetterEnderChest locks all Ender Chests during the conversion process. When an error occurs, the chests won't be unlocked, preventing any damage to your chests.

Chest importers

The importers of MyWorlds, Multiverse-Inventories, MultiInv and WorldInventories haven't been updated yet to use UUIDs. This is not yet possible, as those plugins haven't yet been updated to use UUIDs. When they update, please report it to me, so I can make the necessary changes to BetterEnderChest.