Migration and UUIDs

• Migrating Between Backends
• UUID Support

Migrating Between Backends (top)

Migration between backends has been simplified as of 1.21. Follow these steps:

1. Make sure both backends are configured in the config.yml as expected.
2. Set the backend option in config.yml to the backend being switched to and restart the server.
3. Once the server has loaded again, run the command /pex import <oldbackend>. This will transfer user data from the old backend to the new one, overwriting any existing users or groups in the old backend.

UUID Support (top)

PEX supports UUIDs and will migrate users over to UUID as they log in or are referenced by other PermissionsEx functions. The player's last known name will be stored under the name option, which can allow for reverting changes (though this is still complicated, so read this section before proceeding) However, there are some things to take note of if your server is run in offline mode for any reason.

When your server is run in offline mode, UUIDs are based on name alone. This means that by default if a user changes their name, even if the user would be able to authenticate with Mojang, their UUID will change. However, some proxy configurations have methods of circumventing this limitation.

BungeeCord

To get stable UUIDs on a BungeeCord server, the server must be running Spigot and have the bungeecord option set to true in the spigot configuration file.

LilyPad

On a LilyPad server, only the LilyPad Bukkit-Connect plugin is required to provide stable UUIDs.

Previous: Plugin Configuration, Next: Basic Permissions Setup