# Upgrading from V4

Since v5 ExcellentEnchants uses Paper Registries API to register enchantments on PaperMC servers, where it's recommended to register them under custom namespace.

Because of that, a lot of internals changes were made to accompilish support for both Spigot and Paper servers. Therefore, a lot of configuration changes were introduced.

Alternatively, a clean install is always an option.

# Namespace

By default all enchantments registered under the excellentenchants namespace. This means that enchantments from v4 will permanently be removed from the server when v5 is installed, since they were registered under vanilla minecraft namespace.

To keep your v4 enchantments on v5, you have to pregenerate new configs from v5 in your dev environment and disable custom namespace before upgrade in production.

# Distribution

Global distribution and disabled enchantments settings were moved out to the dedicated config file. Make sure to edit them according to your v4 settings before use in production.

# Enchantment Settings

Enchantments configs are incompatible, backup your current /enchants/ directory and generate a fresh one. After that you can edit enchantment settings according to your v4 setup.

Do not try to upgrade with /enchants/ files from v4!

The config files will be messed up and the server will refuse from loading.

You have been warned.